@arcships/pptx-core 0.3.0

package/dist/index.d.ts

@@ -0,0 +1,89 @@
+import { g as PptxFeatureRecord, d as PptxCapabilityReport, h as PptxObjectSource, i as PptxObjectIdentity, j as PptxMorphMatch, k as PptxPlaybackEffect, l as PptxTriggerEvent, m as PptxPlaybackSlide, n as PptxPropertyTrack, o as PptxTimeNode, p as PptxTrackProperty } from './types-Dg1bRe8C.js';
+export { q as PptxEffectKind, r as PptxFeatureDisposition, s as PptxMediaBookmark, t as PptxMediaItem, u as PptxMorphMatchMethod, c as PptxPlaybackDocument, f as PptxPlaybackError, v as PptxPlaybackErrorCode, w as PptxPlaybackErrorDetails, e as PptxPlaybackWarning, P as PptxPreviewDocument, x as PptxPreviewError, y as PptxPreviewErrorCode, a as PptxPreviewLimits, z as PptxPreviewWarning, b as PptxSearchResult, A as PptxSlideAction, B as PptxSlideInfo, C as PptxSlideTransition, D as PptxTimeCondition, E as PptxTimeContainer, F as PptxTimeNodeKind, G as PptxTrackKeyframe } from './types-Dg1bRe8C.js';
+
+declare function createPptxCapabilityReport(features?: readonly PptxFeatureRecord[]): PptxCapabilityReport;
+
+interface PptxObjectKeyParts {
+    slidePath: string;
+    source: PptxObjectSource;
+    shapeId: string;
+    groupPath?: readonly string[];
+}
+declare function createPptxObjectKey(parts: PptxObjectKeyParts): string;
+declare function matchPptxMorphObjects(fromObjects: readonly PptxObjectIdentity[], toObjects: readonly PptxObjectIdentity[]): readonly PptxMorphMatch[];
+
+type PptxTriggerKey = "auto" | `click:${number}` | `shape:${string}` | `bookmark:${string}`;
+interface PptxScheduledEffect {
+    nodeId: string;
+    effect: PptxPlaybackEffect;
+    triggerKey: PptxTriggerKey;
+    triggerEvent: PptxTriggerEvent;
+    clickBoundary: number;
+    startMs: number;
+    endMs: number | "indefinite";
+    order: number;
+}
+interface PptxTriggerSchedule {
+    key: PptxTriggerKey;
+    clickBoundary: number;
+    durationMs: number | "indefinite";
+    effects: readonly PptxScheduledEffect[];
+}
+interface PptxSlideSchedule {
+    groups: readonly PptxTriggerSchedule[];
+    clickBoundaryCount: number;
+    unsupportedNodeIds: readonly string[];
+}
+declare function compilePptxSlideSchedule(slide: PptxPlaybackSlide): PptxSlideSchedule;
+
+type PptxTrackValue = string | number | boolean;
+type PptxObjectPropertyState = Partial<Record<PptxTrackProperty, PptxTrackValue>>;
+type PptxObjectStateMap = Readonly<Record<string, Readonly<PptxObjectPropertyState>>>;
+interface PptxCompiledPropertyTrack extends PptxPropertyTrack {
+    paragraphRange?: {
+        start: number;
+        end: number;
+    };
+    segments: readonly PptxCompiledTrackSegment[];
+}
+interface PptxCompiledTrackSegment {
+    startMs: number;
+    endMs: number;
+    from: PptxTrackValue;
+    to: PptxTrackValue;
+    sourceNodeId: string;
+    order: number;
+    fill: PptxTimeNode["fill"];
+    easing?: string;
+    repeatStartMs?: number;
+    repeatPeriodMs?: number;
+    repeatIndefinite?: boolean;
+}
+interface PptxCompiledTriggerGroup {
+    key: PptxTriggerKey;
+    clickBoundary: number;
+    durationMs: number | "indefinite";
+    tracks: readonly PptxCompiledPropertyTrack[];
+    effects: readonly PptxScheduledEffect[];
+}
+interface PptxCompiledSlide {
+    slideIndex: number;
+    schedule: PptxSlideSchedule;
+    groups: readonly PptxCompiledTriggerGroup[];
+    initialState: PptxObjectStateMap;
+}
+declare function compilePptxSlideTracks(slide: PptxPlaybackSlide, initialState?: PptxObjectStateMap): PptxCompiledSlide;
+declare function evaluatePptxTrack(track: PptxPropertyTrack, positionMs: number): PptxTrackValue;
+declare function evaluatePptxTriggerGroup(group: PptxCompiledTriggerGroup, positionMs: number): PptxObjectStateMap;
+declare function rebuildPptxStateAtBoundary(compiled: PptxCompiledSlide, clickBoundary: number): PptxObjectStateMap;
+
+declare const DEFAULT_PPTX_PREVIEW_LIMITS: Readonly<{
+    maxInputBytes: number;
+    maxArchiveEntries: 4000;
+    maxSingleEntryBytes: number;
+    maxUncompressedBytes: number;
+    maxMediaBytes: number;
+    maxConcurrency: 8;
+}>;
+
+export { DEFAULT_PPTX_PREVIEW_LIMITS, PptxCapabilityReport, type PptxCompiledPropertyTrack, type PptxCompiledSlide, type PptxCompiledTrackSegment, type PptxCompiledTriggerGroup, PptxFeatureRecord, PptxMorphMatch, PptxObjectIdentity, type PptxObjectKeyParts, type PptxObjectPropertyState, PptxObjectSource, type PptxObjectStateMap, PptxPlaybackEffect, PptxPlaybackSlide, PptxPropertyTrack, type PptxScheduledEffect, type PptxSlideSchedule, PptxTimeNode, PptxTrackProperty, type PptxTrackValue, PptxTriggerEvent, type PptxTriggerKey, type PptxTriggerSchedule, compilePptxSlideSchedule, compilePptxSlideTracks, createPptxCapabilityReport, createPptxObjectKey, evaluatePptxTrack, evaluatePptxTriggerGroup, matchPptxMorphObjects, rebuildPptxStateAtBoundary };

