@deckflow/deckuse 1.2.1 → 1.3.0

package/dist/core/executor.js

@@ -0,0 +1,65 @@
+import { AdapterRegistry, } from './adapter.js';
+import { commandSchema, err } from './schema.js';
+export class Executor {
+    registry;
+    options;
+    #workspaceAdapters = new Map();
+    constructor(registry, options = {}) {
+        this.registry = registry;
+        this.options = options;
+    }
+    async execute(input) {
+        if (typeof input === 'object' &&
+            input !== null &&
+            'version' in input &&
+            input.version !== undefined &&
+            input.version !== '2.0') {
+            return err('UNSUPPORTED_VERSION', `Unsupported protocol version: ${String(input.version)}`, [], { hint: 'Use version "2.0". Protocol 1.0 workspaces must be re-initialized.' });
+        }
+        const parsed = commandSchema.safeParse(input);
+        if (!parsed.success) {
+            const diagnostics = parsed.error.issues.map((issue) => ({
+                severity: 'error',
+                code: 'SCHEMA_VALIDATION',
+                message: issue.message,
+                path: issue.path.map((segment) => typeof segment === 'symbol' ? (segment.description ?? segment.toString()) : segment),
+            }));
+            const first = diagnostics[0];
+            const pathLabel = first?.path && first.path.length > 0 ? `${first.path.map(String).join('.')}: ` : '';
+            const detail = first ? `${pathLabel}${first.message}` : 'invalid input';
+            const extra = diagnostics.length > 1 ? ` (+${String(diagnostics.length - 1)} more issue(s))` : '';
+            return err('INVALID_COMMAND', `Command failed schema validation: ${detail}${extra}`, diagnostics);
+        }
+        const command = parsed.data;
+        if (command.type === 'init') {
+            const adapter = this.registry.get(command.format);
+            if (!adapter)
+                return err('FORMAT_NOT_SUPPORTED', `No adapter registered for format: ${command.format}`);
+            const result = await this.#safely(() => adapter.init(command, this.options.context ?? {}));
+            if (result.ok)
+                this.#workspaceAdapters.set(command.workspaceId, adapter);
+            return result;
+        }
+        const adapter = this.#workspaceAdapters.get(command.workspaceId) ??
+            (await this.options.resolveAdapter?.(command.workspaceId, this.options.context ?? {}));
+        if (adapter)
+            this.#workspaceAdapters.set(command.workspaceId, adapter);
+        if (!adapter)
+            return err('WORKSPACE_NOT_FOUND', `Workspace is not initialized: ${command.workspaceId}`);
+        return this.#safely(() => adapter.execute(command, this.options.context ?? {}));
+    }
+    async #safely(operation) {
+        try {
+            return await operation();
+        }
+        catch (cause) {
+            const message = cause instanceof Error ? cause.message : 'Unknown adapter error';
+            return { ok: false, error: { code: 'INTERNAL_ERROR', message, cause }, diagnostics: [] };
+        }
+    }
+}
+export const execute = (executor, command) => executor.execute(command);
+export const inspect = (executor, workspaceId, options = {}) => executor.execute({ version: '2.0', type: 'inspect', workspaceId, ...options });
+export const getText = (executor, workspaceId, ref) => executor.execute({ version: '2.0', type: 'getText', workspaceId, ref });
+export const setText = (executor, workspaceId, transactionId, ref, text) => executor.execute({ version: '2.0', type: 'setText', workspaceId, transactionId, ref, text });
+//# sourceMappingURL=executor.js.map

package/dist/core/executor.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+export * from './adapter.js';
+export * from './executor.js';
+export * from './length.js';
+export * from './measure.js';
+export * from './not-implemented.js';
+export * from './schema.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,7 @@
+export * from './adapter.js';
+export * from './executor.js';
+export * from './length.js';
+export * from './measure.js';
+export * from './not-implemented.js';
+export * from './schema.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC"}

package/dist/core/length.d.ts

