office-open 0.14.5 → 0.14.6

package/dist/ai/index.d.mts

@@ -3,26 +3,26 @@ import { DocumentOptions } from "@office-open/docx";
 import { PresentationOptions } from "@office-open/pptx";
 import { WorkbookOptions } from "@office-open/xlsx";
 //#region src/ai/error.d.ts
-declare function formatToolError(type: string, error: unknown): string;
+export declare function formatToolError(type: string, error: unknown): string;
 //#endregion
 //#region src/ai/index.d.ts
-interface SchemaLookupInput {
+export interface SchemaLookupInput {
   type: DocumentType;
   definitions: string[];
 }
-declare const docxTool: import("ai").Tool<DocumentOptions, {
+export declare const docxTool: import("ai").Tool<DocumentOptions, {
   base64: string;
   mimeType: string;
 }>;
-declare const pptxTool: import("ai").Tool<PresentationOptions, {
+export declare const pptxTool: import("ai").Tool<PresentationOptions, {
   base64: string;
   mimeType: string;
 }>;
-declare const xlsxTool: import("ai").Tool<WorkbookOptions, {
+export declare const xlsxTool: import("ai").Tool<WorkbookOptions, {
   base64: string;
   mimeType: string;
 }>;
-declare const schemaLookupTool: import("ai").Tool<SchemaLookupInput, {
+export declare const schemaLookupTool: import("ai").Tool<SchemaLookupInput, {
   type: DocumentType;
   requested: string[];
   typeText: string;
@@ -35,7 +35,7 @@ declare const schemaLookupTool: import("ai").Tool<SchemaLookupInput, {
   suggestions: readonly string[];
   typeText?: undefined;
 }>;
-declare const officeOpenTools: {
+export declare const officeOpenTools: {
   readonly "generate-docx": import("ai").Tool<DocumentOptions, {
     base64: string;
     mimeType: string;
@@ -63,5 +63,4 @@ declare const officeOpenTools: {
   }>;
 };
 //#endregion
-export { SchemaLookupInput, docxTool, formatToolError, officeOpenTools, pptxTool, schemaLookupTool, xlsxTool };
 //# sourceMappingURL=index.d.mts.map

package/dist/ai/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/ai/error.ts","../../src/ai/index.ts"],"mappings":";;;;;iBAWgB,gBAAgB,cAAc;;;UCuB7B;EACf,MAAM;EACN;;cAkBW,uBAAQ,KAAA;;;;cA6BR,uBAAQ,KAAA;;;;cA6BR,uBAAQ,KAAA;;;;cAqCR,+BAAgB,KAAA;;;;;;;;;;;;;cAyDhB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/ai/error.ts","../../src/ai/index.ts"],"mappings":";;;;;wBAWgB,gBAAgB,cAAc;;;iBCuB7B;EACf,MAAM;EACN;;qBAkBW,uBAAQ,KAAA;;;;qBA6BR,uBAAQ,KAAA;;;;qBA6BR,uBAAQ,KAAA;;;;qBAqCR,+BAAgB,KAAA;;;;;;;;;;;;;qBAyDhB"}

package/dist/ai/index.mjs

@@ -51,6 +51,7 @@ function generateVerifiedBase64(type, bytes) {
 }
 //#endregion
 //#region src/ai/index.ts
+const SKELETON_GUIDANCE = "This schema is a skeleton — stubs name the definition they stand for. Fetch real fields with the office-open-schema-lookup tool, e.g. { type: 'docx', definitions: ['ParagraphOptions', 'RunOptions'] }. Invalid input is rejected with instance-path errors; fix and retry.";
 /**
 * The generate tools return the file as base64 for the client UI, but the
 * model only needs the outcome — full base64 in the model context would burn
@@ -61,7 +62,7 @@ function documentGeneratedSummary(output) {
 	return `Document generated and all validations passed (${output.mimeType}, ${kb} KB).`;
 }
 const docxTool = tool({
-	description: "Generate a .docx Word document. The input is the document options directly — must include a 'sections' array. Conventions: section children are wrapper-key objects ({ paragraph: {...} }, { table: {...} }, …); run objects require a 'text' key (plain strings also accepted); colors are hex WITHOUT '#': 'FF0000', not '#FF0000'. This schema is a skeleton — stubs name the definition they stand for. Fetch real fields with the office-open-schema-lookup tool, e.g. { type: 'docx', definitions: ['ParagraphOptions', 'RunOptions'] }. Invalid input is rejected with instance-path errors; fix and retry.",
+	description: "Generate a .docx Word document. The input is the document options directly — must include a 'sections' array. Conventions: section children are wrapper-key objects ({ paragraph: {...} }, { table: {...} }, …); run objects require a 'text' key (plain strings also accepted); colors are hex WITHOUT '#': 'FF0000', not '#FF0000'. " + SKELETON_GUIDANCE,
 	inputSchema: jsonSchema(getSkeletonSchema("docx")),
 	execute: async (options) => {
 		try {
@@ -84,7 +85,7 @@ const docxTool = tool({
 	})
 });
 const pptxTool = tool({
-	description: "Generate a .pptx PowerPoint presentation. The input is the presentation options directly — must include a 'slides' array. Conventions: shape x/y/width/height take UniversalMeasure strings ('2cm', '1in', '96px') or raw EMU numbers (914400 = 1 inch); fills are hex color strings or fill objects ('4472C4' or { type: 'solidFill', color: '4472C4' }); colors are hex WITHOUT '#': 'FF0000', not '#FF0000'. This schema is a skeleton — stubs name the definition they stand for. Fetch real fields with the office-open-schema-lookup tool, e.g. { type: 'docx', definitions: ['ParagraphOptions', 'RunOptions'] }. Invalid input is rejected with instance-path errors; fix and retry.",
+	description: "Generate a .pptx PowerPoint presentation. The input is the presentation options directly — must include a 'slides' array. Conventions: shape x/y/width/height take UniversalMeasure strings ('2cm', '1in', '96px') or raw EMU numbers (914400 = 1 inch); fills are hex color strings or fill objects ('4472C4' or { type: 'solidFill', color: '4472C4' }); colors are hex WITHOUT '#': 'FF0000', not '#FF0000'. " + SKELETON_GUIDANCE,
 	inputSchema: jsonSchema(getSkeletonSchema("pptx")),
 	execute: async (options) => {
 		try {
@@ -107,7 +108,7 @@ const pptxTool = tool({
 	})
 });
 const xlsxTool = tool({
-	description: "Generate a .xlsx Excel spreadsheet. The input is the workbook options directly — must include a 'worksheets' array. Conventions: cells are shorthand values (string, number, boolean, null) or { value, style } objects; column 'width' is in Excel character units. This schema is a skeleton — stubs name the definition they stand for. Fetch real fields with the office-open-schema-lookup tool, e.g. { type: 'docx', definitions: ['ParagraphOptions', 'RunOptions'] }. Invalid input is rejected with instance-path errors; fix and retry.",
+	description: "Generate a .xlsx Excel spreadsheet. The input is the workbook options directly — must include a 'worksheets' array. Conventions: cells are shorthand values (string, number, boolean, null) or { value, style } objects; column 'width' is in Excel character units. " + SKELETON_GUIDANCE,
 	inputSchema: jsonSchema(getSkeletonSchema("xlsx")),
 	execute: async (options) => {
 		try {

package/dist/ai/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/ai/error.ts","../../src/ai/verify.ts","../../src/ai/index.ts"],"sourcesContent":["/**\n * Format tool execution errors into LLM-friendly messages.\n *\n * When a tool's `execute` function throws, the AI SDK captures the error as a\n * `tool-error` content part and sends it back to the LLM for self-correction.\n * This module rewrites internal runtime errors into messages the LLM can\n * understand and act on.\n *\n * @module\n */\n\nexport function formatToolError(type: string, error: unknown): string {\n  const msg = error instanceof Error ? error.message : String(error);\n\n  // ── DOCX: paragraph child errors ──\n\n  if (msg.includes(\"Unsupported paragraph child type:\")) {\n    const keys = msg.split(\": \").pop() ?? \"\";\n    return (\n      `Invalid paragraph child \"${keys}\". ` +\n      `Paragraph children must use a wrapper key: ` +\n      `{ paragraph: { children: [{ text: \"...\", bold?: true }] } }, ` +\n      `{ table: { rows: [...] } }, { picture: { ... } }, ` +\n      `{ toc: { ... } }, { textbox: { ... } }, ` +\n      `{ pageBreak: true }, { columnBreak: true }, etc. ` +\n      `Do not use raw property names like { bold: ... } as paragraph children.`\n    );\n  }\n\n  if (msg.includes(\"Unsupported run child type:\")) {\n    const keys = msg.split(\": \").pop() ?? \"\";\n    return (\n      `Invalid run child \"${keys}\". ` +\n      `Run children must be text objects: { text: \"...\", bold?: true, italic?: true, size?: number, color?: \"RRGGBB\", ... }. ` +\n      `The \"text\" key is required. Plain strings are also accepted as children. ` +\n      `Do not use bare property objects like { bold: true } without a \"text\" key.`\n    );\n  }\n\n  if (msg.includes(\"Unknown section child type\")) {\n    return (\n      `Unknown section child. ` +\n      `Section children must use a wrapper key: ` +\n      `{ paragraph: { ... } }, { table: { ... } }, ` +\n      `{ toc: { ... } }, { textbox: { ... } }, { pageBreak: true }, ` +\n      `{ sdt: { ... } }, { altChunk: { ... } }, etc.`\n    );\n  }\n\n  // ── General: iterable errors ──\n\n  if (msg.includes(\"not iterable\")) {\n    const field = type === \"docx\" ? \"sections\" : type === \"pptx\" ? \"slides\" : \"worksheets\";\n    return `\"${field}\" must be an array. Received a non-iterable value.`;\n  }\n\n  // ── Fallback ──\n\n  return `${type.toUpperCase()} generation failed: ${msg}`;\n}\n","/**\n * Post-generation gate for the AI tools: run the OPC package consistency check\n * on freshly generated bytes before handing them to the model.\n *\n * Fresh output is fully under library control, so ANY issue (error or warn) is\n * a library regression, not an options error — fail fast with the diagnosis\n * instead of shipping a file Word/Excel report as corrupt. Mirrors what\n * scripts/validate.ts runs in CI; O7-style duplicate relationship ids are\n * exactly the class of breakage this catches before a user sees it.\n *\n * @module\n */\nimport {\n  encodeBase64,\n  PART_REGISTRIES,\n  unzipSync,\n  validateOpcConsistency,\n} from \"@office-open/core\";\n\nimport type { GenerateType } from \"../generate\";\n\n// Binary parts (media, fonts) decode to replacement chars — the check only\n// reads part presence and paths, never their content.\nconst decoder = new TextDecoder(\"utf-8\", { fatal: false });\n\n/** OPC-check a fresh package and return it as base64 for the tool result. */\nexport function generateVerifiedBase64(type: GenerateType, bytes: Uint8Array): string {\n  const files = unzipSync(bytes);\n  const entries = new Map<string, string>();\n  for (const name of Object.keys(files)) {\n    entries.set(name, decoder.decode(files[name]));\n  }\n  const issues = validateOpcConsistency(entries, PART_REGISTRIES[type]!);\n  if (issues.length > 0) {\n    const lines = issues.map((i) => `  ${i.code} [${i.severity}] ${i.part}: ${i.message}`);\n    throw new Error(\n      `Generated ${type} failed the OPC package consistency check — your options are valid, ` +\n        `this is an office-open bug; please report it:\\n${lines.join(\"\\n\")}`,\n    );\n  }\n  return encodeBase64(bytes);\n}\n","/**\n * Vercel AI SDK tools for generating Office documents.\n *\n * The generate tools use skeleton input schemas (top-level shape + wrapper\n * keys only) instead of the full format schema (~675 KB for docx) — no\n * provider accepts that in a tool definition. Precise field schemas are\n * fetched on demand through the office-open-schema-lookup tool, and the\n * authoritative ajv validation runs inside execute with instancePath-\n * qualified errors the model can iterate on.\n *\n * @module\n */\nimport type { DocumentOptions } from \"@office-open/docx\";\nimport type { PresentationOptions } from \"@office-open/pptx\";\nimport type { WorkbookOptions } from \"@office-open/xlsx\";\nimport { jsonSchema, tool } from \"ai\";\n\nexport { formatToolError } from \"./error\";\n\nimport { lintWorkbookFormulas } from \"@office-open/xlsx\";\n\nimport { generate } from \"../generate\";\nimport {\n  getSkeletonSchema,\n  renderSliceTypeText,\n  sliceDocumentSchema,\n  validateDocumentInput,\n} from \"../schemas\";\nimport type { DocumentType } from \"../schemas/schemas\";\nimport { UnknownDefinitionError } from \"../schemas/slice\";\nimport { formatToolError } from \"./error\";\nimport { generateVerifiedBase64 } from \"./verify\";\n\n/** Input accepted by the office-open-schema-lookup tool. */\nexport interface SchemaLookupInput {\n  type: DocumentType;\n  definitions: string[];\n}\n\nconst SKELETON_GUIDANCE =\n  \"This schema is a skeleton — stubs name the definition they stand for. Fetch real fields with the \" +\n  \"office-open-schema-lookup tool, e.g. { type: 'docx', definitions: ['ParagraphOptions', 'RunOptions'] }. \" +\n  \"Invalid input is rejected with instance-path errors; fix and retry.\";\n\n/**\n * The generate tools return the file as base64 for the client UI, but the\n * model only needs the outcome — full base64 in the model context would burn\n * thousands of tokens per document.\n */\nfunction documentGeneratedSummary(output: { base64: string; mimeType: string }): string {\n  const kb = Math.ceil((output.base64.length * 3) / 4 / 1024);\n  return `Document generated and all validations passed (${output.mimeType}, ${kb} KB).`;\n}\n\nexport const docxTool = tool({\n  description:\n    \"Generate a .docx Word document. \" +\n    \"The input is the document options directly — must include a 'sections' array. \" +\n    \"Conventions: \" +\n    \"section children are wrapper-key objects ({ paragraph: {...} }, { table: {...} }, …); \" +\n    \"run objects require a 'text' key (plain strings also accepted); \" +\n    \"colors are hex WITHOUT '#': 'FF0000', not '#FF0000'. \" +\n    SKELETON_GUIDANCE,\n  inputSchema: jsonSchema<DocumentOptions>(getSkeletonSchema(\"docx\")),\n  execute: async (options) => {\n    try {\n      const validated = validateDocumentInput(\"docx\", options);\n      const bytes = (await generate({\n        type: \"docx\",\n        options: validated as unknown as DocumentOptions,\n        outputType: \"uint8array\",\n      })) as Uint8Array;\n      return {\n        base64: generateVerifiedBase64(\"docx\", bytes),\n        mimeType: \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n      };\n    } catch (error) {\n      throw new Error(formatToolError(\"docx\", error));\n    }\n  },\n  toModelOutput: ({ output }) => ({ type: \"text\", value: documentGeneratedSummary(output) }),\n});\n\nexport const pptxTool = tool({\n  description:\n    \"Generate a .pptx PowerPoint presentation. \" +\n    \"The input is the presentation options directly — must include a 'slides' array. \" +\n    \"Conventions: \" +\n    \"shape x/y/width/height take UniversalMeasure strings ('2cm', '1in', '96px') or raw EMU numbers (914400 = 1 inch); \" +\n    \"fills are hex color strings or fill objects ('4472C4' or { type: 'solidFill', color: '4472C4' }); \" +\n    \"colors are hex WITHOUT '#': 'FF0000', not '#FF0000'. \" +\n    SKELETON_GUIDANCE,\n  inputSchema: jsonSchema<PresentationOptions>(getSkeletonSchema(\"pptx\")),\n  execute: async (options) => {\n    try {\n      const validated = validateDocumentInput(\"pptx\", options);\n      const bytes = (await generate({\n        type: \"pptx\",\n        options: validated as unknown as PresentationOptions,\n        outputType: \"uint8array\",\n      })) as Uint8Array;\n      return {\n        base64: generateVerifiedBase64(\"pptx\", bytes),\n        mimeType: \"application/vnd.openxmlformats-officedocument.presentationml.presentation\",\n      };\n    } catch (error) {\n      throw new Error(formatToolError(\"pptx\", error));\n    }\n  },\n  toModelOutput: ({ output }) => ({ type: \"text\", value: documentGeneratedSummary(output) }),\n});\n\nexport const xlsxTool = tool({\n  description:\n    \"Generate a .xlsx Excel spreadsheet. \" +\n    \"The input is the workbook options directly — must include a 'worksheets' array. \" +\n    \"Conventions: \" +\n    \"cells are shorthand values (string, number, boolean, null) or { value, style } objects; \" +\n    \"column 'width' is in Excel character units. \" +\n    SKELETON_GUIDANCE,\n  inputSchema: jsonSchema<WorkbookOptions>(getSkeletonSchema(\"xlsx\")),\n  execute: async (options) => {\n    try {\n      const validated = validateDocumentInput(\"xlsx\", options);\n      const formulaIssues = lintWorkbookFormulas(validated as unknown as WorkbookOptions);\n      if (formulaIssues.length > 0) {\n        const lines = formulaIssues.map(\n          (i) => `  ${i.location}: ${i.message} — formula \"${i.formula}\"`,\n        );\n        throw new Error(\n          `Invalid xlsx formulas:\\n${lines.join(\"\\n\")}\\nFix the formula or add the missing worksheet.`,\n        );\n      }\n      const bytes = (await generate({\n        type: \"xlsx\",\n        options: validated as unknown as WorkbookOptions,\n        outputType: \"uint8array\",\n      })) as Uint8Array;\n      return {\n        base64: generateVerifiedBase64(\"xlsx\", bytes),\n        mimeType: \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n      };\n    } catch (error) {\n      throw new Error(formatToolError(\"xlsx\", error));\n    }\n  },\n  toModelOutput: ({ output }) => ({ type: \"text\", value: documentGeneratedSummary(output) }),\n});\n\nexport const schemaLookupTool = tool({\n  description:\n    \"Fetch the precise type definitions for office-open option fields on demand. \" +\n    \"Use it before filling complex objects into the generate tools: the generate input schemas are \" +\n    \"skeletons whose stubs name the definition to look up here. \" +\n    \"Valid names come from the skeleton stubs, or list indexed entries with \" +\n    \"`npx office-open schema index <type>` (all names with --all). \" +\n    \"Returns the requested definitions plus their dependency closure as type-definition text \" +\n    '(field types, \"a\" | \"b\" value enums, optional markers, one-line comments); cataloged ' +\n    \"domains not requested stay as stubs, so request each domain root you need (e.g. \" +\n    \"['ParagraphOptions', 'RunOptions', 'TableOptions']).\",\n  inputSchema: jsonSchema<SchemaLookupInput>({\n    type: \"object\",\n    additionalProperties: false,\n    required: [\"type\", \"definitions\"],\n    properties: {\n      type: {\n        type: \"string\",\n        enum: [\"docx\", \"pptx\", \"xlsx\"],\n        description: \"Document format whose schema to slice\",\n      },\n      definitions: {\n        type: \"array\",\n        items: { type: \"string\" },\n        minItems: 1,\n        maxItems: 8,\n        description:\n          \"Definition names (TS type names, e.g. ParagraphOptions, SlideOptions, StyleOptions). \" +\n          \"At most 8 per call.\",\n      },\n    },\n  }),\n  execute: async ({ type, definitions }) => {\n    try {\n      const slice = sliceDocumentSchema(type, definitions);\n      return {\n        type,\n        requested: definitions,\n        typeText: renderSliceTypeText(type, definitions, slice),\n      };\n    } catch (error) {\n      if (error instanceof UnknownDefinitionError) {\n        // Data, not a throw: lets the model self-correct from the suggestions.\n        return {\n          type,\n          requested: definitions,\n          error:\n            `${error.message}. Closest: ${error.suggestions.join(\", \") || \"none\"}. ` +\n            `List indexed entries with: npx office-open schema index ${type}`,\n          suggestions: error.suggestions,\n        };\n      }\n      throw error;\n    }\n  },\n});\n\nexport const officeOpenTools = {\n  \"generate-docx\": docxTool,\n  \"generate-pptx\": pptxTool,\n  \"generate-xlsx\": xlsxTool,\n  \"office-open-schema-lookup\": schemaLookupTool,\n} as const;\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/ai/error.ts","../../src/ai/verify.ts","../../src/ai/index.ts"],"sourcesContent":["/**\n * Format tool execution errors into LLM-friendly messages.\n *\n * When a tool's `execute` function throws, the AI SDK captures the error as a\n * `tool-error` content part and sends it back to the LLM for self-correction.\n * This module rewrites internal runtime errors into messages the LLM can\n * understand and act on.\n *\n * @module\n */\n\nexport function formatToolError(type: string, error: unknown): string {\n  const msg = error instanceof Error ? error.message : String(error);\n\n  // ── DOCX: paragraph child errors ──\n\n  if (msg.includes(\"Unsupported paragraph child type:\")) {\n    const keys = msg.split(\": \").pop() ?? \"\";\n    return (\n      `Invalid paragraph child \"${keys}\". ` +\n      `Paragraph children must use a wrapper key: ` +\n      `{ paragraph: { children: [{ text: \"...\", bold?: true }] } }, ` +\n      `{ table: { rows: [...] } }, { picture: { ... } }, ` +\n      `{ toc: { ... } }, { textbox: { ... } }, ` +\n      `{ pageBreak: true }, { columnBreak: true }, etc. ` +\n      `Do not use raw property names like { bold: ... } as paragraph children.`\n    );\n  }\n\n  if (msg.includes(\"Unsupported run child type:\")) {\n    const keys = msg.split(\": \").pop() ?? \"\";\n    return (\n      `Invalid run child \"${keys}\". ` +\n      `Run children must be text objects: { text: \"...\", bold?: true, italic?: true, size?: number, color?: \"RRGGBB\", ... }. ` +\n      `The \"text\" key is required. Plain strings are also accepted as children. ` +\n      `Do not use bare property objects like { bold: true } without a \"text\" key.`\n    );\n  }\n\n  if (msg.includes(\"Unknown section child type\")) {\n    return (\n      `Unknown section child. ` +\n      `Section children must use a wrapper key: ` +\n      `{ paragraph: { ... } }, { table: { ... } }, ` +\n      `{ toc: { ... } }, { textbox: { ... } }, { pageBreak: true }, ` +\n      `{ sdt: { ... } }, { altChunk: { ... } }, etc.`\n    );\n  }\n\n  // ── General: iterable errors ──\n\n  if (msg.includes(\"not iterable\")) {\n    const field = type === \"docx\" ? \"sections\" : type === \"pptx\" ? \"slides\" : \"worksheets\";\n    return `\"${field}\" must be an array. Received a non-iterable value.`;\n  }\n\n  // ── Fallback ──\n\n  return `${type.toUpperCase()} generation failed: ${msg}`;\n}\n","/**\n * Post-generation gate for the AI tools: run the OPC package consistency check\n * on freshly generated bytes before handing them to the model.\n *\n * Fresh output is fully under library control, so ANY issue (error or warn) is\n * a library regression, not an options error — fail fast with the diagnosis\n * instead of shipping a file Word/Excel report as corrupt. Mirrors what\n * scripts/validate.ts runs in CI; O7-style duplicate relationship ids are\n * exactly the class of breakage this catches before a user sees it.\n *\n * @module\n */\nimport {\n  encodeBase64,\n  PART_REGISTRIES,\n  unzipSync,\n  validateOpcConsistency,\n} from \"@office-open/core\";\n\nimport type { GenerateType } from \"../generate\";\n\n// Binary parts (media, fonts) decode to replacement chars — the check only\n// reads part presence and paths, never their content.\nconst decoder = new TextDecoder(\"utf-8\", { fatal: false });\n\n/** OPC-check a fresh package and return it as base64 for the tool result. */\nexport function generateVerifiedBase64(type: GenerateType, bytes: Uint8Array): string {\n  const files = unzipSync(bytes);\n  const entries = new Map<string, string>();\n  for (const name of Object.keys(files)) {\n    entries.set(name, decoder.decode(files[name]));\n  }\n  const issues = validateOpcConsistency(entries, PART_REGISTRIES[type]!);\n  if (issues.length > 0) {\n    const lines = issues.map((i) => `  ${i.code} [${i.severity}] ${i.part}: ${i.message}`);\n    throw new Error(\n      `Generated ${type} failed the OPC package consistency check — your options are valid, ` +\n        `this is an office-open bug; please report it:\\n${lines.join(\"\\n\")}`,\n    );\n  }\n  return encodeBase64(bytes);\n}\n","/**\n * Vercel AI SDK tools for generating Office documents.\n *\n * The generate tools use skeleton input schemas (top-level shape + wrapper\n * keys only) instead of the full format schema (~675 KB for docx) — no\n * provider accepts that in a tool definition. Precise field schemas are\n * fetched on demand through the office-open-schema-lookup tool, and the\n * authoritative ajv validation runs inside execute with instancePath-\n * qualified errors the model can iterate on.\n *\n * @module\n */\nimport type { DocumentOptions } from \"@office-open/docx\";\nimport type { PresentationOptions } from \"@office-open/pptx\";\nimport type { WorkbookOptions } from \"@office-open/xlsx\";\nimport { jsonSchema, tool } from \"ai\";\n\nexport { formatToolError } from \"./error\";\n\nimport { lintWorkbookFormulas } from \"@office-open/xlsx\";\n\nimport { generate } from \"../generate\";\nimport {\n  getSkeletonSchema,\n  renderSliceTypeText,\n  sliceDocumentSchema,\n  validateDocumentInput,\n} from \"../schemas\";\nimport type { DocumentType } from \"../schemas/schemas\";\nimport { UnknownDefinitionError } from \"../schemas/slice\";\nimport { formatToolError } from \"./error\";\nimport { generateVerifiedBase64 } from \"./verify\";\n\n/** Input accepted by the office-open-schema-lookup tool. */\nexport interface SchemaLookupInput {\n  type: DocumentType;\n  definitions: string[];\n}\n\nconst SKELETON_GUIDANCE =\n  \"This schema is a skeleton — stubs name the definition they stand for. Fetch real fields with the \" +\n  \"office-open-schema-lookup tool, e.g. { type: 'docx', definitions: ['ParagraphOptions', 'RunOptions'] }. \" +\n  \"Invalid input is rejected with instance-path errors; fix and retry.\";\n\n/**\n * The generate tools return the file as base64 for the client UI, but the\n * model only needs the outcome — full base64 in the model context would burn\n * thousands of tokens per document.\n */\nfunction documentGeneratedSummary(output: { base64: string; mimeType: string }): string {\n  const kb = Math.ceil((output.base64.length * 3) / 4 / 1024);\n  return `Document generated and all validations passed (${output.mimeType}, ${kb} KB).`;\n}\n\nexport const docxTool = tool({\n  description:\n    \"Generate a .docx Word document. \" +\n    \"The input is the document options directly — must include a 'sections' array. \" +\n    \"Conventions: \" +\n    \"section children are wrapper-key objects ({ paragraph: {...} }, { table: {...} }, …); \" +\n    \"run objects require a 'text' key (plain strings also accepted); \" +\n    \"colors are hex WITHOUT '#': 'FF0000', not '#FF0000'. \" +\n    SKELETON_GUIDANCE,\n  inputSchema: jsonSchema<DocumentOptions>(getSkeletonSchema(\"docx\")),\n  execute: async (options) => {\n    try {\n      const validated = validateDocumentInput(\"docx\", options);\n      const bytes = (await generate({\n        type: \"docx\",\n        options: validated as unknown as DocumentOptions,\n        outputType: \"uint8array\",\n      })) as Uint8Array;\n      return {\n        base64: generateVerifiedBase64(\"docx\", bytes),\n        mimeType: \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n      };\n    } catch (error) {\n      throw new Error(formatToolError(\"docx\", error));\n    }\n  },\n  toModelOutput: ({ output }) => ({ type: \"text\", value: documentGeneratedSummary(output) }),\n});\n\nexport const pptxTool = tool({\n  description:\n    \"Generate a .pptx PowerPoint presentation. \" +\n    \"The input is the presentation options directly — must include a 'slides' array. \" +\n    \"Conventions: \" +\n    \"shape x/y/width/height take UniversalMeasure strings ('2cm', '1in', '96px') or raw EMU numbers (914400 = 1 inch); \" +\n    \"fills are hex color strings or fill objects ('4472C4' or { type: 'solidFill', color: '4472C4' }); \" +\n    \"colors are hex WITHOUT '#': 'FF0000', not '#FF0000'. \" +\n    SKELETON_GUIDANCE,\n  inputSchema: jsonSchema<PresentationOptions>(getSkeletonSchema(\"pptx\")),\n  execute: async (options) => {\n    try {\n      const validated = validateDocumentInput(\"pptx\", options);\n      const bytes = (await generate({\n        type: \"pptx\",\n        options: validated as unknown as PresentationOptions,\n        outputType: \"uint8array\",\n      })) as Uint8Array;\n      return {\n        base64: generateVerifiedBase64(\"pptx\", bytes),\n        mimeType: \"application/vnd.openxmlformats-officedocument.presentationml.presentation\",\n      };\n    } catch (error) {\n      throw new Error(formatToolError(\"pptx\", error));\n    }\n  },\n  toModelOutput: ({ output }) => ({ type: \"text\", value: documentGeneratedSummary(output) }),\n});\n\nexport const xlsxTool = tool({\n  description:\n    \"Generate a .xlsx Excel spreadsheet. \" +\n    \"The input is the workbook options directly — must include a 'worksheets' array. \" +\n    \"Conventions: \" +\n    \"cells are shorthand values (string, number, boolean, null) or { value, style } objects; \" +\n    \"column 'width' is in Excel character units. \" +\n    SKELETON_GUIDANCE,\n  inputSchema: jsonSchema<WorkbookOptions>(getSkeletonSchema(\"xlsx\")),\n  execute: async (options) => {\n    try {\n      const validated = validateDocumentInput(\"xlsx\", options);\n      const formulaIssues = lintWorkbookFormulas(validated as unknown as WorkbookOptions);\n      if (formulaIssues.length > 0) {\n        const lines = formulaIssues.map(\n          (i) => `  ${i.location}: ${i.message} — formula \"${i.formula}\"`,\n        );\n        throw new Error(\n          `Invalid xlsx formulas:\\n${lines.join(\"\\n\")}\\nFix the formula or add the missing worksheet.`,\n        );\n      }\n      const bytes = (await generate({\n        type: \"xlsx\",\n        options: validated as unknown as WorkbookOptions,\n        outputType: \"uint8array\",\n      })) as Uint8Array;\n      return {\n        base64: generateVerifiedBase64(\"xlsx\", bytes),\n        mimeType: \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n      };\n    } catch (error) {\n      throw new Error(formatToolError(\"xlsx\", error));\n    }\n  },\n  toModelOutput: ({ output }) => ({ type: \"text\", value: documentGeneratedSummary(output) }),\n});\n\nexport const schemaLookupTool = tool({\n  description:\n    \"Fetch the precise type definitions for office-open option fields on demand. \" +\n    \"Use it before filling complex objects into the generate tools: the generate input schemas are \" +\n    \"skeletons whose stubs name the definition to look up here. \" +\n    \"Valid names come from the skeleton stubs, or list indexed entries with \" +\n    \"`npx office-open schema index <type>` (all names with --all). \" +\n    \"Returns the requested definitions plus their dependency closure as type-definition text \" +\n    '(field types, \"a\" | \"b\" value enums, optional markers, one-line comments); cataloged ' +\n    \"domains not requested stay as stubs, so request each domain root you need (e.g. \" +\n    \"['ParagraphOptions', 'RunOptions', 'TableOptions']).\",\n  inputSchema: jsonSchema<SchemaLookupInput>({\n    type: \"object\",\n    additionalProperties: false,\n    required: [\"type\", \"definitions\"],\n    properties: {\n      type: {\n        type: \"string\",\n        enum: [\"docx\", \"pptx\", \"xlsx\"],\n        description: \"Document format whose schema to slice\",\n      },\n      definitions: {\n        type: \"array\",\n        items: { type: \"string\" },\n        minItems: 1,\n        maxItems: 8,\n        description:\n          \"Definition names (TS type names, e.g. ParagraphOptions, SlideOptions, StyleOptions). \" +\n          \"At most 8 per call.\",\n      },\n    },\n  }),\n  execute: async ({ type, definitions }) => {\n    try {\n      const slice = sliceDocumentSchema(type, definitions);\n      return {\n        type,\n        requested: definitions,\n        typeText: renderSliceTypeText(type, definitions, slice),\n      };\n    } catch (error) {\n      if (error instanceof UnknownDefinitionError) {\n        // Data, not a throw: lets the model self-correct from the suggestions.\n        return {\n          type,\n          requested: definitions,\n          error:\n            `${error.message}. Closest: ${error.suggestions.join(\", \") || \"none\"}. ` +\n            `List indexed entries with: npx office-open schema index ${type}`,\n          suggestions: error.suggestions,\n        };\n      }\n      throw error;\n    }\n  },\n});\n\nexport const officeOpenTools = {\n  \"generate-docx\": docxTool,\n  \"generate-pptx\": pptxTool,\n  \"generate-xlsx\": xlsxTool,\n  \"office-open-schema-lookup\": schemaLookupTool,\n} as const;\n"],"mappings":"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"}

package/dist/convert/index.d.mts

@@ -4,16 +4,16 @@ import { ColumnOptions, ConnectorOptions as ConnectorOptions$1, GroupOptions as
 import { ParagraphDescriptorOptions, UniversalMeasure } from "@office-open/core";
 import { EffectDagOptions, EffectListOptions, FillOptions, OutlineOptions, PresetGeometryOptions, Scene3DOptions, Shape3DOptions, ShapeType, TextBodyOptions } from "@office-open/core/drawing";
 //#region src/convert/picture.d.ts
-declare function toDocxPicture(source: PictureOptions$1): PictureOptions;
-declare function toDocxPicture(source: PictureOptions$2): PictureOptions;
-declare function toPptxPicture(source: PictureOptions): PictureOptions$1;
-declare function toPptxPicture(source: PictureOptions$2): PictureOptions$1;
-declare function toXlsxPicture(source: PictureOptions): PictureOptions$2;
-declare function toXlsxPicture(source: PictureOptions$1): PictureOptions$2;
+export declare function toDocxPicture(source: PictureOptions$1): PictureOptions;
+export declare function toDocxPicture(source: PictureOptions$2): PictureOptions;
+export declare function toPptxPicture(source: PictureOptions): PictureOptions$1;
+export declare function toPptxPicture(source: PictureOptions$2): PictureOptions$1;
+export declare function toXlsxPicture(source: PictureOptions): PictureOptions$2;
+export declare function toXlsxPicture(source: PictureOptions$1): PictureOptions$2;
 //#endregion
 //#region src/convert/shape.d.ts
-type DocxShapeOptions = ShapeOptions;
-interface ShapeContent {
+export type DocxShapeOptions = ShapeOptions;
+export interface ShapeContent {
   fill?: FillOptions | null;
   outline?: OutlineOptions;
   effects?: EffectListOptions;
@@ -24,21 +24,21 @@ interface ShapeContent {
 type PickedContent = Omit<ShapeContent, "fill"> & {
   fill?: FillOptions;
 };
-declare function pickContent<T extends ShapeContent>(source: T): PickedContent;
-declare function toPresetGeometry(g: ShapeType | PresetGeometryOptions | undefined): PresetGeometryOptions | undefined;
-declare function textBodyToDocxChildren(textBody: TextBodyOptions): ParagraphOptions[] | string[];
-declare function docxToTextBody(children: ShapeTextBoxChild[] | undefined, bodyProperties: TextBodyOptions["bodyProperties"]): TextBodyOptions | undefined;
-interface DocxShapeParts {
+export declare function pickContent<T extends ShapeContent>(source: T): PickedContent;
+export declare function toPresetGeometry(g: ShapeType | PresetGeometryOptions | undefined): PresetGeometryOptions | undefined;
+export declare function textBodyToDocxChildren(textBody: TextBodyOptions): ParagraphOptions[] | string[];
+export declare function docxToTextBody(children: ShapeTextBoxChild[] | undefined, bodyProperties: TextBodyOptions["bodyProperties"]): TextBodyOptions | undefined;
+export interface DocxShapeParts {
   data: ShapeCoreOptions;
   transformation: MediaTransformation;
 }
-declare function toDocxShapeParts(source: ShapeOptions$1 | ShapeOptions$2): DocxShapeParts;
-declare function toDocxShape(source: ShapeOptions$1): DocxShapeOptions;
-declare function toDocxShape(source: ShapeOptions$2): DocxShapeOptions;
-declare function toPptxShape(source: DocxShapeOptions): ShapeOptions$1;
-declare function toPptxShape(source: ShapeOptions$2): ShapeOptions$1;
-declare function toXlsxShape(source: DocxShapeOptions): ShapeOptions$2;
-declare function toXlsxShape(source: ShapeOptions$1): ShapeOptions$2;
+export declare function toDocxShapeParts(source: ShapeOptions$1 | ShapeOptions$2): DocxShapeParts;
+export declare function toDocxShape(source: ShapeOptions$1): DocxShapeOptions;
+export declare function toDocxShape(source: ShapeOptions$2): DocxShapeOptions;
+export declare function toPptxShape(source: DocxShapeOptions): ShapeOptions$1;
+export declare function toPptxShape(source: ShapeOptions$2): ShapeOptions$1;
+export declare function toXlsxShape(source: DocxShapeOptions): ShapeOptions$2;
+export declare function toXlsxShape(source: ShapeOptions$1): ShapeOptions$2;
 //#endregion
 //#region src/convert/position.d.ts
 interface AbsoluteBox {
@@ -52,45 +52,44 @@ interface AbsoluteBox {
 }
 //#endregion
 //#region src/convert/connector.d.ts
-declare function endpointsToBox(x1: number | UniversalMeasure | undefined, y1: number | UniversalMeasure | undefined, x2: number | UniversalMeasure | undefined, y2: number | UniversalMeasure | undefined): AbsoluteBox;
-declare function boxToEndpoints(box: AbsoluteBox): {
+export declare function endpointsToBox(x1: number | UniversalMeasure | undefined, y1: number | UniversalMeasure | undefined, x2: number | UniversalMeasure | undefined, y2: number | UniversalMeasure | undefined): AbsoluteBox;
+export declare function boxToEndpoints(box: AbsoluteBox): {
   x1: number;
   y1: number;
   x2: number;
   y2: number;
 };
-declare function toDocxConnector(_source: ConnectorOptions | ConnectorOptions$1): undefined;
-declare function toPptxConnector(source: ConnectorOptions$1): ConnectorOptions;
-declare function toXlsxConnector(source: ConnectorOptions): ConnectorOptions$1;
+export declare function toDocxConnector(_source: ConnectorOptions | ConnectorOptions$1): undefined;
+export declare function toPptxConnector(source: ConnectorOptions$1): ConnectorOptions;
+export declare function toXlsxConnector(source: ConnectorOptions): ConnectorOptions$1;
 //#endregion
 //#region src/convert/group.d.ts
-declare function toDocxGroup(source: GroupOptions$1): GroupOptions;
-declare function toDocxGroup(source: GroupOptions$2): GroupOptions;
-declare function toPptxGroup(source: GroupOptions): GroupOptions$1;
-declare function toPptxGroup(source: GroupOptions$2): GroupOptions$1;
-declare function toXlsxGroup(source: GroupOptions): GroupOptions$2;
-declare function toXlsxGroup(source: GroupOptions$1): GroupOptions$2;
+export declare function toDocxGroup(source: GroupOptions$1): GroupOptions;
+export declare function toDocxGroup(source: GroupOptions$2): GroupOptions;
+export declare function toPptxGroup(source: GroupOptions): GroupOptions$1;
+export declare function toPptxGroup(source: GroupOptions$2): GroupOptions$1;
+export declare function toXlsxGroup(source: GroupOptions): GroupOptions$2;
+export declare function toXlsxGroup(source: GroupOptions$1): GroupOptions$2;
 //#endregion
 //#region src/convert/table.d.ts
-interface XlsxVisualTable {
+export interface XlsxVisualTable {
   rows: RowOptions[];
   mergeCells?: MergeCellOptions[];
   columns?: ColumnOptions[];
 }
-declare function toDocxTable(source: TableOptions$1): TableOptions;
-declare function toDocxTable(source: XlsxVisualTable): TableOptions;
-declare function toPptxTable(source: TableOptions): TableOptions$1;
-declare function toPptxTable(source: XlsxVisualTable): TableOptions$1;
-declare function toXlsxTable(source: TableOptions): XlsxVisualTable;
-declare function toXlsxTable(source: TableOptions$1): XlsxVisualTable;
+export declare function toDocxTable(source: TableOptions$1): TableOptions;
+export declare function toDocxTable(source: XlsxVisualTable): TableOptions;
+export declare function toPptxTable(source: TableOptions): TableOptions$1;
+export declare function toPptxTable(source: XlsxVisualTable): TableOptions$1;
+export declare function toXlsxTable(source: TableOptions): XlsxVisualTable;
+export declare function toXlsxTable(source: TableOptions$1): XlsxVisualTable;
 //#endregion
 //#region src/convert/smartart.d.ts
-declare function toDocxSmartArt(source: SmartArtOptions$1): SmartArtOptions;
-declare function toPptxSmartArt(source: SmartArtOptions): SmartArtOptions$1;
+export declare function toDocxSmartArt(source: SmartArtOptions$1): SmartArtOptions;
+export declare function toPptxSmartArt(source: SmartArtOptions): SmartArtOptions$1;
 //#endregion
 //#region src/convert/text.d.ts
-declare function fromDrawingParagraph(drawing: ParagraphDescriptorOptions): ParagraphOptions;
-declare function toDrawingParagraph(docx: ParagraphOptions): ParagraphDescriptorOptions;
+export declare function fromDrawingParagraph(drawing: ParagraphDescriptorOptions): ParagraphOptions;
+export declare function toDrawingParagraph(docx: ParagraphOptions): ParagraphDescriptorOptions;
 //#endregion
-export { DocxShapeOptions, DocxShapeParts, ShapeContent, XlsxVisualTable, boxToEndpoints, docxToTextBody, endpointsToBox, fromDrawingParagraph, pickContent, textBodyToDocxChildren, toDocxConnector, toDocxGroup, toDocxPicture, toDocxShape, toDocxShapeParts, toDocxSmartArt, toDocxTable, toDrawingParagraph, toPptxConnector, toPptxGroup, toPptxPicture, toPptxShape, toPptxSmartArt, toPptxTable, toPresetGeometry, toXlsxConnector, toXlsxGroup, toXlsxPicture, toXlsxShape, toXlsxTable };
 //# sourceMappingURL=index.d.mts.map

package/dist/convert/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/convert/picture.ts","../../src/convert/shape.ts","../../src/convert/position.ts","../../src/convert/connector.ts","../../src/convert/group.ts","../../src/convert/table.ts","../../src/convert/smartart.ts","../../src/convert/text.ts"],"mappings":";;;;;;iBAuHgB,cAAc,QAAQ,mBAAqB;iBAE3C,cAAc,QAAQ,mBAAqB;iBAuC3C,cAAc,QAAQ,iBAAqB;iBAE3C,cAAc,QAAQ,mBAAqB;iBAmC3C,cAAc,QAAQ,iBAAqB;iBAE3C,cAAc,QAAQ,mBAAqB;;;KClJ/C,mBAAmB;UAGd;EAEf,OAAO;EACP,UAAU;EACV,UAAU;EACV,YAAY;EACZ,UAAU;EACV,UAAU;;KAIP,gBAAgB,KAAK;EAA0B,OAAO;;iBAG3C,YAAY,UAAU,cAAc,QAAQ,IAAI;iBAehD,iBACd,GAAG,YAAY,oCACd;iBAQa,uBAAuB,UAAU,kBAAkB;iBAWnD,eACd,UAAU,iCACV,gBAAgB,oCACf;UAoCc;EACf,MAAM;EACN,gBAAgB;;iBA8BF,iBAAiB,QAAQ,iBAAmB,iBAAmB;iBAgD/D,YAAY,QAAQ,iBAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;iBASvC,YAAY,QAAQ,mBAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;iBA+CvC,YAAY,QAAQ,mBAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;;;UC5PtC;EACf;EACA;EACA;EACA;EACA;EACA;EACA;;;;iBCdc,eACd,aAAa,8BACb,aAAa,8BACb,aAAa,8BACb,aAAa,+BACZ;iBAgBa,eAAe,KAAK;EAClC;EACA;EACA;EACA;;iBAiBc,gBAAgB,SAAS,mBAAuB;iBAQhD,gBAAgB,QAAQ,qBAAuB;iBAyB/C,gBAAgB,QAAQ,mBAAuB;;;iBC6G/C,YAAY,QAAQ,iBAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;iBAsEvC,YAAY,QAAQ,eAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;iBAgEvC,YAAY,QAAQ,eAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;;;UC7RtC;EACf,MAAM;EACN,aAAa;EACb,UAAU;;iBAyMI,YAAY,QAAQ,iBAAmB;iBAEvC,YAAY,QAAQ,kBAAkB;iBA+EtC,YAAY,QAAQ,eAAmB;iBAEvC,YAAY,QAAQ,kBAAkB;iBA6DtC,YAAY,QAAQ,eAAmB;iBAEvC,YAAY,QAAQ,iBAAmB;;;iBClWvC,eAAe,QAAQ,oBAAe;iBAqBtC,eAAe,QAAQ,kBAAe;;;iBC2BtC,qBAAqB,SAAS,6BAA6B;iBA2H3D,mBAAmB,MAAM,mBAAmB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/convert/picture.ts","../../src/convert/shape.ts","../../src/convert/position.ts","../../src/convert/connector.ts","../../src/convert/group.ts","../../src/convert/table.ts","../../src/convert/smartart.ts","../../src/convert/text.ts"],"mappings":";;;;;;wBAuHgB,cAAc,QAAQ,mBAAqB;wBAE3C,cAAc,QAAQ,mBAAqB;wBAuC3C,cAAc,QAAQ,iBAAqB;wBAE3C,cAAc,QAAQ,mBAAqB;wBAmC3C,cAAc,QAAQ,iBAAqB;wBAE3C,cAAc,QAAQ,mBAAqB;;;YClJ/C,mBAAmB;iBAGd;EAEf,OAAO;EACP,UAAU;EACV,UAAU;EACV,YAAY;EACZ,UAAU;EACV,UAAU;;KAIP,gBAAgB,KAAK;EAA0B,OAAO;;wBAG3C,YAAY,UAAU,cAAc,QAAQ,IAAI;wBAehD,iBACd,GAAG,YAAY,oCACd;wBAQa,uBAAuB,UAAU,kBAAkB;wBAWnD,eACd,UAAU,iCACV,gBAAgB,oCACf;iBAoCc;EACf,MAAM;EACN,gBAAgB;;wBA8BF,iBAAiB,QAAQ,iBAAmB,iBAAmB;wBAgD/D,YAAY,QAAQ,iBAAmB;wBAEvC,YAAY,QAAQ,iBAAmB;wBASvC,YAAY,QAAQ,mBAAmB;wBAEvC,YAAY,QAAQ,iBAAmB;wBA+CvC,YAAY,QAAQ,mBAAmB;wBAEvC,YAAY,QAAQ,iBAAmB;;;UC5PtC;EACf;EACA;EACA;EACA;EACA;EACA;EACA;;;;wBCdc,eACd,aAAa,8BACb,aAAa,8BACb,aAAa,8BACb,aAAa,+BACZ;wBAgBa,eAAe,KAAK;EAClC;EACA;EACA;EACA;;wBAiBc,gBAAgB,SAAS,mBAAuB;wBAQhD,gBAAgB,QAAQ,qBAAuB;wBAyB/C,gBAAgB,QAAQ,mBAAuB;;;wBC6G/C,YAAY,QAAQ,iBAAmB;wBAEvC,YAAY,QAAQ,iBAAmB;wBAsEvC,YAAY,QAAQ,eAAmB;wBAEvC,YAAY,QAAQ,iBAAmB;wBAgEvC,YAAY,QAAQ,eAAmB;wBAEvC,YAAY,QAAQ,iBAAmB;;;iBC7RtC;EACf,MAAM;EACN,aAAa;EACb,UAAU;;wBAyMI,YAAY,QAAQ,iBAAmB;wBAEvC,YAAY,QAAQ,kBAAkB;wBA+EtC,YAAY,QAAQ,eAAmB;wBAEvC,YAAY,QAAQ,kBAAkB;wBA6DtC,YAAY,QAAQ,eAAmB;wBAEvC,YAAY,QAAQ,iBAAmB;;;wBClWvC,eAAe,QAAQ,oBAAe;wBAqBtC,eAAe,QAAQ,kBAAe;;;wBC2BtC,qBAAqB,SAAS,6BAA6B;wBA2H3D,mBAAmB,MAAM,mBAAmB"}

package/dist/generate.d.mts

@@ -3,20 +3,20 @@ import { PresentationOptions } from "@office-open/pptx";
 import { WorkbookOptions } from "@office-open/xlsx";
 import { OutputType, OutputType as OutputType$1 } from "@office-open/core";
 //#region src/generate.d.ts
-type GenerateType = "docx" | "pptx" | "xlsx";
-interface GenerateOptionsMap {
+export type GenerateType = "docx" | "pptx" | "xlsx";
+export interface GenerateOptionsMap {
   docx: DocumentOptions;
   pptx: PresentationOptions;
   xlsx: WorkbookOptions;
 }
-interface GenerateOptions<T extends GenerateType = GenerateType> {
+export interface GenerateOptions<T extends GenerateType = GenerateType> {
   type: T;
   options: GenerateOptionsMap[T];
   outputType?: OutputType$1;
 }
-declare function generate<T extends GenerateType>(options: GenerateOptions<T>): Promise<unknown>;
-declare function parseInput(input: string): Promise<Record<string, unknown>>;
-declare function generateToFile(outputPath: string, options: GenerateOptions): Promise<void>;
+export declare function generate<T extends GenerateType>(options: GenerateOptions<T>): Promise<unknown>;
+export declare function parseInput(input: string): Promise<Record<string, unknown>>;
+export declare function generateToFile(outputPath: string, options: GenerateOptions): Promise<void>;
 //#endregion
-export { GenerateOptions, GenerateOptionsMap, GenerateType, type OutputType, generate, generateToFile, parseInput };
+export type { OutputType };
 //# sourceMappingURL=generate.d.mts.map

package/dist/generate.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.mts","names":[],"sources":["../src/generate.ts"],"mappings":";;;;;KAYY;UAGK;EACf,MAAM;EACN,MAAM;EACN,MAAM;;UAGS,gBAAgB,UAAU,eAAe;EACxD,MAAM;EACN,SAAS,mBAAmB;EAC5B,aAAa;;iBAGO,SAAS,UAAU,cACvC,SAAS,gBAAgB,KACxB;iBAuBmB,WAAW,gBAAgB,QAAQ;iBASnC,eAAe,oBAAoB,SAAS,kBAAkB"}
+{"version":3,"file":"generate.d.mts","names":[],"sources":["../src/generate.ts"],"mappings":";;;;;YAYY;iBAGK;EACf,MAAM;EACN,MAAM;EACN,MAAM;;iBAGS,gBAAgB,UAAU,eAAe;EACxD,MAAM;EACN,SAAS,mBAAmB;EAC5B,aAAa;;wBAGO,SAAS,UAAU,cACvC,SAAS,gBAAgB,KACxB;wBAuBmB,WAAW,gBAAgB,QAAQ;wBASnC,eAAe,oBAAoB,SAAS,kBAAkB"}

package/dist/schemas/index.d.mts

@@ -1,34 +1,34 @@
 import { a as pptxSchema, i as docxSchema, n as JsonSchema, o as validateDocumentInput, r as SCHEMAS, s as xlsxSchema, t as DocumentType } from "../schemas-Dupoq6xM.mjs";
 //#region src/schemas/entries.d.ts
-interface SchemaEntry {
+export interface SchemaEntry {
   name: string;
   domain: string;
   summary: string;
 }
-declare const SCHEMA_ROOTS: Record<DocumentType, string>;
-declare const SCHEMA_ENTRIES: Readonly<Record<DocumentType, readonly SchemaEntry[]>>;
-declare function entryNames(type: DocumentType): ReadonlySet<string>;
+export declare const SCHEMA_ROOTS: Record<DocumentType, string>;
+export declare const SCHEMA_ENTRIES: Readonly<Record<DocumentType, readonly SchemaEntry[]>>;
+export declare function entryNames(type: DocumentType): ReadonlySet<string>;
 //#endregion
 //#region src/schemas/pointer.d.ts
 type Node = Record<string, unknown>;
-declare function isPropertyPointer(ref: string): boolean;
-declare function pointerHost(ref: string): string;
-declare function resolvePointer(root: Node, ref: string): Node | undefined;
+export declare function isPropertyPointer(ref: string): boolean;
+export declare function pointerHost(ref: string): string;
+export declare function resolvePointer(root: Node, ref: string): Node | undefined;
 //#endregion
 //#region src/schemas/slice.d.ts
-declare class UnknownDefinitionError extends Error {
+export declare class UnknownDefinitionError extends Error {
   readonly suggestions: readonly string[];
   constructor(names: readonly string[], suggestions: readonly string[]);
 }
-declare function sliceSchema(schema: JsonSchema, definitions: readonly string[], format?: DocumentType): JsonSchema;
-declare function sliceDocumentSchema(type: DocumentType, definitions: readonly string[]): JsonSchema;
-declare function assertKnownDefinitions(type: DocumentType, definitions: readonly string[]): void;
+export declare function sliceSchema(schema: JsonSchema, definitions: readonly string[], format?: DocumentType): JsonSchema;
+export declare function sliceDocumentSchema(type: DocumentType, definitions: readonly string[]): JsonSchema;
+export declare function assertKnownDefinitions(type: DocumentType, definitions: readonly string[]): void;
 //#endregion
 //#region src/schemas/skeleton.d.ts
-declare function getSkeletonSchema(type: DocumentType): JsonSchema;
+export declare function getSkeletonSchema(type: DocumentType): JsonSchema;
 //#endregion
 //#region src/schemas/type-text.d.ts
-declare function renderSliceTypeText(format: DocumentType, requested: readonly string[], slice: JsonSchema): string;
+export declare function renderSliceTypeText(format: DocumentType, requested: readonly string[], slice: JsonSchema): string;
 //#endregion
-export { DocumentType, JsonSchema, SCHEMAS, SCHEMA_ENTRIES, SCHEMA_ROOTS, SchemaEntry, UnknownDefinitionError, assertKnownDefinitions, docxSchema, entryNames, getSkeletonSchema, isPropertyPointer, pointerHost, pptxSchema, renderSliceTypeText, resolvePointer, sliceDocumentSchema, sliceSchema, validateDocumentInput, xlsxSchema };
+export { DocumentType, JsonSchema, SCHEMAS, docxSchema, pptxSchema, validateDocumentInput, xlsxSchema };
 //# sourceMappingURL=index.d.mts.map

package/dist/schemas/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/schemas/entries.ts","../../src/schemas/pointer.ts","../../src/schemas/slice.ts","../../src/schemas/skeleton.ts","../../src/schemas/type-text.ts"],"mappings":";;UAqBiB;EAEf;EAEA;EAEA;;cAIW,cAAc,OAAO;cA6ZrB,gBAAgB,SAAS,OAAO,uBAAuB;iBAOpD,WAAW,MAAM,eAAe;;;KCvb3C,OAAO;iBAaI,kBAAkB;iBAKlB,YAAY;iBAMZ,eAAe,MAAM,MAAM,cAAc;;;cCZ5C,+BAA+B;WACjC;EACG,YAAA,0BAA0B;;iBAkExB,YACd,QAAQ,YACR,gCACA,SAAS,eACR;iBA+Da,oBACd,MAAM,cACN,iCACC;iBAmCa,uBAAuB,MAAM,cAAc;;;iBCH3C,kBAAkB,MAAM,eAAe;;;iBCjEvC,oBACd,QAAQ,cACR,8BACA,OAAO"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/schemas/entries.ts","../../src/schemas/pointer.ts","../../src/schemas/slice.ts","../../src/schemas/skeleton.ts","../../src/schemas/type-text.ts"],"mappings":";;iBAqBiB;EAEf;EAEA;EAEA;;qBAIW,cAAc,OAAO;qBA6ZrB,gBAAgB,SAAS,OAAO,uBAAuB;wBAOpD,WAAW,MAAM,eAAe;;;KCvb3C,OAAO;wBAaI,kBAAkB;wBAKlB,YAAY;wBAMZ,eAAe,MAAM,MAAM,cAAc;;;qBCZ5C,+BAA+B;WACjC;EACG,YAAA,0BAA0B;;wBAkExB,YACd,QAAQ,YACR,gCACA,SAAS,eACR;wBA+Da,oBACd,MAAM,cACN,iCACC;wBAmCa,uBAAuB,MAAM,cAAc;;;wBCH3C,kBAAkB,MAAM,eAAe;;;wBCjEvC,oBACd,QAAQ,cACR,8BACA,OAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "office-open",
-  "version": "0.14.5",
+  "version": "0.14.6",
   "description": "AI-native Office documents in one install — generate, parse, and patch Word, Excel, and PowerPoint from plain JSON, with a CLI, AI SDK tools, and JSON schemas for LLM tool-calling",
   "keywords": [
     "ai",
@@ -95,11 +95,11 @@
     "ajv": "8.20.0",
     "ajv-formats": "3.0.1",
     "citty": "0.2.2",
-    "@office-open/core": "0.14.5",
-    "@office-open/docx": "0.14.5",
-    "@office-open/xlsx": "0.14.5",
-    "@office-open/pptx": "0.14.5",
-    "@office-open/xml": "0.14.5"
+    "@office-open/core": "0.14.6",
+    "@office-open/xlsx": "0.14.6",
+    "@office-open/docx": "0.14.6",
+    "@office-open/pptx": "0.14.6",
+    "@office-open/xml": "0.14.6"
   },
   "peerDependencies": {
     "ai": "^6.0.0"