@vibesdotdev/docs 0.0.0-stage → 1.0.0-rc.2

package/dist/docs.plugin.js.map

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

package/dist/documents/documents.cloud.plugin.d.ts

@@ -0,0 +1,3 @@
+export declare const documentsCloudPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default documentsCloudPlugin;
+//# sourceMappingURL=documents.cloud.plugin.d.ts.map

package/dist/documents/documents.cloud.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.cloud.plugin.d.ts","sourceRoot":"","sources":["../../src/documents/documents.cloud.plugin.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,oBAAoB,6CAqB/B,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/dist/documents/documents.cloud.plugin.js

@@ -0,0 +1,26 @@
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import documentsPlugin from "./documents.plugin.js";
+export const documentsCloudPlugin = createRuntimePlugin({
+    id: 'documents.cloud',
+    async onRegister(runtime) {
+        await runtime.registerPlugin(documentsPlugin);
+    },
+    loaders: [
+        loader('document.read', { kind: 'tools/tool', scope: 'cloud' }, async () => {
+            const [{ createDocumentReadTool }, { createCloudDocumentRenderer }] = await Promise.all([
+                import("./tools/document-read.impl.js"),
+                import("./render/render.impl.cloud.js")
+            ]);
+            return createDocumentReadTool(createCloudDocumentRenderer);
+        }),
+        loader('document.view', { kind: 'tools/tool', scope: 'cloud' }, async () => {
+            const [{ createDocumentViewTool }, { createCloudDocumentRenderer }] = await Promise.all([
+                import("./tools/document-view.impl.js"),
+                import("./render/render.impl.cloud.js")
+            ]);
+            return createDocumentViewTool(createCloudDocumentRenderer);
+        }),
+    ]
+});
+export default documentsCloudPlugin;
+//# sourceMappingURL=documents.cloud.plugin.js.map

package/dist/documents/documents.cloud.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.cloud.plugin.js","sourceRoot":"","sources":["../../src/documents/documents.cloud.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,eAAe,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;IACvD,EAAE,EAAE,iBAAiB;IACrB,KAAK,CAAC,UAAU,CAAC,OAAO;QACvB,MAAM,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,EAAE;QACR,MAAM,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,IAAI,EAAE;YAC1E,MAAM,CAAC,EAAE,sBAAsB,EAAE,EAAE,EAAE,2BAA2B,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACvF,MAAM,CAAC,+BAA+B,CAAC;gBACvC,MAAM,CAAC,+BAA+B,CAAC;aACvC,CAAC,CAAC;YACH,OAAO,sBAAsB,CAAC,2BAA2B,CAAC,CAAC;QAC5D,CAAC,CAAC;QACF,MAAM,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,IAAI,EAAE;YAC1E,MAAM,CAAC,EAAE,sBAAsB,EAAE,EAAE,EAAE,2BAA2B,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACvF,MAAM,CAAC,+BAA+B,CAAC;gBACvC,MAAM,CAAC,+BAA+B,CAAC;aACvC,CAAC,CAAC;YACH,OAAO,sBAAsB,CAAC,2BAA2B,CAAC,CAAC;QAC5D,CAAC,CAAC;KACF;CACD,CAAC,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/dist/documents/documents.consumer.plugin.d.ts

@@ -0,0 +1,3 @@
+export declare const documentsConsumerPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default documentsConsumerPlugin;
+//# sourceMappingURL=documents.consumer.plugin.d.ts.map

package/dist/documents/documents.consumer.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.consumer.plugin.d.ts","sourceRoot":"","sources":["../../src/documents/documents.consumer.plugin.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uBAAuB,6CAqBlC,CAAC;AAEH,eAAe,uBAAuB,CAAC"}

package/dist/documents/documents.consumer.plugin.js