package/dist/index.js

@@ -0,0 +1,26 @@
+import {
+  DEFAULT_PPTX_PREVIEW_LIMITS,
+  PptxPlaybackError,
+  PptxPreviewError,
+  compilePptxSlideSchedule,
+  compilePptxSlideTracks,
+  createPptxCapabilityReport,
+  createPptxObjectKey,
+  evaluatePptxTrack,
+  evaluatePptxTriggerGroup,
+  matchPptxMorphObjects,
+  rebuildPptxStateAtBoundary
+} from "./chunk-YX5SL7A5.js";
+export {
+  DEFAULT_PPTX_PREVIEW_LIMITS,
+  PptxPlaybackError,
+  PptxPreviewError,
+  compilePptxSlideSchedule,
+  compilePptxSlideTracks,
+  createPptxCapabilityReport,
+  createPptxObjectKey,
+  evaluatePptxTrack,
+  evaluatePptxTriggerGroup,
+  matchPptxMorphObjects,
+  rebuildPptxStateAtBoundary
+};

package/dist/types-Dg1bRe8C.d.ts

@@ -0,0 +1,222 @@
+type PptxPreviewErrorCode = "ABORTED" | "INVALID_SOURCE" | "LIMIT_EXCEEDED" | "PARSE_FAILED" | "RENDER_FAILED" | "STALE_RESULT" | "UNSUPPORTED_CONTENT";
+declare class PptxPreviewError extends Error {
+    readonly code: PptxPreviewErrorCode;
+    readonly cause?: unknown;
+    constructor(code: PptxPreviewErrorCode, message: string, cause?: unknown);
+}
+interface PptxPreviewLimits {
+    maxInputBytes?: number;
+    maxArchiveEntries?: number;
+    maxSingleEntryBytes?: number;
+    maxUncompressedBytes?: number;
+    maxMediaBytes?: number;
+    maxConcurrency?: number;
+}
+interface PptxSlideInfo {
+    index: number;
+    number: number;
+    hidden: boolean;
+}
+interface PptxPreviewWarning {
+    code: "NOTES_UNSUPPORTED" | "UNSUPPORTED_CONTENT";
+    message: string;
+    slideIndex?: number;
+}
+interface PptxPreviewDocument {
+    fileName?: string;
+    width: number;
+    height: number;
+    slides: readonly PptxSlideInfo[];
+    warnings: readonly PptxPreviewWarning[];
+}
+interface PptxSearchResult {
+    slideIndex: number;
+    nodeId: string;
+    text: string;
+    snippet: string;
+    matchStart: number;
+    matchEnd: number;
+}
+
+type PptxPlaybackErrorCode = "PLAYBACK_NOT_READY" | "PLAYBACK_DISPOSED" | "TARGET_NOT_FOUND" | "TARGET_AMBIGUOUS" | "TIME_CONDITION_UNSUPPORTED" | "TRACK_COMPILE_FAILED" | "MEDIA_BLOCKED" | "MEDIA_FAILED" | "FULLSCREEN_REJECTED" | "UNSUPPORTED_FEATURE";
+interface PptxPlaybackErrorDetails {
+    slideIndex?: number;
+    objectKey?: string;
+    sourceNodeId?: string;
+    cause?: unknown;
+}
+declare class PptxPlaybackError extends Error {
+    readonly code: PptxPlaybackErrorCode;
+    readonly slideIndex?: number;
+    readonly objectKey?: string;
+    readonly sourceNodeId?: string;
+    readonly cause?: unknown;
+    constructor(code: PptxPlaybackErrorCode, message: string, details?: PptxPlaybackErrorDetails);
+}
+
+type PptxObjectSource = "slide" | "layout" | "master";
+interface PptxObjectIdentity {
+    key: string;
+    slidePath: string;
+    source: PptxObjectSource;
+    shapeId: string;
+    groupPath: readonly string[];
+    name?: string;
+    explicitMorphName?: string;
+    creationId?: string;
+    nodeType: string;
+}
+type PptxMorphMatchMethod = "explicit-name" | "creation-id" | "name-and-geometry" | "text-and-geometry";
+interface PptxMorphMatch {
+    from: string;
+    to: string;
+    method: PptxMorphMatchMethod;
+    confidence: "strong" | "medium" | "weak";
+    score: number;
+    unique: boolean;
+}
+type PptxTimeContainer = "root" | "sequence" | "parallel" | "exclusive" | "behavior" | "unknown";
+type PptxTimeNodeKind = "group" | "effect" | "media" | "command" | "unknown";
+type PptxTriggerEvent = "delay" | "on-click" | "with-previous" | "after-previous" | "on-shape-click" | "on-begin" | "on-end" | "on-next" | "on-previous" | "on-media-bookmark" | "on-stop-audio" | "unknown";
+interface PptxTimeCondition {
+    source: "start" | "end" | "previous" | "next";
+    event: PptxTriggerEvent;
+    delayMs: number;
+    targetObjectKey?: string;
+    targetNodeId?: string;
+    bookmarkName?: string;
+    rawEvent?: string;
+}
+type PptxEffectKind = "appear" | "disappear" | "fade-in" | "fade-out" | "wipe" | "scale" | "rotate" | "motion-path" | "emphasis" | "set" | "media-command" | "unknown";
+interface PptxPlaybackEffect {
+    id: string;
+    kind: PptxEffectKind;
+    targetObjectKey?: string;
+    paragraphRange?: {
+        start: number;
+        end: number;
+    };
+    presetClass?: string;
+    presetId?: string;
+    transition?: "in" | "out";
+    filter?: string;
+    command?: string;
+    motionPath?: string;
+    values: Readonly<Record<string, string | number | boolean>>;
+}
+interface PptxTimeNode {
+    id: string;
+    parentId?: string;
+    container: PptxTimeContainer;
+    kind: PptxTimeNodeKind;
+    nodeType?: string;
+    delayMs: number;
+    durationMs: number | "indefinite";
+    repeatCount?: number | "indefinite";
+    autoReverse: boolean;
+    fill: "hold" | "remove" | "freeze" | "unknown";
+    restart: "always" | "when-not-active" | "never" | "unknown";
+    acceleration: number;
+    deceleration: number;
+    conditions: readonly PptxTimeCondition[];
+    childIds: readonly string[];
+    effect?: PptxPlaybackEffect;
+    rawSummary?: string;
+}
+type PptxTrackProperty = "display" | "opacity" | "translate-x" | "translate-y" | "scale-x" | "scale-y" | "rotate" | "clip-path" | "filter" | "fill-color" | "line-color" | "text-color" | "media-playback" | "media-time" | "media-volume";
+interface PptxTrackKeyframe {
+    timeMs: number;
+    value: string | number | boolean;
+    easing?: string;
+    sourceNodeId: string;
+}
+interface PptxPropertyTrack {
+    objectKey: string;
+    property: PptxTrackProperty;
+    initialValue: string | number | boolean;
+    keyframes: readonly PptxTrackKeyframe[];
+    endTimeMs: number | "indefinite";
+    repeatStartMs?: number;
+    repeatPeriodMs?: number;
+    repeatIndefinite?: boolean;
+}
+interface PptxSlideTransition {
+    kind: string;
+    direction?: string;
+    option?: string;
+    durationMs: number;
+    advanceOnClick: boolean;
+    advanceAfterMs?: number;
+    soundRelationId?: string;
+}
+interface PptxMediaBookmark {
+    name: string;
+    timeMs: number;
+}
+interface PptxMediaItem {
+    id: string;
+    objectKey?: string;
+    relationId: string;
+    sourcePath?: string;
+    contentType?: string;
+    kind: "audio" | "video";
+    embedded: boolean;
+    trimStartMs?: number;
+    trimEndMs?: number;
+    loop: boolean;
+    volume: number;
+    bookmarks: readonly PptxMediaBookmark[];
+}
+interface PptxSlideAction {
+    id: string;
+    sourceObjectKey: string;
+    trigger: "click" | "hover";
+    kind: "go-to-slide" | "open-url" | "mailto" | "unsupported";
+    targetSlideIndex?: number;
+    url?: string;
+    rawAction?: string;
+}
+type PptxFeatureDisposition = "strict" | "approximate" | "static" | "unparsed";
+interface PptxFeatureRecord {
+    id: string;
+    slideIndex: number;
+    objectKey?: string;
+    feature: string;
+    disposition: PptxFeatureDisposition;
+    reason?: string;
+    sourceNodeId?: string;
+}
+interface PptxCapabilityReport {
+    discovered: number;
+    strict: number;
+    approximate: number;
+    static: number;
+    unparsed: number;
+    features: readonly PptxFeatureRecord[];
+}
+interface PptxPlaybackSlide {
+    index: number;
+    hidden: boolean;
+    objects: readonly PptxObjectIdentity[];
+    morphFromPrevious: readonly PptxMorphMatch[];
+    transition?: PptxSlideTransition;
+    rootNodeId?: string;
+    nodes: Readonly<Record<string, PptxTimeNode>>;
+    media: readonly PptxMediaItem[];
+    actions: readonly PptxSlideAction[];
+    capability: PptxCapabilityReport;
+}
+interface PptxPlaybackDocument {
+    slides: readonly PptxPlaybackSlide[];
+    capability: PptxCapabilityReport;
+}
+interface PptxPlaybackWarning {
+    code: string;
+    message: string;
+    slideIndex: number;
+    objectKey?: string;
+    sourceNodeId?: string;
+    recoverable: boolean;
+}
+
+export { type PptxSlideAction as A, type PptxSlideInfo as B, type PptxSlideTransition as C, type PptxTimeCondition as D, type PptxTimeContainer as E, type PptxTimeNodeKind as F, type PptxTrackKeyframe as G, type PptxPreviewDocument as P, type PptxPreviewLimits as a, type PptxSearchResult as b, type PptxPlaybackDocument as c, type PptxCapabilityReport as d, type PptxPlaybackWarning as e, PptxPlaybackError as f, type PptxFeatureRecord as g, type PptxObjectSource as h, type PptxObjectIdentity as i, type PptxMorphMatch as j, type PptxPlaybackEffect as k, type PptxTriggerEvent as l, type PptxPlaybackSlide as m, type PptxPropertyTrack as n, type PptxTimeNode as o, type PptxTrackProperty as p, type PptxEffectKind as q, type PptxFeatureDisposition as r, type PptxMediaBookmark as s, type PptxMediaItem as t, type PptxMorphMatchMethod as u, type PptxPlaybackErrorCode as v, type PptxPlaybackErrorDetails as w, PptxPreviewError as x, type PptxPreviewErrorCode as y, type PptxPreviewWarning as z };

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@arcships/pptx-core",
+  "version": "0.3.0",
+  "license": "Apache-2.0",
+  "description": "PPTX preview and playback model with browser document sessions and animation controls",
+  "keywords": ["pptx", "powerpoint", "presentation", "viewer", "playback", "animation"],
+  "homepage": "https://github.com/arcships/agentic-office-ui#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/arcships/agentic-office-ui.git",
+    "directory": "packages/pptx-core"
+  },
+  "bugs": {
+    "url": "https://github.com/arcships/agentic-office-ui/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js",
+      "default": "./dist/browser.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsup",
+    "prepack": "pnpm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "echarts": "^6.0.0",
+    "jszip": "^3.10.1"
+  },
+  "devDependencies": {
+    "@aiden0z/pptx-renderer": "1.2.4",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}