@json-to-office/core-pptx 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -6,5 +6,7 @@ export { isPresentationComponent, isSlideComponent } from './types';
 export { W as WarningCodes } from './utils/warn';
 export type { WarningCode } from './utils/warn';
 export { DEFAULT_PPTX_THEME, getPptxTheme, pptxThemes } from './themes';
+export { createComponent, createVersion, createPresentationGenerator, resolveComponentVersion, validateComponentProps, validatePresentation, cleanComponentProps, ComponentValidationError, DuplicateComponentError, generatePluginPresentationSchema, exportPluginSchema, } from './plugin';
+export type { CustomComponent, ComponentVersion, ComponentVersionMap, RenderFunction, RenderContext, PresentationGeneratorOptions, PresentationGenerator as PluginPresentationGenerator, PresentationGeneratorBuilder, BufferGenerationResult as PluginBufferGenerationResult, FileGenerationResult as PluginFileGenerationResult, ValidationResult as PluginValidationResult, ExtractCustomComponentType, CustomComponentUnion, ExtendedPptxComponentInput, ExtendedPresentationComponent, InferBuilderComponents, InferDocumentType, InferComponentDefinition, ComponentValidationResult, ValidationError as PluginValidationError, } from './plugin';
 export { renderTextComponent, renderImageComponent, renderShapeComponent, renderTableComponent, renderHighchartsComponent, renderComponent, } from './components';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAGD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,iCAAiC,EACjC,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAG5E,YAAY,EACV,kBAAkB,EAClB,+BAA+B,EAC/B,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,eAAe,EACf,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGpE,OAAO,EAAE,CAAC,IAAI,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGxE,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,eAAe,GAChB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAGD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,iCAAiC,EACjC,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAG5E,YAAY,EACV,kBAAkB,EAClB,+BAA+B,EAC/B,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,eAAe,EACf,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGpE,OAAO,EAAE,CAAC,IAAI,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGxE,OAAO,EACL,eAAe,EACf,aAAa,EACb,2BAA2B,EAC3B,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,gCAAgC,EAChC,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,4BAA4B,EAC5B,qBAAqB,IAAI,2BAA2B,EACpD,4BAA4B,EAC5B,sBAAsB,IAAI,4BAA4B,EACtD,oBAAoB,IAAI,0BAA0B,EAClD,gBAAgB,IAAI,sBAAsB,EAC1C,0BAA0B,EAC1B,oBAAoB,EACpB,0BAA0B,EAC1B,6BAA6B,EAC7B,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,IAAI,qBAAqB,GACzC,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1175,18 +1175,407 @@ var PresentationGenerator = {
   isPresentationComponentDefinition
 };
 