@@ -0,0 +1,27 @@
+/** OOXML English Metric Unit constants (documented for agents). */
+export declare const EMU_PER_INCH = 914400;
+export declare const EMU_PER_CM = 360000;
+export declare const EMU_PER_PT = 12700;
+/** CSS px at 96 DPI → EMU (1in = 96px = 914400 EMU). */
+export declare const EMU_PER_PX = 9525;
+/** Default 16:9 slide when presentation.xml has no sldSz. */
+export declare const DEFAULT_SLIDE_WIDTH_EMU = 12192000;
+export declare const DEFAULT_SLIDE_HEIGHT_EMU = 6858000;
+export type LengthAxis = 'x' | 'y' | 'absolute';
+export interface LengthContext {
+    readonly slideWidthEmu?: number;
+    readonly slideHeightEmu?: number;
+    /** Which dimension `%` resolves against. Defaults to absolute (uses width). */
+    readonly axis?: LengthAxis;
+}
+export type LengthInput = number | string;
+/**
+ * Parse a length into EMU.
+ * - bare numbers are treated as EMU (protocol / OOXML convention)
+ * - strings may carry units: px, pt, cm, mm, in, emu, %
+ */
+export declare function parseLength(value: LengthInput, context?: LengthContext): number;
+export declare function parseOptionalLength(value: LengthInput | undefined, context?: LengthContext): number | undefined;
+/** Zod-friendly union: EMU number or unit string (e.g. "120px", "5%"). */
+export declare const lengthInputDescription = "EMU number, or string with unit px|pt|cm|mm|in|emu|% (96 DPI for px; % relative to slide)";
+//# sourceMappingURL=length.d.ts.map

package/dist/core/length.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"length.d.ts","sourceRoot":"","sources":["../../src/core/length.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,eAAO,MAAM,YAAY,SAAU,CAAC;AACpC,eAAO,MAAM,UAAU,SAAU,CAAC;AAClC,eAAO,MAAM,UAAU,QAAS,CAAC;AACjC,wDAAwD;AACxD,eAAO,MAAM,UAAU,OAAQ,CAAC;AAEhC,6DAA6D;AAC7D,eAAO,MAAM,uBAAuB,WAAa,CAAC;AAClD,eAAO,MAAM,wBAAwB,UAAY,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG,GAAG,GAAG,GAAG,GAAG,UAAU,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAI1C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAyCnF;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,GAAG,SAAS,EAC9B,OAAO,GAAE,aAAkB,GAC1B,MAAM,GAAG,SAAS,CAGpB;AAED,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB,8FAC0D,CAAC"}

package/dist/core/length.js

@@ -0,0 +1,63 @@
+/** OOXML English Metric Unit constants (documented for agents). */
+export const EMU_PER_INCH = 914_400;
+export const EMU_PER_CM = 360_000;
+export const EMU_PER_PT = 12_700;
+/** CSS px at 96 DPI → EMU (1in = 96px = 914400 EMU). */
+export const EMU_PER_PX = 9_525;
+/** Default 16:9 slide when presentation.xml has no sldSz. */
+export const DEFAULT_SLIDE_WIDTH_EMU = 12_192_000;
+export const DEFAULT_SLIDE_HEIGHT_EMU = 6_858_000;
+const LENGTH_RE = /^\s*(-?\d+(?:\.\d+)?)\s*(px|pt|cm|mm|in|emu|%)?\s*$/i;
+/**
+ * Parse a length into EMU.
+ * - bare numbers are treated as EMU (protocol / OOXML convention)
+ * - strings may carry units: px, pt, cm, mm, in, emu, %
+ */
+export function parseLength(value, context = {}) {
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value))
+            throw new Error(`Invalid length number: ${String(value)}`);
+        return Math.round(value);
+    }
+    const trimmed = value.trim();
+    if (trimmed.toLowerCase() === 'auto')
+        throw new Error('Length "auto" is only valid for table height; use resolveTableHeight');
+    const match = LENGTH_RE.exec(trimmed);
+    if (!match)
+        throw new Error(`Invalid length: ${value}`);
+    const amount = Number(match[1]);
+    if (!Number.isFinite(amount))
+        throw new Error(`Invalid length: ${value}`);
+    const unit = (match[2] ?? 'emu').toLowerCase();
+    switch (unit) {
+        case 'emu':
+            return Math.round(amount);
+        case 'px':
+            return Math.round(amount * EMU_PER_PX);
+        case 'pt':
+            return Math.round(amount * EMU_PER_PT);
+        case 'cm':
+            return Math.round(amount * EMU_PER_CM);
+        case 'mm':
+            return Math.round(amount * (EMU_PER_CM / 10));
+        case 'in':
+            return Math.round(amount * EMU_PER_INCH);
+        case '%': {
+            const axis = context.axis ?? 'absolute';
+            const basis = axis === 'y'
+                ? (context.slideHeightEmu ?? DEFAULT_SLIDE_HEIGHT_EMU)
+                : (context.slideWidthEmu ?? DEFAULT_SLIDE_WIDTH_EMU);
+            return Math.round((amount / 100) * basis);
+        }
+        default:
+            throw new Error(`Unsupported length unit in: ${value}`);
+    }
+}
+export function parseOptionalLength(value, context = {}) {
+    if (value === undefined)
+        return undefined;
+    return parseLength(value, context);
+}
+/** Zod-friendly union: EMU number or unit string (e.g. "120px", "5%"). */
+export const lengthInputDescription = 'EMU number, or string with unit px|pt|cm|mm|in|emu|% (96 DPI for px; % relative to slide)';
+//# sourceMappingURL=length.js.map

