@adobe/data 0.9.39 → 0.9.41

package/references/data-lit-tictactoe/src/types/board-state/derive-status.ts

@@ -0,0 +1,12 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { BoardState } from "./board-state";
+import type { GameStatus } from "../game-status";
+import { getWinningLine } from "./get-winning-line";
+import { isBoardFull } from "./is-board-full";
+
+export const deriveStatus = (board: BoardState): GameStatus => {
+  if (getWinningLine(board)) return "won";
+  if (isBoardFull(board)) return "draw";
+  return (board.match(/[XO]/g) ?? []).length > 0 ? "in_progress" : "idle";
+};

package/references/data-lit-tictactoe/src/types/board-state/get-cell.ts

@@ -0,0 +1,7 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { BoardState } from "./board-state";
+import type { BoardCell } from "../board-cell";
+
+export const getCell = (board: BoardState, index: number): BoardCell =>
+  (board[index] as BoardCell) ?? " ";

package/references/data-lit-tictactoe/src/types/board-state/get-move-count.ts

@@ -0,0 +1,6 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { BoardState } from "./board-state";
+
+export const getMoveCount = (board: BoardState): number =>
+  (board.match(/[XO]/g) ?? []).length;

package/references/data-lit-tictactoe/src/types/board-state/get-winner.ts

@@ -0,0 +1,14 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { BoardState } from "./board-state";
+import type { PlayerMark } from "../player-mark/player-mark";
+import { getWinningLine } from "./get-winning-line";
+import { isBoardFull } from "./is-board-full";
+
+export const getWinner = (
+  board: BoardState,
+): PlayerMark | "cat" | null => {
+  const line = getWinningLine(board);
+  if (line) return board[line[0]] as PlayerMark;
+  return isBoardFull(board) ? "cat" : null;
+};

package/references/data-lit-tictactoe/src/types/board-state/get-winning-line.ts

@@ -0,0 +1,25 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { BoardState } from "./board-state";
+import type { WinningLine } from "../winning-line";
+
+const LINES: readonly WinningLine[] = [
+  [0, 1, 2],
+  [3, 4, 5],
+  [6, 7, 8],
+  [0, 3, 6],
+  [1, 4, 7],
+  [2, 5, 8],
+  [0, 4, 8],
+  [2, 4, 6],
+];
+
+export const getWinningLine = (board: BoardState): WinningLine | null => {
+  for (const [a, b, c] of LINES) {
+    const mark = board[a];
+    if (mark !== " " && mark === board[b] && mark === board[c]) {
+      return [a, b, c];
+    }
+  }
+  return null;
+};

package/references/data-lit-tictactoe/src/types/board-state/is-board-full.ts

@@ -0,0 +1,5 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { BoardState } from "./board-state";
+
+export const isBoardFull = (board: BoardState): boolean => !board.includes(" ");

package/references/data-lit-tictactoe/src/types/board-state/is-cell-playable.ts

@@ -0,0 +1,13 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { BoardState } from "./board-state";
+import { deriveStatus } from "./derive-status";
+import { getCell } from "./get-cell";
+
+export const isCellPlayable = (board: BoardState, index: number): boolean => {
+  const status = deriveStatus(board);
+  const cell = getCell(board, index);
+  return (
+    (status === "in_progress" || status === "idle") && cell === " "
+  );
+};

package/references/data-lit-tictactoe/src/types/board-state/is-cell-winning.ts

@@ -0,0 +1,9 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { BoardState } from "./board-state";
+import { getWinningLine } from "./get-winning-line";
+
+export const isCellWinning = (board: BoardState, index: number): boolean => {
+  const line = getWinningLine(board);
+  return line !== null && line.includes(index);
+};

package/references/data-lit-tictactoe/src/types/board-state/is-game-over.ts

@@ -0,0 +1,8 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { BoardState } from "./board-state";
+import { getWinningLine } from "./get-winning-line";
+import { isBoardFull } from "./is-board-full";
+
+export const isGameOver = (board: BoardState): boolean =>
+  getWinningLine(board) !== null || isBoardFull(board);