@@ -0,0 +1,26 @@
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import documentsPlugin from "./documents.plugin.js";
+export const documentsConsumerPlugin = createRuntimePlugin({
+    id: 'documents.consumer',
+    async onRegister(runtime) {
+        await runtime.registerPlugin(documentsPlugin);
+    },
+    loaders: [
+        loader('document.read', { kind: 'tools/tool', scope: 'consumer' }, async () => {
+            const [{ createDocumentReadTool }, { createConsumerDocumentRenderer }] = await Promise.all([
+                import("./tools/document-read.impl.js"),
+                import("./render/render.impl.consumer.js")
+            ]);
+            return createDocumentReadTool((runtime) => createConsumerDocumentRenderer(runtime));
+        }),
+        loader('document.view', { kind: 'tools/tool', scope: 'consumer' }, async () => {
+            const [{ createDocumentViewTool }, { createConsumerDocumentRenderer }] = await Promise.all([
+                import("./tools/document-view.impl.js"),
+                import("./render/render.impl.consumer.js")
+            ]);
+            return createDocumentViewTool((runtime) => createConsumerDocumentRenderer(runtime));
+        }),
+    ]
+});
+export default documentsConsumerPlugin;
+//# sourceMappingURL=documents.consumer.plugin.js.map

package/dist/documents/documents.consumer.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.consumer.plugin.js","sourceRoot":"","sources":["../../src/documents/documents.consumer.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,eAAe,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;IAC1D,EAAE,EAAE,oBAAoB;IACxB,KAAK,CAAC,UAAU,CAAC,OAAO;QACvB,MAAM,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,EAAE;QACR,MAAM,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,IAAI,EAAE;YAC7E,MAAM,CAAC,EAAE,sBAAsB,EAAE,EAAE,EAAE,8BAA8B,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC1F,MAAM,CAAC,+BAA+B,CAAC;gBACvC,MAAM,CAAC,kCAAkC,CAAC;aAC1C,CAAC,CAAC;YACH,OAAO,sBAAsB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAC,CAAC;QACrF,CAAC,CAAC;QACF,MAAM,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,IAAI,EAAE;YAC7E,MAAM,CAAC,EAAE,sBAAsB,EAAE,EAAE,EAAE,8BAA8B,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC1F,MAAM,CAAC,+BAA+B,CAAC;gBACvC,MAAM,CAAC,kCAAkC,CAAC;aAC1C,CAAC,CAAC;YACH,OAAO,sBAAsB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAC,CAAC;QACrF,CAAC,CAAC;KACF;CACD,CAAC,CAAC;AAEH,eAAe,uBAAuB,CAAC"}

package/dist/documents/documents.plugin.d.ts

@@ -0,0 +1,3 @@
+declare const defaultExport: import("@vibesdotdev/kernel").RuntimePlugin;
+export default defaultExport;
+//# sourceMappingURL=documents.plugin.d.ts.map

package/dist/documents/documents.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.plugin.d.ts","sourceRoot":"","sources":["../../src/documents/documents.plugin.ts"],"names":[],"mappings":"AAOA,QAAA,MAAM,aAAa,6CAiCjB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/documents/documents.plugin.js

@@ -0,0 +1,33 @@
+/** Universal document contracts and storage manifest; compose a scoped plugin for tool implementations. */
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import { documentToolDescriptors } from "./tools/descriptors.js";
+import { documentPageCacheDescriptor } from "./storage/page-cache.descriptor.js";
+import { documentsSourceRefreshConfigDescriptor } from "../config/documents.source-refresh.config.descriptor.js";
+// Hoisted const: tsc rewriteRelativeImportExtensions does not rewrite `.ts` specifiers inside `export default <expr>` (TS 6.0.3).
+const defaultExport = createRuntimePlugin({
+    id: 'documents',
+    name: 'Documents Runtime',
+    description: 'Document reading, page caching, and vision-OCR orchestration. Owns the document.read tool, the documents.page-cache manifest and the documents.source-refresh destinations.',
+    dependencies: ['tools', 'storage', 'ai', 'config'],
+    descriptors: [
+        ...documentToolDescriptors,
+        documentPageCacheDescriptor,
+        // Where a ref's source refresh may carry the internal service credential.
+        documentsSourceRefreshConfigDescriptor
+    ],
+    loaders: [
+        ...['document.read', 'document.view'].map((id) => loader(id, { kind: 'tools/tool' }, async () => {
+            const { createUnavailableDocumentTool } = await import("./tools/unavailable.impl.js");
+            return createUnavailableDocumentTool();
+        })),
+        // Storage manifest loader: the storage plugin resolves this from the descriptor
+        // array above — storage/manifest kind handles its own resolution. The loader
+        // below is for any eager consumers that need the descriptor before plugin activation.
+        loader('documents.page-cache', { kind: 'storage/manifest' }, async () => {
+            const { documentPageCacheDescriptor: descriptor } = await import('./storage/page-cache.descriptor.js');
+            return descriptor;
+        })
+    ]
+});
+export default defaultExport;
+//# sourceMappingURL=documents.plugin.js.map

