@json-to-office/core-pptx 1.4.0 → 1.7.0

package/dist/ir/compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/ir/compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,KAAK,EAEV,eAAe,EAGf,qBAAqB,EAKtB,MAAM,UAAU,CAAC;AAalB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,OAAO,EAGL,KAAK,MAAM,EA+BZ,MAAM,SAAS,CAAC;AAWjB,gEAAgE;AAChE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,QAAQ,EAAE,SAAS,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;IACrD,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B;;;;OAIG;IACH,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAwBD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,qBAAqB,EAChC,QAAQ,GAAE,eAAe,EAAO,GAC/B,iBAAiB,CAoDnB"}
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/ir/compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,KAAK,EACV,eAAe,EAGf,qBAAqB,EAKtB,MAAM,UAAU,CAAC;AAWlB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,OAAO,EAGL,KAAK,MAAM,EA+BZ,MAAM,SAAS,CAAC;AAWjB,gEAAgE;AAChE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,QAAQ,EAAE,SAAS,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;IACrD,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B;;;;OAIG;IACH,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAwBD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,qBAAqB,EAChC,QAAQ,GAAE,eAAe,EAAO,GAC/B,iBAAiB,CAoDnB"}

package/dist/quality/facts.d.ts

@@ -0,0 +1,59 @@
+import type { PreparedDocument, QualityFact } from '@json-to-office/quality';
+import type { FontRuntimeOpts, ServicesConfig } from '@json-to-office/shared';
+import type { PipelineWarning, PptxThemeConfig, PresentationComponentDefinition, ProcessedPresentation } from '../types';
+export interface PptxCanvasFact extends QualityFact {
+    kind: 'pptx/canvas';
+    widthIn?: number;
+    heightIn?: number;
+}
+export interface PptxTextFact extends QualityFact {
+    kind: 'pptx/text';
+    slidePath: string;
+    text: string;
+    fontSizePt: number;
+    lineSpacingPt: number;
+    paraSpaceBeforePt: number;
+    paraSpaceAfterPt: number;
+    styleName?: string;
+    boxXPt?: number;
+    boxYPt?: number;
+    boxWidthPt?: number;
+    boxHeightPt?: number;
+    verticalAlign: 'top' | 'middle' | 'bottom';
+    rotationDeg: number;
+    /**
+     * True when neither `h` nor a grid supplies a height. The compiler resolves
+     * grid positions before checking `props.h`, so grid height is a hard ceiling.
+     */
+    autoFit: boolean;
+    /** Effective bold, from the run or its named style. */
+    bold: boolean;
+    /** Resolved run colour, bare hex, when the document states one. */
+    colorHex?: string;
+    /**
+     * Every colour the surface behind this text can paint, bare hex. A gradient
+     * contributes each stop: text has to stay legible over all of them, and the
+     * worst stop is the one a reader notices.
+     */
+    backgroundHexes?: readonly string[];
+}
+export interface PptxSlideFact extends QualityFact {
+    kind: 'pptx/slide';
+    bodyWords: number;
+}
+export type PptxQualityFact = PptxCanvasFact | PptxTextFact | PptxSlideFact;
+export interface PptxQualityModel {
+    authored: PresentationComponentDefinition;
+    document: PresentationComponentDefinition;
+    theme: PptxThemeConfig;
+    processed: ProcessedPresentation;
+}
+export interface PreparePptxQualityOptions {
+    customThemes?: Record<string, PptxThemeConfig>;
+    fonts?: FontRuntimeOpts;
+    services?: ServicesConfig;
+    warnings?: PipelineWarning[];
+    renderer?: string;
+}
+export declare function preparePptxQualityDocument(document: PresentationComponentDefinition, options?: PreparePptxQualityOptions): PreparedDocument<PptxQualityModel, PptxQualityFact>;
+//# sourceMappingURL=facts.d.ts.map

package/dist/quality/facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts.d.ts","sourceRoot":"","sources":["../../src/quality/facts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEhB,WAAW,EACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE9E,OAAO,KAAK,EAGV,eAAe,EAEf,eAAe,EACf,+BAA+B,EAC/B,qBAAqB,EAEtB,MAAM,UAAU,CAAC;AASlB,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,IAAI,EAAE,OAAO,CAAC;IACd,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,YAAY,GAAG,aAAa,CAAC;AAE5E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,qBAAqB,CAAC;CAClC;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC/C,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAsjBD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,+BAA+B,EACzC,OAAO,GAAE,yBAA8B,GACtC,gBAAgB,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAyIrD"}