package/references/data-lit-tictactoe/src/types/board-state/public.ts

@@ -0,0 +1,15 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+export { schema } from "./schema";
+export { createInitialBoard } from "./create-initial-board";
+export { currentPlayer } from "./current-player";
+export { deriveStatus } from "./derive-status";
+export { getCell } from "./get-cell";
+export { getWinningLine } from "./get-winning-line";
+export { isCellPlayable } from "./is-cell-playable";
+export { isCellWinning } from "./is-cell-winning";
+export { getWinner } from "./get-winner";
+export { getMoveCount } from "./get-move-count";
+export { isBoardFull } from "./is-board-full";
+export { isGameOver } from "./is-game-over";
+export { setBoardCell } from "./set-board-cell";

package/references/data-lit-tictactoe/src/types/board-state/schema.ts

@@ -0,0 +1,10 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import { Schema } from "@adobe/data/schema";
+
+export const schema = {
+  type: "string",
+  description: "Tic-Tac-Toe board top left to bottom right",
+  minLength: 9,
+  maxLength: 9,
+} as const satisfies Schema;

package/references/data-lit-tictactoe/src/types/board-state/set-board-cell.ts

@@ -0,0 +1,13 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { BoardState } from "./board-state";
+import type { PlayerMark } from "../player-mark/player-mark";
+
+export const setBoardCell = (args: {
+  board: BoardState;
+  index: number;
+  mark: PlayerMark;
+}): BoardState => {
+  const { board, index, mark } = args;
+  return board.slice(0, index) + mark + board.slice(index + 1);
+};

package/references/data-lit-tictactoe/src/types/game-status.ts

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+export type GameStatus = "idle" | "in_progress" | "won" | "draw";

package/references/data-lit-tictactoe/src/types/move-reject-reason.ts

@@ -0,0 +1,7 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+export type MoveRejectReason =
+  | "index_out_of_bounds"
+  | "game_not_active"
+  | "cell_occupied"
+  | "game_over";

package/references/data-lit-tictactoe/src/types/play-move-args/can-play-move.ts

@@ -0,0 +1,33 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import { BoardState } from "../board-state/board-state";
+import type { MoveRejectReason } from "../move-reject-reason";
+
+export type CanPlayMoveArgs = {
+  readonly board: BoardState;
+  readonly index: number;
+};
+
+export type CanPlayMoveResult =
+  | { readonly ok: true }
+  | { readonly ok: false; readonly reason: MoveRejectReason };
+
+export const canPlayMove = ({
+  board,
+  index,
+}: CanPlayMoveArgs): CanPlayMoveResult => {
+  if (!Number.isInteger(index) || index < 0 || index > 8) {
+    return { ok: false, reason: "index_out_of_bounds" };
+  }
+
+  const status = BoardState.deriveStatus(board);
+  if (status === "won" || status === "draw") {
+    return { ok: false, reason: "game_over" };
+  }
+
+  if (board[index] !== " ") {
+    return { ok: false, reason: "cell_occupied" };
+  }
+
+  return { ok: true };
+};

package/references/data-lit-tictactoe/src/types/play-move-args/play-move-args.ts

@@ -0,0 +1,4 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+export type PlayMoveArgs = { readonly index: number };
+export * as PlayMoveArgs from "./public";

package/references/{data-lit-todo/src/elements/todo-undo-redo/index.ts → data-lit-tictactoe/src/types/play-move-args/public.ts}

@@ -1,3 +1,3 @@
 // © 2026 Adobe. MIT License. See /LICENSE for details.
 
-export * from './todo-undo-redo.js';
+export { canPlayMove } from "./can-play-move";

package/references/data-lit-tictactoe/src/types/player-mark/player-mark.ts

@@ -0,0 +1,7 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import { Schema } from "@adobe/data/schema";
+import { schema } from "./schema";
+
+export type PlayerMark = Schema.ToType<typeof schema>;
+export * as PlayerMark from "./public";

package/references/{data-lit-todo/src/elements/todo-row/index.ts → data-lit-tictactoe/src/types/player-mark/public.ts}

@@ -1,2 +1,3 @@
 // © 2026 Adobe. MIT License. See /LICENSE for details.
