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

package/README.md

@@ -1,6 +1,11 @@
 # @json-to-office/json-to-pptx
 
-Generate professional .pptx presentations from JSON definitions.
+**Presentations as data, not code.** Generate professional `.pptx` files from JSON definitions — serializable, schema-validated, LLM-friendly.
+
+[![npm](https://img.shields.io/npm/v/@json-to-office/json-to-pptx.svg)](https://www.npmjs.com/package/@json-to-office/json-to-pptx)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/Wiseair-srl/json-to-office/blob/main/LICENSE)
+
+Part of the [json-to-office](https://github.com/Wiseair-srl/json-to-office) monorepo.
 
 ## Install
 
@@ -11,19 +16,69 @@ npm install @json-to-office/json-to-pptx pptxgenjs
 ## Usage
 
 ```ts
-import { generatePptx } from '@json-to-office/json-to-pptx';
+import { generateBufferFromJson } from '@json-to-office/json-to-pptx';
+import { writeFileSync } from 'fs';
 
-const buffer = await generatePptx({
-  slides: [
+const buffer = await generateBufferFromJson({
+  name: 'pptx',
+  props: {
+    title: 'Q1 Review',
+    theme: 'corporate',
+    grid: { columns: 12, rows: 6 },
+  },
+  children: [
     {
-      elements: [
-        { type: 'text', text: 'Hello!', options: { x: 1, y: 1, w: 8, h: 1 } },
+      name: 'slide',
+      props: { background: { color: 'background' } },
+      children: [
+        {
+          name: 'text',
+          props: {
+            text: 'Q1 Results',
+            style: 'title',
+            grid: { column: 0, row: 0, columnSpan: 12 },
+          },
+        },
+        {
+          name: 'chart',
+          props: {
+            chartType: 'bar',
+            data: [{ name: 'Revenue ($M)', values: [1.2, 2.4, 3.1, 4.2] }],
+            grid: { column: 0, row: 1, columnSpan: 8, rowSpan: 5 },
+          },
+        },
+        {
+          name: 'shape',
+          props: {
+            type: 'roundRect',
+            fill: { color: 'accent' },
+            text: 'Revenue\n$4.2M',
+            bold: true,
+            fontColor: 'FFFFFF',
+            grid: { column: 8, row: 1, columnSpan: 4, rowSpan: 2 },
+          },
+        },
       ],
     },
   ],
 });
+
+writeFileSync('deck.pptx', buffer);
 ```
 
+## Components
+
+7 component types: **text** (bullets, hyperlinks, style presets), **image** (URL/file/base64, rotation, rounded corners, shadows), **shape** (15 types: rect, ellipse, arrow, star, cloud, etc.), **table** (auto-pagination with header repeat, colspan/rowspan), **chart** (8 native PowerPoint types: bar, line, pie, area, doughnut, radar, bubble, scatter), **highcharts**, and **slides** with grid-based positioning.
+
+## Highlights
+
+- **Grid layout** — 12-column responsive grid with configurable margins and gutters. Position elements by grid coordinates or absolute inches/percentages.
+- **Theme system** — 10-slot semantic color scheme, text style presets, 3 built-in themes (minimal, corporate, vibrant) or define your own.
+- **Template/placeholder system** — Define reusable slide templates with named placeholder regions, static elements, and style inheritance.
+- **Schema validation** — TypeBox schemas as both TypeScript types and runtime validators.
+- **Native charts** — 8 PowerPoint chart types rendered natively (no image export needed).
+- **Peer dependency** — Uses [pptxgenjs](https://github.com/gitbrent/PptxGenJS) as the rendering backend. You control the version.
+
 ## License
 
-[MIT](../../LICENSE)
+[MIT](https://github.com/Wiseair-srl/json-to-office/blob/main/LICENSE) — Wiseair srl

package/dist/index.cjs

@@ -21,38 +21,61 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ComponentValidationError: () => import_core_pptx3.ComponentValidationError,
+  DuplicateComponentError: () => import_core_pptx3.DuplicateComponentError,
   PresentationGenerator: () => import_core_pptx.PresentationGenerator,
   WarningCodes: () => import_core_pptx2.WarningCodes,
+  cleanComponentProps: () => import_core_pptx3.cleanComponentProps,
   compareSemver: () => import_shared.compareSemver,
+  createComponent: () => import_core_pptx3.createComponent,
+  createPresentationGenerator: () => import_core_pptx3.createPresentationGenerator,
+  createVersion: () => import_core_pptx3.createVersion,
+  exportPluginSchema: () => import_core_pptx3.exportPluginSchema,
   generateAndSaveFromJson: () => import_core_pptx.generateAndSaveFromJson,
   generateBufferFromJson: () => import_core_pptx.generateBufferFromJson,
   generateBufferWithWarnings: () => import_core_pptx.generateBufferWithWarnings,
   generateFromFile: () => import_core_pptx.generateFromFile,
+  generatePluginPresentationSchema: () => import_core_pptx3.generatePluginPresentationSchema,
   generatePresentation: () => import_core_pptx.generatePresentation,
   isValidSemver: () => import_shared.isValidSemver,
   latestVersion: () => import_shared.latestVersion,
   parseSemver: () => import_shared.parseSemver,
-  savePresentation: () => import_core_pptx.savePresentation
+  resolveComponentVersion: () => import_core_pptx3.resolveComponentVersion,
+  savePresentation: () => import_core_pptx.savePresentation,
+  validateComponentProps: () => import_core_pptx3.validateComponentProps,
+  validatePresentation: () => import_core_pptx3.validatePresentation
 });
 module.exports = __toCommonJS(index_exports);
 var import_core_pptx = require("@json-to-office/core-pptx");
 var import_core_pptx2 = require("@json-to-office/core-pptx");
+var import_core_pptx3 = require("@json-to-office/core-pptx");
 __reExport(index_exports, require("@json-to-office/shared-pptx"), module.exports);
 var import_shared = require("@json-to-office/shared");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ComponentValidationError,
+  DuplicateComponentError,
   PresentationGenerator,
   WarningCodes,
+  cleanComponentProps,
   compareSemver,
+  createComponent,
+  createPresentationGenerator,
+  createVersion,
+  exportPluginSchema,
   generateAndSaveFromJson,
   generateBufferFromJson,
   generateBufferWithWarnings,
   generateFromFile,
+  generatePluginPresentationSchema,
   generatePresentation,
   isValidSemver,
   latestVersion,
   parseSemver,
+  resolveComponentVersion,
   savePresentation,
+  validateComponentProps,
+  validatePresentation,
   ...require("@json-to-office/shared-pptx")
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @json-to-office/json-to-pptx\n *\n * Public API package for PPTX presentation generation.\n * Re-exports from core-pptx and shared-pptx.\n */\n\n// Core generation API\nexport {\n  generatePresentation,\n  generateBufferFromJson,\n  generateBufferWithWarnings,\n  generateAndSaveFromJson,\n  generateFromFile,\n  savePresentation,\n  PresentationGenerator,\n} from '@json-to-office/core-pptx';\n\nexport type { GenerationResult, PipelineWarning, WarningCode } from '@json-to-office/core-pptx';\nexport { WarningCodes } from '@json-to-office/core-pptx';\n\n// Re-export shared-pptx schemas and types\nexport * from '@json-to-office/shared-pptx';\n\n// Re-export shared utilities\nexport {\n  type ComponentDefinition,\n  type GenerationWarning,\n  type AddWarningFunction,\n  type ValidationError,\n  type ParsedSemver,\n  isValidSemver,\n  parseSemver,\n  compareSemver,\n  latestVersion,\n} from '@json-to-office/shared';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,uBAQO;AAGP,IAAAA,oBAA6B;AAG7B,0BAAc,wCAtBd;AAyBA,oBAUO;","names":["import_core_pptx"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @json-to-office/json-to-pptx\n *\n * Public API package for PPTX presentation generation.\n * Re-exports from core-pptx and shared-pptx.\n */\n\n// Core generation API\nexport {\n  generatePresentation,\n  generateBufferFromJson,\n  generateBufferWithWarnings,\n  generateAndSaveFromJson,\n  generateFromFile,\n  savePresentation,\n  PresentationGenerator,\n} from '@json-to-office/core-pptx';\n\nexport type {\n  GenerationResult,\n  PipelineWarning,\n  WarningCode,\n} from '@json-to-office/core-pptx';\nexport { WarningCodes } from '@json-to-office/core-pptx';\n\n// Plugin system\nexport {\n  createComponent,\n  createVersion,\n  createPresentationGenerator,\n  resolveComponentVersion,\n  validateComponentProps,\n  validatePresentation,\n  cleanComponentProps,\n  ComponentValidationError,\n  DuplicateComponentError,\n  generatePluginPresentationSchema,\n  exportPluginSchema,\n} from '@json-to-office/core-pptx';\n\nexport type {\n  CustomComponent,\n  ComponentVersion,\n  ComponentVersionMap,\n  RenderFunction,\n  RenderContext,\n  PresentationGeneratorOptions,\n  PluginPresentationGenerator,\n  PresentationGeneratorBuilder,\n  PluginBufferGenerationResult,\n  PluginFileGenerationResult,\n  PluginValidationResult,\n  ExtractCustomComponentType,\n  CustomComponentUnion,\n  ExtendedPptxComponentInput,\n  ExtendedPresentationComponent,\n  InferBuilderComponents,\n  InferDocumentType,\n  InferComponentDefinition,\n  ComponentValidationResult,\n  PluginValidationError,\n} from '@json-to-office/core-pptx';\n\n// Re-export shared-pptx schemas and types\nexport * from '@json-to-office/shared-pptx';\n\n// Re-export shared utilities\nexport {\n  type ComponentDefinition,\n  type GenerationWarning,\n  type AddWarningFunction,\n  type ValidationError,\n  type ParsedSemver,\n  isValidSemver,\n  parseSemver,\n  compareSemver,\n  latestVersion,\n} from '@json-to-office/shared';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,uBAQO;AAOP,IAAAA,oBAA6B;AAG7B,IAAAA,oBAYO;AA0BP,0BAAc,wCAhEd;AAmEA,oBAUO;","names":["import_core_pptx"]}

package/dist/index.d.cts

@@ -1,3 +1,3 @@
-export { GenerationResult, PipelineWarning, PresentationGenerator, WarningCode, WarningCodes, generateAndSaveFromJson, generateBufferFromJson, generateBufferWithWarnings, generateFromFile, generatePresentation, savePresentation } from '@json-to-office/core-pptx';
+export { ComponentValidationError, ComponentValidationResult, ComponentVersion, ComponentVersionMap, CustomComponent, CustomComponentUnion, DuplicateComponentError, ExtendedPptxComponentInput, ExtendedPresentationComponent, ExtractCustomComponentType, GenerationResult, InferBuilderComponents, InferComponentDefinition, InferDocumentType, PipelineWarning, PluginBufferGenerationResult, PluginFileGenerationResult, PluginPresentationGenerator, PluginValidationError, PluginValidationResult, PresentationGenerator, PresentationGeneratorBuilder, PresentationGeneratorOptions, RenderContext, RenderFunction, WarningCode, WarningCodes, cleanComponentProps, createComponent, createPresentationGenerator, createVersion, exportPluginSchema, generateAndSaveFromJson, generateBufferFromJson, generateBufferWithWarnings, generateFromFile, generatePluginPresentationSchema, generatePresentation, resolveComponentVersion, savePresentation, validateComponentProps, validatePresentation } from '@json-to-office/core-pptx';
 export * from '@json-to-office/shared-pptx';
 export { AddWarningFunction, ComponentDefinition, GenerationWarning, ParsedSemver, ValidationError, compareSemver, isValidSemver, latestVersion, parseSemver } from '@json-to-office/shared';

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { GenerationResult, PipelineWarning, PresentationGenerator, WarningCode, WarningCodes, generateAndSaveFromJson, generateBufferFromJson, generateBufferWithWarnings, generateFromFile, generatePresentation, savePresentation } from '@json-to-office/core-pptx';
+export { ComponentValidationError, ComponentValidationResult, ComponentVersion, ComponentVersionMap, CustomComponent, CustomComponentUnion, DuplicateComponentError, ExtendedPptxComponentInput, ExtendedPresentationComponent, ExtractCustomComponentType, GenerationResult, InferBuilderComponents, InferComponentDefinition, InferDocumentType, PipelineWarning, PluginBufferGenerationResult, PluginFileGenerationResult, PluginPresentationGenerator, PluginValidationError, PluginValidationResult, PresentationGenerator, PresentationGeneratorBuilder, PresentationGeneratorOptions, RenderContext, RenderFunction, WarningCode, WarningCodes, cleanComponentProps, createComponent, createPresentationGenerator, createVersion, exportPluginSchema, generateAndSaveFromJson, generateBufferFromJson, generateBufferWithWarnings, generateFromFile, generatePluginPresentationSchema, generatePresentation, resolveComponentVersion, savePresentation, validateComponentProps, validatePresentation } from '@json-to-office/core-pptx';
 export * from '@json-to-office/shared-pptx';
 export { AddWarningFunction, ComponentDefinition, GenerationWarning, ParsedSemver, ValidationError, compareSemver, isValidSemver, latestVersion, parseSemver } from '@json-to-office/shared';

package/dist/index.js

@@ -9,6 +9,19 @@ import {
   PresentationGenerator
 } from "@json-to-office/core-pptx";
 import { WarningCodes } from "@json-to-office/core-pptx";
+import {
+  createComponent,
+  createVersion,
+  createPresentationGenerator,
+  resolveComponentVersion,
+  validateComponentProps,
+  validatePresentation,
+  cleanComponentProps,
+  ComponentValidationError,
+  DuplicateComponentError,
+  generatePluginPresentationSchema,
+  exportPluginSchema
+} from "@json-to-office/core-pptx";
 export * from "@json-to-office/shared-pptx";
 import {
   isValidSemver,
@@ -17,17 +30,28 @@ import {
   latestVersion
 } from "@json-to-office/shared";
 export {
+  ComponentValidationError,
+  DuplicateComponentError,
   PresentationGenerator,
   WarningCodes,
+  cleanComponentProps,
   compareSemver,
+  createComponent,
+  createPresentationGenerator,
+  createVersion,
+  exportPluginSchema,
   generateAndSaveFromJson,
   generateBufferFromJson,
   generateBufferWithWarnings,
   generateFromFile,
+  generatePluginPresentationSchema,
   generatePresentation,
   isValidSemver,
   latestVersion,
   parseSemver,
-  savePresentation
+  resolveComponentVersion,
+  savePresentation,
+  validateComponentProps,
+  validatePresentation
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @json-to-office/json-to-pptx\n *\n * Public API package for PPTX presentation generation.\n * Re-exports from core-pptx and shared-pptx.\n */\n\n// Core generation API\nexport {\n  generatePresentation,\n  generateBufferFromJson,\n  generateBufferWithWarnings,\n  generateAndSaveFromJson,\n  generateFromFile,\n  savePresentation,\n  PresentationGenerator,\n} from '@json-to-office/core-pptx';\n\nexport type { GenerationResult, PipelineWarning, WarningCode } from '@json-to-office/core-pptx';\nexport { WarningCodes } from '@json-to-office/core-pptx';\n\n// Re-export shared-pptx schemas and types\nexport * from '@json-to-office/shared-pptx';\n\n// Re-export shared utilities\nexport {\n  type ComponentDefinition,\n  type GenerationWarning,\n  type AddWarningFunction,\n  type ValidationError,\n  type ParsedSemver,\n  isValidSemver,\n  parseSemver,\n  compareSemver,\n  latestVersion,\n} from '@json-to-office/shared';\n"],"mappings":";AAQA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,oBAAoB;AAG7B,cAAc;AAGd;AAAA,EAME;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @json-to-office/json-to-pptx\n *\n * Public API package for PPTX presentation generation.\n * Re-exports from core-pptx and shared-pptx.\n */\n\n// Core generation API\nexport {\n  generatePresentation,\n  generateBufferFromJson,\n  generateBufferWithWarnings,\n  generateAndSaveFromJson,\n  generateFromFile,\n  savePresentation,\n  PresentationGenerator,\n} from '@json-to-office/core-pptx';\n\nexport type {\n  GenerationResult,\n  PipelineWarning,\n  WarningCode,\n} from '@json-to-office/core-pptx';\nexport { WarningCodes } from '@json-to-office/core-pptx';\n\n// Plugin system\nexport {\n  createComponent,\n  createVersion,\n  createPresentationGenerator,\n  resolveComponentVersion,\n  validateComponentProps,\n  validatePresentation,\n  cleanComponentProps,\n  ComponentValidationError,\n  DuplicateComponentError,\n  generatePluginPresentationSchema,\n  exportPluginSchema,\n} from '@json-to-office/core-pptx';\n\nexport type {\n  CustomComponent,\n  ComponentVersion,\n  ComponentVersionMap,\n  RenderFunction,\n  RenderContext,\n  PresentationGeneratorOptions,\n  PluginPresentationGenerator,\n  PresentationGeneratorBuilder,\n  PluginBufferGenerationResult,\n  PluginFileGenerationResult,\n  PluginValidationResult,\n  ExtractCustomComponentType,\n  CustomComponentUnion,\n  ExtendedPptxComponentInput,\n  ExtendedPresentationComponent,\n  InferBuilderComponents,\n  InferDocumentType,\n  InferComponentDefinition,\n  ComponentValidationResult,\n  PluginValidationError,\n} from '@json-to-office/core-pptx';\n\n// Re-export shared-pptx schemas and types\nexport * from '@json-to-office/shared-pptx';\n\n// Re-export shared utilities\nexport {\n  type ComponentDefinition,\n  type GenerationWarning,\n  type AddWarningFunction,\n  type ValidationError,\n  type ParsedSemver,\n  isValidSemver,\n  parseSemver,\n  compareSemver,\n  latestVersion,\n} from '@json-to-office/shared';\n"],"mappings":";AAQA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAOP,SAAS,oBAAoB;AAG7B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AA0BP,cAAc;AAGd;AAAA,EAME;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@json-to-office/json-to-pptx",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Professional .pptx presentation generation from JSON - Public API package",
   "type": "module",
   "main": "dist/index.cjs",
@@ -24,9 +24,9 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@json-to-office/shared": "^0.1.0",
-    "@json-to-office/shared-pptx": "^0.1.0",
-    "@json-to-office/core-pptx": "^0.1.0"
+    "@json-to-office/core-pptx": "^0.2.0",
+    "@json-to-office/shared": "^0.2.0",
+    "@json-to-office/shared-pptx": "^0.2.0"
   },
   "peerDependencies": {
     "pptxgenjs": "^3.12.0"