package/dist/documents/documents.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.plugin.js","sourceRoot":"","sources":["../../src/documents/documents.plugin.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,sCAAsC,EAAE,MAAM,yDAAyD,CAAC;AAEjH,kIAAkI;AAClI,MAAM,aAAa,GAAG,mBAAmB,CAAC;IACzC,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACV,6KAA6K;IAC9K,YAAY,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC;IAClD,WAAW,EAAE;QACZ,GAAG,uBAAuB;QAC1B,2BAA2B;QAC3B,0EAA0E;QAC1E,sCAAsC;KACtC;IACD,OAAO,EAAE;QACR,GAAG,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAChD,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,KAAK,IAAI,EAAE;YAC7C,MAAM,EAAE,6BAA6B,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;YACtF,OAAO,6BAA6B,EAAE,CAAC;QACxC,CAAC,CAAC,CACF;QACD,gFAAgF;QAChF,6EAA6E;QAC7E,sFAAsF;QACtF,MAAM,CACL,sBAAsB,EACtB,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAC5B,KAAK,IAAI,EAAE;YACV,MAAM,EAAE,2BAA2B,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAC/D,oCAAoC,CACpC,CAAC;YACF,OAAO,UAAU,CAAC;QACnB,CAAC,CACD;KACD;CACD,CAAC,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/documents/docx/client.d.ts

@@ -0,0 +1,56 @@
+import { BaseRuntimeClient, type RuntimeClientDescriptor } from '@vibesdotdev/kernel/client';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+import type { JsonValue } from '@vibesdotdev/kernel/schemas/json';
+import type { z } from 'zod/v4';
+import { type DocxTemplateDescriptor, type DocxSchemaDescriptor } from './schemas/runtime.ts';
+import type { GenerateDocumentOptions } from './schemas/generator.ts';
+/** Semantic owner; descriptors live exclusively in the kernel registry. */
+export declare class DocxClient extends BaseRuntimeClient {
+    #private;
+    constructor(descriptor: RuntimeClientDescriptor, context?: KindContext, runtime?: RuntimeRef);
+    createRegistryId(): string;
+    listTemplates(registry?: string): DocxTemplateDescriptor[];
+    getTemplate(id: string, registry?: string): {
+        id: string;
+        content: Buffer<ArrayBufferLike>;
+        description: string;
+    };
+    registerTemplate(id: string, content: Buffer, description?: string, registry?: string): void;
+    unregisterTemplate(id: string, registry?: string): void;
+    listSchemas(registry?: string): DocxSchemaDescriptor[];
+    getSchema(id: string, registry?: string): {
+        id: string;
+        registry: string;
+        templateId: string;
+        kind: "docx/schema";
+        schema: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+        description: string;
+        name?: string | undefined;
+        tags?: string[] | undefined;
+        hardware?: string[] | undefined;
+        enabled?: boolean | undefined;
+        priority?: number | undefined;
+        capabilityId?: string | undefined;
+        requiredContext?: string[] | undefined;
+        optionalContext?: string[] | undefined;
+        config?: unknown;
+        retention?: string | {
+            reason: string;
+            maxAgeDays?: number | undefined;
+            maxEntries?: number | undefined;
+            maxBytes?: number | undefined;
+            cascadeFrom?: string | undefined;
+            ageField?: string | undefined;
+            enforcedBy?: string | undefined;
+        } | undefined;
+    } | undefined;
+    registerSchema(id: string, schema: z.ZodType, description?: string, registry?: string): void;
+    render(templateId: string, data: Record<string, JsonValue>, options?: GenerateDocumentOptions): Buffer;
+    renderWithRegisteredSchema(templateId: string, data: Record<string, JsonValue>): Buffer;
+    protected onDispose(): void;
+}
+export declare function getVibesDocxClient(runtime: RuntimeRef): Promise<DocxClient>;
+/** Compatible synchronous access after activating and resolving the client. */
+export declare function createDocxClient(runtime?: RuntimeRef): DocxClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/documents/docx/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/documents/docx/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAqC,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAChI,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAA0E,KAAK,sBAAsB,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACtK,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAItE,2EAA2E;AAC3E,qBAAa,UAAW,SAAQ,iBAAiB;;gBAKpC,UAAU,EAAE,uBAAuB,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,UAAU;IAI5F,gBAAgB,IAAI,MAAM;IAI1B,aAAa,CAAC,QAAQ,SAAY,GAAG,sBAAsB,EAAE;IAM7D,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,SAAY;;;;;IAQ5C,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,SAAK,EAAE,QAAQ,SAAY,GAAG,IAAI;IAc3F,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,IAAI;IAO1D,WAAW,CAAC,QAAQ,SAAY,GAAG,oBAAoB,EAAE;IAMzD,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,SAAY;;;;;;;;;;;;;;;;;;;;;;;;;;IAI1C,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,WAAW,SAAK,EAAE,QAAQ,SAAY,GAAG,IAAI;IAW3F,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAE,uBAA4B,GAAG,MAAM;IAI1G,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM;cAOpE,SAAS,IAAI,IAAI;CAIpC;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAEjF;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU,CAOjE"}