-export * from './todo-row.js';
+
+export { schema } from "./schema";

package/references/data-lit-tictactoe/src/types/player-mark/schema.ts

@@ -0,0 +1,9 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import { Schema } from "@adobe/data/schema";
+
+export const schema = {
+  type: "string",
+  enum: ["X", "O"],
+  description: "Player mark",
+} as const satisfies Schema;

package/references/data-lit-tictactoe/src/types/winning-line.ts

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+export type WinningLine = readonly [number, number, number];

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

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": false,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "experimentalDecorators": true,
+    "strict": true
+  },
+  "include": ["src"]
+}

package/references/data-react/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-react",
-  "version": "0.9.39",
+  "version": "0.9.41",
   "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.39",
+  "version": "0.9.41",
   "description": "Hello World sample - click counter using @adobe/data-react",
   "type": "module",
   "private": true,

package/references/data-react-hello/src/{App.tsx → app.tsx}

@@ -1,8 +1,8 @@
 // © 2026 Adobe. MIT License. See /LICENSE for details.
 
 import { DatabaseProvider } from "@adobe/data-react";
-import { counterPlugin } from "./counter-plugin";
-import { Counter } from "./Counter";
+import { counterPlugin } from "./state/counter-plugin";
+import { Counter } from "./components/counter/counter";
 
 export function App() {
   return (

package/references/data-react-hello/src/components/counter/counter-presentation.tsx

@@ -0,0 +1,13 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+export function render(args: { count: number; increment: () => void }) {
+  const { count, increment } = args;
+  return (
+    <div>
+      <p className="counter">Count: {count}</p>
+      <button type="button" onClick={increment}>
+        Increment
+      </button>
+    </div>
+  );
+}

package/references/data-react-hello/src/components/counter/counter.tsx

@@ -0,0 +1,26 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import { useObservableValues } from "@adobe/data-react";
+import { useCounterDatabase } from "../../state/use-counter-database";
+import * as presentation from "./counter-presentation";
+
+export function Counter() {
+  // get your database context (The only context you will ever need)
+  const db = useCounterDatabase();
+  // observe the values you need
+  // when they change we will re-render
+  const values = useObservableValues(() => ({
+    count: db.observe.resources.count,
+  }));
+
+  // if the values are not ready yet, we will render nothing
+  if (!values) return null;
+  // once we have our minimum required values then render,
+  // injecting the current values and any action callbacks.
+  // note we use verbNoun action semantics NEVER onClick event style semantics.
+  return presentation.render({
+    ...values,
+    // increment and all our functions are pure so we never need to bind `this`
+    increment: db.transactions.increment,
+  });
+}

package/references/data-react-hello/src/main.tsx

@@ -1,7 +1,7 @@
 // © 2026 Adobe. MIT License. See /LICENSE for details.
 
 import { createRoot } from "react-dom/client";
-import { App } from "./App";
+import { App } from "./app";
 
 const root = document.getElementById("root");
 if (root) {

package/references/data-react-hello/src/state/use-counter-database.ts

@@ -0,0 +1,6 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import { useDatabase } from "@adobe/data-react";
+import { counterPlugin } from "./counter-plugin";
+
+export const useCounterDatabase = () => useDatabase(counterPlugin);

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

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

package/references/data-react-pixie/src/{App.tsx → app.tsx}

@@ -2,18 +2,18 @@
 
 import { Application } from "@pixi/react";
 import { DatabaseProvider } from "@adobe/data-react";
-import { pixiePlugin } from "./pixie-plugin.js";
-import { FilterToggle } from "./filter-toggle.js";
-import { SpriteContainer } from "./sprite-container.js";
-import { Tick } from "./tick.js";
+import { pixiePlugin } from "./state/pixie-plugin";
+import { FilterSelector } from "./components/filter-selector/filter-selector";
+import { PixieTick } from "./components/pixie-scene/pixie-tick";
+import { PixieScene } from "./components/pixie-scene/pixie-scene";
 
 export function App() {
   return (
     <DatabaseProvider plugin={pixiePlugin}>
-      <FilterToggle />
+      <FilterSelector />
       <Application background="beige" width={640} height={480}>
-        <Tick />
-        <SpriteContainer />
+        <PixieTick />
+        <PixieScene />
       </Application>
     </DatabaseProvider>
   );

package/references/data-react-pixie/src/{filter-toggle.tsx → components/filter-selector/filter-selector-presentation.tsx}

@@ -1,6 +1,6 @@
-import { useObservableValues } from "@adobe/data-react";
-import { useDatabase } from "./hooks/use-database";
-import type { FilterType } from "./pixie-plugin.js";
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { FilterType } from "../../types/filter-type";
 
 const FILTER_LABELS: Record<FilterType, string> = {
   none: "None",
@@ -15,24 +15,18 @@ const FILTER_OPTIONS = (Object.entries(FILTER_LABELS) as [FilterType, string][])
   label,
 }));
 
-export function FilterToggle() {
-  const db = useDatabase();
-  const values = useObservableValues(
-    () => ({
-      filterType: db.observe.resources.filterType,
-    }),
-    [],
-  );
-
-  const currentFilter = values?.filterType ?? "none";
-
+export function render(args: {
+  currentFilter: FilterType;
+  setFilterType: (filterType: FilterType) => void;
+}) {
+  const { currentFilter, setFilterType } = args;
   return (
     <div style={{ display: "flex", gap: "0.5rem", marginBottom: "0.5rem" }}>
       {FILTER_OPTIONS.map(({ value, label }) => (
         <button
           key={value}
           type="button"
-          onClick={() => db.transactions.setFilterType({ filterType: value })}
+          onClick={() => setFilterType(value)}
           style={{
             padding: "0.25rem 0.5rem",
             fontWeight: currentFilter === value ? "bold" : "normal",

package/references/data-react-pixie/src/components/filter-selector/filter-selector.tsx

@@ -0,0 +1,22 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import { useObservableValues } from "@adobe/data-react";
+import { usePixieDatabase } from "../../state/use-pixie-database";
+import * as presentation from "./filter-selector-presentation";
+
+export function FilterSelector() {
+  const db = usePixieDatabase();
+  const values = useObservableValues(
+    () => ({
+      filterType: db.observe.resources.filterType,
+    }),
+    [],
+  );
+
+  const currentFilter = values?.filterType ?? "none";
+
+  return presentation.render({
+    currentFilter,
+    setFilterType: (filterType) => db.transactions.setFilterType({ filterType }),
+  });
+}

package/references/data-react-pixie/src/{filters.ts → components/pixie-scene/pixie-filters.ts}

@@ -1,5 +1,7 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
 import { BlurFilter, ColorMatrixFilter } from "pixi.js";
-import type { FilterType } from "./pixie-plugin.js";
+import type { FilterType } from "../../types/filter-type";
 
 const blurFilter = new BlurFilter({ strength: 2, quality: 2 });
 const sepiaFilter = new ColorMatrixFilter();

package/references/data-react-pixie/src/components/pixie-scene/pixie-scene-presentation.tsx

@@ -0,0 +1,18 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { Filter } from "pixi.js";
+import { Sprite } from "../sprite/sprite";
+
+export function render(args: {
+  filters: Filter[];
+  sprites: readonly number[];
+}) {
+  const { filters, sprites } = args;
+  return (
+    <pixiContainer filters={filters}>
+      {sprites.map((entity) => (
+        <Sprite key={entity} entity={entity} />
+      ))}
+    </pixiContainer>
+  );
+}

package/references/data-react-pixie/src/components/pixie-scene/pixie-scene.tsx

@@ -0,0 +1,26 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import { useObservableValues } from "@adobe/data-react";
+import { usePixieDatabase } from "../../state/use-pixie-database";
+import { getFiltersForType } from "./pixie-filters";
+import * as presentation from "./pixie-scene-presentation";
+
+export function PixieScene() {
+  const db = usePixieDatabase();
+  const values = useObservableValues(
+    () => ({
+      sprites: db.observe.select(db.archetypes.Sprite.components),
+      filterType: db.observe.resources.filterType,
+    }),
+    [],
+  );
+
+  if (!values) return null;
+
+  const filters = getFiltersForType(values.filterType ?? "none");
+
+  return presentation.render({
+    filters,
+    sprites: values.sprites,
+  });
+}

package/references/data-react-pixie/src/components/pixie-scene/pixie-tick.tsx

@@ -0,0 +1,12 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import { useTick } from "@pixi/react";
+import { usePixieDatabase } from "../../state/use-pixie-database";
+
+export function PixieTick() {
+  const db = usePixieDatabase();
+  useTick((ticker) => {
+    db.transactions.tick(ticker.deltaTime);
+  });
+  return null;
+}

package/references/data-react-pixie/src/components/sprite/sprite-presentation.tsx

@@ -0,0 +1,39 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { Texture } from "pixi.js";
+
+export function render(args: {
+  texture: Texture;
+  x: number;
+  y: number;
+  rotation: number;
+  scale: number;
+  toggleSpriteActive: () => void;
+  setSpriteHoveredTrue: () => void;
+  setSpriteHoveredFalse: () => void;
+}) {
+  const {
+    texture,
+    x,
+    y,
+    rotation,
+    scale,
+    toggleSpriteActive,
+    setSpriteHoveredTrue,
+    setSpriteHoveredFalse,
+  } = args;
+  return (
+    <pixiSprite
+      anchor={0.5}
+      eventMode="static"
+      onClick={toggleSpriteActive}
+      onPointerOver={setSpriteHoveredTrue}
+      onPointerOut={setSpriteHoveredFalse}
+      scale={scale}
+      texture={texture}
+      x={x}
+      y={y}
+      rotation={rotation}
+    />
+  );
+}

package/references/data-react-pixie/src/components/sprite/sprite.tsx

@@ -0,0 +1,37 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { Entity } from "@adobe/data/ecs";
+import { useObservableValues } from "@adobe/data-react";
+import { usePixieDatabase } from "../../state/use-pixie-database";
+import { SpriteType } from "../../types/sprite-type/sprite-type";
+import { useSpriteTexture } from "./use-sprite-texture";
+import * as presentation from "./sprite-presentation";
+
+export function Sprite({ entity }: { entity: Entity }) {
+  const db = usePixieDatabase();
+  const values = useObservableValues(
+    () => ({
+      sprite: db.observe.entity(entity, db.archetypes.Sprite),
+    }),
+    [entity],
+  );
+
+  const spriteType = values?.sprite?.sprite ?? "bunny";
+  const texture = useSpriteTexture(SpriteType.image[spriteType]);
+
+  if (!values?.sprite || !texture) return null;
+
+  const { sprite } = values;
+  const scale = sprite.active ? 1.5 : sprite.hovered ? 1.25 : 1;
+
+  return presentation.render({
+    texture,
+    x: sprite.position[0],
+    y: sprite.position[1],
+    rotation: sprite.rotation,
+    scale,
+    toggleSpriteActive: () => db.transactions.toggleSpriteActive({ entity }),
+    setSpriteHoveredTrue: () => db.transactions.setSpriteHovered({ entity, hovered: true }),
+    setSpriteHoveredFalse: () => db.transactions.setSpriteHovered({ entity, hovered: false }),
+  });
+}

package/references/data-react-pixie/src/{hooks/use-texture.ts → components/sprite/use-sprite-texture.ts}

@@ -1,7 +1,9 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
 import { Assets, type Texture } from "pixi.js";
 import { useEffect, useState } from "react";
 
-export function useTexture(url: string): Texture | undefined {
+export function useSpriteTexture(url: string): Texture | undefined {
   const [texture, setTexture] = useState<Texture | undefined>();
 
   useEffect(() => {

package/references/data-react-pixie/src/main.tsx

@@ -3,7 +3,7 @@
 import { createRoot } from "react-dom/client";
 import { Container, Graphics, Sprite } from "pixi.js";
 import { extend } from "@pixi/react";
-import { App } from "./App.jsx";
+import { App } from "./app";
 
 // Register PixiJS components for @pixi/react (pixiSprite, pixiContainer)
 extend({ Container, Graphics, Sprite });