Scope in schema, reserved-name guards, conformance context, and 0.10.20 back-compat

[krisnye]

Summary

Follow-up to #210: small fixes and guards found while porting the samples, plus back-compat so a 0.10.20 consumer can take this release as a version bump.

• Scope moves to @adobe/data/schema. It only annotates a schema with its scope flags, so data/ files no longer import the ECS module to declare a column's scope.
• presence is documented as not yet synced. @adobe/data-sync deliberately skips nonPersistent data, so a presence value currently stays local.
• Reserved names are a compile error. Database.Plugin.create rejects id, nonPersistent and nonShared as component or resource names. A type test covers both.
• A Parameter is not assignable to Schema (Schema.schema?: never), so a named parameter can't be passed where its schema is expected.
• Conformance.implementation takes concurrency and seedContext. p2p presence (whose action reads the peer userId) now uses plain checkFeature instead of the lower-level runners. There is a new library test for this.
• New conventions check: no runtime file in a feature package imports spec/, ecs/conformance/, @adobe/data-testing or vitest. TS project references already enforce this for data/, services/ and ecs/; this extends it to ui/ and app/.
• Rule cleanup:
  • features/ui/binding-element.md is removed. Its unique contract (the presentation exports, callback naming, cleanup via hooks) moved into element.md.
  • service.md now matches the samples (flat create / createFake) and drops the nonexistent singletonFactory.
• Version bump to 0.10.24.

Back-compat for 0.10.20 consumers

The samples stay on the new spec-based layout; existing code on the 0.10.20 state-based layout keeps working unchanged.

• Bare-Schema parameters. signature.parameters accepts a named Parameter or (deprecated) a bare Schema. ToType and toTypeScript handle both; a bare entry renders as argN. New Parameter.schemaOf(p) reads either form. Code that reads parameters through the generic Schema type and needs a Schema should call it.
• Legacy conformance API. Conformance.feature and FeatureSpec are restored (@deprecated). checkSpec / checkFeature accept either shape and run the 0.10.20 runner for the old one: transactions plus actions, schemas from the plugin, and lenient doubles. The new path is unchanged and stays strict.
• Name clash warns instead of throwing. A resource sharing a component's name keeps the 0.10.20 behaviour (its schema replaces the component's) and logs a one-time console.warn per name. The hopper sample's rename (width → boardWidth / boardHeight) stays. A component redefining a resource's name with a different schema still throws, as in 0.10.20.
• Legacy rules. data-ai restores features/data/state.md and features/services/main-service/* for features that still have data/state/ or services/main-service/. The shared feature rules and the build/review skills each say in one line to follow the legacy rules for such a feature and not migrate it unless asked.

Not included: the struct-packing crash, where an object schema of optional Vec2 fields with a {} default crashes at Store.create. It needs a decision on how struct detection should treat optional fields.

Testing

• pnpm run build, pnpm run lint, pnpm run typecheck (with build caches cleared) and pnpm run check:workspace pass.
• pnpm run test passes in every package: data 3,581 tests, data-testing 56 (2 skipped), plus data-gpu, data-sync, data-persistence, data-lit, data-rpc and all seven feature samples.
• New coverage: Parameter.schemaOf and mixed/bare parameter type tests, bare-parameter toTypeScript output and IsValidWithCompleteSchema, the once-per-name clash warning, the restored legacy type test, a runtime legacy-conformance fixture (a transaction-only op and an unscheduled fake call), and the lenient-double mode.
• Validated against a large downstream app on 0.10.20 using packed tarballs of this branch. With only the version bump, plus a 4-line Parameter.schemaOf change in one file, typecheck is clean and its full test suite passes.

🤖 Generated with Claude Code