package/dist/documents/docx/client.js

@@ -0,0 +1,90 @@
+import { BaseRuntimeClient, getVibesClient, tryGetVibesClient } from '@vibesdotdev/kernel/client';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { DocxIdSchema, DocxTemplateDescriptorSchema, DocxSchemaDescriptorSchema } from "./schemas/runtime.js";
+import { createTemplateRegistry } from "./templates/loader.js";
+import { generateDocument, generateDocumentWithRegisteredSchema, DocumentSchemaRegistry } from "./generator.js";
+/** Semantic owner; descriptors live exclusively in the kernel registry. */
+export class DocxClient extends BaseRuntimeClient {
+    // Retraction handles own resource lifetimes, never copies of descriptor data.
+    #retractions = new Map();
+    #nextRegistry = 0;
+    constructor(descriptor, context, runtime) {
+        super(descriptor, context, runtime);
+    }
+    createRegistryId() {
+        return 'custom-' + ++this.#nextRegistry;
+    }
+    listTemplates(registry = 'default') {
+        return this.runtime.query('docx/template').descriptors()
+            .map((entry) => DocxTemplateDescriptorSchema.parse(entry))
+            .filter((entry) => entry.registry === registry);
+    }
+    getTemplate(id, registry = 'default') {
+        const entry = this.listTemplates(registry).find((entry) => entry.templateId === id);
+        if (!entry) {
+            throw new CapabilityError('Template not found: ' + id, 'NOT_FOUND', { reason: 'docx-template-not-found' });
+        }
+        return { id: entry.templateId, content: entry.content, description: entry.description };
+    }
+    registerTemplate(id, content, description = id, registry = 'default') {
+        const descriptor = DocxTemplateDescriptorSchema.parse({
+            kind: 'docx/template', id: JSON.stringify([registry, id]),
+            registry, templateId: id, content, description
+        });
+        if (this.listTemplates(registry).some((entry) => entry.templateId === id)) {
+            throw new CapabilityError('Template already registered: ' + id, 'CONFLICT', { reason: 'docx-template-duplicate' });
+        }
+        this.#retractions.set(descriptor.kind + descriptor.id, this.runtime.registerDynamicAsset(descriptor.kind, descriptor, async () => ({
+            impl: { id, content, description }
+        })));
+    }
+    unregisterTemplate(id, registry = 'default') {
+        DocxIdSchema.parse(id);
+        const key = 'docx/template' + JSON.stringify([registry, id]);
+        this.#retractions.get(key)?.();
+        this.#retractions.delete(key);
+    }
+    listSchemas(registry = 'default') {
+        return this.runtime.query('docx/schema').descriptors()
+            .map((entry) => DocxSchemaDescriptorSchema.parse(entry))
+            .filter((entry) => entry.registry === registry);
+    }
+    getSchema(id, registry = 'default') {
+        return this.listSchemas(registry).find((entry) => entry.templateId === id);
+    }
+    registerSchema(id, schema, description = id, registry = 'default') {
+        const descriptor = DocxSchemaDescriptorSchema.parse({
+            kind: 'docx/schema', id: JSON.stringify([registry, id]),
+            registry, templateId: id, schema, description
+        });
+        const key = descriptor.kind + descriptor.id;
+        this.#retractions.get(key)?.();
+        this.#retractions.set(key, this.runtime.registerDynamicAsset(descriptor.kind, descriptor, async () => ({ impl: { schema, description } })));
+    }
+    render(templateId, data, options = {}) {
+        return generateDocument(templateId, data, { ...options, runtime: this.runtime });
+    }
+    renderWithRegisteredSchema(templateId, data) {
+        return generateDocumentWithRegisteredSchema(templateId, data, {
+            registry: createTemplateRegistry(this.runtime, 'default'),
+            schemaRegistry: new DocumentSchemaRegistry(this.runtime, 'default')
+        });
+    }
+    onDispose() {
+        for (const retract of this.#retractions.values())
+            retract();
+        this.#retractions.clear();
+    }
+}
+export async function getVibesDocxClient(runtime) {
+    return getVibesClient('docx', runtime);
+}
+/** Compatible synchronous access after activating and resolving the client. */
+export function createDocxClient(runtime) {
+    const client = runtime && tryGetVibesClient('docx', runtime);
+    if (!client) {
+        throw new CapabilityError('Resolve getVibesDocxClient(runtime) before synchronous DOCX access.', 'NOT_FOUND', { reason: 'docx-client-not-active' });
+    }
+    return client;
+}
+//# sourceMappingURL=client.js.map

