@adobe/data 0.9.68 → 0.9.69

package/dist/typed-buffer/structs/index.d.ts

@@ -1,2 +1,3 @@
 export { getStructLayout } from "./get-struct-layout.js";
 export * from "./struct-layout.js";
+export { wgslStructFields } from "./wgsl-struct-fields.js";

package/dist/typed-buffer/structs/index.js

@@ -1,4 +1,5 @@
 // © 2026 Adobe. MIT License. See /LICENSE for details.
 export { getStructLayout } from "./get-struct-layout.js";
 export * from "./struct-layout.js";
+export { wgslStructFields } from "./wgsl-struct-fields.js";
 //# sourceMappingURL=index.js.map

package/dist/typed-buffer/structs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/typed-buffer/structs/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/typed-buffer/structs/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/typed-buffer/structs/wgsl-struct-fields.d.ts

@@ -0,0 +1,17 @@
+import { type Schema } from "../../schema/index.js";
+/**
+ * Generates WGSL struct field declarations from a JSON Schema object type.
+ *
+ * Maps each property to the appropriate WGSL type (f32, vec3f, mat4x4f, etc.)
+ * using the same schema that drives host-side TypedBuffer layout — so the host
+ * struct and the WGSL struct are guaranteed to agree on field order and types.
+ *
+ * Usage:
+ * ```ts
+ * const source = `
+ * struct MyUniforms {
+ * ${wgslStructFields(MyUniforms.schema)}
+ * }`;
+ * ```
+ */
+export declare const wgslStructFields: (schema: Schema) => string;

package/dist/typed-buffer/structs/wgsl-struct-fields.js

@@ -0,0 +1,58 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+const primitiveWgslType = (schema) => {
+    if (schema.type === "number")
+        return "f32";
+    if (schema.type === "integer") {
+        return schema.minimum !== undefined && schema.minimum >= 0 ? "u32" : "i32";
+    }
+    return null;
+};
+const fieldWgslType = (schema) => {
+    const prim = primitiveWgslType(schema);
+    if (prim)
+        return prim;
+    if (schema.type === "array" &&
+        schema.items !== undefined &&
+        !Array.isArray(schema.items) &&
+        schema.minItems === schema.maxItems &&
+        schema.minItems !== undefined) {
+        const elemType = primitiveWgslType(schema.items);
+        if (!elemType)
+            return null;
+        const n = schema.minItems;
+        const suffix = elemType === "f32" ? "f" : elemType === "i32" ? "i" : "u";
+        if (n === 16 && suffix === "f")
+            return "mat4x4f";
+        if (n === 2 || n === 3 || n === 4)
+            return `vec${n}${suffix}`;
+    }
+    return null;
+};
+/**
+ * Generates WGSL struct field declarations from a JSON Schema object type.
+ *
+ * Maps each property to the appropriate WGSL type (f32, vec3f, mat4x4f, etc.)
+ * using the same schema that drives host-side TypedBuffer layout — so the host
+ * struct and the WGSL struct are guaranteed to agree on field order and types.
+ *
+ * Usage:
+ * ```ts
+ * const source = `
+ * struct MyUniforms {
+ * ${wgslStructFields(MyUniforms.schema)}
+ * }`;
+ * ```
+ */
+export const wgslStructFields = (schema) => {
+    if (schema.type !== "object" || !schema.properties)
+        return "";
+    return Object.entries(schema.properties)
+        .map(([name, fieldSchema]) => {
+        const type = fieldWgslType(fieldSchema);
+        if (!type)
+            throw new Error(`Cannot map schema field "${name}" to a WGSL type`);
+        return `    ${name}: ${type},`;
+    })
+        .join("\n");
+};
+//# sourceMappingURL=wgsl-struct-fields.js.map

package/dist/typed-buffer/structs/wgsl-struct-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgsl-struct-fields.js","sourceRoot":"","sources":["../../../src/typed-buffer/structs/wgsl-struct-fields.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAIvD,MAAM,iBAAiB,GAAG,CAAC,MAAc,EAAiB,EAAE;IACxD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/E,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,MAAc,EAAiB,EAAE;IACpD,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACtB,IACI,MAAM,CAAC,IAAI,KAAK,OAAO;QACvB,MAAM,CAAC,KAAK,KAAK,SAAS;QAC1B,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ;QACnC,MAAM,CAAC,QAAQ,KAAK,SAAS,EAC/B,CAAC;QACC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC1B,MAAM,MAAM,GAAG,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QACzE,IAAI,CAAC,KAAK,EAAE,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,SAAS,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC;IACjE,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAU,EAAE;IACvD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC9D,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;SACnC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,kBAAkB,CAAC,CAAC;QAC/E,OAAO,OAAO,IAAI,KAAK,IAAI,GAAG,CAAC;IACnC,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data",
-  "version": "0.9.68",
+  "version": "0.9.69",
   "description": "Adobe data oriented programming library",
   "type": "module",
   "sideEffects": false,

