@adobe/data 0.9.40 → 0.9.42

package/references/data-lit-todo/src/services/dependent-state-service/create-dependent-state-service.ts

@@ -1,8 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { applyArg } from "@adobe/data/functions";
-
-import * as dependentState from './dependent-state/index.js';
-
-import { TodoCoreService } from '../main-service/todo-main-service.js';
-
-export const createDependentStateService = (service: TodoCoreService) => applyArg(service, dependentState);

package/references/data-lit-todo/src/services/dependent-state-service/dependent-state/all-todos.ts

@@ -1,5 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { TodoCoreService } from '../../main-service/todo-main-service.js';
-
-export const allTodos = (service: TodoCoreService) =>
-  service.state.observe.select(service.state.archetypes.Todo.components, { order: { order: true } });

package/references/data-lit-todo/src/services/dependent-state-service/dependent-state/complete-todos.ts

@@ -1,5 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { TodoCoreService } from '../../main-service/todo-main-service.js';
-
-export const completeTodos = (service: TodoCoreService) =>
-  service.state.observe.select(service.state.archetypes.Todo.components, { where: { complete: true } });

package/references/data-lit-todo/src/services/dependent-state-service/dependent-state/incomplete-todos.ts

@@ -1,5 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { TodoCoreService } from '../../main-service/todo-main-service.js';
-
-export const incompleteTodos = (service: TodoCoreService) =>
-  service.state.observe.select(service.state.archetypes.Todo.components, { where: { complete: false } });

package/references/data-lit-todo/src/services/dependent-state-service/dependent-state/index.ts

@@ -1,4 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-export * from './all-todos.js';
-export * from './complete-todos.js';
-export * from './incomplete-todos.js';

package/references/data-lit-todo/src/services/dependent-state-service/dependent-state-service.ts

@@ -1,4 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { createDependentStateService } from './create-dependent-state-service.js';
-
-export type DependentStateService = ReturnType<typeof createDependentStateService>;

package/references/data-lit-todo/src/services/main-service/create-main-service.ts

@@ -1,53 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { TodoCoreService, TodoMainService } from './todo-main-service.js';
-import { createStoragePersistenceService, createUndoRedoService } from "@adobe/data/ecs";
-import { createDependentStateService } from '../dependent-state-service/create-dependent-state-service.js';
-import { createTodoDatabase } from '../state-service/create-todo-database.js';
-import { todoStoreSchemaVersion } from '../state-service/create-todo-store.js';
-import { TodoStateService } from '../state-service/todo-state-service.js';
-
-/**
- * Initializes any core services and returns a new todo main service.
- */
-export async function createMainService(services: {
-  state?: TodoStateService;
-} = {}): Promise<TodoMainService> {
-  {
-    const {
-      state = createTodoDatabase(),
-      ...rest
-    } = services;
-
-    state.transactions.createTodo({ name: 'Buy groceries' });
-    state.transactions.createTodo({ name: 'Pickup dry cleaning' });
-    state.transactions.createTodo({ name: 'Buy flowers', complete: true });
-
-    const persistence = await createStoragePersistenceService({
-      database: state,
-      storage: sessionStorage,
-      defaultFileId: `todo-database-v${todoStoreSchemaVersion}`,
-      autoSaveOnChange: true,
-      autoLoadOnStart: true,
-    });
-
-    // Create the undo-redo actions
-    const undoRedo = createUndoRedoService(state);
-
-    // The core service is what we call the service without the dependent state service
-    const coreService = {
-      serviceName: 'todo-core-service' as const,
-      ...rest,
-      state,
-      undoRedo,
-      persistence,
-    } satisfies TodoCoreService;
-
-    // We create the dependent state from the core service.
-    const dependentState = createDependentStateService(coreService);
-
-    return {
-      ...coreService,
-      dependentState,
-    } satisfies TodoMainService;
-  }
-}