package/dist/documents/docx/client.js.map

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

package/dist/documents/docx/extract.d.ts

@@ -0,0 +1,12 @@
+export interface ExtractDocxTextOptions {
+    includeHeadersAndFooters?: boolean;
+}
+export interface ExtractDocxTextResult {
+    text: string;
+    parts: Array<{
+        path: string;
+        text: string;
+    }>;
+}
+export declare function extractTextFromDocx(content: ArrayBuffer | Uint8Array | Buffer, options?: ExtractDocxTextOptions): ExtractDocxTextResult;
+//# sourceMappingURL=extract.d.ts.map

package/dist/documents/docx/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../src/documents/docx/extract.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,sBAAsB;IACtC,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7C;AAED,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,WAAW,GAAG,UAAU,GAAG,MAAM,EAC1C,OAAO,GAAE,sBAA2B,GAClC,qBAAqB,CAkBvB"}

package/dist/documents/docx/extract.js

@@ -0,0 +1,62 @@
+import PizZip from 'pizzip';
+const DOCX_TEXT_PART_RE = /^word\/(?:document|header\d+|footer\d+)\.xml$/;
+export function extractTextFromDocx(content, options = {}) {
+    const zip = new PizZip(content);
+    const parts = [];
+    for (const path of Object.keys(zip.files).sort()) {
+        if (!DOCX_TEXT_PART_RE.test(path))
+            continue;
+        if (!options.includeHeadersAndFooters && path !== 'word/document.xml')
+            continue;
+        const file = zip.file(path);
+        if (!file)
+            continue;
+        const text = extractTextFromWordXml(file.asText());
+        if (text.trim())
+            parts.push({ path, text });
+    }
+    return {
+        text: parts.map((part) => part.text).join('\n\n').trim(),
+        parts
+    };
+}
+function extractTextFromWordXml(xml) {
+    const paragraphs = xml.match(/<w:p(?:\s[^>]*)?>[\s\S]*?<\/w:p>/g) ?? [];
+    const lines = [];
+    for (const paragraph of paragraphs) {
+        const line = extractTextFromParagraphXml(paragraph).trim();
+        if (line)
+            lines.push(line);
+    }
+    if (lines.length > 0)
+        return lines.join('\n');
+    return Array.from(xml.matchAll(/<w:t(?:\s[^>]*)?>([\s\S]*?)<\/w:t>/g))
+        .map((match) => decodeXmlText(match[1] ?? ''))
+        .join('')
+        .trim();
+}
+function extractTextFromParagraphXml(xml) {
+    let text = '';
+    const tokenRe = /<w:t(?:\s[^>]*)?>([\s\S]*?)<\/w:t>|<w:tab\b[^>]*\/>|<w:br\b[^>]*\/>/g;
+    for (const match of xml.matchAll(tokenRe)) {
+        if (match[0].startsWith('<w:tab')) {
+            text += '\t';
+            continue;
+        }
+        if (match[0].startsWith('<w:br')) {
+            text += '\n';
+            continue;
+        }
+        text += decodeXmlText(match[1] ?? '');
+    }
+    return text;
+}
+function decodeXmlText(value) {
+    return value
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&amp;/g, '&');
+}
+//# sourceMappingURL=extract.js.map

