@deckflow/deckuse 1.2.1 → 1.3.1

package/dist/docx/text-spans.js

@@ -0,0 +1,142 @@
+import { children, writeTextNode } from './xml.js';
+const PROTECTED = new Set([
+    'sdt',
+    'del',
+    'ins',
+    'moveFrom',
+    'moveTo',
+    'oMath',
+    'oMathPara',
+    'fldSimple',
+    'fldChar',
+    'instrText',
+    'customXml',
+    'commentRangeStart',
+    'commentRangeEnd',
+    'commentReference',
+]);
+const SKIP = new Set([
+    'pPr',
+    'rPr',
+    'bookmarkStart',
+    'bookmarkEnd',
+    'proofErr',
+    'permStart',
+    'permEnd',
+    'sectPr',
+    'lastRenderedPageBreak',
+]);
+/**
+ * Concatenate visible `w:t` text in a paragraph. `w:proofErr` and bookmarks are
+ * skipped so a match can cross run boundaries. Protected markup (revisions,
+ * fields, content controls) stays in the string so overlap can be rejected.
+ */
+export const collectSpans = (paragraph) => {
+    const acc = { text: '', spans: [] };
+    walk(paragraph, acc, false);
+    return acc;
+};
+const walk = (container, acc, inheritedProtected) => {
+    for (const child of children(container)) {
+        const name = child.localName ?? '';
+        const protectedHere = inheritedProtected || PROTECTED.has(name);
+        if (name === 'r') {
+            for (const inner of children(child)) {
+                if (inner.localName !== 't')
+                    continue;
+                const value = inner.textContent ?? '';
+                const start = acc.text.length;
+                acc.text += value;
+                acc.spans.push({
+                    start,
+                    end: start + value.length,
+                    node: inner,
+                    run: child,
+                    protected: protectedHere,
+                });
+            }
+            continue;
+        }
+        if (SKIP.has(name))
+            continue;
+        if (children(child).length > 0)
+            walk(child, acc, protectedHere);
+    }
+};
+export const visibleRuns = (paragraph) => {
+    const runs = [];
+    const seen = new Set();
+    for (const span of collectSpans(paragraph).spans) {
+        if (span.protected || seen.has(span.run))
+            continue;
+        seen.add(span.run);
+        runs.push(span.run);
+    }
+    return runs;
+};
+const applyRange = (spans, start, end, replacement) => {
+    const first = spans[0];
+    const last = spans[spans.length - 1];
+    if (!first || !last)
+        return;
+    const firstText = first.node.textContent ?? '';
+    const lastText = last.node.textContent ?? '';
+    const prefix = firstText.slice(0, Math.max(0, start - first.start));
+    const suffix = lastText.slice(Math.max(0, end - last.start));
+    if (first === last) {
+        writeTextNode(first.node, `${prefix}${replacement}${suffix}`);
+        return;
+    }
+    writeTextNode(first.node, `${prefix}${replacement}`);
+    for (let index = 1; index < spans.length - 1; index += 1) {
+        const span = spans[index];
+        if (span)
+            writeTextNode(span.node, '');
+    }
+    writeTextNode(last.node, suffix);
+};
+export const replaceInParagraph = (paragraph, find, replacement, regex, maxMatches) => {
+    let pattern;
+    if (regex) {
+        try {
+            pattern = new RegExp(find, 'g');
+        }
+        catch (cause) {
+            return { error: cause instanceof Error ? cause.message : 'Invalid regular expression' };
+        }
+    }
+    let matched = 0;
+    for (let guard = 0; guard < 10_000; guard += 1) {
+        const { text, spans } = collectSpans(paragraph);
+        let start = -1;
+        let end = -1;
+        if (pattern) {
+            pattern.lastIndex = 0;
+            const found = pattern.exec(text);
+            if (!found || found[0].length === 0)
+                break;
+            start = found.index;
+            end = start + found[0].length;
+        }
+        else {
+            start = text.indexOf(find);
+            if (start < 0)
+                break;
+            end = start + find.length;
+        }
+        const overlapping = spans.filter((span) => span.end > start && span.start < end);
+        if (overlapping.length === 0)
+            break;
+        if (overlapping.some((span) => span.protected)) {
+            return {
+                error: 'Match overlaps tracked changes, fields, comments, content controls, or equations',
+            };
+        }
+        applyRange(overlapping, start, end, replacement);
+        matched += 1;
+        if (maxMatches !== undefined && matched >= maxMatches)
+            break;
+    }
+    return { matched };
+};
+//# sourceMappingURL=text-spans.js.map

