@json-to-office/core-pptx 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,184 @@
+/**
+ * PPTX Core Types
+ */
+export interface PptxComponentInput {
+    name: string;
+    id?: string;
+    enabled?: boolean;
+    props: Record<string, any>;
+    children?: PptxComponentInput[];
+}
+export interface PresentationComponentDefinition {
+    name: 'pptx';
+    $schema?: string;
+    id?: string;
+    props: {
+        title?: string;
+        author?: string;
+        subject?: string;
+        company?: string;
+        theme?: string;
+        slideWidth?: number;
+        slideHeight?: number;
+        rtlMode?: boolean;
+        pageNumberFormat?: '9' | '09';
+        grid?: GridConfig;
+        templates?: TemplateSlideDefinition[];
+    };
+    children?: PptxComponentInput[];
+}
+export interface SlideComponentDefinition {
+    name: 'slide';
+    id?: string;
+    props: {
+        background?: {
+            color?: string;
+            image?: {
+                path?: string;
+                base64?: string;
+            };
+        };
+        transition?: {
+            type?: string;
+            speed?: string;
+        };
+        notes?: string;
+        layout?: string;
+        hidden?: boolean;
+        template?: string;
+        placeholders?: Record<string, PptxComponentInput>;
+    };
+    children?: PptxComponentInput[];
+}
+export interface ProcessedPresentation {
+    metadata: {
+        title?: string;
+        author?: string;
+        subject?: string;
+        company?: string;
+    };
+    theme: PptxThemeConfig;
+    grid?: GridConfig;
+    slideWidth: number;
+    slideHeight: number;
+    rtlMode: boolean;
+    pageNumberFormat: '9' | '09';
+    slides: ProcessedSlide[];
+    templates?: TemplateSlideDefinition[];
+}
+export interface ProcessedSlide {
+    components: PptxComponentInput[];
+    background?: {
+        color?: string;
+        image?: {
+            path?: string;
+            base64?: string;
+        };
+    };
+    notes?: string;
+    layout?: string;
+    hidden?: boolean;
+    template?: string;
+    placeholders?: Record<string, PptxComponentInput>;
+}
+export interface GridConfig {
+    columns?: number;
+    rows?: number;
+    margin?: number | {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    gutter?: number | {
+        column: number;
+        row: number;
+    };
+}
+export interface GridPosition {
+    column: number;
+    row: number;
+    columnSpan?: number;
+    rowSpan?: number;
+}
+export interface TextStyle {
+    fontSize?: number;
+    fontFace?: string;
+    fontColor?: string;
+    bold?: boolean;
+    italic?: boolean;
+    align?: string;
+    lineSpacing?: number;
+    charSpacing?: number;
+    paraSpaceAfter?: number;
+}
+export type StyleName = 'title' | 'subtitle' | 'heading1' | 'heading2' | 'heading3' | 'body' | 'caption';
+export interface PptxThemeConfig {
+    name: string;
+    colors: {
+        primary: string;
+        secondary: string;
+        accent: string;
+        background: string;
+        text: string;
+        text2?: string;
+        background2?: string;
+        accent4?: string;
+        accent5?: string;
+        accent6?: string;
+    };
+    fonts: {
+        heading: string;
+        body: string;
+    };
+    defaults: {
+        fontSize: number;
+        fontColor: string;
+    };
+    styles?: Partial<Record<StyleName, TextStyle>>;
+}
+export interface PlaceholderDefinition {
+    name: string;
+    x?: number;
+    y?: number;
+    w?: number;
+    h?: number;
+    grid?: GridPosition;
+    defaults?: PptxComponentInput;
+}
+export interface TemplateSlideDefinition {
+    name: string;
+    background?: {
+        color?: string;
+        image?: {
+            path?: string;
+            base64?: string;
+        };
+    };
+    margin?: number | [number, number, number, number];
+    slideNumber?: {
+        x: number;
+        y: number;
+        w?: number;
+        h?: number;
+        color?: string;
+        fontSize?: number;
+    };
+    objects?: PptxComponentInput[];
+    placeholders?: PlaceholderDefinition[];
+    grid?: GridConfig;
+}
+export interface SlideContext {
+    slideNumber: number;
+    totalSlides: number;
+    pageNumberFormat: '9' | '09';
+}
+export interface PipelineWarning {
+    code: string;
+    message: string;
+    component?: string;
+    slide?: number;
+}
+export declare function isPresentationComponent(component: unknown): component is PresentationComponentDefinition;
+export declare function isSlideComponent(component: unknown): component is SlideComponentDefinition;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/utils/color.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Color utilities for PPTX generation.
+ * pptxgenjs expects bare 6-char hex (e.g. 'FF0000'), but our theme
+ * convention uses '#'-prefixed values (e.g. '#FF0000').
+ */
+import type { PptxThemeConfig, PipelineWarning } from '../types';
+/**
+ * Resolve a color value to bare hex (no '#' prefix).
+ * Accepts hex colors (with or without '#') or semantic theme color names.
+ */
+export declare function resolveColor(color: string, theme: PptxThemeConfig, warnings?: PipelineWarning[]): string;
+//# sourceMappingURL=color.d.ts.map

package/dist/utils/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/utils/color.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAiBjE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,eAAe,EAAE,GAAG,MAAM,CAmBxG"}

package/dist/utils/environment.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Environment detection utilities
+ */
+/**
+ * Check if the current environment is Node.js
+ */
+export declare function isNodeEnvironment(): boolean;
+//# sourceMappingURL=environment.d.ts.map

package/dist/utils/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/utils/environment.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C"}

package/dist/utils/warn.d.ts

@@ -0,0 +1,20 @@
+import type { PipelineWarning } from '../types';
+export declare const W: {
+    readonly UNKNOWN_COMPONENT: "UNKNOWN_COMPONENT";
+    readonly UNKNOWN_CHART_TYPE: "UNKNOWN_CHART_TYPE";
+    readonly UNKNOWN_SHAPE: "UNKNOWN_SHAPE";
+    readonly CHART_NO_DATA: "CHART_NO_DATA";
+    readonly CHART_INVALID_SERIES: "CHART_INVALID_SERIES";
+    readonly CHART_MULTI_SERIES: "CHART_MULTI_SERIES";
+    readonly IMAGE_NO_SOURCE: "IMAGE_NO_SOURCE";
+    readonly IMAGE_PROBE_FAILED: "IMAGE_PROBE_FAILED";
+    readonly MISSING_TEMPLATE: "MISSING_TEMPLATE";
+    readonly UNKNOWN_PLACEHOLDER: "UNKNOWN_PLACEHOLDER";
+    readonly PLACEHOLDER_NO_POSITION: "PLACEHOLDER_NO_POSITION";
+    readonly THEME_COLOR_FALLBACK: "THEME_COLOR_FALLBACK";
+    readonly UNKNOWN_COLOR: "UNKNOWN_COLOR";
+    readonly GRID_POSITION_CLAMPED: "GRID_POSITION_CLAMPED";
+};
+export type WarningCode = typeof W[keyof typeof W];
+export declare function warn(warnings: PipelineWarning[] | undefined, code: WarningCode, message: string, extra?: Partial<PipelineWarning>): void;
+//# sourceMappingURL=warn.d.ts.map

package/dist/utils/warn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warn.d.ts","sourceRoot":"","sources":["../../src/utils/warn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;CAeJ,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC;AAEnD,wBAAgB,IAAI,CAClB,QAAQ,EAAE,eAAe,EAAE,GAAG,SAAS,EACvC,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAC/B,IAAI,CAMN"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@json-to-office/core-pptx",
+  "version": "0.1.0",
+  "description": "Core PPTX presentation generation engine",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
+    }
+  },
+  "dependencies": {
+    "@sinclair/typebox": "0.34.38",
+    "jszip": "3.10.1",
+    "probe-image-size": "7.2.3",
+    "pptxgenjs": "^3.12.0",
+    "@json-to-office/shared": "^0.1.0",
+    "@json-to-office/shared-pptx": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "20.11.0",
+    "@types/probe-image-size": "7.2.4",
+    "tsup": "8.5.0",
+    "typescript": "5.3.3"
+  },
+  "license": "MIT",
+  "author": "Paolo Barbato",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Wiseair-srl/json-to-office.git",
+    "directory": "packages/core-pptx"
+  },
+  "homepage": "https://github.com/Wiseair-srl/json-to-office/tree/main/packages/core-pptx",
+  "bugs": {
+    "url": "https://github.com/Wiseair-srl/json-to-office/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "keywords": [
+    "json-to-office",
+    "typescript",
+    "pptx",
+    "presentation",
+    "powerpoint"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly --declaration",
+    "build:js": "tsup",
+    "build:types": "tsc --emitDeclarationOnly --declaration",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write src/**/*.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage --passWithNoTests"
+  }
+}