package/dist/documents/docx/extract.js.map

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

package/dist/documents/docx/generator.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Document Generator
+ *
+ * Generates DOCX documents from templates using docxtemplater.
+ * Validates data against Zod schemas before rendering.
+ *
+ * Usage:
+ * ```ts
+ * import { generateDocument } from '@vibesdotdev/docs/documents/docx';
+ * import { z } from 'zod/v4';
+ * const ReportSchema = z.object({ title: z.string() });
+ *
+ * const buffer = await generateDocument('report', validData, {
+ *   schema: ReportSchema, registry
+ * });
+ * ```
+ */
+import type * as z from 'zod/v4';
+import type { JsonValue } from '@vibesdotdev/kernel/schemas/json';
+import type { GenerateDocumentOptions, SchemaEntry } from './schemas/generator.ts';
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+/** Compatible namespace facade; all entries remain kernel descriptors. */
+export declare class DocumentSchemaRegistry {
+    #private;
+    constructor(runtime?: RuntimeRef, namespace?: string);
+    get runtime(): RuntimeRef;
+    register(templateId: string, schema: z.ZodType, description?: string): void;
+    get(templateId: string): SchemaEntry | undefined;
+}
+export declare function createDocumentSchemaRegistry(runtime?: RuntimeRef): DocumentSchemaRegistry;
+/**
+ * Generate a DOCX document from a template with data binding.
+ *
+ * @param templateId - The registered template identifier
+ * @param data - The data object to bind to the template
+ * @param options - Optional: schema for validation, custom registry
+ * @returns Buffer containing the generated .docx file
+ * @throws ZodError if schema validation fails
+ * @throws Error if template not found
+ */
+export declare function generateDocument(templateId: string, data: Record<string, JsonValue>, options?: GenerateDocumentOptions): Buffer;
+/**
+ * Generate a document with schema registered for the template ID.
+ * Looks up schema from the schema registry by templateId.
+ */
+export declare function generateDocumentWithRegisteredSchema(templateId: string, data: Record<string, JsonValue>, options: Pick<GenerateDocumentOptions, 'registry'> & {
+    schemaRegistry: DocumentSchemaRegistry;
+}): Buffer;
+//# sourceMappingURL=generator.d.ts.map

package/dist/documents/docx/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/documents/docx/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,KAAK,CAAC,MAAM,QAAQ,CAAC;AAEjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,0EAA0E;AAC1E,qBAAa,sBAAsB;;gBAItB,OAAO,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM;IAKpD,IAAI,OAAO,IAAI,UAAU,CAExB;IAED,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3E,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;CAGhD;AAED,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,sBAAsB,CAEzF;AAID;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC/B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/B,OAAO,GAAE,uBAA4B,GACnC,MAAM,CAoCR;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CACnD,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/B,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,UAAU,CAAC,GAAG;IACpD,cAAc,EAAE,sBAAsB,CAAC;CACvC,GACC,MAAM,CAYR"}