package/dist/core/length.js.map

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

package/dist/core/measure.d.ts

@@ -0,0 +1,24 @@
+export interface MeasureTextInput {
+    readonly text: string;
+    /** Font size in points. */
+    readonly fontSize: number;
+    readonly bold?: boolean;
+    readonly fontFamily?: string;
+    /** Optional max width in EMU; when set, text wraps for height estimation. */
+    readonly maxWidthEmu?: number;
+}
+export interface MeasureTextResult {
+    readonly widthEmu: number;
+    readonly heightEmu: number;
+    readonly widthPx: number;
+    readonly heightPx: number;
+    readonly lines: number;
+    readonly heuristic: true;
+    readonly note: string;
+}
+/**
+ * Heuristic text measure for agent layout (not a real font rasterizer).
+ * Suitable for sizing boxes before render QA; expect ~10–20% error vs PowerPoint.
+ */
+export declare function measureText(input: MeasureTextInput): MeasureTextResult;
+//# sourceMappingURL=measure.d.ts.map

package/dist/core/measure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../src/core/measure.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAeD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CAyDtE"}

package/dist/core/measure.js

@@ -0,0 +1,79 @@
+import { EMU_PER_PT, EMU_PER_PX } from './length.js';
+const isCjk = (ch) => /[\u3000-\u9fff\uac00-\ud7af\uf900-\ufaff]/.test(ch);
+/** Average glyph width as a fraction of font size (pt → pt). */
+const charWidthPt = (ch, bold) => {
+    const factor = bold ? 1.08 : 1;
+    if (ch === '\n' || ch === '\r')
+        return 0;
+    if (ch === ' ')
+        return 0.33 * factor;
+    if (isCjk(ch))
+        return 1.0 * factor;
+    if (/[iIlj1|]/.test(ch))
+        return 0.28 * factor;
+    if (/[mwMW@%]/.test(ch))
+        return 0.85 * factor;
+    return 0.55 * factor;
+};
+/**
+ * Heuristic text measure for agent layout (not a real font rasterizer).
+ * Suitable for sizing boxes before render QA; expect ~10–20% error vs PowerPoint.
+ */
+export function measureText(input) {
+    const fontSize = input.fontSize;
+    if (!(fontSize > 0))
+        throw new Error('fontSize must be a positive number (pt)');
+    const bold = input.bold === true;
+    const lineHeightPt = fontSize * 1.2;
+    const maxWidthPt = input.maxWidthEmu !== undefined && input.maxWidthEmu > 0
+        ? input.maxWidthEmu / EMU_PER_PT
+        : undefined;
+    const paragraphs = input.text.replace(/\r\n/g, '\n').replace(/\r/g, '\n').split('\n');
+    let lines = 0;
+    let maxLinePt = 0;
+    for (const paragraph of paragraphs) {
+        if (paragraph.length === 0) {
+            lines += 1;
+            continue;
+        }
+        if (maxWidthPt === undefined) {
+            let widthPt = 0;
+            for (const ch of paragraph)
+                widthPt += charWidthPt(ch, bold);
+            maxLinePt = Math.max(maxLinePt, widthPt);
+            lines += 1;
+            continue;
+        }
+        let lineWidth = 0;
+        let lineCount = 1;
+        for (const ch of paragraph) {
+            const w = charWidthPt(ch, bold);
+            if (lineWidth > 0 && lineWidth + w > maxWidthPt) {
+                maxLinePt = Math.max(maxLinePt, lineWidth);
+                lineWidth = w;
+                lineCount += 1;
+            }
+            else {
+                lineWidth += w;
+            }
+        }
+        maxLinePt = Math.max(maxLinePt, lineWidth);
+        lines += lineCount;
+    }
+    if (lines === 0)
+        lines = 1;
+    const widthPt = maxWidthPt !== undefined ? Math.min(maxLinePt, maxWidthPt) : maxLinePt;
+    const heightPt = lines * lineHeightPt;
+    const widthEmu = Math.max(1, Math.round(widthPt * EMU_PER_PT));
+    const heightEmu = Math.max(1, Math.round(heightPt * EMU_PER_PT));
+    return {
+        widthEmu,
+        heightEmu,
+        widthPx: Math.round(widthEmu / EMU_PER_PX),
+        heightPx: Math.round(heightEmu / EMU_PER_PX),
+        lines,
+        heuristic: true,
+        note: 'Heuristic glyph widths (~10–20% vs PowerPoint). Verify with deckuse render.',
+    };
+}
+//# sourceMappingURL=measure.js.map