+// src/plugin/index.ts
+import {
+  createComponent,
+  createVersion
+} from "@json-to-office/shared/plugin";
+
+// src/plugin/createPresentationGenerator.ts
+import JSZip2 from "jszip";
+import {
+  resolveComponentVersion as resolveComponentVersion2,
+  DuplicateComponentError as DuplicateComponentError2,
+  ComponentValidationError as ComponentValidationError3
+} from "@json-to-office/shared/plugin";
+
+// src/plugin/validation.ts
+import {
+  resolveComponentVersion,
+  validateCustomComponentProps,
+  ComponentValidationError
+} from "@json-to-office/shared/plugin";
+import {
+  DuplicateComponentError,
+  ComponentValidationError as ComponentValidationError2
+} from "@json-to-office/shared/plugin";
+function validateComponentProps(schema, props, componentName) {
+  return validateCustomComponentProps(schema.propsSchema, props, {
+    clean: true,
+    applyDefaults: true,
+    componentName
+  });
+}
+function validatePresentation(document, customComponents) {
+  const errors = [];
+  function validateComponents(components, pathPrefix = "children") {
+    components.forEach((componentData, index) => {
+      const customComponent = customComponents.find(
+        (cc) => cc.name === componentData.name
+      );
+      if (customComponent) {
+        const versionEntry = resolveComponentVersion(
+          customComponent.name,
+          customComponent.versions,
+          componentData.version
+        );
+        const validation = validateComponentProps(
+          versionEntry,
+          componentData.props,
+          customComponent.name
+        );
+        if (!validation.valid && validation.errors) {
+          const indexedErrors = validation.errors.map(
+            (error) => ({
+              ...error,
+              path: `${pathPrefix}[${index}].${error.path}`
+            })
+          );
+          errors.push(...indexedErrors);
+        }
+      }
+      if (componentData.children && Array.isArray(componentData.children)) {
+        validateComponents(
+          componentData.children,
+          `${pathPrefix}[${index}].children`
+        );
+      }
+    });
+  }
+  if (document.children) {
+    validateComponents(document.children);
+  }
+  return errors.length > 0 ? { valid: false, errors } : { valid: true, errors: [] };
+}
+function getValidatedProps(schema, props) {
+  const validation = validateComponentProps(schema, props);
+  if (!validation.valid) {
+    throw new ComponentValidationError(validation.errors || [], props);
+  }
+  return validation.data;
+}
+var cleanComponentProps = getValidatedProps;
+
+// src/plugin/schema.ts
+import {
+  generateUnifiedDocumentSchema
+} from "@json-to-office/shared-pptx";
+function generatePluginPresentationSchema(customComponents) {
+  const customComponentInfos = customComponents.map(
+    (component) => {
+      const versionKeys = Object.keys(component.versions);
+      const versions = versionKeys.map((v) => ({
+        version: v,
+        propsSchema: component.versions[v].propsSchema,
+        hasChildren: component.versions[v].hasChildren === true,
+        description: component.versions[v].description
+      }));
+      return {
+        name: component.name,
+        versions
+      };
+    }
+  );
+  return generateUnifiedDocumentSchema({
+    customComponents: customComponentInfos
+  });
+}
+async function exportPluginSchema(customComponents, outputPath, options = {}) {
+  const { prettyPrint = true } = options;
+  const { convertToJsonSchema, exportSchemaToFile } = await import("@json-to-office/shared");
+  const schema = generatePluginPresentationSchema(customComponents);
+  const jsonSchema = convertToJsonSchema(schema, {
+    $schema: "http://json-schema.org/draft-07/schema#"
+  });
+  await exportSchemaToFile(jsonSchema, outputPath, { prettyPrint });
+}
+
+// src/plugin/createPresentationGenerator.ts
+var MEDIUM_STYLE_2_ACCENT_12 = "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}";
+var NO_STYLE_NO_GRID2 = "{2D5ABB26-0587-4C30-8999-92F81FD0307C}";
+async function neutralizeTableStyle2(buffer) {
+  const zip = await JSZip2.loadAsync(buffer);
+  let changed = false;
+  for (const [path2, entry] of Object.entries(zip.files)) {
+    if (!path2.match(/^ppt\/slides\/slide\d+\.xml$/)) continue;
+    const xml = await entry.async("string");
+    if (xml.includes(MEDIUM_STYLE_2_ACCENT_12)) {
+      zip.file(path2, xml.replaceAll(MEDIUM_STYLE_2_ACCENT_12, NO_STYLE_NO_GRID2));
+      changed = true;
+    }
+  }
+  return changed ? await zip.generateAsync({ type: "nodebuffer" }) : buffer;
+}
+function createBuilderImpl(state) {
+  const componentMap = new Map(state.components.map((c) => [c.name, c]));
+  async function processSlideComponents(components, warningsCollector, theme, depth = 0) {
+    if (depth > 20) {
+      throw new Error(
+        "Maximum component nesting depth exceeded (20). Check for circular component references."
+      );
+    }
+    const processed = [];
+    for (const componentData of components) {
+      const customComponent = componentMap.get(componentData.name);
+      if (customComponent) {
+        try {
+          if (!componentData.props) {
+            throw new Error(
+              `Custom component '${componentData.name}' must have a 'props' property. Use format: { name: '${componentData.name}', props: {...} }`
+            );
+          }
+          const componentWithVersion = componentData;
+          const versionEntry = resolveComponentVersion2(
+            customComponent.name,
+            customComponent.versions,
+            componentWithVersion.version
+          );
+          const cleanedProps = cleanComponentProps(
+            versionEntry,
+            componentWithVersion.props
+          );
+          let nestedChildren;
+          if (componentWithVersion.children && Array.isArray(componentWithVersion.children)) {
+            nestedChildren = await processSlideComponents(
+              componentWithVersion.children,
+              warningsCollector,
+              theme,
+              depth + 1
+            );
+          }
+          const versionLabel = componentWithVersion.version ? `${customComponent.name}@${componentWithVersion.version}` : customComponent.name;
+          const addWarning = (message, context) => {
+            warningsCollector.push({
+              code: context?.code ?? "PLUGIN_WARNING",
+              message,
+              component: versionLabel,
+              slide: context?.slide
+            });
+          };
+          const result = await versionEntry.render({
+            props: cleanedProps,
+            theme,
+            addWarning,
+            children: nestedChildren
+          });
+          const resultComponents = Array.isArray(result) ? result : [result];
+          const processedResult = await processSlideComponents(
+            resultComponents,
+            warningsCollector,
+            theme,
+            depth + 1
+          );
+          processed.push(...processedResult);
+          if (state.debug) {
+            console.log(
+              `Processed custom component '${versionLabel}':`,
+              processedResult
+            );
+          }
+        } catch (error) {
+          if (error instanceof ComponentValidationError3) {
+            throw error;
+          }
+          throw new Error(
+            `Error processing custom component '${customComponent.name}': ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      } else {
+        if (componentData.children && Array.isArray(componentData.children)) {
+          const processedChildren = await processSlideComponents(
+            componentData.children,
+            warningsCollector,
+            theme,
+            depth + 1
+          );
+          processed.push({
+            ...componentData,
+            children: processedChildren
+          });
+        } else {
+          processed.push(componentData);
+        }
+      }
+    }
+    return processed;
+  }
+  function addComponent(component) {
+    if (!component.name) {
+      throw new Error("Component name is required");
+    }
+    if (state.componentNames.has(component.name)) {
+      throw new DuplicateComponentError2(component.name);
+    }
+    const newComponentNames = new Set(state.componentNames);
+    newComponentNames.add(component.name);
+    const newState = {
+      components: [...state.components, component],
+      componentNames: newComponentNames,
+      theme: state.theme,
+      customThemes: state.customThemes,
+      debug: state.debug
+    };
+    return createBuilderImpl(
+      newState
+    );
+  }
+  async function generate(document) {
+    try {
+      const internalDocument = document;
+      if (!internalDocument || internalDocument.name !== "pptx") {
+        throw new Error("Top-level component must be a pptx component");
+      }
+      const themeName = typeof state.theme === "string" ? state.theme : internalDocument.props.theme ?? "default";
+      const resolvedTheme = typeof state.theme === "object" ? state.theme : state.customThemes?.[themeName] ?? getPptxTheme(themeName);
+      const warnings = [];
+      const processedChildren = internalDocument.children ? await processAllSlides(
+        internalDocument.children,
+        warnings,
+        resolvedTheme
+      ) : [];
+      const processedDocument = {
+        ...internalDocument,
+        children: processedChildren
+      };
+      const processed = processPresentation(processedDocument, {
+        customThemes: state.customThemes
+      });
+      const pptx = await renderPresentation(processed, warnings);
+      const data = await pptx.write({ outputType: "nodebuffer" });
+      const buffer = await neutralizeTableStyle2(data);
+      return { buffer, warnings };
+    } catch (error) {
+      if (state.debug) {
+        console.error("Presentation generation error:", error);
+      }
+      throw error;
+    }
+  }
+  async function processAllSlides(children, warnings, theme) {
+    const result = [];
+    for (const child of children) {
+      if (child.name === "slide" && child.children) {
+        const processedSlideChildren = await processSlideComponents(
+          child.children,
+          warnings,
+          theme
+        );
+        result.push({ ...child, children: processedSlideChildren });
+      } else {
+        const processedTopLevel = await processSlideComponents(
+          [child],
+          warnings,
+          theme
+        );
+        result.push(...processedTopLevel);
+      }
+    }
+    return result;
+  }
+  async function generateFile(document, outputPath) {
+    const { buffer, warnings } = await generate(document);
+    const fs = await import("fs/promises");
+    await fs.writeFile(outputPath, new Uint8Array(buffer));
+    return { warnings };
+  }
+  function getComponentNames() {
+    return Array.from(state.componentNames);
+  }
+  function validate(document) {
+    try {
+      const internalDocument = document;
+      const result = validatePresentation(
+        internalDocument,
+        state.components
+      );
+      if (!result.valid) {
+        return {
+          valid: false,
+          errors: result.errors.map((e) => ({
+            path: e.path,
+            message: e.message
+          }))
+        };
+      }
+      return { valid: true };
+    } catch (error) {
+      if (error instanceof ComponentValidationError3) {
+        return {
+          valid: false,
+          errors: error.errors.map((e) => ({
+            path: e.path,
+            message: e.message
+          }))
+        };
+      }
+      return {
+        valid: false,
+        errors: [
+          {
+            path: "document",
+            message: error instanceof Error ? error.message : String(error)
+          }
+        ]
+      };
+    }
+  }
+  function generateSchema() {
+    return generatePluginPresentationSchema(
+      state.components
+    );
+  }
+  async function exportSchemaToFile(outputPath, options) {
+    await exportPluginSchema(
+      state.components,
+      outputPath,
+      options
+    );
+  }
+  return Object.freeze({
+    addComponent,
+    generate,
+    generateBuffer: generate,
+    generateFile,
+    getComponentNames,
+    validate,
+    generateSchema,
+    exportSchema: exportSchemaToFile
+  });
+}
+function createPresentationGenerator(options = {}) {
+  const initialState = {
+    components: [],
+    componentNames: /* @__PURE__ */ new Set(),
+    theme: options.theme,
+    customThemes: options.customThemes,
+    debug: options.debug ?? false
+  };
+  return createBuilderImpl(initialState);
+}
+
+// src/plugin/index.ts
+import { resolveComponentVersion as resolveComponentVersion3 } from "@json-to-office/shared/plugin";
+
 // src/index.ts
 function getPptxCoreVersion() {
   return "PptxCore v1.0.0";
 }
 export {
+  ComponentValidationError2 as ComponentValidationError,
   DEFAULT_PPTX_THEME,
+  DuplicateComponentError,
   PresentationGenerator,
   W as WarningCodes,
+  cleanComponentProps,
+  createComponent,
+  createPresentationGenerator,
+  createVersion,
+  exportPluginSchema,
   generateAndSaveFromJson,
   generateBufferFromJson,
   generateBufferWithWarnings,
   generateFromFile,
+  generatePluginPresentationSchema,
   generatePresentation,
   getPptxCoreVersion,
   getPptxTheme,
@@ -1200,6 +1589,9 @@ export {
   renderShapeComponent,
   renderTableComponent,
   renderTextComponent,
-  savePresentation
+  resolveComponentVersion3 as resolveComponentVersion,
+  savePresentation,
+  validateComponentProps,
+  validatePresentation
 };
 //# sourceMappingURL=index.js.map