package/dist/documents/docx/generator.js

@@ -0,0 +1,101 @@
+/**
+ * Document Generator
+ *
+ * Generates DOCX documents from templates using docxtemplater.
+ * Validates data against Zod schemas before rendering.
+ *
+ * Usage:
+ * ```ts
+ * import { generateDocument } from '@vibesdotdev/docs/documents/docx';
+ * import { z } from 'zod/v4';
+ * const ReportSchema = z.object({ title: z.string() });
+ *
+ * const buffer = await generateDocument('report', validData, {
+ *   schema: ReportSchema, registry
+ * });
+ * ```
+ */
+import Docxtemplater from 'docxtemplater';
+import PizZip from 'pizzip';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { createTemplateRegistry } from "./templates/loader.js";
+import { createDocxClient } from "./client.js";
+import { RenderDataSchema } from "./schemas/runtime.js";
+/** Compatible namespace facade; all entries remain kernel descriptors. */
+export class DocumentSchemaRegistry {
+    #client;
+    #namespace;
+    constructor(runtime, namespace) {
+        this.#client = createDocxClient(runtime);
+        this.#namespace = namespace ?? this.#client.createRegistryId();
+    }
+    get runtime() {
+        return this.#client.runtime;
+    }
+    register(templateId, schema, description) {
+        this.#client.registerSchema(templateId, schema, description, this.#namespace);
+    }
+    get(templateId) {
+        return this.#client.getSchema(templateId, this.#namespace);
+    }
+}
+export function createDocumentSchemaRegistry(runtime) {
+    return new DocumentSchemaRegistry(runtime);
+}
+// Generate Document
+/**
+ * Generate a DOCX document from a template with data binding.
+ *
+ * @param templateId - The registered template identifier
+ * @param data - The data object to bind to the template
+ * @param options - Optional: schema for validation, custom registry
+ * @returns Buffer containing the generated .docx file
+ * @throws ZodError if schema validation fails
+ * @throws Error if template not found
+ */
+export function generateDocument(templateId, data, options = {}) {
+    const { schema } = options;
+    const registry = options.registry ?? createTemplateRegistry(options.runtime, 'default');
+    // Render validated defaults and transforms; invalid output must never fall back to input.
+    let renderData = data;
+    if (schema) {
+        const result = schema.safeParse(data);
+        if (!result.success) {
+            throw result.error;
+        }
+        const validated = RenderDataSchema.safeParse(result.data);
+        if (!validated.success) {
+            throw new CapabilityError('Schema output must be a JSON render-data object.', 'INVALID_INPUT', {
+                reason: 'docx-render-data-invalid'
+            });
+        }
+        renderData = validated.data;
+    }
+    // Step 2: Load template from registry
+    const entry = registry.get(templateId);
+    const zip = new PizZip(entry.content);
+    // Step 3: Parse and render template. nullGetter maps any missing scalar/section to ''
+    // — NEVER the literal string 'undefined' on the customer-facing document.
+    const doc = new Docxtemplater(zip, {
+        paragraphLoop: true,
+        linebreaks: true,
+        nullGetter: () => ''
+    });
+    doc.render(renderData);
+    // Step 4: Generate output buffer
+    return doc.toBuffer();
+}
+/**
+ * Generate a document with schema registered for the template ID.
+ * Looks up schema from the schema registry by templateId.
+ */
+export function generateDocumentWithRegisteredSchema(templateId, data, options) {
+    const { registry, schemaRegistry } = options;
+    const entry = schemaRegistry.get(templateId);
+    if (!entry) {
+        throw new CapabilityError(`No schema registered for template: ${templateId}. ` +
+            `Register it on the supplied DocumentSchemaRegistry or pass schema to generateDocument().`, 'NOT_FOUND', { reason: 'docx-template-schema-not-found' });
+    }
+    return generateDocument(templateId, data, { schema: entry.schema, registry, runtime: schemaRegistry.runtime });
+}
+//# sourceMappingURL=generator.js.map

