human2ai 0.1.0

package/dist/domain/session/canvas-edit-history.js

@@ -0,0 +1,53 @@
+/** In-memory operation history; server revisions remain an independent append-only log. */
+export class CanvasEditHistory {
+    past = [];
+    future = [];
+    current;
+    constructor(initial) {
+        this.current = structuredClone(initial);
+    }
+    get canUndo() { return this.past.length > 0; }
+    get canRedo() { return this.future.length > 0; }
+    record(next, beforeContext, afterContext = beforeContext, group) {
+        if (JSON.stringify(this.current) === JSON.stringify(next))
+            return false;
+        const previous = this.past.at(-1);
+        const after = structuredClone(next);
+        if (group && previous?.group === group) {
+            previous.after = after;
+            previous.afterContext = afterContext;
+            if (JSON.stringify(previous.before) === JSON.stringify(after))
+                this.past.pop();
+        }
+        else {
+            this.past.push({ before: this.current, after, beforeContext, afterContext, group });
+            if (this.past.length > 100)
+                this.past.shift();
+        }
+        this.current = after;
+        this.future = [];
+        return true;
+    }
+    undo() {
+        const entry = this.past.pop();
+        if (!entry)
+            return null;
+        this.future.push(entry);
+        this.current = entry.before;
+        return { draft: structuredClone(this.current), context: entry.beforeContext };
+    }
+    redo() {
+        const entry = this.future.pop();
+        if (!entry)
+            return null;
+        this.past.push(entry);
+        this.current = entry.after;
+        return { draft: structuredClone(this.current), context: entry.afterContext };
+    }
+    reset(draft) {
+        this.current = structuredClone(draft);
+        this.past = [];
+        this.future = [];
+    }
+}
+//# sourceMappingURL=canvas-edit-history.js.map

package/dist/domain/session/canvas-edit-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-edit-history.js","sourceRoot":"","sources":["../../../src/domain/session/canvas-edit-history.ts"],"names":[],"mappings":"AAaA,2FAA2F;AAC3F,MAAM,OAAO,iBAAiB;IACpB,IAAI,GAA+B,EAAE,CAAC;IACtC,MAAM,GAA+B,EAAE,CAAC;IAChD,OAAO,CAAI;IAEX,YAAY,OAAU;QACpB,IAAI,CAAC,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO,KAAc,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,OAAO,KAAc,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAEzD,MAAM,CAAC,IAAO,EAAE,aAAuB,EAAE,YAAY,GAAG,aAAa,EAAE,KAAc;QACnF,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,KAAK,IAAI,QAAQ,EAAE,KAAK,KAAK,KAAK,EAAE,CAAC;YACvC,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;YACvB,QAAQ,CAAC,YAAY,GAAG,YAAY,CAAC;YACrC,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;YACpF,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG;gBAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAChD,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI;QACF,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;IAChF,CAAC;IAED,IAAI;QACF,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAChC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC;QAC3B,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC;IAC/E,CAAC;IAED,KAAK,CAAC,KAAQ;QACZ,IAAI,CAAC,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF"}

package/dist/domain/session/capabilities.d.ts

@@ -0,0 +1,16 @@
+import type { SessionType } from "./types.ts";
+export type SessionOperationMode = "read" | "derive" | "artifact";
+export interface SessionOperationDefinition {
+    id: string;
+    mode: SessionOperationMode;
+    command: readonly string[];
+    sessionScoped: boolean;
+    sourceCaptureKind?: string;
+}
+export interface SessionTypeDefinition {
+    sessionType: SessionType;
+    captureKind: "composition-draft" | "ui-layout-draft" | "spatial-draft";
+    uiPath: string;
+    operations: readonly SessionOperationDefinition[];
+}
+export declare function sessionTypeDefinition(type: SessionType): SessionTypeDefinition;

package/dist/domain/session/capabilities.js

