🛤️ tracking: The Road to Polaris ✨

[runspired]

🌌 Universal

[!NOTE] Universal also presumes that we ship SchemaRecord (in the WarpDrive section) for full utility, and that tasks in the Vite section are done.

• derisk decoupling EmberData from Ember's runloop

  • [ ] (upstream) Implement Render Aware Scheduler RFC

• EmberData without EmberSource

  • [x] deprecate Store extending EmberObject
  • [ ] hook @ember-data/tracking for arbitrary signal implementations
    • and/or adopt StarbeamJS
    • and/or adopt Reactive Primitives proposal from TC39
  • [x] replace @ember/debug (assert) usage with something not tied to ember-source
  • [ ] replace @ember/debug (warn, deprecate) usage with something not tied to ember-source
  • [ ] Configuration point for @ember/test-waiters for non-ember projects
  • [x] replace @ember/string usage with something lighter of our own

🚀 WarpDrive

• SchemaService
  • [x] RFC SchemaService upgrade needed for SchemaRecord
  • [x] Implement RFC
  • [ ] Ship new implementation with 4.12 support

Schema DSL

- Legacy - [ ] Can parse simple legacy attributes to JSON schema - [ ] Can parse complex legacy attributes to JSON schema - [ ] Can parse belongsTo to JSON schema - [ ] Can parse hasMany to JSON schema - [ ] Can parse ID field to JSON schema - [ ] Can parse derived field to JSON schema - [ ] Can parse local field to JSON schema - [ ] Traits are included in JSON schema - [ ] Can parse simple legacy attributes to read Type - [ ] Can parse complex legacy attributes to read Type - [ ] Can parse belongsTo to read Type - [ ] Can parse ID field to read Type - [ ] Can parse derived field to read Type - [ ] Can parse local field to read Type - [ ] Traits are included in read Type - [ ] Can parse hasMany to read Type - [ ] Can parse simple legacy attributes to update Type - [ ] Can parse complex legacy attributes to update Type - [ ] Can parse belongsTo to update Type - [ ] Can parse hasMany to update Type - [ ] Can parse ID field to update Type - [ ] Can parse derived field to update Type - [ ] Can parse local field to update Type - [ ] Traits are included in update Type - [ ] Can parse simple legacy attributes to create type - [ ] Can parse complex legacy attributes to create Type - [ ] Can parse belongsTo to create type - [ ] Can parse hasMany to create type - [ ] Can parse ID field to create Type - [ ] Can parse derived field to create Type - [ ] Can parse local field to create Type - [ ] Traits are included in create Type - Modern - [ ] Can parse generic fields to JSON schema - [ ] Can parse object fields to JSON schema - [ ] Can parse array fields to JSON schema - [ ] Can parse schema-object to JSON schema - [ ] Can parse schema-array to JSON schema - [ ] Can parse resource to JSON schema - [ ] Can parse collection to JSON schema - [ ] Can parse generic fields to read Type - [ ] Can parse object fields to read Type - [ ] Can parse array fields to read Type - [ ] Can parse schema-object to read Type - [ ] Can parse schema-array to read Type - [ ] Can parse resource to read Type - [ ] Can parse collection to read Type - [ ] Can parse generic fields to update Type - [ ] Can parse object fields to update Type - [ ] Can parse array fields to update Type - [ ] Can parse schema-object to update Type - [ ] Can parse schema-array to update Type - [ ] Can parse resource to update Type - [ ] Can parse collection to update Type - [ ] Can parse generic fields to create Type - [ ] Can parse object fields to create Type - [ ] Can parse array fields to create Type - [ ] Can parse schema-object to create Type - [ ] Can parse schema-array to create Type - [ ] Can parse resource to create Type - [ ] Can parse collection to create Type

SchemaRecord

