@adobe/data 0.9.37 → 0.9.40

package/references/data-lit-tictactoe/src/elements/tictactoe-hud/tictactoe-hud.css.ts

@@ -0,0 +1,18 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import { css } from "lit";
+
+export const styles = css`
+  .hud {
+    padding: 0.5rem 1rem;
+    font-family: system-ui, sans-serif;
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+  }
+
+  .hud button {
+    padding: 0.25rem 0.75rem;
+    cursor: pointer;
+  }
+`;

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

@@ -0,0 +1,44 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import { customElement } from "lit/decorators.js";
+import { useObservableValues } from "@adobe/data-lit";
+import { BoardState } from "../../types/board-state/board-state.js";
+import { TictactoeElement } from "../../tictactoe-element.js";
+import { styles } from "./tictactoe-hud.css.js";
+import * as presentation from "./tictactoe-hud-presentation.js";
+
+export const tagName = "tictactoe-hud";
+
+@customElement(tagName)
+export class TictactoeHud extends TictactoeElement {
+  static styles = styles;
+
+  render() {
+    const values = useObservableValues(
+      () => ({
+        board: this.service.observe.resources.board,
+        firstPlayer: this.service.observe.resources.firstPlayer,
+      }),
+      [],
+    );
+
+    const board = values?.board ?? "         ";
+    const firstPlayer = values?.firstPlayer ?? "X";
+
+    const currentPlayer = BoardState.currentPlayer(board, firstPlayer);
+    const status = BoardState.deriveStatus(board);
+    const winner = BoardState.getWinner(board);
+
+    const statusText =
+      status === "won" && winner !== null
+        ? `Winner: ${winner}`
+        : status === "draw"
+          ? "Draw"
+          : `Current Player: ${currentPlayer}`;
+
+    return presentation.render({
+      statusText,
+      restartGame: () => this.service.transactions.restartGame(),
+    });
+  }
+}

package/references/data-lit-tictactoe/src/main.ts

@@ -0,0 +1,9 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import "./elements/tictactoe-app/tictactoe-app.js";
+
+const app = document.getElementById("app");
+if (app) {
+  const el = document.createElement("tictactoe-app");
+  app.appendChild(el);
+}

package/references/data-lit-tictactoe/src/state/agent-plugin.ts

@@ -0,0 +1,117 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import { Database } from "@adobe/data/ecs";
+import { Observe } from "@adobe/data/observe";
+import { AgenticService } from "@adobe/data/service";
+import { BoardState } from "../types/board-state/board-state";
+import type { PlayerMark } from "../types/player-mark/player-mark";
+import { tictactoePlugin } from "./tictactoe-plugin";
+import type { TictactoeDatabase } from "./tictactoe-plugin";
+
+const roleDescription = (mark: PlayerMark): string =>
+  `You are playing as ${mark} in tic-tac-toe. Play to the best of your ability.`;
+
+const createTictactoeAgentService = (
+  db: TictactoeDatabase,
+  agentMark: PlayerMark,
+): AgenticService => {
+  const board = db.observe.resources.board;
+  const isGameOver = Observe.withFilter(board, BoardState.isGameOver);
+  const currentPlayer = Observe.withFilter(
+    board,
+    (nextBoard) =>
+      BoardState.currentPlayer(nextBoard, db.resources.firstPlayer),
+  );
+  const yourTurn = Observe.withMap(
+    Observe.fromProperties({ isGameOver, currentPlayer }),
+    ({ isGameOver: over, currentPlayer: cur }) => !over && cur === agentMark,
+  );
+
+  return AgenticService.create({
+    interface: {
+      role: {
+        type: "state",
+        schema: { type: "string" as const },
+        description: "Your role and objective",
+      },
+      board: {
+        type: "state",
+        schema: BoardState.schema,
+        description: "Board state",
+      },
+      yourTurn: {
+        type: "state",
+        schema: { type: "boolean" as const },
+        description: "True when it is your turn to play",
+      },
+      resetGame: {
+        type: "action",
+        description: "Reset the game after completion",
+        parameters: [],
+      },
+      winner: {
+        type: "state",
+        schema: {
+          type: "string" as const,
+          enum: ["X", "O", "cat", null],
+        },
+        description: "Winner mark when game over",
+      },
+      playMove: {
+        type: "action",
+        description: `Play a ${agentMark} move on the board`,
+        parameters: [
+          {
+            title: "index",
+            type: "integer" as const,
+            minimum: 0,
+            maximum: 8,
+          },
+        ],
+      },
+    },
+    implementation: {
+      role: Observe.fromConstant(roleDescription(agentMark)),
+      board,
+      yourTurn,
+      winner: Observe.withFilter(board, BoardState.getWinner),
+      resetGame: async () => {
+        db.transactions.restartGame();
+      },
+      playMove: async (index: number) => {
+        db.transactions.playMove({ index });
+      },
+    },
+    conditional: {
+      resetGame: isGameOver,
+      playMove: yourTurn,
+    },
+  });
+};
+
+const tictactoeLinkDescriptions = { x: "Play as X", o: "Play as O" } as const;
+
+const createTictactoeRootAgentService = (
+  db: TictactoeDatabase,
+): AgenticService => {
+  const root = AgenticService.create({
+    interface: {
+      x: { type: "link", description: tictactoeLinkDescriptions.x },
+      o: { type: "link", description: tictactoeLinkDescriptions.o },
+    },
+    implementation: {
+      x: createTictactoeAgentService(db, "X"),
+      o: createTictactoeAgentService(db, "O"),
+    },
+  });
+  return { ...root, linkDescriptions: tictactoeLinkDescriptions } as AgenticService;
+};
+
+export const agentPlugin = Database.Plugin.create({
+  extends: tictactoePlugin,
+  services: {
+    agent: (db): AgenticService => createTictactoeRootAgentService(db),
+    agentX: (db): AgenticService => createTictactoeAgentService(db, "X"),
+    agentO: (db): AgenticService => createTictactoeAgentService(db, "O"),
+  },
+});