package/dist/core/measure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.js","sourceRoot":"","sources":["../../src/core/measure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAsBrD,MAAM,KAAK,GAAG,CAAC,EAAU,EAAW,EAAE,CAAC,2CAA2C,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAE5F,gEAAgE;AAChE,MAAM,WAAW,GAAG,CAAC,EAAU,EAAE,IAAa,EAAU,EAAE;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IACzC,IAAI,EAAE,KAAK,GAAG;QAAE,OAAO,IAAI,GAAG,MAAM,CAAC;IACrC,IAAI,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,GAAG,GAAG,MAAM,CAAC;IACnC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,GAAG,MAAM,CAAC;IAC9C,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,GAAG,MAAM,CAAC;IAC9C,OAAO,IAAI,GAAG,MAAM,CAAC;AACvB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAChC,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAChF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;IACjC,MAAM,YAAY,GAAG,QAAQ,GAAG,GAAG,CAAC;IACpC,MAAM,UAAU,GACd,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,GAAG,CAAC;QACtD,CAAC,CAAC,KAAK,CAAC,WAAW,GAAG,UAAU;QAChC,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtF,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,KAAK,MAAM,EAAE,IAAI,SAAS;gBAAE,OAAO,IAAI,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC7D,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACzC,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAChC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,GAAG,UAAU,EAAE,CAAC;gBAChD,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;gBAC3C,SAAS,GAAG,CAAC,CAAC;gBACd,SAAS,IAAI,CAAC,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,SAAS,IAAI,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;QACD,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC3C,KAAK,IAAI,SAAS,CAAC;IACrB,CAAC;IAED,IAAI,KAAK,KAAK,CAAC;QAAE,KAAK,GAAG,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvF,MAAM,QAAQ,GAAG,KAAK,GAAG,YAAY,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC;IAEjE,OAAO;QACL,QAAQ;QACR,SAAS;QACT,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC;QAC1C,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,UAAU,CAAC;QAC5C,KAAK;QACL,SAAS,EAAE,IAAI;QACf,IAAI,EAAE,6EAA6E;KACpF,CAAC;AACJ,CAAC"}

package/dist/core/not-implemented.d.ts

@@ -0,0 +1,3 @@
+import type { FormatAdapter } from './adapter.js';
+export declare const createNotImplementedAdapter: (format: string, version?: string) => FormatAdapter;
+//# sourceMappingURL=not-implemented.d.ts.map

package/dist/core/not-implemented.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-implemented.d.ts","sourceRoot":"","sources":["../../src/core/not-implemented.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,eAAO,MAAM,2BAA2B,GAAI,QAAQ,MAAM,EAAE,gBAAiB,KAAG,aAa9E,CAAC"}

package/dist/core/not-implemented.js

@@ -0,0 +1,12 @@
+import { err } from './schema.js';
+export const createNotImplementedAdapter = (format, version = '0.0.0') => ({
+    format,
+    version,
+    async init() {
+        return Promise.resolve(err('FORMAT_NOT_IMPLEMENTED', `The ${format} adapter is reserved but not implemented`));
+    },
+    async execute() {
+        return Promise.resolve(err('FORMAT_NOT_IMPLEMENTED', `The ${format} adapter is reserved but not implemented`));
+    },
+});
+//# sourceMappingURL=not-implemented.js.map

package/dist/core/not-implemented.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-implemented.js","sourceRoot":"","sources":["../../src/core/not-implemented.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,MAAc,EAAE,OAAO,GAAG,OAAO,EAAiB,EAAE,CAAC,CAAC;IAChG,MAAM;IACN,OAAO;IACP,KAAK,CAAC,IAAI;QACR,OAAO,OAAO,CAAC,OAAO,CACpB,GAAG,CAAC,wBAAwB,EAAE,OAAO,MAAM,0CAA0C,CAAC,CACvF,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,OAAO;QACX,OAAO,OAAO,CAAC,OAAO,CACpB,GAAG,CAAC,wBAAwB,EAAE,OAAO,MAAM,0CAA0C,CAAC,CACvF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}