- Legacy - [x] supports read on `attr` - [x] supports read on `belongsTo` - [x] supports read on `hasMany` - [x] supports read on derivation - [x] supports read on `@local` - [x] supports read on `@id` - [x] attr is reactive - [x] belongsTo is reactive - [x] hasMany is reactive - [x] derivations are reactive - [x] `@local` is reactive - [x] `@id` is reactive - [x] supports edit on `attr` - [x] supports edit on `belongsTo` - [x] supports edit on `hasMany` - [x] errors for edit on derivation - [x] supports edit on `@local` - [x] supports edit on `@id` when record is new only - [x] supports create on `attr` - [x] supports create on `belongsTo` - [x] supports create on `hasMany` - [x] errors for create on derivation - [-] ~(MAYBE) supports create on `@local`~ - [x] supports create on `@id` - [x] supports LEGACY mode (no checkout required) - Modern - [ ] supports `record.checkout` - [x] supports read on `field` - [x] supports read on `object` - [x] supports read on `array` - [ ] supports read on `schema-object` - [x] supports read on `schema-array` - [x] supports read on `resource` - [ ] supports read on sync `collection` - [ ] supports read on async `collection` (requires cache pagination support) - [x] `field` is reactive - [x] `object` is deeply reactive - [x] `array` is deeply reactive - [ ] `schema-object` is deeply reactive - [x] `schema-array` is deeply reactive - [ ] `resource` is reactive - [ ] `collection` is reactive - [ ] supports edit on `field` - [ ] supports edit on `object` - [x] supports edit on `array` - [ ] supports edit on `schema-object` - [ ] supports edit on `schema-array` - [ ] supports edit on `resource` - [ ] supports edit on sync `collection` - [ ] supports edit on async `collection` (requires cache pagination support) - [ ] supports create on `field` - [ ] supports create on `object` - [ ] supports create on `array` - [ ] supports create on `schema-object` - [ ] supports create on `schema-array` - [ ] supports create on `resource` - [ ] supports create on sync `collection` - [ ] supports create on async `collection` (requires cache pagination support)

• Cache/Graph
  • [ ] Supports Paginated Collections
  • [ ] Supports Explicitly Named Partials

🐹 Ember

• Ship stable of @warp-drive/ember
  • [ ] Instrument legacy promises for eager promise cache population
  • [x] Implement isRefreshing
  • [x] Implement latestRequest abort/retry
  • [x] Implement autorefresh
  • [ ] Implement Pagination Utils
  • [ ] Implement Pagination Component
  • consider adding a linked-list/tree component

🩻 Testing & Debugging

• Inspector
  • [ ] Support RequestManager in Inspector
  • [ ] Support SchemaRecord in Inspector
  • [ ] Make it possible to activate logging during development without restarting build

Nice To Have

• Mocking
  • Ship stable of @warp-drive/holodeck
  • Make it easy to toggle recording for the entire test-suite
  • Integrate recording toggle to testem and diagnostic options
  • Add docs for testem config
  • fix shutdown bug
  • http/3 ? (if Bun lands support)
  • Provide utils and docs around how to functionally compose mock data for holodeck
  • API Route Mocking

⚡️ Vite

[!TIP] This section might be one of the easiest to complete for someone that understands a bit of tooling without needing to dig into EmberData's library code.

• EmberData without EmberCLI
  • [x] build config method
  • [x] ship all packages in v2 format

Nice To Have

• stand-alone macros plugin for vite

💚 Typescript

[!TIP] This section might be one of the easiest to complete for someone that understands typescript without needing to learn too much of EmberData's library code.

• [ ] improve quality of types so we can mark them as stable

Nice To Have

• rollup .d.ts files to reduce import surface area

💡 API Documentation

• 🚧 FILL ME OUT 🚧

🔭 Guides

• [ ] Ember Guides rewritten to Polaris EmberData patterns
• [x] SuperRentals tutorial rewritten to Polaris EmberData patterns
• [ ] Find somewhere to publish the in-repo guides we've written

🚢 Onboarding

• npx warp-drive|ember-data to run user through a flow that configures packages for them.

[lifeart]

Really inspiring list!

@runspired is any CRDT support planned (https://blog.notmyidea.org/a-comparison-of-javascript-crdts.html)? @Baltazore said it's could be implemented on top of custom handler

[runspired]

@lifeart built-in support for CRDT is not planned, and likely never will be due to how it overlaps with JSON:API operations, but yes, it could be implemented overtop of a handler

[sandstrom]

@lifeart If you have some free time, and would like to contribute to this roadmap, we'd be willing to sponsor your work on Ember Data.

Can discuss in more detail if you're interested (we're sponsoring runspired and rwjblue already).

[runspired]

a few polaris updates:

• due to time constraints, we won't ship the schema-dsl
• we won't ship store forking
• we won't ship explicit partials (note, most of what folks want from partials works out of the box, explicit partials is a very niche feature addition)