package/references/data-lit-todo/src/services/main-service/todo-main-service.ts

@@ -1,20 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { PersistenceService, UndoRedoService } from "@adobe/data/ecs";
-import { Service } from "@adobe/data/service";
-import { DependentStateService } from '../dependent-state-service/dependent-state-service.js';
-import { TodoStateService } from '../state-service/todo-state-service.js';
-
-export interface TodoMainService extends Service {
-  readonly serviceName: string;
-  state: TodoStateService;
-  dependentState: DependentStateService;
-  undoRedo: UndoRedoService;
-  persistence: PersistenceService;
-}
-
-export type TodoCoreService = Omit<TodoMainService, 'dependentState'>;
-
-/**
- * The main service as used by the UI. We only allow access to the observe and actions properties.
- */
-export type TodoUIMainService = Omit<TodoMainService, 'state'> & { state: Omit<TodoStateService, 'resources'> };

package/references/data-lit-todo/src/services/state-service/create-todo-database.ts

@@ -1,16 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { todoStoreSchema } from './create-todo-store.js';
-import { Database } from "@adobe/data/ecs";
-
-import * as transactions from './transactions/index.js';
-
-export const createTodoDatabase = () => {
-  return Database.create(Database.Plugin.create({
-    components: todoStoreSchema.components,
-    resources: todoStoreSchema.resources,
-    archetypes: todoStoreSchema.archetypes,
-    transactions,
-  }));
-};
-
-export type TodoDatabase = ReturnType<typeof createTodoDatabase>;

package/references/data-lit-todo/src/services/state-service/create-todo-store.ts

@@ -1,28 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { Store } from "@adobe/data/ecs";
-import { F32, True, Schema } from "@adobe/data/schema";
-
-// Increment this value if you change the schema in a non-backwards compatible way
-export const todoStoreSchemaVersion = 1;
-
-export const todoStoreSchema = {
-  components: {
-    todo: True.schema, // a tag that indicates an entity is a todo item.
-    complete: { type: 'boolean' as const },
-    name: { type: 'string' as const },
-    order: F32.schema,
-    dragPosition: Schema.Nullable(F32.schema), // null = not being dragged
-  },
-  resources: {
-    displayCompleted: { type: 'boolean' as const, default: false },
-  },
-  archetypes: {
-    Todo: ['todo', 'complete', 'name', 'order', 'dragPosition'],
-  }
-} as const;
-
-export const createTodoStore = () => {
-  return Store.create(todoStoreSchema);
-};
-
-export type TodoStore = ReturnType<typeof createTodoStore>;

package/references/data-lit-todo/src/services/state-service/todo-state-service.ts

@@ -1,9 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { type TodoDatabase } from './create-todo-database.js';
-import { FromArchetype } from "@adobe/data/ecs";
-
-export type TodoStateService = TodoDatabase;
-
-export type Todo = FromArchetype<TodoDatabase['archetypes']['Todo']>;
-
-export type DragTodoFunction = TodoStateService['transactions']['dragTodo'];

package/references/data-lit-todo/src/services/state-service/transactions/create-bulk-todos.ts

@@ -1,12 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { createTodo } from './create-todo.js';
-
-import { type TodoStore } from '../create-todo-store.js';
-
-export const createBulkTodos = (t: TodoStore, count: number) => {
-  t.undoable = { coalesce: false };
-  const currentCount = t.archetypes.Todo.rowCount;
-  for (let i = 0; i < count; i++) {
-    createTodo(t, { name: `Todo ${currentCount + i}`, complete: false });
-  }
-};

package/references/data-lit-todo/src/services/state-service/transactions/create-todo.test.ts