package/dist/documents/docx/generator.js.map

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

package/dist/documents/docx/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @vibesdotdev/docs/documents/docx
+ *
+ * Document generation package with docxtemplater integration.
+ * Template-based DOCX generation with data binding.
+ *
+ */
+export { DocumentSchemaRegistry, createDocumentSchemaRegistry, generateDocument, generateDocumentWithRegisteredSchema } from './generator.ts';
+export type { GenerateDocumentOptions } from './schemas/generator.ts';
+export { extractTextFromDocx } from './extract.ts';
+export type { ExtractDocxTextOptions, ExtractDocxTextResult } from './extract.ts';
+export { defaultRegistry, createTemplateRegistry } from './templates/index.ts';
+export type { GenerateOptions, TemplateEntry, TemplateListEntry, TemplateRegistry } from './templates/index.ts';
+export type { GenerateDocumentOptions as SchemaGenerateDocumentOptions, SchemaEntry } from './schemas/index.ts';
+export { getVibesDocxClient, createDocxClient } from './client.ts';
+export type { DocxClient } from './client.ts';
+export { docxPlugin } from './plugin/docx.plugin.ts';
+export { docxTemplateKind, docxSchemaKind } from './kinds.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/documents/docx/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/documents/docx/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACN,sBAAsB,EACtB,4BAA4B,EAC5B,gBAAgB,EAChB,oCAAoC,EACpC,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGlF,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,YAAY,EACX,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACX,uBAAuB,IAAI,6BAA6B,EACxD,WAAW,EACX,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/documents/docx/index.js

@@ -0,0 +1,16 @@
+/**
+ * @vibesdotdev/docs/documents/docx
+ *
+ * Document generation package with docxtemplater integration.
+ * Template-based DOCX generation with data binding.
+ *
+ */
+// Public API
+export { DocumentSchemaRegistry, createDocumentSchemaRegistry, generateDocument, generateDocumentWithRegisteredSchema } from "./generator.js";
+export { extractTextFromDocx } from "./extract.js";
+// Template management
+export { defaultRegistry, createTemplateRegistry } from "./templates/index.js";
+export { getVibesDocxClient, createDocxClient } from "./client.js";
+export { docxPlugin } from "./plugin/docx.plugin.js";
+export { docxTemplateKind, docxSchemaKind } from "./kinds.js";
+//# sourceMappingURL=index.js.map

package/dist/documents/docx/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/documents/docx/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,aAAa;AACb,OAAO,EACN,sBAAsB,EACtB,4BAA4B,EAC5B,gBAAgB,EAChB,oCAAoC,EACpC,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD,sBAAsB;AACtB,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAc/E,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/documents/docx/kinds.d.ts

@@ -0,0 +1,10 @@
+export declare const docxTemplateKind: import("@vibesdotdev/kernel").RuntimeKindDescriptorRecord<{
+    id: string;
+    content: Buffer<ArrayBufferLike>;
+    description: string;
+}>;
+export declare const docxSchemaKind: import("@vibesdotdev/kernel").RuntimeKindDescriptorRecord<{
+    schema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+    description: string;
+}>;
+//# sourceMappingURL=kinds.d.ts.map

package/dist/documents/docx/kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../../../src/documents/docx/kinds.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,gBAAgB;;;;EAG3B,CAAC;AACH,eAAO,MAAM,cAAc;;;EAGzB,CAAC"}

package/dist/documents/docx/kinds.js

@@ -0,0 +1,11 @@
+import { createRuntimeKind } from '@vibesdotdev/kernel';
+import { DocxTemplateDescriptorSchema, DocxSchemaDescriptorSchema } from "./schemas/runtime.js";
+export const docxTemplateKind = createRuntimeKind({
+    id: 'docx/template',
+    descriptorSchema: DocxTemplateDescriptorSchema
+});
+export const docxSchemaKind = createRuntimeKind({
+    id: 'docx/schema',
+    descriptorSchema: DocxSchemaDescriptorSchema
+});
+//# sourceMappingURL=kinds.js.map