package/dist/quality/preflight.d.ts

@@ -0,0 +1,15 @@
+/** PPTX quality analysis over renderer-aligned prepared facts. */
+import { type PreparedDocument, type QualityAnalysis, type QualityPolicy, type QualityProfile } from '@json-to-office/quality';
+import type { PptxThemeConfig } from '../types';
+import type { PptxQualityFact, PptxQualityModel } from './facts';
+export interface PptxQualityOptions {
+    customThemes?: Record<string, PptxThemeConfig>;
+}
+export interface PptxQualityAnalysisOptions extends PptxQualityOptions {
+    renderer?: string;
+    profile?: QualityProfile;
+    policy?: QualityPolicy;
+    prepared?: PreparedDocument<PptxQualityModel, PptxQualityFact>;
+}
+export declare function analyzePptxQuality(doc: unknown, options?: PptxQualityAnalysisOptions): QualityAnalysis;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/quality/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/quality/preflight.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,cAAc,EAEpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAUjE,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;CAChE;AAiBD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,0BAA+B,GACvC,eAAe,CA2CjB"}

package/dist/quality/rules.d.ts

@@ -0,0 +1,41 @@
+import { QualityEngine, type QualityProfile, type QualityRule, type QualityRulePack } from '@json-to-office/quality';
+import type { PptxQualityFact, PptxQualityModel } from './facts';
+export declare const pptxCanvasRule: QualityRule<PptxQualityModel, PptxQualityFact>;
+export declare const pptxMinimumFontRule: QualityRule<PptxQualityModel, PptxQualityFact>;
+export declare const pptxTextFitRule: QualityRule<PptxQualityModel, PptxQualityFact>;
+export declare const pptxSlideDensityRule: QualityRule<PptxQualityModel, PptxQualityFact>;
+export declare const pptxTextContrastRule: QualityRule<PptxQualityModel, PptxQualityFact>;
+export declare const PPTX_QUALITY_RULES: QualityRulePack<PptxQualityModel, PptxQualityFact>;
+export declare const PPTX_QUALITY_PROFILES: {
+    readonly 'executive-presentation': {
+        readonly id: "executive-presentation";
+        readonly formats: readonly ["pptx"];
+        readonly description: "Decision deck optimized for scan speed and projection.";
+        readonly rules: {
+            readonly 'pptx/minimum-font-size': {
+                readonly parameters: {
+                    readonly minimumFontPt: 14;
+                };
+            };
+            readonly 'pptx/slide-density': {
+                readonly parameters: {
+                    readonly maximumBodyWords: 70;
+                };
+            };
+        };
+    };
+    readonly 'technical-presentation': {
+        readonly id: "technical-presentation";
+        readonly formats: readonly ["pptx"];
+        readonly description: "Portable professional presentation defaults.";
+    };
+};
+export declare const PPTX_DEFAULT_QUALITY_PROFILE: QualityProfile;
+/**
+ * Callers name a shipped profile by id — `{ id: 'executive-presentation', formats: ['pptx'] }`.
+ * Without this lookup that request reaches the engine carrying nothing but its id,
+ * so the analysis runs on defaults while stamping the requested profileId.
+ */
+export declare function resolvePptxQualityProfile(requested: QualityProfile | undefined): QualityProfile | undefined;
+export declare const pptxQualityEngine: QualityEngine<PptxQualityModel, PptxQualityFact>;
+//# sourceMappingURL=rules.d.ts.map

package/dist/quality/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/quality/rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,aAAa,EAEb,KAAK,cAAc,EACnB,KAAK,WAAW,EAEhB,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAEV,eAAe,EACf,gBAAgB,EAGjB,MAAM,SAAS,CAAC;AA8EjB,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,EAAE,eAAe,CA2EzE,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAC3C,gBAAgB,EAChB,eAAe,CAkChB,CAAC;AAsCF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,gBAAgB,EAAE,eAAe,CAgG1E,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAC5C,gBAAgB,EAChB,eAAe,CA8BhB,CAAC;AAqCF,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAC5C,gBAAgB,EAChB,eAAe,CAiFhB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAAe,CAC9C,gBAAgB,EAChB,eAAe,CAUhB,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;CAeiB,CAAC;AAEpD,eAAO,MAAM,4BAA4B,EAAE,cACM,CAAC;AAKlD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,cAAc,GAAG,SAAS,GACpC,cAAc,GAAG,SAAS,CAK5B;AAED,eAAO,MAAM,iBAAiB,kDAA8C,CAAC"}