@deckflow/deckuse 1.2.1 → 1.3.1

package/dist/workspace/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EACd,UAAU,EACV,UAAU,EACV,SAAS,EACT,QAAQ,EACR,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,eAAe,EACf,QAAQ,EACR,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EACL,KAAK,eAAe,EACpB,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/workspace/index.js

@@ -0,0 +1,7 @@
+export { sourceDir, deckuseDir, manifestPath, indexPath, operationsPath, monitorDir, previewDir, renderDir, lockPath, gitignorePath, } from './paths.js';
+export { revision, nextRevision, isIntegerRevision, INITIAL_REVISION } from './revision.js';
+export { hasWorkspaceGitRepo, ensureGitignore, initGitRepo, commitWorkspace, resetGit, operationCommitMessage, } from './git.js';
+export { acquireWriteLock, isWriteLockHeld, withWriteLock } from './lock.js';
+export { readOperations, writeOperations, appendOperationCommit, readHistory, } from './operations.js';
+export { readManifest, writeMetadata } from './metadata.js';
+//# sourceMappingURL=index.js.map

package/dist/workspace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EACd,UAAU,EACV,UAAU,EACV,SAAS,EACT,QAAQ,EACR,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,eAAe,EACf,QAAQ,EACR,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EAEL,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/workspace/lock.d.ts

@@ -0,0 +1,5 @@
+/** True when a live process holds the write lock (stale/empty files count as unlocked). */
+export declare const isWriteLockHeld: (workspace: string) => Promise<boolean>;
+export declare const acquireWriteLock: (workspace: string) => Promise<() => Promise<void>>;
+export declare const withWriteLock: <T>(workspace: string, operation: () => Promise<T>) => Promise<T>;
+//# sourceMappingURL=lock.d.ts.map

package/dist/workspace/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/workspace/lock.ts"],"names":[],"mappings":"AAiDA,2FAA2F;AAC3F,eAAO,MAAM,eAAe,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,OAAO,CAaxE,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CA0BrF,CAAC;AAEF,eAAO,MAAM,aAAa,GAAU,CAAC,EACnC,WAAW,MAAM,EACjB,WAAW,MAAM,OAAO,CAAC,CAAC,CAAC,KAC1B,OAAO,CAAC,CAAC,CAOX,CAAC"}

package/dist/workspace/lock.js