@@ -1,17 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { createTodo } from './create-todo.js';
-import { describe, expect, it } from 'vitest';
-
-import { createTodoStore } from '../create-todo-store.js';
-
-describe('createTodo', () => {
-  describe('when creating a new todo', () => {
-    it('should return the created todo entity id and create the todo', () => {
-      const t = createTodoStore();
-      const todoId = createTodo(t, { name: 'Buy groceries' });
-      expect(todoId).toBeGreaterThanOrEqual(0);
-      const values = t.read(todoId);
-      expect(values).toEqual({ id: todoId, name: 'Buy groceries', dragPosition: null, complete: false, todo: true, order: 0 });
-    });
-  });
-});

package/references/data-lit-todo/src/services/state-service/transactions/create-todo.ts

@@ -1,15 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { type TodoStore } from '../create-todo-store.js';
-
-export const createTodo = (t: TodoStore, props: { name: string; complete?: boolean }) => {
-  t.undoable = { coalesce: false };
-  const order = t.archetypes.Todo.rowCount;
-  // TODO: Figure out why the order seems to be zero on each added row.
-  return t.archetypes.Todo.insert({
-    ...props,
-    complete: props.complete ?? false,
-    todo: true,
-    order,
-    dragPosition: null,
-  });
-};

package/references/data-lit-todo/src/services/state-service/transactions/delete-all-todos.ts

@@ -1,18 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { type TodoStore } from '../create-todo-store.js';
-
-export const deleteAllTodos = (t: TodoStore) => {
-  t.undoable = { coalesce: false };
-  // query for all specific archetypes which satisfy the general todo archetype
-  for (const archetype of t.queryArchetypes(t.archetypes.Todo.components)) {
-    // traverse each row in reverse order
-    // it's slightly more efficient to delete in this order
-    // since we don't need to swap the final row to fill in the hole on delete.
-    for (let row = archetype.rowCount - 1; row >= 0; row--) {
-      // get the id for this row from the id column
-      const entityId = archetype.columns.id.get(row);
-      // delete the entity
-      t.delete(entityId);
-    }
-  }
-};

package/references/data-lit-todo/src/services/state-service/transactions/delete-todo.test.ts

@@ -1,25 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { createTodo } from './create-todo.js';
-import { deleteTodo } from './delete-todo.js';
-import { describe, expect, it } from 'vitest';
-
-import { createTodoStore } from '../create-todo-store.js';
-
-describe('deleteTodo', () => {
-  describe('when deleting a todo', () => {
-    it('should remove it from the archetype', () => {
-      const t = createTodoStore();
-      const todoA = createTodo(t, { name: 'A' });
-      const todoB = createTodo(t, { name: 'B' });
-      const todoC = createTodo(t, { name: 'C' });
-      deleteTodo(t, todoA);
-      const values = t.read(todoA);
-      expect(values).toBeNull();
-      const valuesB = t.read(todoB);
-      expect(valuesB).toBeDefined();
-      const valuesC = t.read(todoC);
-      expect(valuesC).toBeDefined();
-      expect(t.archetypes.Todo.rowCount).toBe(2);
-    });
-  });
-});

package/references/data-lit-todo/src/services/state-service/transactions/delete-todo.ts

@@ -1,11 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { reorderTodos } from './reorder-todos.js';
-import type { Entity } from "@adobe/data/ecs";
-
-import { type TodoStore } from '../create-todo-store.js';
-
-export const deleteTodo = (t: TodoStore, id: Entity) => {
-  t.undoable = { coalesce: false };
-  t.delete(id);
-  reorderTodos(t);
-};

package/references/data-lit-todo/src/services/state-service/transactions/drag-todo.ts

@@ -1,19 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { reorderTodos } from './reorder-todos.js';
-import type { Entity } from "@adobe/data/ecs";
-
-import { type TodoStore } from '../create-todo-store.js';
-
-export const dragTodo = (t: TodoStore, props: { todo: Entity; dragPosition: number; finalIndex?: number }) => {
-  t.undoable = { coalesce: false };
-  const { todo, dragPosition, finalIndex } = props;
-  const completed = finalIndex !== undefined;
-  if (!completed) {
-    t.update(todo, { dragPosition });
-  } else {
-    // insert it with an order value 0.5 less than the final index
-    t.update(todo, { dragPosition: null, order: finalIndex - 0.5 });
-    // then we call reorderTodos which will reorder everything to integer order values
-    reorderTodos(t); // this is an example of calling another transaction from a transaction
-  }
-};