package/references/data-lit-tictactoe/src/state/tictactoe-plugin.ts

@@ -0,0 +1,56 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import { Database } from "@adobe/data/ecs";
+import { Observe } from "@adobe/data/observe";
+import { BoardState } from "../types/board-state/board-state";
+import type { PlayerMark } from "../types/player-mark/player-mark";
+import { PlayMoveArgs } from "../types/play-move-args/play-move-args";
+
+export const tictactoePlugin = Database.Plugin.create({
+  resources: {
+    board: { default: BoardState.createInitialBoard() },
+    firstPlayer: { default: "X" as PlayerMark },
+  },
+  computed: {
+    currentPlayer: (db) =>
+      Observe.withFilter(db.observe.resources.board, (board) =>
+        BoardState.currentPlayer(board, db.resources.firstPlayer),
+      ),
+    moveCount: (db) =>
+      Observe.withFilter(db.observe.resources.board, BoardState.getMoveCount),
+    status: (db) =>
+      Observe.withFilter(db.observe.resources.board, BoardState.deriveStatus),
+    winningLine: (db) =>
+      Observe.withFilter(db.observe.resources.board, BoardState.getWinningLine),
+    winner: (db) =>
+      Observe.withFilter(db.observe.resources.board, BoardState.getWinner),
+    isGameOver: (db) =>
+      Observe.withFilter(db.observe.resources.board, BoardState.isGameOver),
+  },
+  transactions: {
+    restartGame: (t) => {
+      t.resources.firstPlayer =
+        t.resources.firstPlayer === "X" ? "O" : "X";
+      t.resources.board = BoardState.createInitialBoard();
+    },
+    playMove: (t, { index }: PlayMoveArgs) => {
+      const validation = PlayMoveArgs.canPlayMove({
+        board: t.resources.board,
+        index,
+      });
+      if (!validation.ok) return;
+      const mark = BoardState.currentPlayer(
+        t.resources.board,
+        t.resources.firstPlayer,
+      );
+      const nextBoard = BoardState.setBoardCell({
+        board: t.resources.board,
+        index,
+        mark,
+      });
+      t.resources.board = nextBoard;
+    },
+  },
+});
+
+export type TictactoeDatabase = Database.FromPlugin<typeof tictactoePlugin>;

package/references/data-lit-tictactoe/src/tictactoe-element.ts

@@ -0,0 +1,10 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import { DatabaseElement } from "@adobe/data-lit";
+import { agentPlugin } from "./state/agent-plugin.js";
+
+export class TictactoeElement extends DatabaseElement<typeof agentPlugin> {
+  get plugin() {
+    return agentPlugin;
+  }
+}

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

@@ -0,0 +1,5 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { PlayerMark } from "./player-mark/player-mark";
+
+export type BoardCell = PlayerMark | " ";

package/references/data-lit-tictactoe/src/types/board-state/board-state.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 BoardState = Schema.ToType<typeof schema>;
+export * as BoardState from "./public";

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

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

package/references/data-lit-tictactoe/src/types/board-state/current-player.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 currentPlayer = (
+  board: BoardState,
+  firstPlayer: PlayerMark,
+): PlayerMark => {
+  const xCount = (board.match(/X/g) ?? []).length;
+  const oCount = (board.match(/O/g) ?? []).length;
+  return xCount === oCount ? firstPlayer : firstPlayer === "X" ? "O" : "X";
+};

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-tictactoe/src/types/play-move-args/public.ts

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+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-tictactoe/src/types/player-mark/public.ts

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+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-lit-todo/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "data-lit-todo",
+  "version": "0.9.38",
+  "description": "Todo sample app demonstrating @adobe/data with Lit",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite",
+    "publish-public": "true"
+  },
+  "dependencies": {
+    "@adobe/data": "workspace:*",
+    "@adobe/data-lit": "workspace:*",
+    "@spectrum-web-components/action-button": "^1.7.0",
+    "@spectrum-web-components/action-group": "^1.7.0",
+    "@spectrum-web-components/button": "^1.7.0",
+    "@spectrum-web-components/card": "^1.7.0",
+    "@spectrum-web-components/checkbox": "^1.7.0",
+    "@spectrum-web-components/icons-workflow": "^1.7.0",
+    "@spectrum-web-components/styles": "^1.7.0",
+    "@spectrum-web-components/theme": "^1.7.0",
+    "lit": "^3.3.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "vite": "^6.4.0",
+    "vitest": "^1.6.0"
+  }
+}

package/references/data-lit-todo/src/elements/todo-list/todo-list-presentation.ts

@@ -0,0 +1,22 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import type { Entity } from "@adobe/data/ecs";
+import { html } from 'lit';
+import { repeat } from 'lit/directives/repeat.js';
+import '@spectrum-web-components/action-button/sp-action-button.js';
+import '../todo-row/todo-row.js';
+
+type RenderArgs = {
+  todos: readonly Entity[];
+};
+
+export function render(args: RenderArgs) {
+  return html`
+    <div class="todo-list">
+      ${repeat(
+    args.todos,
+    todo => todo,
+    (todo, index) => html` <data-todo-row .entity=${todo} .index=${index}></data-todo-row> `
+  )}
+    </div>
+  `;
+}

package/references/data-lit-todo/src/elements/todo-list/todo-list.css.ts

@@ -0,0 +1,12 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import { css } from 'lit';
+
+export const styles = css`
+    .todo-list {
+        display: flex;
+        flex-direction: column;
+        position: relative;
+        user-select: none;
+    }
+`;