package/references/data-lit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-lit",
-  "version": "0.9.68",
+  "version": "0.9.69",
   "description": "Adobe data Lit bindings - hooks, elements, decorators",
   "type": "module",
   "private": false,

package/references/data-lit/src/elements/database-element.ts

@@ -9,8 +9,23 @@ import { attachDecorator, withHooks } from '../index.js';
 
 export abstract class DatabaseElement<P extends Database.Plugin> extends LitElement {
 
+  /**
+   * The live database, fully typed. Set by an ancestor via DI (`.database=…`)
+   * or created from `plugin` on connect. Bootstrap containers — those that own
+   * a controller or drive a streaming (async-generator) transaction — read
+   * this directly; pure widgets use the restricted `service` view below.
+   */
   @property({ type: Object, reflect: false })
-  service!: UIService.FromService<Database.Plugin.ToDatabase<P>>;
+  database!: Database.Plugin.ToDatabase<P>;
+
+  /**
+   * UI-restricted view of {@link database} for pure-widget rendering: every
+   * transaction / mutator is rewritten to fire-and-forget `void` so a widget
+   * can never await on or read back a mutation; reads go through `observe`.
+   */
+  get service(): UIService.FromService<Database.Plugin.ToDatabase<P>> {
+    return UIService.restrict(this.database);
+  }
 
   constructor() {
     super();
@@ -20,18 +35,18 @@ export abstract class DatabaseElement<P extends Database.Plugin> extends LitElem
   abstract get plugin(): P;
 
   connectedCallback(): void {
-    if (!this.service) {
-      const service = this.findAncestorDatabase();
-      this.service = (service?.extend(this.plugin) ?? Database.create(this.plugin)) as unknown as UIService.FromService<Database.Plugin.ToDatabase<P>>;
+    if (!this.database) {
+      const ancestor = this.findAncestorDatabase();
+      this.database = ancestor?.extend(this.plugin) ?? Database.create(this.plugin);
     }
     super.connectedCallback();
   }
 
   protected findAncestorDatabase(): Database | void {
     for (const element of iterateSelfAndAncestors(this)) {
-      const { service } = element as Partial<DatabaseElement<any>>;
-      if (Database.is(service)) {
-        return service;
+      const { database } = element as Partial<DatabaseElement<any>>;
+      if (Database.is(database)) {
+        return database;
       }
     }
   }

package/references/data-lit-tictactoe/package.json

@@ -1,6 +1,6 @@
 {
   "name": "data-lit-tictactoe",
-  "version": "0.9.68",
+  "version": "0.9.69",
   "description": "Tic-Tac-Toe sample - Lit web components with @adobe/data-lit and AgenticService",
   "type": "module",
   "private": true,

package/references/data-lit-tictactoe/src/elements/tictactoe-app/tictactoe-app.ts

@@ -14,5 +14,5 @@ type TictactoeService = Database.Plugin.ToDatabase<typeof tictactoePlugin>;
  */
 export const Tictactoe = <S extends TictactoeService>(args: { service: S }): TemplateResult => {
     void import("./tictactoe-app-element.js");
-    return html`<tictactoe-app .service=${args.service}></tictactoe-app>`;
+    return html`<tictactoe-app .database=${args.service}></tictactoe-app>`;
 };

package/references/data-react/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-react",
-  "version": "0.9.68",
+  "version": "0.9.69",
   "description": "Adobe data React bindings — hooks and context for ECS database",
   "type": "module",
   "private": false,

package/references/data-react-hello/package.json

@@ -1,6 +1,6 @@
 {
   "name": "data-react-hello",
-  "version": "0.9.68",
+  "version": "0.9.69",
   "description": "Hello World sample - click counter using @adobe/data-react",
   "type": "module",
   "private": true,
@@ -18,8 +18,9 @@
   "devDependencies": {
     "@types/react": "^19",
     "@types/react-dom": "^19",
+    "@vitejs/plugin-react": "^4.3.0",
     "typescript": "^5.8.3",
     "vite": "^5.1.1",
-    "@vitejs/plugin-react": "^4.3.0"
+    "vite-plugin-checker": "^0.12.0"
   }
 }

package/references/data-react-pixie/package.json

@@ -1,6 +1,6 @@
 {
   "name": "data-react-pixie",
-  "version": "0.9.68",
+  "version": "0.9.69",
   "description": "PixiJS React sample - ECS sprites (bunny, fox) with @adobe/data-react",
   "type": "module",
   "private": true,

package/dist/service/async-data-service/index.d.ts

@@ -1 +0,0 @@
-export * as AsyncDataService from "./public.js";

package/dist/service/async-data-service/index.js

@@ -1,3 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-export * as AsyncDataService from "./public.js";
-//# sourceMappingURL=index.js.map

package/dist/service/async-data-service/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/service/async-data-service/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,KAAK,gBAAgB,MAAM,aAAa,CAAC"}