@byfungsi/lipat 0.2.1 → 0.4.0

package/README.md

@@ -1,6 +1,6 @@
 # Lipat
 
-An agent-friendly slide authoring engine with an independent PPTX parser and exporter. Create slides from semantic JSON, TypeScript presets or Markdown; edit by stable IDs; compile into a shared scene for preview and export. The portable Rust core runs natively and as real WebAssembly in browsers and Node.
+An agent-friendly slide authoring engine with an independent PPTX parser and exporter. Create slides from semantic JSON, TypeScript presets or Markdown; edit by stable IDs; compile into a shared scene for preview and export. The portable Rust core runs natively and as real WebAssembly in browsers, Node and Workers with imported precompiled modules.
 
 Inspired by [Nori](https://github.com/byfungsi/nori)'s headless model/runtime/adapters and [reveal.js](https://github.com/hakimel/reveal.js)'s declarative presentation flow. Lipat's primary source is an abstract authoring document. PPTX is a separate file adapter.
 
@@ -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. Choose **Animation sample** to try fade, rise, slide and zoom, or [open it directly](https://byfungsi.github.io/lipat/playground/index.html?sample=animations).
+`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). Native PPTX export retains these effects. The [image sample](https://byfungsi.github.io/lipat/playground/index.html?sample=images) supports direct image URLs and embeds them in downloads.
 
 ## Create and edit
 
@@ -121,6 +121,7 @@ Five provider-neutral tools implement inspect → edit → compile → preview
 | `@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        |
+| `/images`         | Host-controlled URL image loading and immutable offline embedding      |
 | `/pptx`           | Independent PPTX byte adapter                                          |
 | `/wasm`           | Explicit Rust engine initialization                                    |
 | `/render`         | Headless SVG and self-contained HTML output                            |
@@ -136,7 +137,7 @@ ESM and TypeScript declarations are supplied. React 18.3/19 and Motion 14.6+ are
 
 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. 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.
+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. Portable entrance effects and reveal steps map to both the optional [Motion browser adapter and native PPTX timing](docs/animations.md), with easing approximations reported. [Direct image URLs](docs/images.md) can be previewed, linked, or embedded for offline delivery. Charts, SmartArt, media, arbitrary timelines and lossless PPTX rewriting are outside this version. Import/export warnings make these boundaries visible.
 
 ## Native Rust
 
@@ -152,4 +153,12 @@ Workspace crates are path dependencies until published. `cargo run -p lipat-wasm
 
 `npm run verify` checks dependency boundaries, strict/headless TypeScript, behavioral/property/React tests through the real WASM engine, native Rust tests, native/WASM equivalence, builds, an isolated packed npm consumer, optional React/SSR isolation and documentation generation/build.
 
-`npm run verify:browser` exercises the built demo in a real Chromium browser. `npm run verify:interop` independently opens exported PPTX with python-pptx after installing `scripts/requirements-interop.txt`. CI runs these extra checks too.
+`npm run verify:browser` exercises the built demo in a real Chromium browser. `npm run verify:interop` independently opens exported PPTX with python-pptx after installing `scripts/requirements-interop.txt`. `npm run verify:openxml` validates animated and linked-image packages with Microsoft’s Open XML SDK (.NET 8 required). CI runs these extra checks too.
+
+## Worker and immutable Artifact hosts
+
+Version **0.4.0** adds `createLipatFromModule(module, {limits})` for precompiled Worker WASM while preserving `createLipat(bytes, {limits})`. Both share one ABI bridge and native resource budgets. See [Worker setup](docs/wasm.md) and [limit enforcement](docs/limits.md).
+
+`ScenePreview` and `ScenePlayer` from `/react` accept a `SlideScene` directly, with no authoring runtime or WASM initialization. They default to `imagePolicy="embedded-only"`. Existing runtime viewers accept the same policy. [Scene viewer guide](docs/react.md) · [Live sample](https://byfungsi.github.io/lipat/playground/scene.html).
+
+`npm run verify:workerd` tests the real restricted runtime; browser checks verify scene-only rendering without external fetches. Resource budgets bound admitted processing, not elapsed time or total heap usage; synchronous WASM cannot be interrupted by a JavaScript timer on the same thread.