package/references/data-lit-todo/src/services/state-service/transactions/index.ts

@@ -1,8 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-export * from './create-todo.js';
-export * from './delete-todo.js';
-export * from './toggle-complete.js';
-export * from './create-bulk-todos.js';
-export * from './drag-todo.js';
-// This is used by the undo-redo actions, the implementation is in the data package.
-export { applyOperations } from "@adobe/data/ecs";

package/references/data-lit-todo/src/services/state-service/transactions/reorder-todos.ts

@@ -1,13 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { TodoStore } from '../create-todo-store.js';
-
-/**
- * Ensures each todo has an monotonically increasing integer order value.
- * You might call this after inserting a todo with a floating point order value for insertion.
- */
-export const reorderTodos = (t: TodoStore) => {
-  const todos = t.select(t.archetypes.Todo.components, { order: { order: true } });
-  for (let i = 0; i < todos.length; i++) {
-    t.update(todos[i], { order: i });
-  }
-};

package/references/data-lit-todo/src/services/state-service/transactions/toggle-complete.test.ts

@@ -1,78 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { createTodo } from './create-todo.js';
-import { toggleComplete } from './toggle-complete.js';
-import { describe, expect, it } from 'vitest';
-
-import { createTodoStore } from '../create-todo-store.js';
-
-describe('toggleComplete', () => {
-  describe('when toggling a complete todo', () => {
-    it('should mark it as incomplete', () => {
-      const t = createTodoStore();
-      const todoId = createTodo(t, { name: 'Test todo' });
-      // First mark as complete
-      t.update(todoId, { complete: true });
-      expect(t.read(todoId)?.complete).toBe(true);
-
-      // Then toggle it
-      toggleComplete(t, todoId);
-      expect(t.read(todoId)?.complete).toBe(false);
-    });
-  });
-
-  describe('when toggling an incomplete todo', () => {
-    it('should mark it as complete', () => {
-      const t = createTodoStore();
-      const todoId = createTodo(t, { name: 'Test todo' });
-      expect(t.read(todoId)?.complete).toBe(false);
-
-      toggleComplete(t, todoId);
-      expect(t.read(todoId)?.complete).toBe(true);
-    });
-  });
-
-  describe('when toggling multiple times', () => {
-    it('should alternate between complete and incomplete', () => {
-      const t = createTodoStore();
-      const todoId = createTodo(t, { name: 'Test todo' });
-      expect(t.read(todoId)?.complete).toBe(false);
-
-      // First toggle
-      toggleComplete(t, todoId);
-      expect(t.read(todoId)?.complete).toBe(true);
-
-      // Second toggle
-      toggleComplete(t, todoId);
-      expect(t.read(todoId)?.complete).toBe(false);
-
-      // Third toggle
-      toggleComplete(t, todoId);
-      expect(t.read(todoId)?.complete).toBe(true);
-    });
-  });
-
-  describe('when toggling a non-existent todo', () => {
-    it('should not throw an error and should no-op', () => {
-      const t = createTodoStore();
-      const nonExistentId = 999;
-      expect(t.read(nonExistentId)).toBeNull();
-
-      // Should not throw
-      expect(() => toggleComplete(t, nonExistentId)).not.toThrow();
-
-      // Should still be null
-      expect(t.read(nonExistentId)).toBeNull();
-    });
-  });
-
-  describe('when toggling with invalid entity id', () => {
-    it('should not throw an error and should no-op', () => {
-      const t = createTodoStore();
-      const invalidId = -1;
-
-      // Should not throw
-      toggleComplete(t, invalidId);
-      expect(() => toggleComplete(t, invalidId)).not.toThrow();
-    });
-  });
-});

