@byfungsi/lipat 0.1.0 → 0.2.0

package/README.md

@@ -25,7 +25,7 @@ npm run verify
 npm run dev
 ```
 
-`npm run dev` builds the package and prints the Vite URL. The demo includes semantic editing, drag/resize and keyboard nudges, history, source JSON, Markdown/PPTX upload, presentation playback, an agent edit and a read-only attachment preview. The library ships no global CSS.
+`npm run dev` builds the package and prints the Vite URL. The demo includes semantic editing, drag/resize and keyboard nudges, history, source JSON, Markdown/PPTX upload, presentation playback, an agent edit and a read-only attachment preview. The library ships no global CSS. Choose **Animation sample** to try fade, rise, slide and zoom, or [open it directly](https://byfungsi.github.io/lipat/playground/index.html?sample=animations).
 
 ## Create and edit
 
@@ -116,26 +116,27 @@ Five provider-neutral tools implement inspect → edit → compile → preview
 
 ## Public entrypoints
 
-| Import            | Responsibility                                                        |
-| ----------------- | --------------------------------------------------------------------- |
-| `@byfungsi/lipat` | WASM initialization, creation, presets, common types and PPTX helpers |
-| `/model`          | Portable document, scene, operation and diagnostic contracts          |
-| `/core`           | Runtime, history, subscriptions, presets and Markdown authoring       |
-| `/pptx`           | Independent PPTX byte adapter                                         |
-| `/wasm`           | Explicit Rust engine initialization                                   |
-| `/render`         | Headless SVG and self-contained HTML output                           |
-| `/react`          | Provider, hooks, canvas, inspector, editor, preview and player        |
-| `/agent`          | Tool definitions, execution and generated JSON schemas                |
-| `/reveal`         | Optional reveal.js-compatible markup and synchronization              |
-| `/lipat.wasm`     | Bundled binary asset, emitted/copied by the host's bundler            |
-
-ESM and TypeScript declarations are supplied. React 18.3/19 is an optional peer and is isolated to `/react`. The npm package has no runtime JavaScript dependencies. Source releases and documentation are published from the byfungsi/lipat repository.
+| Import            | Responsibility                                                         |
+| ----------------- | ---------------------------------------------------------------------- |
+| `@byfungsi/lipat` | WASM initialization, creation, presets, common types and PPTX helpers  |
+| `/model`          | Portable document, scene, operation and diagnostic contracts           |
+| `/core`           | Runtime, history, subscriptions, presets and Markdown authoring        |
+| `/pptx`           | Independent PPTX byte adapter                                          |
+| `/wasm`           | Explicit Rust engine initialization                                    |
+| `/render`         | Headless SVG and self-contained HTML output                            |
+| `/motion`         | Optional Motion browser playback adapter (install `motion` separately) |
+| `/react`          | Provider, hooks, canvas, inspector, editor, preview and player         |
+| `/agent`          | Tool definitions, execution and generated JSON schemas                 |
+| `/reveal`         | Optional reveal.js-compatible markup and synchronization               |
+| `/lipat.wasm`     | Bundled binary asset, emitted/copied by the host's bundler             |
+
+ESM and TypeScript declarations are supplied. React 18.3/19 and Motion 14.6+ are optional peers isolated to `/react` and `/motion`. The npm package has no runtime JavaScript dependencies. Source releases and documentation are published from the byfungsi/lipat repository.
 
 ## Architecture and compatibility
 
 Read [architecture](docs/architecture.md), [creation](docs/creation.md), [API](docs/api.md), [WASM and native usage](docs/wasm.md), [support and Nori parity](docs/support.md), [React](docs/react.md), [import/export](docs/pptx.md), and [verification](docs/verification.md).
 
-Flow layout uses deterministic font metrics. Defaults are approximate and reported as diagnostics; supply measured glyph widths for accurate wrapping. Browser font rasterization can differ from the compiler. Supported PPTX content includes ordinary text/runs, basic shapes, raster images, simple tables, notes, slide ordering and inherited placeholder geometry. Charts, SmartArt, media, animations and arbitrary lossless PPTX rewriting are outside this version. Import/export warnings make these boundaries visible.
+Flow layout uses deterministic font metrics. Defaults are approximate and reported as diagnostics; supply measured glyph widths for accurate wrapping. Browser font rasterization can differ from the compiler. Supported PPTX content includes ordinary text/runs, basic shapes, raster images, simple tables, notes, slide ordering and inherited placeholder geometry. Browser entrance effects are available through the optional [Motion adapter](docs/animations.md). Charts, SmartArt, media, native PPTX animations and arbitrary lossless PPTX rewriting are outside this version. Import/export warnings make these boundaries visible.
 
 ## Native Rust
 

package/dist/agent.d.ts

@@ -1,4 +1,4 @@
-import { D as DeckRuntime } from './deck-runtime-BpZw0FJ_.js';
+import { D as DeckRuntime } from './deck-runtime-30b2wHTB.js';
 import { LipatResult, LipatEngine } from './model.js';
 
 /** Provider-neutral tool description; register with the agent framework of your choice. */
@@ -62,6 +62,10 @@ declare const deckSchemas: {
         $schema: string;
         additionalProperties: boolean;
         definitions: {
+            AnimationEasing: {
+                enum: string[];
+                type: string;
+            };
             Asset: {
                 additionalProperties: boolean;
                 properties: {
@@ -86,6 +90,41 @@ declare const deckSchemas: {
                 required: string[];
                 type: string;
             };
+            EntranceAnimation: {
+                additionalProperties: boolean;
+                description: string;
+                properties: {
+                    delayMs: {
+                        default: number;
+                        format: string;
+                        maximum: number;
+                        minimum: number;
+                        type: string;
+                    };
+                    durationMs: {
+                        default: number;
+                        format: string;
+                        maximum: number;
+                        minimum: number;
+                        type: string;
+                    };
+                    easing: {
+                        allOf: {
+                            $ref: string;
+                        }[];
+                        default: string;
+                    };
+                    effect: {
+                        $ref: string;
+                    };
+                };
+                required: string[];
+                type: string;
+            };
+            EntranceEffect: {
+                enum: string[];
+                type: string;
+            };
             Frame: {
                 additionalProperties: boolean;
                 properties: {
@@ -440,6 +479,15 @@ declare const deckSchemas: {
                     type: string;
                 })[];
                 properties: {
+                    animation: {
+                        anyOf: ({
+                            $ref: string;
+                            type?: never;
+                        } | {
+                            type: string;
+                            $ref?: never;
+                        })[];
+                    };
                     frame: {
                         anyOf: ({
                             $ref: string;
@@ -662,6 +710,10 @@ declare const deckSchemas: {
     operation: {
         $schema: string;
         definitions: {
+            AnimationEasing: {
+                enum: string[];
+                type: string;
+            };
             Asset: {
                 additionalProperties: boolean;
                 properties: {
@@ -686,6 +738,41 @@ declare const deckSchemas: {
                 required: string[];
                 type: string;
             };
+            EntranceAnimation: {
+                additionalProperties: boolean;
+                description: string;
+                properties: {
+                    delayMs: {
+                        default: number;
+                        format: string;
+                        maximum: number;
+                        minimum: number;
+                        type: string;
+                    };
+                    durationMs: {
+                        default: number;
+                        format: string;
+                        maximum: number;
+                        minimum: number;
+                        type: string;
+                    };
+                    easing: {
+                        allOf: {
+                            $ref: string;
+                        }[];
+                        default: string;
+                    };
+                    effect: {
+                        $ref: string;
+                    };
+                };
+                required: string[];
+                type: string;
+            };
+            EntranceEffect: {
+                enum: string[];
+                type: string;
+            };
             Frame: {
                 additionalProperties: boolean;
                 properties: {
@@ -1086,6 +1173,15 @@ declare const deckSchemas: {
                     type: string;
                 })[];
                 properties: {
+                    animation: {
+                        anyOf: ({
+                            $ref: string;
+                            type?: never;
+                        } | {
+                            type: string;
+                            $ref?: never;
+                        })[];
+                    };
                     frame: {
                         anyOf: ({
                             $ref: string;
@@ -1248,6 +1344,8 @@ declare const deckSchemas: {
                 };
                 style?: never;
                 frame?: never;
+                animation?: never;
+                step?: never;
                 layout?: never;
                 node?: never;
                 index?: never;
@@ -1278,6 +1376,8 @@ declare const deckSchemas: {
                 };
                 text?: never;
                 frame?: never;
+                animation?: never;
+                step?: never;
                 layout?: never;
                 node?: never;
                 index?: never;
@@ -1314,6 +1414,80 @@ declare const deckSchemas: {
                 };
                 text?: never;
                 style?: never;
+                animation?: never;
+                step?: never;
+                layout?: never;
+                node?: never;
+                index?: never;
+                parentId?: never;
+                slide?: never;
+                slideId?: never;
+                background?: never;
+                hidden?: never;
+                notes?: never;
+                title?: never;
+                theme?: never;
+                asset?: never;
+                assetId?: never;
+            };
+            required: string[];
+            type: string;
+        } | {
+            properties: {
+                animation: {
+                    anyOf: ({
+                        $ref: string;
+                        type?: never;
+                    } | {
+                        type: string;
+                        $ref?: never;
+                    })[];
+                };
+                nodeId: {
+                    type: string;
+                };
+                type: {
+                    enum: string[];
+                    type: string;
+                };
+                text?: never;
+                style?: never;
+                frame?: never;
+                step?: never;
+                layout?: never;
+                node?: never;
+                index?: never;
+                parentId?: never;
+                slide?: never;
+                slideId?: never;
+                background?: never;
+                hidden?: never;
+                notes?: never;
+                title?: never;
+                theme?: never;
+                asset?: never;
+                assetId?: never;
+            };
+            required: string[];
+            type: string;
+        } | {
+            properties: {
+                nodeId: {
+                    type: string;
+                };
+                step: {
+                    format: string;
+                    minimum: number;
+                    type: string[];
+                };
+                type: {
+                    enum: string[];
+                    type: string;
+                };
+                text?: never;
+                style?: never;
+                frame?: never;
+                animation?: never;
                 layout?: never;
                 node?: never;
                 index?: never;
@@ -1345,6 +1519,8 @@ declare const deckSchemas: {
                 text?: never;
                 style?: never;
                 frame?: never;
+                animation?: never;
+                step?: never;
                 node?: never;
                 index?: never;
                 parentId?: never;
@@ -1375,6 +1551,8 @@ declare const deckSchemas: {
                 text?: never;
                 style?: never;
                 frame?: never;
+                animation?: never;
+                step?: never;
                 layout?: never;
                 index?: never;
                 parentId?: never;
@@ -1411,6 +1589,8 @@ declare const deckSchemas: {
                 text?: never;
                 style?: never;
                 frame?: never;
+                animation?: never;
+                step?: never;
                 layout?: never;
                 slide?: never;
                 slideId?: never;
@@ -1436,6 +1616,8 @@ declare const deckSchemas: {
                 text?: never;
                 style?: never;
                 frame?: never;
+                animation?: never;
+                step?: never;
                 layout?: never;
                 node?: never;
                 index?: never;
@@ -1472,6 +1654,8 @@ declare const deckSchemas: {
                 text?: never;
                 style?: never;
                 frame?: never;
+                animation?: never;
+                step?: never;
                 layout?: never;
                 node?: never;
                 slide?: never;
@@ -1504,6 +1688,8 @@ declare const deckSchemas: {
                 text?: never;
                 style?: never;
                 frame?: never;
+                animation?: never;
+                step?: never;
                 layout?: never;
                 node?: never;
                 parentId?: never;
@@ -1531,6 +1717,8 @@ declare const deckSchemas: {
                 text?: never;
                 style?: never;
                 frame?: never;
+                animation?: never;
+                step?: never;
                 layout?: never;
                 node?: never;
                 index?: never;
@@ -1564,6 +1752,8 @@ declare const deckSchemas: {
                 text?: never;
                 style?: never;
                 frame?: never;
+                animation?: never;
+                step?: never;
                 layout?: never;
                 node?: never;
                 parentId?: never;
@@ -1607,6 +1797,8 @@ declare const deckSchemas: {
                 text?: never;
                 style?: never;
                 frame?: never;
+                animation?: never;
+                step?: never;
                 layout?: never;
                 node?: never;
                 index?: never;
@@ -1631,6 +1823,8 @@ declare const deckSchemas: {
                 text?: never;
                 style?: never;
                 frame?: never;
+                animation?: never;
+                step?: never;
                 layout?: never;
                 node?: never;
                 index?: never;
@@ -1659,6 +1853,8 @@ declare const deckSchemas: {
                 text?: never;
                 style?: never;
                 frame?: never;
+                animation?: never;
+                step?: never;
                 layout?: never;
                 node?: never;
                 index?: never;
@@ -1687,6 +1883,8 @@ declare const deckSchemas: {
                 text?: never;
                 style?: never;
                 frame?: never;
+                animation?: never;
+                step?: never;
                 layout?: never;
                 node?: never;
                 index?: never;

package/dist/agent.js

@@ -1,5 +1,5 @@
-import { encodeAssetBytes } from './chunk-JII3PWXC.js';
-import { renderDeckHtml, renderSlideSvg } from './chunk-WY2QAOOU.js';
+import { encodeAssetBytes } from './chunk-NBLRI3RU.js';
+import { renderDeckHtml, renderSlideSvg } from './chunk-VSEJNCEF.js';
 
 // ../agent/src/schemas.json
 var schemas_default = {
@@ -50,6 +50,10 @@ var schemas_default = {
     $schema: "http://json-schema.org/draft-07/schema#",
     additionalProperties: false,
     definitions: {
+      AnimationEasing: {
+        enum: ["easeOut", "easeInOut", "linear"],
+        type: "string"
+      },
       Asset: {
         additionalProperties: false,
         properties: {
@@ -74,6 +78,43 @@ var schemas_default = {
         required: ["data", "id", "mimeType"],
         type: "object"
       },
+      EntranceAnimation: {
+        additionalProperties: false,
+        description: "Portable entrance effects; milliseconds are serialized, never executable Motion props.",
+        properties: {
+          delayMs: {
+            default: 0,
+            format: "double",
+            maximum: 6e4,
+            minimum: 0,
+            type: "number"
+          },
+          durationMs: {
+            default: 350,
+            format: "double",
+            maximum: 1e4,
+            minimum: 0,
+            type: "number"
+          },
+          easing: {
+            allOf: [
+              {
+                $ref: "#/definitions/AnimationEasing"
+              }
+            ],
+            default: "easeOut"
+          },
+          effect: {
+            $ref: "#/definitions/EntranceEffect"
+          }
+        },
+        required: ["effect"],
+        type: "object"
+      },
+      EntranceEffect: {
+        enum: ["fade", "rise", "slide", "zoom"],
+        type: "string"
+      },
       Frame: {
         additionalProperties: false,
         properties: {
@@ -324,6 +365,16 @@ var schemas_default = {
           }
         ],
         properties: {
+          animation: {
+            anyOf: [
+              {
+                $ref: "#/definitions/EntranceAnimation"
+              },
+              {
+                type: "null"
+              }
+            ]
+          },
           frame: {
             anyOf: [
               {
@@ -566,6 +617,10 @@ var schemas_default = {
   operation: {
     $schema: "http://json-schema.org/draft-07/schema#",
     definitions: {
+      AnimationEasing: {
+        enum: ["easeOut", "easeInOut", "linear"],
+        type: "string"
+      },
       Asset: {
         additionalProperties: false,
         properties: {
@@ -590,6 +645,43 @@ var schemas_default = {
         required: ["data", "id", "mimeType"],
         type: "object"
       },
+      EntranceAnimation: {
+        additionalProperties: false,
+        description: "Portable entrance effects; milliseconds are serialized, never executable Motion props.",
+        properties: {
+          delayMs: {
+            default: 0,
+            format: "double",
+            maximum: 6e4,
+            minimum: 0,
+            type: "number"
+          },
+          durationMs: {
+            default: 350,
+            format: "double",
+            maximum: 1e4,
+            minimum: 0,
+            type: "number"
+          },
+          easing: {
+            allOf: [
+              {
+                $ref: "#/definitions/AnimationEasing"
+              }
+            ],
+            default: "easeOut"
+          },
+          effect: {
+            $ref: "#/definitions/EntranceEffect"
+          }
+        },
+        required: ["effect"],
+        type: "object"
+      },
+      EntranceEffect: {
+        enum: ["fade", "rise", "slide", "zoom"],
+        type: "string"
+      },
       Frame: {
         additionalProperties: false,
         properties: {
@@ -901,6 +993,16 @@ var schemas_default = {
           }
         ],
         properties: {
+          animation: {
+            anyOf: [
+              {
+                $ref: "#/definitions/EntranceAnimation"
+              },
+              {
+                type: "null"
+              }
+            ]
+          },
           frame: {
             anyOf: [
               {
@@ -1121,6 +1223,47 @@ var schemas_default = {
         required: ["nodeId", "type"],
         type: "object"
       },
+      {
+        properties: {
+          animation: {
+            anyOf: [
+              {
+                $ref: "#/definitions/EntranceAnimation"
+              },
+              {
+                type: "null"
+              }
+            ]
+          },
+          nodeId: {
+            type: "string"
+          },
+          type: {
+            enum: ["setAnimation"],
+            type: "string"
+          }
+        },
+        required: ["nodeId", "type"],
+        type: "object"
+      },
+      {
+        properties: {
+          nodeId: {
+            type: "string"
+          },
+          step: {
+            format: "uint32",
+            minimum: 0,
+            type: ["integer", "null"]
+          },
+          type: {
+            enum: ["setStep"],
+            type: "string"
+          }
+        },
+        required: ["nodeId", "type"],
+        type: "object"
+      },
       {
         properties: {
           layout: {
@@ -1341,7 +1484,7 @@ function createAgentTools(deck, options) {
   const tools = [
     {
       name: "lipat_inspect",
-      description: "Read deck revision, stable slide/node identities and compact semantic content.",
+      description: "Read deck revision, stable slide/node identities, compact semantic content and explicit reveal steps/animations.",
       inputSchema: {
         type: "object",
         additionalProperties: false,