@@ -0,0 +1,84 @@
+const SESSION_TYPE_DEFINITIONS = {
+    spatial: {
+        sessionType: "spatial", captureKind: "spatial-draft", uiPath: "/spatial/",
+        operations: [
+            { id: "spatial.methods@1", mode: "read", command: ["spatial", "methods"], sessionScoped: false },
+            { id: "spatial.inspect@1", mode: "read", command: ["spatial", "inspect", "--revision", "<revision>"], sessionScoped: true, sourceCaptureKind: "spatial-draft" },
+            { id: "spatial.apply@1", mode: "derive", command: ["spatial", "apply", "--revision", "<revision>", "--input", "<operations.json>"], sessionScoped: true, sourceCaptureKind: "spatial-draft" },
+            { id: "spatial.render@1", mode: "artifact", command: ["spatial", "render", "--revision", "<revision>", "--camera", "<camera-id>", "--output", "<preview.png>"], sessionScoped: true, sourceCaptureKind: "spatial-draft" },
+            { id: "spatial.render-box@1", mode: "artifact", command: ["spatial", "render", "--revision", "<revision>", "--box", "<box-id>", "--view", "sheet", "--output", "<six-views.png>"], sessionScoped: true, sourceCaptureKind: "spatial-draft" },
+        ],
+    },
+    "image-composition": {
+        sessionType: "image-composition",
+        captureKind: "composition-draft",
+        uiPath: "/composition/",
+        operations: [
+            {
+                id: "composition.methods@1",
+                mode: "read",
+                command: ["composition", "methods"],
+                sessionScoped: false,
+            },
+            {
+                id: "composition.inspect@1",
+                mode: "read",
+                command: ["composition", "inspect", "--revision", "<revision>"],
+                sessionScoped: true,
+                sourceCaptureKind: "composition-draft",
+            },
+            {
+                id: "composition.refine@1",
+                mode: "derive",
+                command: [
+                    "composition",
+                    "apply",
+                    "--revision",
+                    "<revision>",
+                    "--plan",
+                    "<plan.json>",
+                ],
+                sessionScoped: true,
+                sourceCaptureKind: "composition-draft",
+            },
+            {
+                id: "composition.reference@1",
+                mode: "artifact",
+                command: [
+                    "composition",
+                    "reference",
+                    "--run",
+                    "<run-id>",
+                    "--output",
+                    "<reference.png>",
+                ],
+                sessionScoped: true,
+            },
+        ],
+    },
+    "ui-layout": {
+        sessionType: "ui-layout",
+        captureKind: "ui-layout-draft",
+        uiPath: "/ui-sketch/",
+        operations: [
+            {
+                id: "ui-layout.render@1",
+                mode: "artifact",
+                command: ["ui-layout", "render", "--revision", "<revision>", "--state", "<state-id>", "--output", "<preview.png>"],
+                sessionScoped: true,
+                sourceCaptureKind: "ui-layout-draft",
+            },
+            {
+                id: "ui-layout.standardize@1",
+                mode: "derive",
+                command: ["ui-layout", "standardize", "--input", "<document.json>", "--output", "<standardized.json>"],
+                sessionScoped: false,
+                sourceCaptureKind: "ui-layout-draft",
+            },
+        ],
+    },
+};
+export function sessionTypeDefinition(type) {
+    return SESSION_TYPE_DEFINITIONS[type];
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/domain/session/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../../src/domain/session/capabilities.ts"],"names":[],"mappings":"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"}

package/dist/domain/session/draft-version.d.ts

@@ -0,0 +1,41 @@
+export interface StyleProcessingInput {
+    styleId: string;
+    styleRevision: number;
+    sessionRevision: number;
+}
+export interface StyleProcessing {
+    styleId: string;
+    styleRevision: number;
+    sourceRevision: number;
+    resultRevision: number;
+}
+export interface DraftVersion<TDraft> {
+    id: string;
+    sessionId: string;
+    revision: number;
+    fingerprint: string;
+    draft: TDraft;
+    createdAt: string;
+    styleProcessing?: StyleProcessing;
+}
+export interface CreateDraftVersionInput {
+    expectedLatestRevision: number;
+    draft: unknown;
+    styleProcessing?: StyleProcessingInput;
+}
+export interface UndoDraftVersionInput {
+    changeRevision: number;
+    expectedLatestRevision: number;
+}
+export interface RestoreDraftVersionInput {
+    targetRevision: number;
+    expectedLatestRevision: number;
+}
+export interface DraftVersionOperations<TDraft> {
+    restoreDraftVersion(sessionId: string, input: RestoreDraftVersionInput): DraftVersion<TDraft>;
+    listDraftVersions(sessionId: string): DraftVersion<TDraft>[];
+    getLatestDraftVersion(sessionId: string, knownRevision?: number): DraftVersion<TDraft> | null;
+    getDraftVersion(sessionId: string, revision: number): DraftVersion<TDraft>;
+    createDraftVersion(sessionId: string, input: CreateDraftVersionInput): DraftVersion<TDraft>;
+    undoDraftVersion(sessionId: string, input: UndoDraftVersionInput): DraftVersion<TDraft>;
+}

package/dist/domain/session/draft-version.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=draft-version.js.map

package/dist/domain/session/draft-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-version.js","sourceRoot":"","sources":["../../../src/domain/session/draft-version.ts"],"names":[],"mappings":""}

package/dist/domain/session/index.d.ts

@@ -0,0 +1,5 @@
+export { sessionTypeDefinition } from "./capabilities.ts";
+export type * from "./capabilities.ts";
+export type * from "./draft-version.ts";
+export { SESSION_TYPES } from "./types.ts";
+export type * from "./types.ts";

package/dist/domain/session/index.js

@@ -0,0 +1,3 @@
+export { sessionTypeDefinition } from "./capabilities.js";
+export { SESSION_TYPES } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/domain/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/domain/session/types.d.ts

@@ -0,0 +1,23 @@
+export declare const SESSION_TYPES: readonly ["image-composition", "ui-layout", "spatial"];
+export type SessionType = (typeof SESSION_TYPES)[number];
+export type SessionLifecycleStage = "draft" | "interpreted" | "approved" | "exported";
+export interface Project {
+    id: string;
+    name: string;
+    description: string | null;
+    revision: number;
+    sessionCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Session {
+    id: string;
+    projectId: string | null;
+    styleId: string | null;
+    sessionType: SessionType;
+    title: string;
+    lifecycleStage: SessionLifecycleStage;
+    revision: number;
+    createdAt: string;
+    updatedAt: string;
+}

package/dist/domain/session/types.js

@@ -0,0 +1,2 @@
+export const SESSION_TYPES = ["image-composition", "ui-layout", "spatial"];
+//# sourceMappingURL=types.js.map

package/dist/domain/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/domain/session/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,mBAAmB,EAAE,WAAW,EAAE,SAAS,CAAU,CAAC"}