package/references/data-lit-todo/src/services/state-service/transactions/toggle-complete.ts

@@ -1,15 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import type { Entity } from "@adobe/data/ecs";
-
-import { type TodoStore } from '../create-todo-store.js';
-
-export const toggleComplete = (t: TodoStore, id: Entity) => {
-  t.undoable = { coalesce: false };
-  const todo = t.read(id);
-  // actions must never throw errors.
-  // if state is invalid they must no op.
-  // this is important for resolving concurrency conflicts.
-  if (todo) {
-    t.update(id, { complete: !todo.complete });
-  }
-};

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

@@ -1,6 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { TodoMainService } from './services/main-service/todo-main-service.js';
-
-import { ApplicationElement } from "@adobe/data-lit";
-
-export class TodoElement extends ApplicationElement<TodoMainService> { }

package/references/data-lit-todo/src/todo-host.ts

@@ -1,29 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-
-import { LitElement, html, css } from 'lit';
-import { customElement } from 'lit/decorators.js';
-import { createMainService } from './services/main-service/create-main-service.js';
-import './todo-main-element.js';  // Side effect: registers custom elements
-import "@adobe/data-lit"; // Side effect: registers ApplicationHost and other elements
-
-export const tagName = 'todo-host';
-
-@customElement(tagName)
-export class TodoHost extends LitElement {
-    static styles = css`
-        :host {
-            display: flex;
-            flex: 1 1 auto;
-            color: red;
-        }
-    `;
-
-    render() {
-        return html`
-            <application-host 
-                .createService=${createMainService} 
-                .renderElement=${() => html`<data-todo></data-todo>`}>
-            </application-host>
-        `;
-    }
-}

package/references/data-lit-todo/src/todo-main-element.ts

@@ -1,40 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import './elements/todo-list/todo-list.js';
-import './elements/todo-row/todo-row.js';
-import './elements/todo-toolbar/todo-toolbar.js';
-import './elements/todo-undo-redo/todo-undo-redo.js';
-import { TodoElement } from './todo-element.js';
-import { html, css } from 'lit';
-import { customElement } from 'lit/decorators.js';
-
-export const tagName = 'data-todo';
-
-@customElement(tagName)
-export class TodoMainElement extends TodoElement {
-  static styles = css`
-    :host {
-      display: flex;
-      flex-direction: column;
-      height: 400px;
-      max-height: 400px;
-      overflow: hidden;
-    }
-    
-    data-todo-toolbar {
-      flex-shrink: 0;
-    }
-    
-    data-todo-list {
-      flex: 1;
-      overflow-y: auto;
-      min-height: 0;
-    }
-  `;
-
-  render() {
-    return html`
-      <data-todo-toolbar></data-todo-toolbar>
-      <data-todo-list></data-todo-list>
-    `;
-  }
-}

package/references/data-lit-todo/src/todo-sample.ts

@@ -1,21 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-
-import type { Sample } from "./sample-types.js";
-import "./todo-host.js"; // Side effect: registers todo-host
-
-export const todoSample: Sample = {
-    id: 'todo',
-    title: 'Todo Application',
-    description: 'A complete todo application demonstrating ECS architecture, state management, undo/redo, and persistence.',
-    category: 'Application Examples',
-    difficulty: 'intermediate',
-    features: [
-        'Entity-Component-System (ECS)',
-        'State Management',
-        'Undo/Redo System',
-        'Local Storage Persistence',
-        'Drag and Drop Reordering',
-        'Reactive UI Updates'
-    ],
-    elementTag: 'todo-host'
-};

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

@@ -1,10 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "esnext",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "strict": true,
-    "skipLibCheck": true
-  },
-  "include": ["src/**/*"]
-}