@@ -0,0 +1,104 @@
+import { mkdir, open, readFile, rm } from 'node:fs/promises';
+import { deckuseDir, lockPath } from './paths.js';
+const LOCK_WAIT_MS = 30_000;
+const LOCK_POLL_MS = 50;
+const isProcessAlive = (pid) => {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code !== 'ESRCH';
+    }
+};
+const parseLockPayload = (raw) => {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return undefined;
+    try {
+        const value = JSON.parse(trimmed);
+        if (!Number.isInteger(value.pid) || value.pid <= 0)
+            return undefined;
+        if (!Number.isFinite(value.acquiredAt))
+            return undefined;
+        return { pid: value.pid, acquiredAt: value.acquiredAt };
+    }
+    catch {
+        return undefined;
+    }
+};
+/** Remove lock if missing holder / dead PID. Returns true when the path is free. */
+const reclaimIfStale = async (path) => {
+    let raw;
+    try {
+        raw = await readFile(path, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return true;
+        throw error;
+    }
+    const payload = parseLockPayload(raw);
+    if (payload && isProcessAlive(payload.pid))
+        return false;
+    await rm(path, { force: true });
+    return true;
+};
+/** True when a live process holds the write lock (stale/empty files count as unlocked). */
+export const isWriteLockHeld = async (workspace) => {
+    const path = lockPath(workspace);
+    let raw;
+    try {
+        raw = await readFile(path, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+    const payload = parseLockPayload(raw);
+    if (payload && isProcessAlive(payload.pid))
+        return true;
+    await rm(path, { force: true });
+    return false;
+};
+export const acquireWriteLock = async (workspace) => {
+    await mkdir(deckuseDir(workspace), { recursive: true });
+    const path = lockPath(workspace);
+    const deadline = Date.now() + LOCK_WAIT_MS;
+    let handle;
+    while (Date.now() < deadline) {
+        try {
+            handle = await open(path, 'wx');
+            const payload = { pid: process.pid, acquiredAt: Date.now() };
+            await handle.writeFile(`${JSON.stringify(payload)}\n`);
+            break;
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST')
+                throw error;
+            if (await reclaimIfStale(path))
+                continue;
+            await new Promise((resolve) => setTimeout(resolve, LOCK_POLL_MS));
+        }
+    }
+    if (!handle) {
+        throw new Error('Timed out waiting for workspace write lock. If no other deckuse process is running, remove .deckuse/write.lock and retry.');
+    }
+    return async () => {
+        await handle.close();
+        await rm(path, { force: true });
+    };
+};
+export const withWriteLock = async (workspace, operation) => {
+    const release = await acquireWriteLock(workspace);
+    try {
+        return await operation();
+    }
+    finally {
+        await release();
+    }
+};
+//# sourceMappingURL=lock.js.map

package/dist/workspace/lock.js.map

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

package/dist/workspace/metadata.d.ts

@@ -0,0 +1,4 @@
+import type { WorkspaceManifest } from '../core/index.js';
+export declare const readManifest: (workspace: string) => Promise<WorkspaceManifest>;
+export declare const writeMetadata: (workspace: string, manifest: WorkspaceManifest, index: unknown) => Promise<void>;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/workspace/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/workspace/metadata.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,YAAY,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,iBAAiB,CACE,CAAC;AAEnF,eAAO,MAAM,aAAa,GACxB,WAAW,MAAM,EACjB,UAAU,iBAAiB,EAC3B,OAAO,OAAO,KACb,OAAO,CAAC,IAAI,CAcd,CAAC"}

package/dist/workspace/metadata.js

@@ -0,0 +1,21 @@
+import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
+import { deckuseDir, indexPath, manifestPath } from './paths.js';
+export const readManifest = async (workspace) => JSON.parse(await readFile(manifestPath(workspace), 'utf8'));
+export const writeMetadata = async (workspace, manifest, index) => {
+    await mkdir(deckuseDir(workspace), { recursive: true });
+    const nonce = randomUUID();
+    const indexTmp = `${indexPath(workspace)}.${nonce}.tmp`;
+    const manifestTmp = `${manifestPath(workspace)}.${nonce}.tmp`;
+    try {
+        await writeFile(indexTmp, `${JSON.stringify(index, null, 2)}\n`, { flag: 'wx' });
+        await writeFile(manifestTmp, `${JSON.stringify(manifest, null, 2)}\n`, { flag: 'wx' });
+        await rename(indexTmp, indexPath(workspace));
+        await rename(manifestTmp, manifestPath(workspace));
+    }
+    catch (error) {
+        await Promise.all([rm(indexTmp, { force: true }), rm(manifestTmp, { force: true })]);
+        throw error;
+    }
+};
+//# sourceMappingURL=metadata.js.map

package/dist/workspace/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/workspace/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,SAAiB,EAA8B,EAAE,CAClF,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAsB,CAAC;AAEnF,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,SAAiB,EACjB,QAA2B,EAC3B,KAAc,EACC,EAAE;IACjB,MAAM,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC;IACxD,MAAM,WAAW,GAAG,GAAG,YAAY,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC;IAC9D,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACjF,MAAM,SAAS,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACvF,MAAM,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7C,MAAM,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACrF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC"}

package/dist/workspace/operations.d.ts

@@ -0,0 +1,14 @@
+export interface OperationRecord {
+    readonly at: string;
+    readonly revision: string;
+    readonly operation: unknown;
+    readonly slides: number[];
+}
+export declare const readOperations: (workspace: string) => Promise<OperationRecord[]>;
+export declare const writeOperations: (workspace: string, records: OperationRecord[]) => Promise<void>;
+export declare const appendOperationCommit: (workspace: string, record: OperationRecord) => Promise<string>;
+export declare const readHistory: (workspace: string, limit: number, offset: number) => Promise<{
+    records: OperationRecord[];
+    total: number;
+}>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/workspace/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/workspace/operations.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,eAAO,MAAM,cAAc,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,eAAe,EAAE,CAWjF,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,WAAW,MAAM,EACjB,SAAS,eAAe,EAAE,KACzB,OAAO,CAAC,IAAI,CAMd,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,WAAW,MAAM,EACjB,QAAQ,eAAe,KACtB,OAAO,CAAC,MAAM,CAKhB,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,WAAW,MAAM,EACjB,OAAO,MAAM,EACb,QAAQ,MAAM,KACb,OAAO,CAAC;IAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAGvD,CAAC"}

package/dist/workspace/operations.js

@@ -0,0 +1,35 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { commitWorkspace, operationCommitMessage } from './git.js';
+import { deckuseDir, operationsPath } from './paths.js';
+export const readOperations = async (workspace) => {
+    try {
+        const raw = await readFile(operationsPath(workspace), 'utf8');
+        return raw
+            .split(/\r?\n/)
+            .filter(Boolean)
+            .map((line) => JSON.parse(line));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+};
+export const writeOperations = async (workspace, records) => {
+    await mkdir(deckuseDir(workspace), { recursive: true });
+    const content = records.length
+        ? `${records.map((record) => JSON.stringify(record)).join('\n')}\n`
+        : '';
+    await writeFile(operationsPath(workspace), content);
+};
+export const appendOperationCommit = async (workspace, record) => {
+    const records = await readOperations(workspace);
+    records.push(record);
+    await writeOperations(workspace, records);
+    return commitWorkspace(workspace, operationCommitMessage(record.operation));
+};
+export const readHistory = async (workspace, limit, offset) => {
+    const records = await readOperations(workspace);
+    return { records: records.slice(offset, offset + limit), total: records.length };
+};
+//# sourceMappingURL=operations.js.map

package/dist/workspace/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/workspace/operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AASxD,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,SAAiB,EAA8B,EAAE;IACpF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9D,OAAO,GAAG;aACP,KAAK,CAAC,OAAO,CAAC;aACd,MAAM,CAAC,OAAO,CAAC;aACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAClE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,SAAiB,EACjB,OAA0B,EACX,EAAE;IACjB,MAAM,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM;QAC5B,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QACnE,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,SAAS,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EACxC,SAAiB,EACjB,MAAuB,EACN,EAAE;IACnB,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,MAAM,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,eAAe,CAAC,SAAS,EAAE,sBAAsB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;AAC9E,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAC9B,SAAiB,EACjB,KAAa,EACb,MAAc,EAC0C,EAAE;IAC1D,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;IAChD,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AACnF,CAAC,CAAC"}

package/dist/workspace/paths.d.ts

@@ -0,0 +1,11 @@
+export declare const sourceDir: (workspace: string) => string;
+export declare const deckuseDir: (workspace: string) => string;
+export declare const manifestPath: (workspace: string) => string;
+export declare const indexPath: (workspace: string) => string;
+export declare const operationsPath: (workspace: string) => string;
+export declare const monitorDir: (workspace: string) => string;
+export declare const previewDir: (workspace: string) => string;
+export declare const renderDir: (workspace: string) => string;
+export declare const lockPath: (workspace: string) => string;
+export declare const gitignorePath: (workspace: string) => string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/workspace/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/workspace/paths.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,GAAI,WAAW,MAAM,WAAuC,CAAC;AACnF,eAAO,MAAM,UAAU,GAAI,WAAW,MAAM,WAAyC,CAAC;AACtF,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,WAAiD,CAAC;AAChG,eAAO,MAAM,SAAS,GAAI,WAAW,MAAM,WAA8C,CAAC;AAC1F,eAAO,MAAM,cAAc,GAAI,WAAW,MAAM,WACC,CAAC;AAClD,eAAO,MAAM,UAAU,GAAI,WAAW,MAAM,WAA2C,CAAC;AACxF,eAAO,MAAM,UAAU,GAAI,WAAW,MAAM,WAA2C,CAAC;AACxF,eAAO,MAAM,SAAS,GAAI,WAAW,MAAM,WAA0C,CAAC;AACtF,eAAO,MAAM,QAAQ,GAAI,WAAW,MAAM,WAA8C,CAAC;AACzF,eAAO,MAAM,aAAa,GAAI,WAAW,MAAM,WAA2C,CAAC"}

package/dist/workspace/paths.js

@@ -0,0 +1,12 @@
+import { join, resolve } from 'node:path';
+export const sourceDir = (workspace) => join(resolve(workspace), 'source');
+export const deckuseDir = (workspace) => join(resolve(workspace), '.deckuse');
+export const manifestPath = (workspace) => join(deckuseDir(workspace), 'manifest.json');
+export const indexPath = (workspace) => join(deckuseDir(workspace), 'index.json');
+export const operationsPath = (workspace) => join(deckuseDir(workspace), 'operations.jsonl');
+export const monitorDir = (workspace) => join(deckuseDir(workspace), 'monitor');
+export const previewDir = (workspace) => join(deckuseDir(workspace), 'preview');
+export const renderDir = (workspace) => join(deckuseDir(workspace), 'render');
+export const lockPath = (workspace) => join(deckuseDir(workspace), 'write.lock');
+export const gitignorePath = (workspace) => join(resolve(workspace), '.gitignore');
+//# sourceMappingURL=paths.js.map

package/dist/workspace/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/workspace/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC,CAAC;AAChG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC,CAAC;AAC1F,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAiB,EAAE,EAAE,CAClD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;AACxF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;AACxF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC,CAAC;AACzF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC,CAAC"}

package/dist/workspace/revision.d.ts

@@ -0,0 +1,6 @@
+/** Monotonic integer revision as a decimal string (index/manifest stay string-typed). */
+export declare const INITIAL_REVISION = "1";
+export declare const revision: () => string;
+export declare const nextRevision: (current: string) => string;
+export declare const isIntegerRevision: (value: string) => boolean;
+//# sourceMappingURL=revision.d.ts.map

package/dist/workspace/revision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision.d.ts","sourceRoot":"","sources":["../../src/workspace/revision.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,eAAO,MAAM,QAAQ,QAAO,MAA0B,CAAC;AAEvD,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,MAK9C,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,KAAG,OAGjD,CAAC"}

package/dist/workspace/revision.js

@@ -0,0 +1,15 @@
+/** Monotonic integer revision as a decimal string (index/manifest stay string-typed). */
+export const INITIAL_REVISION = '1';
+export const revision = () => INITIAL_REVISION;
+export const nextRevision = (current) => {
+    const n = Number(current);
+    if (Number.isInteger(n) && n >= 0)
+        return String(n + 1);
+    // Legacy non-integer revisions: start a new integer line after the write.
+    return INITIAL_REVISION;
+};
+export const isIntegerRevision = (value) => {
+    const n = Number(value);
+    return Number.isInteger(n) && n >= 1 && String(n) === value;
+};
+//# sourceMappingURL=revision.js.map

package/dist/workspace/revision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision.js","sourceRoot":"","sources":["../../src/workspace/revision.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEpC,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAW,EAAE,CAAC,gBAAgB,CAAC;AAEvD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAU,EAAE;IACtD,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1B,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,0EAA0E;IAC1E,OAAO,gBAAgB,CAAC;AAC1B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAAW,EAAE;IAC1D,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC;AAC9D,CAAC,CAAC"}

package/dist/xlsx/index.d.ts

@@ -0,0 +1,2 @@
+export declare const xlsxAdapter: import("../core/adapter.js").FormatAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/xlsx/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/xlsx/index.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,WAAW,4CAAsC,CAAC"}

package/dist/xlsx/index.js

@@ -0,0 +1,3 @@
+import { createNotImplementedAdapter } from '../core/index.js';
+export const xlsxAdapter = createNotImplementedAdapter('xlsx');
+//# sourceMappingURL=index.js.map

package/dist/xlsx/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/xlsx/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,MAAM,CAAC,MAAM,WAAW,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC"}

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@deckflow/deckuse",
-  "version": "1.2.1",
+  "version": "1.3.1",
   "license": "AGPL-3.0",
   "type": "module",
   "private": false,
+  "packageManager": "pnpm@10.6.3",
+  "engines": {
+    "node": ">=20.19.0"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -12,40 +16,60 @@
     "./bin": {
       "types": "./dist/bin.d.ts",
       "import": "./dist/bin.js"
-    }
+    },
+    "./schema/command.json": "./schema/command.schema.json"
   },
   "files": [
-    "dist"
+    "dist",
+    "assets",
+    "schema"
   ],
-  "dependencies": {
-    "@deckflow/office2html": "^0.3.3",
-    "playwright-core": "^1.62.1",
-    "@deckflow/deckuse-core": "1.2.1",
-    "@deckflow/deckuse-edition-config": "1.2.0",
-    "@deckflow/deckuse-pptx": "1.2.1",
-    "@deckflow/deckuse-docx": "0.1.3",
-    "@deckflow/deckuse-workspace": "1.1.2",
-    "@deckflow/deckuse-xlsx": "0.1.3",
-    "@deckflow/deckuse-numbers": "0.1.3",
-    "@deckflow/deckuse-key": "0.1.3"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
   "bin": {
     "deckuse": "./dist/bin.js"
   },
+  "scripts": {
+    "prepare": "git config core.hooksPath .githooks || true",
+    "build": "node scripts/generate-cli-version.mjs && tsc && node scripts/generate-schema.mjs",
+    "prepack": "node scripts/sync-npm-readme.mjs",
+    "postpack": "node scripts/sync-npm-readme.mjs --restore",
+    "lint": "eslint .",
+    "typecheck": "tsc --pretty false",
+    "test": "vitest run",
+    "test:integration-writes": "node scripts/integration-writes.mjs",
+    "test:integration-writes:smoke": "node scripts/integration-writes-smoke.mjs",
+    "test:integration-writes:corpus": "node scripts/integration-writes.mjs",
+    "test:openability": "node scripts/check-openability.mjs",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "check:no-commercial-leak": "node scripts/assert-no-commercial-leak.mjs",
+    "install:global": "node scripts/install-global.mjs",
+    "uninstall:global": "node scripts/uninstall-global.mjs",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "pnpm build && pnpm check:no-commercial-leak && node scripts/sync-npm-readme.mjs && changeset publish && node scripts/sync-npm-readme.mjs --restore"
+  },
+  "dependencies": {
+    "@deckflow/office2html": "^0.3.5",
+    "@xmldom/xmldom": "^0.9.10",
+    "@zip.js/zip.js": "^2.8.34",
+    "isomorphic-git": "latest",
+    "playwright-core": "^1.62.1",
+    "zod": "latest"
+  },
   "devDependencies": {
-    "@deckflow/deckuse-opc": "1.1.0"
+    "@changesets/cli": "latest",
+    "@eslint/js": "latest",
+    "@types/node": "latest",
+    "eslint": "latest",
+    "eslint-config-prettier": "latest",
+    "prettier": "latest",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "latest",
+    "vitest": "latest"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/deckflow/deckuse.git",
-    "directory": "packages/deckuse"
+    "url": "git+https://github.com/deckflow/deckuse.git"
   },
-  "homepage": "https://github.com/deckflow/deckuse#readme",
-  "scripts": {
-    "build": "node ../../scripts/generate-cli-version.mjs && tsc -b",
-    "typecheck": "tsc -b --pretty false"
-  }
-}
+  "homepage": "https://github.com/deckflow/deckuse#readme"
+}