package/dist/docx/text-spans.js.map

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

package/dist/docx/types.d.ts

@@ -0,0 +1,27 @@
+import type { Diagnostic, ElementRef } from '../core/index.js';
+export type ElementKind = 'paragraph' | 'run' | 'table' | 'tableCell' | 'section' | 'style' | 'bookmark';
+export interface IndexedElement {
+    ref: ElementRef;
+    kind: ElementKind;
+    partUri: string;
+    name?: string;
+    text?: string;
+    parentId?: string;
+    location?: Record<string, unknown>;
+    payload?: Record<string, unknown>;
+}
+export interface IndexFile {
+    revision: string;
+    elements: IndexedElement[];
+}
+export interface MutationOutcome {
+    changed: boolean;
+    matched?: number;
+    refs?: ElementRef[];
+    partUri?: string;
+    slides?: number[];
+    diagnostics?: Diagnostic[];
+    changedTargets?: string[];
+    changedParts?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/docx/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/docx/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE/D,MAAM,MAAM,WAAW,GACrB,WAAW,GAAG,KAAK,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAEjF,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,UAAU,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB"}

package/dist/docx/types.js

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

package/dist/docx/types.js.map

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

package/dist/docx/workspace.d.ts

@@ -0,0 +1,20 @@
+import type { WorkspaceManifest } from '../core/index.js';
+import { type OpcArchive as OpcArchiveType } from '../opc/index.js';
+import type { IndexFile } from './types.js';
+export { revision, nextRevision, sourceDir, readManifest, readHistory, withWriteLock, } from '../workspace/index.js';
+export type { OperationRecord } from '../workspace/index.js';
+export declare const packagePath: (workspace: string) => string;
+export declare const readIndex: (workspace: string) => Promise<IndexFile>;
+export declare function hashSourceTree(workspace: string): Promise<string>;
+export declare const isPackageStale: (workspace: string, manifest?: WorkspaceManifest) => Promise<boolean>;
+export declare function repackWorkspace(workspace: string): Promise<{
+    manifest: WorkspaceManifest;
+    packagePath: string;
+}>;
+export declare function initializeWorkspace(workspace: string, archive: OpcArchiveType, manifest: WorkspaceManifest, index: IndexFile): Promise<WorkspaceManifest>;
+export declare function persistWrite(workspace: string, archive: OpcArchiveType, manifest: WorkspaceManifest, index: IndexFile, operation: unknown, slides: number[]): Promise<WorkspaceManifest>;
+export declare function undoWrites(workspace: string, steps: number): Promise<{
+    undone: number;
+    revision: string;
+}>;
+//# sourceMappingURL=workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/docx/workspace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAA+B,KAAK,UAAU,IAAI,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAejG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,WAAW,EACX,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,eAAO,MAAM,WAAW,GAAI,WAAW,MAAM,WAA6C,CAAC;AAE3F,eAAO,MAAM,SAAS,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,SAAS,CACE,CAAC;AAExE,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBvE;AAgBD,eAAO,MAAM,cAAc,GACzB,WAAW,MAAM,EACjB,WAAW,iBAAiB,KAC3B,OAAO,CAAC,OAAO,CAMjB,CAAC;AAsBF,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAChE,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAaD;AAED,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,iBAAiB,CAAC,CAe5B;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,iBAAiB,CAAC,CA2B5B;AAED,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAiB/C"}

package/dist/docx/workspace.js

@@ -0,0 +1,145 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { mkdir, readFile, readdir, rename, rm } from 'node:fs/promises';
+import { basename, join, resolve } from 'node:path';
+import { OpcArchive, snapshotArchive } from '../opc/index.js';
+import { appendOperationCommit, deckuseDir, indexPath, initGitRepo, readManifest, readOperations, resetGit, sourceDir, withWriteLock, writeMetadata, writeOperations, } from '../workspace/index.js';
+import { loadIndex } from './index-sync.js';
+const DOCX_MEDIA_TYPE = 'application/vnd.openxmlformats-officedocument.wordprocessingml.document';
+export { revision, nextRevision, sourceDir, readManifest, readHistory, withWriteLock, } from '../workspace/index.js';
+export const packagePath = (workspace) => join(resolve(workspace), 'package.docx');
+export const readIndex = async (workspace) => JSON.parse(await readFile(indexPath(workspace), 'utf8'));
+export async function hashSourceTree(workspace) {
+    const root = sourceDir(workspace);
+    const entries = [];
+    const walk = async (dir, prefix = '') => {
+        for (const entry of await readdir(dir, { withFileTypes: true })) {
+            const relative = prefix ? `${prefix}/${entry.name}` : entry.name;
+            const absolute = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(absolute, relative);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            entries.push({ relative: relative.replaceAll('\\', '/'), data: await readFile(absolute) });
+        }
+    };
+    await walk(root);
+    entries.sort((a, b) => a.relative.localeCompare(b.relative));
+    const hash = createHash('sha256');
+    for (const entry of entries) {
+        hash.update(entry.relative);
+        hash.update('\0');
+        hash.update(entry.data);
+    }
+    return hash.digest('hex');
+}
+const withSourceContentHash = async (workspace, manifest) => {
+    const sourceContentHash = await hashSourceTree(workspace);
+    return {
+        ...manifest,
+        metadata: {
+            ...(manifest.metadata ?? {}),
+            sourceContentHash,
+        },
+    };
+};
+export const isPackageStale = async (workspace, manifest) => {
+    const current = manifest ?? (await readManifest(workspace));
+    const stored = current.metadata?.['sourceContentHash'];
+    if (typeof stored !== 'string' || stored.length === 0)
+        return false;
+    const live = await hashSourceTree(workspace);
+    return live !== stored;
+};
+const packPackage = async (workspace, archive, manifest) => {
+    const path = packagePath(workspace);
+    const { checksum } = await snapshotArchive(archive, path);
+    const withFiles = {
+        ...manifest,
+        files: [
+            {
+                path: basename(path),
+                mediaType: DOCX_MEDIA_TYPE,
+                checksum,
+            },
+        ],
+    };
+    return withSourceContentHash(workspace, withFiles);
+};
+export async function repackWorkspace(workspace) {
+    const root = resolve(workspace);
+    return withWriteLock(root, async () => {
+        const manifest = await readManifest(root);
+        const archive = await OpcArchive.openDirectory(sourceDir(root));
+        const index = await loadIndex(root, archive, manifest, { persist: true });
+        const packed = await packPackage(root, archive, {
+            ...manifest,
+            updatedAt: new Date().toISOString(),
+        });
+        await writeMetadata(root, packed, index);
+        return { manifest: packed, packagePath: packagePath(root) };
+    });
+}
+export async function initializeWorkspace(workspace, archive, manifest, index) {
+    const root = resolve(workspace);
+    await mkdir(root, { recursive: true });
+    await mkdir(deckuseDir(root), { recursive: true });
+    await archive.writeDirectory(sourceDir(root), true);
+    const packed = await packPackage(root, archive, manifest);
+    const next = {
+        ...packed,
+        revision: index.revision,
+        updatedAt: new Date().toISOString(),
+    };
+    await writeMetadata(root, next, index);
+    await writeOperations(root, []);
+    await initGitRepo(root, 'deckuse: init');
+    return next;
+}
+export async function persistWrite(workspace, archive, manifest, index, operation, slides) {
+    const root = resolve(workspace);
+    const rev = index.revision;
+    const source = sourceDir(root);
+    const sourceTmp = `${source}.${randomUUID()}.tmp`;
+    try {
+        await archive.writeDirectory(sourceTmp);
+        await rm(source, { recursive: true, force: true });
+        await rename(sourceTmp, source);
+        const next = {
+            ...manifest,
+            revision: rev,
+            updatedAt: new Date().toISOString(),
+        };
+        const packed = await packPackage(root, archive, next);
+        await writeMetadata(root, packed, index);
+        await appendOperationCommit(root, {
+            at: new Date().toISOString(),
+            revision: rev,
+            operation,
+            slides: [...new Set(slides)].sort((a, b) => a - b),
+        });
+        return packed;
+    }
+    catch (error) {
+        await rm(sourceTmp, { recursive: true, force: true });
+        throw error;
+    }
+}
+export async function undoWrites(workspace, steps) {
+    const root = resolve(workspace);
+    const records = await readOperations(root);
+    if (steps > records.length)
+        throw new Error(`Cannot undo ${String(steps)} step(s); only ${String(records.length)} available`);
+    await resetGit(root, steps);
+    const manifest = await readManifest(root);
+    const archive = await OpcArchive.openDirectory(sourceDir(root));
+    const index = await loadIndex(root, archive, manifest, { persist: true });
+    const packed = await packPackage(root, archive, {
+        ...manifest,
+        updatedAt: new Date().toISOString(),
+    });
+    await writeMetadata(root, packed, index);
+    return { undone: steps, revision: index.revision };
+}
+//# sourceMappingURL=workspace.js.map

package/dist/docx/workspace.js.map

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

package/dist/docx/xml.d.ts

@@ -0,0 +1,18 @@
+import type { Document, Element, Node } from '@xmldom/xmldom';
+export declare const NS: {
+    readonly w: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+    readonly w14: "http://schemas.microsoft.com/office/word/2010/wordml";
+    readonly mc: "http://schemas.openxmlformats.org/markup-compatibility/2006";
+};
+export declare const DOCUMENT_PART = "/word/document.xml";
+export declare const STYLES_PART = "/word/styles.xml";
+export declare const children: (node: Node) => Element[];
+export declare const descendants: (node: Node, localName?: string) => Element[];
+export declare const attr: (node: Element | undefined, name: string) => string | undefined;
+export declare const wEl: (doc: Document, name: string) => Element;
+export declare const documentBody: (doc: Document) => Element;
+export declare const paraIdOf: (paragraph: Element) => string | undefined;
+export declare const ensureW14: (doc: Document) => void;
+export declare const protectionReason: (node: Element) => string | undefined;
+export declare const writeTextNode: (node: Element, value: string) => void;
+//# sourceMappingURL=xml.d.ts.map

package/dist/docx/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../src/docx/xml.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE9D,eAAO,MAAM,EAAE;;;;CAIL,CAAC;AAEX,eAAO,MAAM,aAAa,uBAAuB,CAAC;AAClD,eAAO,MAAM,WAAW,qBAAqB,CAAC;AAmB9C,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,KAAG,OAAO,EACuC,CAAC;AAErF,eAAO,MAAM,WAAW,GAAI,MAAM,IAAI,EAAE,YAAY,MAAM,KAAG,OAAO,EAUnE,CAAC;AAEF,eAAO,MAAM,IAAI,GAAI,MAAM,OAAO,GAAG,SAAS,EAAE,MAAM,MAAM,KAAG,MAAM,GAAG,SAIvE,CAAC;AAEF,eAAO,MAAM,GAAG,GAAI,KAAK,QAAQ,EAAE,MAAM,MAAM,KAAG,OAAiD,CAAC;AAEpG,eAAO,MAAM,YAAY,GAAI,KAAK,QAAQ,KAAG,OAO5C,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,WAAW,OAAO,KAAG,MAAM,GAAG,SAMtD,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,KAAK,QAAQ,KAAG,IAQzC,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,MAAM,OAAO,KAAG,MAAM,GAAG,SAMzD,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,MAAM,OAAO,EAAE,OAAO,MAAM,KAAG,IAI5D,CAAC"}

package/dist/docx/xml.js

@@ -0,0 +1,87 @@
+export const NS = {
+    w: 'http://schemas.openxmlformats.org/wordprocessingml/2006/main',
+    w14: 'http://schemas.microsoft.com/office/word/2010/wordml',
+    mc: 'http://schemas.openxmlformats.org/markup-compatibility/2006',
+};
+export const DOCUMENT_PART = '/word/document.xml';
+export const STYLES_PART = '/word/styles.xml';
+const PROTECTED = new Set([
+    'sdt',
+    'del',
+    'ins',
+    'moveFrom',
+    'moveTo',
+    'oMath',
+    'oMathPara',
+    'fldSimple',
+    'fldChar',
+    'instrText',
+    'customXml',
+    'commentRangeStart',
+    'commentRangeEnd',
+    'commentReference',
+]);
+export const children = (node) => Array.from(node.childNodes).filter((item) => item.nodeType === 1);
+export const descendants = (node, localName) => {
+    const result = [];
+    const visit = (current) => {
+        for (const child of children(current)) {
+            if (!localName || child.localName === localName)
+                result.push(child);
+            visit(child);
+        }
+    };
+    visit(node);
+    return result;
+};
+export const attr = (node, name) => {
+    if (!node)
+        return undefined;
+    const value = node.getAttribute(name);
+    return value === null || value === '' ? undefined : value;
+};
+export const wEl = (doc, name) => doc.createElementNS(NS.w, `w:${name}`);
+export const documentBody = (doc) => {
+    const root = doc.documentElement;
+    if (!root)
+        throw new Error('word/document.xml has no document element');
+    const body = children(root).find((child) => child.localName === 'body') ?? descendants(root, 'body')[0];
+    if (!body)
+        throw new Error('word/document.xml has no w:body');
+    return body;
+};
+export const paraIdOf = (paragraph) => {
+    const raw = paragraph.getAttributeNS(NS.w14, 'paraId') ??
+        paragraph.getAttribute('w14:paraId') ??
+        paragraph.getAttribute('paraId');
+    return raw ? raw.toUpperCase() : undefined;
+};
+export const ensureW14 = (doc) => {
+    const root = doc.documentElement;
+    if (!root)
+        return;
+    if (!root.getAttribute('xmlns:w14'))
+        root.setAttribute('xmlns:w14', NS.w14);
+    if (!root.getAttribute('xmlns:mc'))
+        root.setAttribute('xmlns:mc', NS.mc);
+    const ignorable = root.getAttribute('mc:Ignorable') ?? '';
+    const tokens = ignorable.split(/\s+/).filter(Boolean);
+    if (!tokens.includes('w14'))
+        root.setAttribute('mc:Ignorable', [...tokens, 'w14'].join(' '));
+};
+export const protectionReason = (node) => {
+    const hit = PROTECTED.has(node.localName ?? '')
+        ? node
+        : descendants(node).find((item) => PROTECTED.has(item.localName ?? ''));
+    if (!hit)
+        return undefined;
+    return `Cannot rewrite ${hit.localName ?? 'markup'}; tracked changes, fields, comments, content controls, and equations are preserved`;
+};
+export const writeTextNode = (node, value) => {
+    node.textContent = value;
+    if (/^\s|\s$/.test(value) || value.includes('  '))
+        node.setAttribute('xml:space', 'preserve');
+    else if (node.hasAttribute('xml:space'))
+        node.removeAttribute('xml:space');
+};
+//# sourceMappingURL=xml.js.map

package/dist/docx/xml.js.map

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

package/dist/edition-config/index.d.ts

@@ -0,0 +1,25 @@
+/** Product edition for a DeckUse build. */
+export type Edition = 'community' | 'commercial';
+/** Community defaults. Commercial overlays must not rewrite this module in-tree. */
+export declare const EDITION: Edition;
+export declare const EDITION_VARIANT = "community";
+export declare const DISTRIBUTION_CHANNEL = "oss";
+/**
+ * Status / documentation capability claims for this edition.
+ * Master / layout / theme / advanced-chart *writes* are hard-denied in shared
+ * pptx code unless a proprietary `PptxEditionExtension` is registered —
+ * flipping these flags alone never opens those write paths.
+ */
+export declare const editionCapabilities: {
+    readonly mastersEdit: false;
+    readonly layoutsEdit: false;
+    readonly themeEdit: false;
+    readonly chartBasicOnly: true;
+};
+export type EditionCapabilities = typeof editionCapabilities;
+export declare const editionMetadata: {
+    readonly edition: "community";
+    readonly variant: "community";
+    readonly 'distribution-channel': "oss";
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/edition-config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/edition-config/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,YAAY,CAAC;AAEjD,oFAAoF;AACpF,eAAO,MAAM,OAAO,EAAE,OAAqB,CAAC;AAC5C,eAAO,MAAM,eAAe,cAAc,CAAC;AAC3C,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAE7D,eAAO,MAAM,eAAe;;;;CAIlB,CAAC"}

package/dist/edition-config/index.js

@@ -0,0 +1,22 @@
+/** Community defaults. Commercial overlays must not rewrite this module in-tree. */
+export const EDITION = 'community';
+export const EDITION_VARIANT = 'community';
+export const DISTRIBUTION_CHANNEL = 'oss';
+/**
+ * Status / documentation capability claims for this edition.
+ * Master / layout / theme / advanced-chart *writes* are hard-denied in shared
+ * pptx code unless a proprietary `PptxEditionExtension` is registered —
+ * flipping these flags alone never opens those write paths.
+ */
+export const editionCapabilities = {
+    mastersEdit: false,
+    layoutsEdit: false,
+    themeEdit: false,
+    chartBasicOnly: true,
+};
+export const editionMetadata = {
+    edition: EDITION,
+    variant: EDITION_VARIANT,
+    'distribution-channel': DISTRIBUTION_CHANNEL,
+};
+//# sourceMappingURL=index.js.map

package/dist/edition-config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/edition-config/index.ts"],"names":[],"mappings":"AAGA,oFAAoF;AACpF,MAAM,CAAC,MAAM,OAAO,GAAY,WAAW,CAAC;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;AAC3C,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,KAAK;IAClB,SAAS,EAAE,KAAK;IAChB,cAAc,EAAE,IAAI;CACZ,CAAC;AAIX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,eAAe;IACxB,sBAAsB,EAAE,oBAAoB;CACpC,CAAC"}

package/dist/edition.d.ts

@@ -1,4 +1,4 @@
 /** Product edition metadata for the DeckUse CLI package (re-export of edition-config). */
-export type { Edition, EditionCapabilities } from '@deckflow/deckuse-edition-config';
-export { EDITION, EDITION_VARIANT, DISTRIBUTION_CHANNEL, editionCapabilities, editionMetadata, } from '@deckflow/deckuse-edition-config';
+export type { Edition, EditionCapabilities } from './edition-config/index.js';
+export { EDITION, EDITION_VARIANT, DISTRIBUTION_CHANNEL, editionCapabilities, editionMetadata, } from './edition-config/index.js';
 //# sourceMappingURL=edition.d.ts.map

package/dist/edition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edition.d.ts","sourceRoot":"","sources":["../src/edition.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,YAAY,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACrF,OAAO,EACL,OAAO,EACP,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"edition.d.ts","sourceRoot":"","sources":["../src/edition.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,YAAY,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EACL,OAAO,EACP,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,2BAA2B,CAAC"}

package/dist/edition.js

@@ -1,2 +1,2 @@
-export { EDITION, EDITION_VARIANT, DISTRIBUTION_CHANNEL, editionCapabilities, editionMetadata, } from '@deckflow/deckuse-edition-config';
+export { EDITION, EDITION_VARIANT, DISTRIBUTION_CHANNEL, editionCapabilities, editionMetadata, } from './edition-config/index.js';
 //# sourceMappingURL=edition.js.map

package/dist/edition.js.map

@@ -1 +1 @@
-{"version":3,"file":"edition.js","sourceRoot":"","sources":["../src/edition.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,OAAO,EACP,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"edition.js","sourceRoot":"","sources":["../src/edition.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,OAAO,EACP,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,2BAA2B,CAAC"}

package/dist/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,SAAS,QAgCrB,CAAC;AAkqBF,2EAA2E;AAC3E,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,EAAE,KAAG,MAwB7C,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,EAAE,KAAG,MAAM,EAAE,GAAG,IAW9D,CAAC"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,SAAS,QAiCrB,CAAC;AAowBF,2EAA2E;AAC3E,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,EAAE,KAAG,MAsB7C,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,EAAE,KAAG,MAAM,EAAE,GAAG,IAa9D,CAAC"}