m0saic 0.2.1 → 0.3.0

package/node_modules/@m0saic/dictionary/README.md

@@ -0,0 +1,315 @@
+# @m0saic/dictionary
+
+The official catalog of reusable m0saic layouts — 30 fixed entries and 10 parameterized generators.
+
+```
+npm install @m0saic/dictionary
+```
+
+---
+
+## Where this fits
+
+```
+              @m0saic/dsl
+        the language core (zero deps)
+      grammar, parser, validator, types
+                    |
+      +-------------+-------------+
+      |                           |
+  @m0saic/dsl-         @m0saic/dsl-stdlib
+  file-formats           builders, transforms
+  .m0  .m0c              authoring toolkit
+      |                           |
+      +-------------+-------------+
+                    |
+            @m0saic/dictionary       <── you are here
+         curated entries + generators
+```
+
+The dictionary depends on all three packages above. It consumes DSL validation, stdlib builders, and file-format parsing to produce a curated, tested catalog of reusable layouts.
+
+---
+
+## Quick start
+
+```typescript
+import { entries, generators, resolveM0saic } from "@m0saic/dictionary";
+
+// Browse all entries
+entries.all.forEach(e => console.log(e.id, e.sourceCount));
+
+// Get a specific entry
+const hero = entries.byId["layouts/hero-sidebar"];
+console.log(hero.m0saic);  // "2(F,2[F,F])"
+
+// Resolve heavy entries (brand logos with large DSL)
+const dsl = await resolveM0saic(entries.byId["brand/m0saic-m-256"]);
+
+// Use a generator
+const { m0saic, sourceCount } = generators.grid({
+  columns: 4, rows: 3, gutter: 0.1
+});
+```
+
+---
+
+## Entries
+
+30 fixed canonical layouts across 4 categories.
+
+```
+  entries/
+  ├── splits/          10 entries    simple N-way splits
+  │   ├── 2-col                      2(F,F)
+  │   ├── 2-row                      2[F,F]
+  │   ├── 3-col                      3(F,F,F)
+  │   ├── 3-row                      3[F,F,F]
+  │   ├── 4-col                      4(F,F,F,F)
+  │   ├── 4-row                      4[F,F,F,F]
+  │   ├── 2-1-col                    3(0,F,F)         2:1 ratio
+  │   ├── 1-2-col                    3(F,0,F)         1:2 ratio
+  │   ├── 2-1-row                    3[0,F,F]         2:1 ratio
+  │   └── 1-2-row                    3[F,0,F]         1:2 ratio
+  │
+  ├── grids/           5 entries     uniform rectangular grids
+  │   ├── 2x2                        2[2(F,F),2(F,F)]
+  │   ├── 2x3                        3[2(F,F),2(F,F),2(F,F)]
+  │   ├── 3x2                        2[3(F,F,F),3(F,F,F)]
+  │   ├── 3x3                        3[3(F,F,F),3(F,F,F),3(F,F,F)]
+  │   └── 4x4                        4[4(...),4(...),4(...),4(...)]
+  │
+  ├── layouts/         8 entries     editorial / compositional layouts
+  │   ├── hero-sidebar                2(F,2[F,F])
+  │   ├── hero-bottom-strip           2[F,3(F,F,F)]
+  │   ├── hero-top-strip              2[3(F,F,F),F]
+  │   ├── sidebar-main                2(2[F,F],F)
+  │   ├── l-shape                     2[2(F,F),2(F,-)]
+  │   ├── t-shape                     2[3(F,F,F),3(-,F,-)]
+  │   ├── three-up                    2[F,2(F,F)]
+  │   └── main-two-supporting         3[0,F,2(F,F)]
+  │
+  └── brand/           7 entries     canonical brand primitives
+      ├── m0saic-m-64                 2,242 tiles (64x64 bitmap)
+      ├── m0saic-m-256                35,298 tiles (256x256 bitmap)
+      ├── m0saic-m-rects              109 tiles (rect decomposition)
+      ├── m0saic-pattern              110 tiles (brand pattern)
+      ├── m-33                        33 tiles (composed logo)
+      ├── m-33_bitmap                 36,426 tiles (bitmap logo)
+      └── m0                          26 tiles (M0 mark)
+```
+
+### Entry shape
+
+Each entry is a `MosaicDictionaryEntryResolved`:
+
+```
+  MosaicDictionaryEntry
+  +── id: string                    permanent identifier
+  +── m0saic: string                canonical DSL (empty for heavy entries)
+  +── sourceCount: number           rendered tile count
+  +── title: string                 display name
+  +── description: string           human-readable description
+  +── category: string              "split" | "grid" | "layout" | "brand"
+  +── tags: string[]                searchable tags
+  +── m0File?: string               path to .m0 file (heavy entries)
+  +── preview?: { mode, src? }      "canvas" (SVG from DSL) or "image" (shipped PNG)
+  +── minWidthPx?: number           exact minimum feasible width
+  +── minHeightPx?: number          exact minimum feasible height
+  +── rankSets?: Record<...>        named rank orderings
+  +── maskSets?: Record<...>        named clipping masks
+```
+
+### Light vs heavy entries
+
+```
+  Light entries (splits, grids, layouts)
+  ──────────────────────────────────────
+  DSL inlined in browser bundle
+  m0saic: "2(F,F)"
+  Instant access, no fetch needed
+
+  Heavy entries (brand)
+  ─────────────────────
+  DSL in .m0 file on disk/server
+  m0saic: "" (empty in browser)
+  m0File: "entries/brand/m0saic-m-256/m0saic.m0"
+  Resolved via: await resolveM0saic(entry)
+```
+
+---
+
+## Generators
+
+10 parameterized layout producers. Each has a descriptor (for UI controls) and a build function.
+
+```
+  Generator            Description                        Key params
+  ─────────            ───────────                        ──────────
+  grid                 rectangular grid                   columns, rows, gutter
+  aspectFit            fit content to aspect ratio        rootW/H, target ratio
+  placeRect            position rect in canvas            rootW/H, rectW/H, align
+  aspectSafeGrid       grid with aspect preservation      columns, rows, priority
+  magazine             editorial hero + sidebar + strip   heroWeight, sidebarCount
+  safeCanvas           canvas with constraints            columns, rows, gutter
+  spotlight            hero + supporting tiles            supportCount, arrangement
+  comparison           before/after pairs                 pairs, direction
+  rankedList           ranked items with decay            count, decay, direction
+  bentoGrid            curated irregular grids            base, variant
+```
+
+### Using generators
+
+```typescript
+import { generators } from "@m0saic/dictionary";
+
+// Call directly
+const { m0saic, sourceCount } = generators.grid({
+  columns: 3, rows: 2, gutter: 0.05
+});
+
+// Enumerate all descriptors (for UI)
+generators.descriptors.forEach(d => {
+  console.log(d.id, d.title, d.params.length);
+});
+```
+
+### Generator descriptor shape
+
+```
+  GeneratorDescriptor
+  +── id: string                    generator identifier
+  +── title: string                 display name
+  +── description: string           what it produces
+  +── category: string              grouping
+  +── params: GeneratorParamDescriptor[]
+        +── key: string             parameter name
+        +── title: string           display label
+        +── type: "int" | "float" | "bool" | "enum"
+        +── default: number | boolean | string
+        +── min?: number
+        +── max?: number
+        +── step?: number
+        +── options?: { value, label }[]     (enum only)
+        +── visibleWhen?: Record<string, ...>  conditional visibility
+```
+
+---
+
+## Resolution
+
+### `resolveM0saic(entry): Promise<string>`
+
+Resolves the m0saic DSL string for any entry. Light entries return immediately. Heavy entries fetch and parse the `.m0` file.
+
+```typescript
+import { resolveM0saic, entries } from "@m0saic/dictionary";
+
+const dsl = await resolveM0saic(entries.byId["brand/m0saic-m-rects"]);
+// Returns canonical DSL string (109 tiles)
+```
+
+Results are cached (bounded, max 64, FIFO eviction).
+
+### `setDictionaryAssetsBase(base)`
+
+Set the base URL for `.m0` file fetches. Default: `"/dictionary"`.
+
+```typescript
+import { setDictionaryAssetsBase } from "@m0saic/dictionary";
+
+setDictionaryAssetsBase("/assets/dictionary");
+// Heavy entries will fetch from /assets/dictionary/entries/brand/...
+```
+
+---
+
+## Mask sets
+
+Entries with non-rectangular silhouettes (e.g. `brand/m-33`, `brand/m0`) ship a `masks.json` whose entries describe each frame's clip shape (`localPath` + design-space `bounds`). Templates load the set at template-execution time and bake the data inline on each `MosaicSource.mask`:
+
+```typescript
+import { registry } from "@m0saic/dictionary";
+
+const masks = registry.getMaskSet("brand/m-33", "default").masks;
+sources.forEach((s, i) => {
+  const m = masks[i];
+  if (m) s.mask = { kind: "inline-mask", localPath: m.localPath, bounds: m.bounds };
+});
+```
+
+Rasterization happens engine-side in `@m0saic/core` (`rasterizeMaskPng`) — `@m0saic/dictionary` no longer carries `sharp` as a dependency, and there is no `getOrCreateMaskPng` export. The dictionary's job is to ship the silhouette source-of-truth; turning it into pixels is the engine's job.
+
+---
+
+## Browser vs Node
+
+```
+  Browser (via bundler)              Node / CLI
+  ─────────────────────              ──────────
+  Resolves to browser.ts             Resolves to index.ts
+  via package.json "browser"         via package.json "main"
+
+  Light DSL inlined                  Light DSL inlined
+  Heavy DSL: fetch .m0 from server   Heavy DSL: fs.readFileSync
+
+  Same API shape:                    Same API shape:
+    entries.all                        entries.all
+    entries.byId                       entries.byId
+    generators.*                       generators.*
+    resolveM0saic()                    resolveM0saic()
+    registry.getMaskSet()              registry.getMaskSet()
+```
+
+Consumers always import from `@m0saic/dictionary` — the bundler handles resolution automatically.
+
+---
+
+## Stability contract
+
+Entry IDs and generator schemas are **permanent public contract**.
+
+```
+  Action                          Allowed in
+  ──────                          ──────────
+  Add new entries                 minor / patch
+  Add new generators              minor / patch
+  Change metadata (title, tags)   minor / patch
+  Change entry m0saic string      major only (geometry changes)
+  Remove / rename entry IDs       major only
+  Change generator param schemas  major only
+```
+
+---
+
+## Development
+
+### Add a new entry
+
+```bash
+cd packages/dictionary
+npx ts-node tools/create-new-entry.ts <group> <slug> <path-to-file.m0>
+npm run dictionary:build
+```
+
+### Build
+
+```bash
+npm run dictionary:build
+# validates -> generates artifacts -> generates index -> compiles -> copies assets
+```
+
+### Test
+
+```bash
+npm test                    # unit + generator tests
+npm run test:visual         # golden wireframe PNGs
+npm run test:visual:update  # regenerate goldens
+```
+
+---
+
+## License
+
+Licensed under the Apache License, Version 2.0.
+See `LICENSE` and `NOTICE`.

package/node_modules/@m0saic/dictionary/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m0saic/dictionary",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "main": "dist/index.js",
   "license": "MIT"
 }

package/node_modules/@m0saic/dsl/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m0saic/dsl",
-  "version": "1.1.0",
+  "version": "2.0.0",
   "main": "./dist/cjs/index.js",
   "exports": {
     ".": {

package/node_modules/@m0saic/dsl-file-formats/dist/cjs/agent.js

@@ -0,0 +1,6 @@
+"use strict";var f=Object.defineProperty;var r=(e,t)=>f(e,"name",{value:t,configurable:!0});Object.defineProperty(exports,"__esModule",{value:!0}),exports.normalizeCandidateContext=normalizeCandidateContext,exports.mintAgentId=mintAgentId,exports.collapseAgentProse=collapseAgentProse,exports.normalizeAgentProse=normalizeAgentProse;const CANDIDATE_CONTEXT_KEYS=new Set(["session","candidate","phase","category","intent","layoutIntent","regionAnnotations","evaluation","relation","extras"]);function normalizeCandidateContext(e){if(e==null)return;if(typeof e!="object"||Array.isArray(e))return{extras:{raw:e}};const t=e,s={},a={};let o=!1,l=!1;for(const[i,n]of Object.entries(t))if(n!==void 0){if(i==="extras"){if(n!==null&&typeof n=="object"&&!Array.isArray(n))for(const[u,c]of Object.entries(n))c!==void 0&&(a[u]=c,o=!0);continue}CANDIDATE_CONTEXT_KEYS.has(i)?(s[i]=n,l=!0):(a[i]=n,o=!0)}return o&&(s.extras=a),l||o?s:void 0}r(normalizeCandidateContext,"normalizeCandidateContext");function mintAgentId(){const e=typeof globalThis<"u"?globalThis.crypto:void 0;return e&&typeof e.randomUUID=="function"?e.randomUUID().replace(/-/g,"").slice(0,8):Math.random().toString(36).slice(2,6)+Math.random().toString(36).slice(2,6)}r(mintAgentId,"mintAgentId");function collapseAgentProse(e){return e.replace(/[\r\n]+/g," ").replace(/\s+/g," ").trim()}r(collapseAgentProse,"collapseAgentProse");function normalizeAgentProse(e){return e.replace(/\r\n?/g,`
+`).split(`
+`).map(t=>t.replace(/[ \t]+$/g,"")).join(`
+`).replace(/\n{3,}/g,`
+
+`).trim()}r(normalizeAgentProse,"normalizeAgentProse");

package/node_modules/@m0saic/dsl-file-formats/dist/cjs/m0/parseM0File.js

@@ -1 +1 @@
-"use strict";var x=Object.defineProperty;var y=(t,o)=>x(t,"name",{value:o,configurable:!0});Object.defineProperty(exports,"__esModule",{value:!0}),exports.parseM0File=parseM0File;const momo_types_1=require("@m0saic/momo-types"),m0Validation_1=require("../m0Validation");function parseM0File(t){if(typeof t!="string")throw new Error("parseM0File: input must be a string");const o=t.split(/\r?\n/),n={},s={},m=[],c=[];for(const l of o){const p=l.trim();if(p!==""){if(p.startsWith("#")){if(p==="# m0"||p==="# m0saic")continue;const w=p.match(/^#\s*m0agent:([^:]+):\s*(.*)$/);if(w){const d=w[1].trim(),h=w[2].trim();d==="comment"?m.push(h):d&&(s[d]=h);continue}const M=p.match(/^#\s*([^:]+):\s*(.*)$/);if(M){const d=M[1].trim(),h=M[2].trim();d&&(n[d]=h)}continue}c.push(p)}}const b=(0,m0Validation_1.canonicalizeAndValidateM0)("parseM0File",c.join(""),"parseM0File: payload is empty");if(n.version!=null&&n.version.trim()!=="1")throw new Error(`parseM0File: unsupported version "${n.version}" (expected "1")`);const g=parseSize(n.size);if(n.size!=null&&g==null)throw new Error(`parseM0File: invalid size "${n.size}" (expected WxH e.g. 1920x1080)`);const a=n.created?.trim();if(!a)throw new Error('parseM0File: missing required header "created"');const i=n.app?.trim(),e=n.appVersion?.trim(),f=extractKnownMeta(n),u=extractAgentMeta(s,m);return{version:1,created:a,app:i&&i!==""?i:null,appVersion:e&&e!==""?e:null,meta:f,agent:u,size:g??null,m0:b}}y(parseM0File,"parseM0File");function parseSize(t){if(t==null||t.trim()==="")return null;const o=t.match(/^(\d+)x(\d+)$/);if(!o)return null;const n=Number(o[1]),s=Number(o[2]);return!Number.isInteger(n)||n<=0||!Number.isInteger(s)||s<=0?null:{width:n,height:s}}y(parseSize,"parseSize");function extractKnownMeta(t){const o=t.title?.trim(),n=t.author?.trim(),s=t.source?.trim(),m=t.note?.trim(),c={};return o&&(c.title=o),n&&(c.author=n),s&&(c.source=s),m&&(c.note=m),Object.keys(c).length?c:null}y(extractKnownMeta,"extractKnownMeta");function extractAgentMeta(t,o){const n=t.id?.trim(),s=t.note?.trim(),m=t.question?.trim(),c=t.regions?.trim(),b=t.context?.trim(),g=t.response?.trim(),a={};if(n&&(a.id=n),s&&(a.note=s),m&&(a.question=m),c){const i=safeJsonParse(c);if(i&&typeof i=="object"&&!Array.isArray(i)){const e={};for(const[f,u]of Object.entries(i))typeof u=="string"&&(e[f]=u);Object.keys(e).length&&(a.regions=e)}}if(b){const i=safeJsonParse(b),e=(0,momo_types_1.normalizeCandidateContext)(i);e!==void 0&&(a.context=e)}if(g){const i=safeJsonParse(g);if(i&&typeof i=="object"&&!Array.isArray(i)){const e=i;if(typeof e.body=="string"&&e.body.trim()!==""){const f={body:e.body};typeof e.from=="string"&&e.from.trim()!==""&&(f.from=e.from),typeof e.at=="string"&&e.at.trim()!==""&&(f.at=e.at),a.response=f}}}if(o.length>0){const i=[];for(const e of o){const f=e.trim();if(!f)continue;const u=safeJsonParse(f);if(!u||typeof u!="object"||Array.isArray(u))continue;const r=u;if(typeof r.body!="string"||r.body.trim()==="")continue;const l={body:r.body};typeof r.id=="string"&&r.id.trim()!==""&&(l.id=r.id),typeof r.from=="string"&&r.from.trim()!==""&&(l.from=r.from),typeof r.at=="string"&&r.at.trim()!==""&&(l.at=r.at),i.push(l)}i.length&&(a.comments=i)}return Object.keys(a).length?a:null}y(extractAgentMeta,"extractAgentMeta");function safeJsonParse(t){try{return JSON.parse(t)}catch{return}}y(safeJsonParse,"safeJsonParse");
+"use strict";var x=Object.defineProperty;var y=(t,r)=>x(t,"name",{value:r,configurable:!0});Object.defineProperty(exports,"__esModule",{value:!0}),exports.parseM0File=parseM0File;const agent_1=require("../agent"),m0Validation_1=require("../m0Validation");function parseM0File(t){if(typeof t!="string")throw new Error("parseM0File: input must be a string");const r=t.split(/\r?\n/),n={},s={},m=[],c=[];for(const l of r){const p=l.trim();if(p!==""){if(p.startsWith("#")){if(p==="# m0"||p==="# m0saic")continue;const w=p.match(/^#\s*m0agent:([^:]+):\s*(.*)$/);if(w){const d=w[1].trim(),h=w[2].trim();d==="comment"?m.push(h):d&&(s[d]=h);continue}const M=p.match(/^#\s*([^:]+):\s*(.*)$/);if(M){const d=M[1].trim(),h=M[2].trim();d&&(n[d]=h)}continue}c.push(p)}}const b=(0,m0Validation_1.canonicalizeAndValidateM0)("parseM0File",c.join(""),"parseM0File: payload is empty");if(n.version!=null&&n.version.trim()!=="1")throw new Error(`parseM0File: unsupported version "${n.version}" (expected "1")`);const g=parseSize(n.size);if(n.size!=null&&g==null)throw new Error(`parseM0File: invalid size "${n.size}" (expected WxH e.g. 1920x1080)`);const a=n.created?.trim();if(!a)throw new Error('parseM0File: missing required header "created"');const i=n.app?.trim(),e=n.appVersion?.trim(),f=extractKnownMeta(n),u=extractAgentMeta(s,m);return{version:1,created:a,app:i&&i!==""?i:null,appVersion:e&&e!==""?e:null,meta:f,agent:u,size:g??null,m0:b}}y(parseM0File,"parseM0File");function parseSize(t){if(t==null||t.trim()==="")return null;const r=t.match(/^(\d+)x(\d+)$/);if(!r)return null;const n=Number(r[1]),s=Number(r[2]);return!Number.isInteger(n)||n<=0||!Number.isInteger(s)||s<=0?null:{width:n,height:s}}y(parseSize,"parseSize");function extractKnownMeta(t){const r=t.title?.trim(),n=t.author?.trim(),s=t.source?.trim(),m=t.note?.trim(),c={};return r&&(c.title=r),n&&(c.author=n),s&&(c.source=s),m&&(c.note=m),Object.keys(c).length?c:null}y(extractKnownMeta,"extractKnownMeta");function extractAgentMeta(t,r){const n=t.id?.trim(),s=t.note?.trim(),m=t.question?.trim(),c=t.regions?.trim(),b=t.context?.trim(),g=t.response?.trim(),a={};if(n&&(a.id=n),s&&(a.note=s),m&&(a.question=m),c){const i=safeJsonParse(c);if(i&&typeof i=="object"&&!Array.isArray(i)){const e={};for(const[f,u]of Object.entries(i))typeof u=="string"&&(e[f]=u);Object.keys(e).length&&(a.regions=e)}}if(b){const i=safeJsonParse(b),e=(0,agent_1.normalizeCandidateContext)(i);e!==void 0&&(a.context=e)}if(g){const i=safeJsonParse(g);if(i&&typeof i=="object"&&!Array.isArray(i)){const e=i;if(typeof e.body=="string"&&e.body.trim()!==""){const f={body:e.body};typeof e.from=="string"&&e.from.trim()!==""&&(f.from=e.from),typeof e.at=="string"&&e.at.trim()!==""&&(f.at=e.at),a.response=f}}}if(r.length>0){const i=[];for(const e of r){const f=e.trim();if(!f)continue;const u=safeJsonParse(f);if(!u||typeof u!="object"||Array.isArray(u))continue;const o=u;if(typeof o.body!="string"||o.body.trim()==="")continue;const l={body:o.body};typeof o.id=="string"&&o.id.trim()!==""&&(l.id=o.id),typeof o.from=="string"&&o.from.trim()!==""&&(l.from=o.from),typeof o.at=="string"&&o.at.trim()!==""&&(l.at=o.at),i.push(l)}i.length&&(a.comments=i)}return Object.keys(a).length?a:null}y(extractAgentMeta,"extractAgentMeta");function safeJsonParse(t){try{return JSON.parse(t)}catch{return}}y(safeJsonParse,"safeJsonParse");

package/node_modules/@m0saic/dsl-file-formats/dist/cjs/m0/serializeM0File.js

@@ -1,3 +1,3 @@
-"use strict";var a=Object.defineProperty;var o=(i,e)=>a(i,"name",{value:e,configurable:!0});Object.defineProperty(exports,"__esModule",{value:!0}),exports.serializeM0File=serializeM0File,exports.formatISO=formatISO;const momo_types_1=require("@m0saic/momo-types"),m0Validation_1=require("../m0Validation");function serializeM0File(i){const e=(0,m0Validation_1.canonicalizeAndValidateM0)("serializeM0File",i.m0,"serializeM0File: m0 layout string cannot be empty."),t=i.created??new Date,n=i.app??null?String(i.app).trim():null,u=i.appVersion??null?String(i.appVersion).trim():null,c=i.meta??null,s=i.size??null;s&&assertValidSize(s.width,s.height);const r=["# m0","# version: 1",`# created: ${formatISO(t)}`];if(s&&r.push(`# size: ${s.width}x${s.height}`),n&&r.push(`# app: ${n}`),u&&r.push(`# appVersion: ${u}`),c){const l=["title","author","source","note"];for(const p of l){const m=c[p];m!=null&&m.trim()!==""&&r.push(`# ${p}: ${m.trim()}`)}}return appendAgentLines(r,i.agent??null),r.push(""),r.push(e),r.join(`
+"use strict";var l=Object.defineProperty;var o=(i,e)=>l(i,"name",{value:e,configurable:!0});Object.defineProperty(exports,"__esModule",{value:!0}),exports.serializeM0File=serializeM0File,exports.formatISO=formatISO;const agent_1=require("../agent"),m0Validation_1=require("../m0Validation");function serializeM0File(i){const e=(0,m0Validation_1.canonicalizeAndValidateM0)("serializeM0File",i.m0,"serializeM0File: m0 layout string cannot be empty."),t=i.created??new Date,n=i.app??null?String(i.app).trim():null,u=i.appVersion??null?String(i.appVersion).trim():null,c=i.meta??null,s=i.size??null;s&&assertValidSize(s.width,s.height);const r=["# m0","# version: 1",`# created: ${formatISO(t)}`];if(s&&r.push(`# size: ${s.width}x${s.height}`),n&&r.push(`# app: ${n}`),u&&r.push(`# appVersion: ${u}`),c){const a=["title","author","source","note"];for(const p of a){const m=c[p];m!=null&&m.trim()!==""&&r.push(`# ${p}: ${m.trim()}`)}}return appendAgentLines(r,i.agent??null),r.push(""),r.push(e),r.join(`
 `)+`
-`}o(serializeM0File,"serializeM0File");function appendAgentLines(i,e){if(e){if(e.id&&e.id.trim()!==""&&i.push(`# m0agent:id: ${e.id.trim()}`),e.note&&e.note.trim()!==""&&i.push(`# m0agent:note: ${collapseToSingleLine(e.note)}`),e.question&&e.question.trim()!==""&&i.push(`# m0agent:question: ${collapseToSingleLine(e.question)}`),e.regions&&Object.keys(e.regions).length>0&&i.push(`# m0agent:regions: ${JSON.stringify(e.regions)}`),e.context!==void 0){const t=(0,momo_types_1.normalizeCandidateContext)(e.context);t!==void 0&&i.push(`# m0agent:context: ${JSON.stringify(t)}`)}if(e.response&&e.response.body.trim()!==""){const t={body:collapseToSingleLine(e.response.body),...e.response.from&&e.response.from.trim()!==""?{from:e.response.from.trim()}:{},...e.response.at&&e.response.at.trim()!==""?{at:e.response.at.trim()}:{}};i.push(`# m0agent:response: ${JSON.stringify(t)}`)}if(e.comments&&e.comments.length>0)for(const t of e.comments){if(!t||typeof t.body!="string"||t.body.trim()==="")continue;const n={...t.id&&t.id.trim()!==""?{id:t.id.trim()}:{},body:collapseToSingleLine(t.body),...t.from&&t.from.trim()!==""?{from:t.from.trim()}:{},...t.at&&t.at.trim()!==""?{at:t.at.trim()}:{}};i.push(`# m0agent:comment: ${JSON.stringify(n)}`)}}}o(appendAgentLines,"appendAgentLines");function collapseToSingleLine(i){return i.replace(/[\r\n]+/g," ").replace(/\s+/g," ").trim()}o(collapseToSingleLine,"collapseToSingleLine");function assertValidSize(i,e){if(!Number.isInteger(i)||i<=0)throw new Error("serializeM0File: width must be a positive integer.");if(!Number.isInteger(e)||e<=0)throw new Error("serializeM0File: height must be a positive integer.")}o(assertValidSize,"assertValidSize");function formatISO(i){const e=o((t,n=2)=>String(t).padStart(n,"0"),"pad");return`${i.getUTCFullYear()}-${e(i.getUTCMonth()+1)}-${e(i.getUTCDate())}T${e(i.getUTCHours())}:${e(i.getUTCMinutes())}:${e(i.getUTCSeconds())}.${e(i.getUTCMilliseconds(),3)}Z`}o(formatISO,"formatISO");
+`}o(serializeM0File,"serializeM0File");function appendAgentLines(i,e){if(e){if(e.id&&e.id.trim()!==""&&i.push(`# m0agent:id: ${e.id.trim()}`),e.note&&e.note.trim()!==""&&i.push(`# m0agent:note: ${collapseToSingleLine(e.note)}`),e.question&&e.question.trim()!==""&&i.push(`# m0agent:question: ${collapseToSingleLine(e.question)}`),e.regions&&Object.keys(e.regions).length>0&&i.push(`# m0agent:regions: ${JSON.stringify(e.regions)}`),e.context!==void 0){const t=(0,agent_1.normalizeCandidateContext)(e.context);t!==void 0&&i.push(`# m0agent:context: ${JSON.stringify(t)}`)}if(e.response&&e.response.body.trim()!==""){const t={body:collapseToSingleLine(e.response.body),...e.response.from&&e.response.from.trim()!==""?{from:e.response.from.trim()}:{},...e.response.at&&e.response.at.trim()!==""?{at:e.response.at.trim()}:{}};i.push(`# m0agent:response: ${JSON.stringify(t)}`)}if(e.comments&&e.comments.length>0)for(const t of e.comments){if(!t||typeof t.body!="string"||t.body.trim()==="")continue;const n={...t.id&&t.id.trim()!==""?{id:t.id.trim()}:{},body:collapseToSingleLine(t.body),...t.from&&t.from.trim()!==""?{from:t.from.trim()}:{},...t.at&&t.at.trim()!==""?{at:t.at.trim()}:{}};i.push(`# m0agent:comment: ${JSON.stringify(n)}`)}}}o(appendAgentLines,"appendAgentLines");function collapseToSingleLine(i){return i.replace(/[\r\n]+/g," ").replace(/\s+/g," ").trim()}o(collapseToSingleLine,"collapseToSingleLine");function assertValidSize(i,e){if(!Number.isInteger(i)||i<=0)throw new Error("serializeM0File: width must be a positive integer.");if(!Number.isInteger(e)||e<=0)throw new Error("serializeM0File: height must be a positive integer.")}o(assertValidSize,"assertValidSize");function formatISO(i){const e=o((t,n=2)=>String(t).padStart(n,"0"),"pad");return`${i.getUTCFullYear()}-${e(i.getUTCMonth()+1)}-${e(i.getUTCDate())}T${e(i.getUTCHours())}:${e(i.getUTCMinutes())}:${e(i.getUTCSeconds())}.${e(i.getUTCMilliseconds(),3)}Z`}o(formatISO,"formatISO");

package/node_modules/@m0saic/dsl-file-formats/dist/cjs/m0c/m0cFile.js

@@ -1,5 +1,5 @@
-"use strict";var w=Object.defineProperty;var u=(e,n)=>w(e,"name",{value:n,configurable:!0});Object.defineProperty(exports,"__esModule",{value:!0}),exports.MOGGING_HEADER=void 0,exports.serializeM0cFile=serializeM0cFile,exports.serializeM0gFile=serializeM0gFile,exports.normalizeAgent=normalizeAgent,exports.parseM0cFile=parseM0cFile,exports.parseAgentOrNull=parseAgentOrNull;const serializeM0File_1=require("../m0/serializeM0File"),m0Validation_1=require("../m0Validation"),momo_types_1=require("@m0saic/momo-types"),derive_1=require("../derive");exports.MOGGING_HEADER="#mogging";function serializeM0cFile(e){const n=e.created??new Date,t=(0,m0Validation_1.canonicalizeAndValidateM0)("serializeM0cFile",e.m0,"serializeM0cFile: m0 layout string cannot be empty."),r=e.size??null;r&&assertValidSize(r.width,r.height);const i=e.app??null,s=e.appVersion??null,o=normalizeMeta(e.meta??null),c=normalizeAgent(e.agent??null),l=normalizeLabels(e.labels??null),a=normalizeDerive(e.background!==void 0?e.background:(0,derive_1.encodeBackgroundImage)(e.deriveImage??null)),f=normalizeMasks(e.masks??null),p=normalizeFill(e.fill??null),b=normalizeInsets(e.insets??null),y=normalizeRankSets(e.rankSets??null),d=e.gold??null,m=d!=null,g={format:m?"m0g":"m0c",version:1,created:(0,serializeM0File_1.formatISO)(n),app:i&&i.trim()!==""?i.trim():null,appVersion:s&&s.trim()!==""?s.trim():null,meta:o,agent:c,...m?{gold:d}:{},size:r,m0:t,labels:l,derive:a,masks:f,fill:p,insets:b,rankSets:y,custom:e.custom??null},h=JSON.stringify(g,null,2)+`
+"use strict";var w=Object.defineProperty;var u=(e,n)=>w(e,"name",{value:n,configurable:!0});Object.defineProperty(exports,"__esModule",{value:!0}),exports.MOGGING_HEADER=void 0,exports.serializeM0cFile=serializeM0cFile,exports.serializeM0gFile=serializeM0gFile,exports.normalizeAgent=normalizeAgent,exports.parseM0cFile=parseM0cFile,exports.parseAgentOrNull=parseAgentOrNull;const serializeM0File_1=require("../m0/serializeM0File"),m0Validation_1=require("../m0Validation"),agent_1=require("../agent"),derive_1=require("../derive");exports.MOGGING_HEADER="#mogging";function serializeM0cFile(e){const n=e.created??new Date,t=(0,m0Validation_1.canonicalizeAndValidateM0)("serializeM0cFile",e.m0,"serializeM0cFile: m0 layout string cannot be empty."),r=e.size??null;r&&assertValidSize(r.width,r.height);const i=e.app??null,s=e.appVersion??null,o=normalizeMeta(e.meta??null),c=normalizeAgent(e.agent??null),l=normalizeLabels(e.labels??null),a=normalizeDerive(e.background!==void 0?e.background:(0,derive_1.encodeBackgroundImage)(e.deriveImage??null)),f=normalizeMasks(e.masks??null),p=normalizeFill(e.fill??null),b=normalizeInsets(e.insets??null),y=normalizeRankSets(e.rankSets??null),d=e.gold??null,m=d!=null,g={format:m?"m0g":"m0c",version:1,created:(0,serializeM0File_1.formatISO)(n),app:i&&i.trim()!==""?i.trim():null,appVersion:s&&s.trim()!==""?s.trim():null,meta:o,agent:c,...m?{gold:d}:{},size:r,m0:t,labels:l,derive:a,masks:f,fill:p,insets:b,rankSets:y,custom:e.custom??null},h=JSON.stringify(g,null,2)+`
 `;return m?`${exports.MOGGING_HEADER}
-${h}`:h}u(serializeM0cFile,"serializeM0cFile");function serializeM0gFile(e){return serializeM0cFile(e)}u(serializeM0gFile,"serializeM0gFile");function normalizeAgent(e){if(!e)return null;const n={};if(e.id&&e.id.trim()!==""&&(n.id=e.id.trim()),e.note&&e.note.trim()!==""&&(n.note=(0,momo_types_1.normalizeAgentProse)(e.note)),e.question&&e.question.trim()!==""&&(n.question=(0,momo_types_1.normalizeAgentProse)(e.question)),e.regions){const t={};for(const[r,i]of Object.entries(e.regions))typeof i=="string"&&i.trim()!==""&&(t[r]=i);Object.keys(t).length&&(n.regions=t)}if(e.context!==void 0){const t=(0,momo_types_1.normalizeCandidateContext)(e.context);t!==void 0&&(n.context=t)}if(e.response&&e.response.body&&e.response.body.trim()!==""){const t=e.response,r=Array.isArray(t.images)?t.images.filter(i=>typeof i=="string"&&i.length>0):[];n.response={body:(0,momo_types_1.normalizeAgentProse)(t.body),...t.from&&t.from.trim()!==""?{from:t.from.trim()}:{},...t.at&&t.at.trim()!==""?{at:t.at.trim()}:{},...t.src&&t.src.trim()!==""?{src:t.src.trim()}:{},...t.srcMosaic&&t.srcMosaic.trim()!==""?{srcMosaic:t.srcMosaic.trim()}:{},...r.length>0?{images:r}:{}}}if(e.comments&&Array.isArray(e.comments)&&e.comments.length>0){const t=[];for(const r of e.comments)!r||typeof r.body!="string"||r.body.trim()===""||t.push({...r.id&&r.id.trim()!==""?{id:r.id.trim()}:{},body:(0,momo_types_1.normalizeAgentProse)(r.body),...r.from&&r.from.trim()!==""?{from:r.from.trim()}:{},...r.at&&r.at.trim()!==""?{at:r.at.trim()}:{}});t.length&&(n.comments=t)}return Object.keys(n).length?n:null}u(normalizeAgent,"normalizeAgent");function normalizeMeta(e){if(!e)return null;const n={},t=["title","author","source","note"];for(const r of t){const i=e[r];if(i!=null){const s=i.trim();s!==""&&(n[r]=s)}}return Object.keys(n).length?n:null}u(normalizeMeta,"normalizeMeta");function normalizeLabels(e){if(!e)return null;const n={};for(const[t,r]of Object.entries(e).sort(([i],[s])=>i.localeCompare(s))){if(!t||!r)continue;const i=(r.text??"").trim();if(!i)continue;const s=r.color?.trim();n[t]=s?{text:i,color:s}:{text:i}}return Object.keys(n).length?n:null}u(normalizeLabels,"normalizeLabels");function normalizeDerive(e){if(typeof e!="string")return{background:null};const n=e.trim();return{background:n===""?null:n}}u(normalizeDerive,"normalizeDerive");function normalizeMasks(e){if(!e)return null;const n={};for(const[t,r]of Object.entries(e).sort(([i],[s])=>i.localeCompare(s))){if(!t)continue;if(r===null){n[t]=null;continue}if(!r||typeof r.localPath!="string"||r.localPath.trim()==="")continue;const i=r.bounds;!i||typeof i.x!="number"||typeof i.y!="number"||typeof i.width!="number"||typeof i.height!="number"||(n[t]={localPath:r.localPath,bounds:{x:i.x,y:i.y,width:i.width,height:i.height}})}return Object.keys(n).length?n:null}u(normalizeMasks,"normalizeMasks");function normalizeFill(e){if(!e)return null;const n={};for(const[t,r]of Object.entries(e).sort(([i],[s])=>i.localeCompare(s))){if(!t||!r)continue;const i=typeof r.color=="string"?r.color.trim():"",s=typeof r.mediaRef=="string"?r.mediaRef.trim():"";if(!i&&!s)continue;const o={};i&&(o.color=i),s&&(o.mediaRef=s),n[t]=o}return Object.keys(n).length?n:null}u(normalizeFill,"normalizeFill");const INSET_EDGES=["top","right","bottom","left"];function normalizeInsets(e){if(!e)return null;const n={};for(const[t,r]of Object.entries(e).sort(([i],[s])=>i.localeCompare(s)))t&&(!r||typeof r!="object"||INSET_EDGES.some(i=>typeof r[i]!="number"||!Number.isFinite(r[i]))||INSET_EDGES.every(i=>r[i]===0)||(n[t]={top:r.top,right:r.right,bottom:r.bottom,left:r.left}));return Object.keys(n).length?n:null}u(normalizeInsets,"normalizeInsets");function normalizeRankSets(e){if(!e)return null;const n={};for(const[t,r]of Object.entries(e).sort(([i],[s])=>i.localeCompare(s))){if(!t)continue;if(r===null){n[t]=null;continue}const i=normalizeRankSet(r);i!==null&&(n[t]=i)}return Object.keys(n).length?n:null}u(normalizeRankSets,"normalizeRankSets");function normalizeRankSet(e){if(!e||typeof e!="object")return null;const n=typeof e.mode=="string"&&e.mode.trim()!==""?e.mode.trim():void 0,t={},r=e.ranks;if(!r||typeof r!="object"||Array.isArray(r))return null;for(const[i,s]of Object.entries(r).sort(([o],[c])=>o.localeCompare(c)))if(i){if(s===null){t[i]=null;continue}typeof s!="number"||!Number.isFinite(s)||(t[i]=s)}return Object.keys(t).length===0&&n===void 0?null:n!==void 0?{mode:n,ranks:t}:{ranks:t}}u(normalizeRankSet,"normalizeRankSet");function assertValidSize(e,n){if(!Number.isInteger(e)||e<=0)throw new Error("serializeM0cFile: width must be a positive integer.");if(!Number.isInteger(n)||n<=0)throw new Error("serializeM0cFile: height must be a positive integer.")}u(assertValidSize,"assertValidSize");function stripLeadingHashComments(e){const n=e.split(`
+${h}`:h}u(serializeM0cFile,"serializeM0cFile");function serializeM0gFile(e){return serializeM0cFile(e)}u(serializeM0gFile,"serializeM0gFile");function normalizeAgent(e){if(!e)return null;const n={};if(e.id&&e.id.trim()!==""&&(n.id=e.id.trim()),e.note&&e.note.trim()!==""&&(n.note=(0,agent_1.normalizeAgentProse)(e.note)),e.question&&e.question.trim()!==""&&(n.question=(0,agent_1.normalizeAgentProse)(e.question)),e.regions){const t={};for(const[r,i]of Object.entries(e.regions))typeof i=="string"&&i.trim()!==""&&(t[r]=i);Object.keys(t).length&&(n.regions=t)}if(e.context!==void 0){const t=(0,agent_1.normalizeCandidateContext)(e.context);t!==void 0&&(n.context=t)}if(e.response&&e.response.body&&e.response.body.trim()!==""){const t=e.response,r=Array.isArray(t.images)?t.images.filter(i=>typeof i=="string"&&i.length>0):[];n.response={body:(0,agent_1.normalizeAgentProse)(t.body),...t.from&&t.from.trim()!==""?{from:t.from.trim()}:{},...t.at&&t.at.trim()!==""?{at:t.at.trim()}:{},...t.src&&t.src.trim()!==""?{src:t.src.trim()}:{},...t.srcMosaic&&t.srcMosaic.trim()!==""?{srcMosaic:t.srcMosaic.trim()}:{},...r.length>0?{images:r}:{}}}if(e.comments&&Array.isArray(e.comments)&&e.comments.length>0){const t=[];for(const r of e.comments)!r||typeof r.body!="string"||r.body.trim()===""||t.push({...r.id&&r.id.trim()!==""?{id:r.id.trim()}:{},body:(0,agent_1.normalizeAgentProse)(r.body),...r.from&&r.from.trim()!==""?{from:r.from.trim()}:{},...r.at&&r.at.trim()!==""?{at:r.at.trim()}:{}});t.length&&(n.comments=t)}return Object.keys(n).length?n:null}u(normalizeAgent,"normalizeAgent");function normalizeMeta(e){if(!e)return null;const n={},t=["title","author","source","note"];for(const r of t){const i=e[r];if(i!=null){const s=i.trim();s!==""&&(n[r]=s)}}return Object.keys(n).length?n:null}u(normalizeMeta,"normalizeMeta");function normalizeLabels(e){if(!e)return null;const n={};for(const[t,r]of Object.entries(e).sort(([i],[s])=>i.localeCompare(s))){if(!t||!r)continue;const i=(r.text??"").trim();if(!i)continue;const s=r.color?.trim();n[t]=s?{text:i,color:s}:{text:i}}return Object.keys(n).length?n:null}u(normalizeLabels,"normalizeLabels");function normalizeDerive(e){if(typeof e!="string")return{background:null};const n=e.trim();return{background:n===""?null:n}}u(normalizeDerive,"normalizeDerive");function normalizeMasks(e){if(!e)return null;const n={};for(const[t,r]of Object.entries(e).sort(([i],[s])=>i.localeCompare(s))){if(!t)continue;if(r===null){n[t]=null;continue}if(!r||typeof r.localPath!="string"||r.localPath.trim()==="")continue;const i=r.bounds;!i||typeof i.x!="number"||typeof i.y!="number"||typeof i.width!="number"||typeof i.height!="number"||(n[t]={localPath:r.localPath,bounds:{x:i.x,y:i.y,width:i.width,height:i.height}})}return Object.keys(n).length?n:null}u(normalizeMasks,"normalizeMasks");function normalizeFill(e){if(!e)return null;const n={};for(const[t,r]of Object.entries(e).sort(([i],[s])=>i.localeCompare(s))){if(!t||!r)continue;const i=typeof r.color=="string"?r.color.trim():"",s=typeof r.mediaRef=="string"?r.mediaRef.trim():"";if(!i&&!s)continue;const o={};i&&(o.color=i),s&&(o.mediaRef=s),n[t]=o}return Object.keys(n).length?n:null}u(normalizeFill,"normalizeFill");const INSET_EDGES=["top","right","bottom","left"];function normalizeInsets(e){if(!e)return null;const n={};for(const[t,r]of Object.entries(e).sort(([i],[s])=>i.localeCompare(s)))t&&(!r||typeof r!="object"||INSET_EDGES.some(i=>typeof r[i]!="number"||!Number.isFinite(r[i]))||INSET_EDGES.every(i=>r[i]===0)||(n[t]={top:r.top,right:r.right,bottom:r.bottom,left:r.left}));return Object.keys(n).length?n:null}u(normalizeInsets,"normalizeInsets");function normalizeRankSets(e){if(!e)return null;const n={};for(const[t,r]of Object.entries(e).sort(([i],[s])=>i.localeCompare(s))){if(!t)continue;if(r===null){n[t]=null;continue}const i=normalizeRankSet(r);i!==null&&(n[t]=i)}return Object.keys(n).length?n:null}u(normalizeRankSets,"normalizeRankSets");function normalizeRankSet(e){if(!e||typeof e!="object")return null;const n=typeof e.mode=="string"&&e.mode.trim()!==""?e.mode.trim():void 0,t={},r=e.ranks;if(!r||typeof r!="object"||Array.isArray(r))return null;for(const[i,s]of Object.entries(r).sort(([o],[c])=>o.localeCompare(c)))if(i){if(s===null){t[i]=null;continue}typeof s!="number"||!Number.isFinite(s)||(t[i]=s)}return Object.keys(t).length===0&&n===void 0?null:n!==void 0?{mode:n,ranks:t}:{ranks:t}}u(normalizeRankSet,"normalizeRankSet");function assertValidSize(e,n){if(!Number.isInteger(e)||e<=0)throw new Error("serializeM0cFile: width must be a positive integer.");if(!Number.isInteger(n)||n<=0)throw new Error("serializeM0cFile: height must be a positive integer.")}u(assertValidSize,"assertValidSize");function stripLeadingHashComments(e){const n=e.split(`
 `);let t=0;for(;t<n.length;){const r=n[t].trim();if(r===""||r.startsWith("#")){t++;continue}break}return n.slice(t).join(`
-`)}u(stripLeadingHashComments,"stripLeadingHashComments");function parseGoldOrNull(e){if(!isPlainObject(e))return null;const n=e,t={};return typeof n.promotedAt=="string"&&(t.promotedAt=n.promotedAt),typeof n.provenance=="string"&&(t.provenance=n.provenance),"criteria"in n&&(t.criteria=n.criteria),t}u(parseGoldOrNull,"parseGoldOrNull");function parseM0cFile(e){if(typeof e!="string")throw new Error("parseM0cFile: input must be a string");let n;try{n=JSON.parse(stripLeadingHashComments(e))}catch{throw new Error("parseM0cFile: invalid JSON")}if(!isPlainObject(n))throw new Error("parseM0cFile: expected JSON object");const t=n;if(t.format!=="m0c"&&t.format!=="m0g")throw new Error(`parseM0cFile: expected format "m0c" or "m0g", got "${String(t.format)}"`);if(t.version!==1)throw new Error(`parseM0cFile: expected version 1, got ${String(t.version)}`);const r=typeof t.created=="string"?t.created.trim():"";if(!r)throw new Error("parseM0cFile: missing created timestamp");const i=(0,m0Validation_1.canonicalizeAndValidateM0)("parseM0cFile",typeof t.m0=="string"?t.m0:"","parseM0cFile: missing m0 payload"),s=parseSizeOrNull(t.size),o=parseStringOrNull(t.app),c=parseStringOrNull(t.appVersion),l=parseMetaOrNull(t.meta),a=parseAgentOrNull(t.agent),f=parseGoldOrNull(t.gold),p=parseLabelsOrNull(t.labels),b=parseDerive(t.derive),y=parseMasksOrNull(t.masks),d=parseFillOrNull(t.fill),m=parseInsetsOrNull(t.insets),g=parseRankSetsOrNull(t.rankSets);return{format:t.format,version:1,created:r,app:o,appVersion:c,meta:l,agent:a,...f?{gold:f}:{},size:s,m0:i,labels:p,derive:b,masks:y,fill:d,insets:m,rankSets:g,custom:t.custom===void 0?null:t.custom}}u(parseM0cFile,"parseM0cFile");function parseAgentOrNull(e){if(e==null||!isPlainObject(e))return null;const n=e,t={},r=parseStringOrNull(n.id);r&&(t.id=r);const i=parseStringOrNull(n.note);i&&(t.note=i);const s=parseStringOrNull(n.question);if(s&&(t.question=s),isPlainObject(n.regions)){const o={};for(const[c,l]of Object.entries(n.regions))typeof l=="string"&&l.trim()!==""&&(o[c]=l);Object.keys(o).length&&(t.regions=o)}if("context"in n){const o=(0,momo_types_1.normalizeCandidateContext)(n.context);o!==void 0&&(t.context=o)}if(isPlainObject(n.response)){const o=n.response;if(typeof o.body=="string"&&o.body.trim()!==""){const c={body:o.body};if(typeof o.from=="string"&&o.from.trim()!==""&&(c.from=o.from),typeof o.at=="string"&&o.at.trim()!==""&&(c.at=o.at),typeof o.src=="string"&&o.src.trim()!==""&&(c.src=o.src),typeof o.srcMosaic=="string"&&o.srcMosaic.trim()!==""&&(c.srcMosaic=o.srcMosaic),Array.isArray(o.images)){const l=o.images.filter(a=>typeof a=="string"&&a.length>0);l.length>0&&(c.images=l)}t.response=c}}if(Array.isArray(n.comments)){const o=[];for(const c of n.comments){if(!isPlainObject(c))continue;const l=c;if(typeof l.body!="string"||l.body.trim()==="")continue;const a={body:l.body};typeof l.id=="string"&&l.id.trim()!==""&&(a.id=l.id),typeof l.from=="string"&&l.from.trim()!==""&&(a.from=l.from),typeof l.at=="string"&&l.at.trim()!==""&&(a.at=l.at),o.push(a)}o.length&&(t.comments=o)}return Object.keys(t).length?t:null}u(parseAgentOrNull,"parseAgentOrNull");function parseStringOrNull(e){if(e==null||typeof e!="string")return null;const n=e.trim();return n||null}u(parseStringOrNull,"parseStringOrNull");function parseSizeOrNull(e){if(e==null||!isPlainObject(e))return null;const n=e.width,t=e.height;if(typeof n!="number"||typeof t!="number"||!Number.isInteger(n)||!Number.isInteger(t)||n<=0||t<=0)throw new Error("parseM0cFile: invalid size (expected {width,height} positive ints or null)");return{width:n,height:t}}u(parseSizeOrNull,"parseSizeOrNull");function parseMetaOrNull(e){if(e==null)return null;if(!isPlainObject(e))throw new Error("parseM0cFile: invalid meta (expected object or null)");const n=e,t={};for(const r of["title","author","source","note"]){const i=n[r];if(typeof i=="string"){const s=i.trim();s&&(t[r]=s)}}return Object.keys(t).length?t:null}u(parseMetaOrNull,"parseMetaOrNull");function parseLabelsOrNull(e){if(e==null)return null;if(!isPlainObject(e)||Array.isArray(e))throw new Error("parseM0cFile: invalid labels (expected object map or null)");const n=e,t={};for(const[r,i]of Object.entries(n)){if(!r||!isPlainObject(i))continue;const s=i.text,o=typeof s=="string"?s.trim():"";if(!o)continue;const c=i.color,l=typeof c=="string"?c.trim():void 0;t[r]=l?{text:o,color:l}:{text:o}}return Object.keys(t).length?t:null}u(parseLabelsOrNull,"parseLabelsOrNull");function parseDerive(e){if(e==null)return{background:null};if(!isPlainObject(e))throw new Error("parseM0cFile: invalid derive (expected object or null)");const n=e.background;if(n==null)return{background:null};if(typeof n!="string")throw new Error("parseM0cFile: invalid derive.background (expected string or null)");const t=n.trim();return{background:t===""?null:t}}u(parseDerive,"parseDerive");function parseMasksOrNull(e){if(e==null)return null;if(!isPlainObject(e)||Array.isArray(e))throw new Error("parseM0cFile: invalid masks (expected object map or null)");const n=e,t={};for(const[r,i]of Object.entries(n)){if(!r)continue;if(i===null){t[r]=null;continue}if(!isPlainObject(i))throw new Error(`parseM0cFile: invalid masks["${r}"] (expected object or null)`);const s=i.localPath;if(typeof s!="string"||s.trim()==="")throw new Error(`parseM0cFile: invalid masks["${r}"].localPath (expected non-empty string)`);const o=i.bounds;if(!isPlainObject(o))throw new Error(`parseM0cFile: invalid masks["${r}"].bounds (expected object)`);const c=o.x,l=o.y,a=o.width,f=o.height;if(typeof c!="number"||typeof l!="number"||typeof a!="number"||typeof f!="number"||!Number.isFinite(c)||!Number.isFinite(l)||!Number.isFinite(a)||!Number.isFinite(f))throw new Error(`parseM0cFile: invalid masks["${r}"].bounds (x/y/width/height must be finite numbers)`);t[r]={localPath:s,bounds:{x:c,y:l,width:a,height:f}}}return Object.keys(t).length?t:null}u(parseMasksOrNull,"parseMasksOrNull");function parseFillOrNull(e){if(e==null)return null;if(!isPlainObject(e)||Array.isArray(e))throw new Error("parseM0cFile: invalid fill (expected object map or null)");const n=e,t={};for(const[r,i]of Object.entries(n)){if(!r)continue;if(!isPlainObject(i))throw new Error(`parseM0cFile: invalid fill["${r}"] (expected object)`);const s=i.color,o=i.mediaRef,c=typeof s=="string"?s.trim():"",l=typeof o=="string"?o.trim():"";if(!c&&!l)continue;const a={};c&&(a.color=c),l&&(a.mediaRef=l),t[r]=a}return Object.keys(t).length?t:null}u(parseFillOrNull,"parseFillOrNull");function parseInsetsOrNull(e){if(e==null)return null;if(!isPlainObject(e)||Array.isArray(e))throw new Error("parseM0cFile: invalid insets (expected object map or null)");const n=e,t={};for(const[r,i]of Object.entries(n)){if(!r)continue;if(!isPlainObject(i))throw new Error(`parseM0cFile: invalid insets["${r}"] (expected object)`);const s={};for(const o of INSET_EDGES){const c=i[o];if(typeof c!="number"||!Number.isFinite(c))throw new Error(`parseM0cFile: invalid insets["${r}"].${o} (expected finite number)`);s[o]=c}INSET_EDGES.every(o=>s[o]===0)||(t[r]={top:s.top,right:s.right,bottom:s.bottom,left:s.left})}return Object.keys(t).length?t:null}u(parseInsetsOrNull,"parseInsetsOrNull");function parseRankSetsOrNull(e){if(e==null)return null;if(!isPlainObject(e)||Array.isArray(e))throw new Error("parseM0cFile: invalid rankSets (expected object map or null)");const n=e,t={};for(const[r,i]of Object.entries(n)){if(!r)continue;if(i===null){t[r]=null;continue}if(!isPlainObject(i))throw new Error(`parseM0cFile: invalid rankSets["${r}"] (expected object or null)`);const s=i.mode,o=s===void 0?void 0:typeof s=="string"?s:(()=>{throw new Error(`parseM0cFile: invalid rankSets["${r}"].mode (expected string or absent)`)})(),c=i.ranks;if(!isPlainObject(c)||Array.isArray(c))throw new Error(`parseM0cFile: invalid rankSets["${r}"].ranks (expected object map keyed by stableKey)`);const l={};for(const[a,f]of Object.entries(c))if(a){if(f===null){l[a]=null;continue}if(typeof f!="number"||!Number.isFinite(f))throw new Error(`parseM0cFile: invalid rankSets["${r}"].ranks["${a}"] (expected finite number or null)`);l[a]=f}t[r]=o!==void 0?{mode:o,ranks:l}:{ranks:l}}return Object.keys(t).length?t:null}u(parseRankSetsOrNull,"parseRankSetsOrNull");function isPlainObject(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}u(isPlainObject,"isPlainObject");
+`)}u(stripLeadingHashComments,"stripLeadingHashComments");function parseGoldOrNull(e){if(!isPlainObject(e))return null;const n=e,t={};return typeof n.promotedAt=="string"&&(t.promotedAt=n.promotedAt),typeof n.provenance=="string"&&(t.provenance=n.provenance),"criteria"in n&&(t.criteria=n.criteria),t}u(parseGoldOrNull,"parseGoldOrNull");function parseM0cFile(e){if(typeof e!="string")throw new Error("parseM0cFile: input must be a string");let n;try{n=JSON.parse(stripLeadingHashComments(e))}catch{throw new Error("parseM0cFile: invalid JSON")}if(!isPlainObject(n))throw new Error("parseM0cFile: expected JSON object");const t=n;if(t.format!=="m0c"&&t.format!=="m0g")throw new Error(`parseM0cFile: expected format "m0c" or "m0g", got "${String(t.format)}"`);if(t.version!==1)throw new Error(`parseM0cFile: expected version 1, got ${String(t.version)}`);const r=typeof t.created=="string"?t.created.trim():"";if(!r)throw new Error("parseM0cFile: missing created timestamp");const i=(0,m0Validation_1.canonicalizeAndValidateM0)("parseM0cFile",typeof t.m0=="string"?t.m0:"","parseM0cFile: missing m0 payload"),s=parseSizeOrNull(t.size),o=parseStringOrNull(t.app),c=parseStringOrNull(t.appVersion),l=parseMetaOrNull(t.meta),a=parseAgentOrNull(t.agent),f=parseGoldOrNull(t.gold),p=parseLabelsOrNull(t.labels),b=parseDerive(t.derive),y=parseMasksOrNull(t.masks),d=parseFillOrNull(t.fill),m=parseInsetsOrNull(t.insets),g=parseRankSetsOrNull(t.rankSets);return{format:t.format,version:1,created:r,app:o,appVersion:c,meta:l,agent:a,...f?{gold:f}:{},size:s,m0:i,labels:p,derive:b,masks:y,fill:d,insets:m,rankSets:g,custom:t.custom===void 0?null:t.custom}}u(parseM0cFile,"parseM0cFile");function parseAgentOrNull(e){if(e==null||!isPlainObject(e))return null;const n=e,t={},r=parseStringOrNull(n.id);r&&(t.id=r);const i=parseStringOrNull(n.note);i&&(t.note=i);const s=parseStringOrNull(n.question);if(s&&(t.question=s),isPlainObject(n.regions)){const o={};for(const[c,l]of Object.entries(n.regions))typeof l=="string"&&l.trim()!==""&&(o[c]=l);Object.keys(o).length&&(t.regions=o)}if("context"in n){const o=(0,agent_1.normalizeCandidateContext)(n.context);o!==void 0&&(t.context=o)}if(isPlainObject(n.response)){const o=n.response;if(typeof o.body=="string"&&o.body.trim()!==""){const c={body:o.body};if(typeof o.from=="string"&&o.from.trim()!==""&&(c.from=o.from),typeof o.at=="string"&&o.at.trim()!==""&&(c.at=o.at),typeof o.src=="string"&&o.src.trim()!==""&&(c.src=o.src),typeof o.srcMosaic=="string"&&o.srcMosaic.trim()!==""&&(c.srcMosaic=o.srcMosaic),Array.isArray(o.images)){const l=o.images.filter(a=>typeof a=="string"&&a.length>0);l.length>0&&(c.images=l)}t.response=c}}if(Array.isArray(n.comments)){const o=[];for(const c of n.comments){if(!isPlainObject(c))continue;const l=c;if(typeof l.body!="string"||l.body.trim()==="")continue;const a={body:l.body};typeof l.id=="string"&&l.id.trim()!==""&&(a.id=l.id),typeof l.from=="string"&&l.from.trim()!==""&&(a.from=l.from),typeof l.at=="string"&&l.at.trim()!==""&&(a.at=l.at),o.push(a)}o.length&&(t.comments=o)}return Object.keys(t).length?t:null}u(parseAgentOrNull,"parseAgentOrNull");function parseStringOrNull(e){if(e==null||typeof e!="string")return null;const n=e.trim();return n||null}u(parseStringOrNull,"parseStringOrNull");function parseSizeOrNull(e){if(e==null||!isPlainObject(e))return null;const n=e.width,t=e.height;if(typeof n!="number"||typeof t!="number"||!Number.isInteger(n)||!Number.isInteger(t)||n<=0||t<=0)throw new Error("parseM0cFile: invalid size (expected {width,height} positive ints or null)");return{width:n,height:t}}u(parseSizeOrNull,"parseSizeOrNull");function parseMetaOrNull(e){if(e==null)return null;if(!isPlainObject(e))throw new Error("parseM0cFile: invalid meta (expected object or null)");const n=e,t={};for(const r of["title","author","source","note"]){const i=n[r];if(typeof i=="string"){const s=i.trim();s&&(t[r]=s)}}return Object.keys(t).length?t:null}u(parseMetaOrNull,"parseMetaOrNull");function parseLabelsOrNull(e){if(e==null)return null;if(!isPlainObject(e)||Array.isArray(e))throw new Error("parseM0cFile: invalid labels (expected object map or null)");const n=e,t={};for(const[r,i]of Object.entries(n)){if(!r||!isPlainObject(i))continue;const s=i.text,o=typeof s=="string"?s.trim():"";if(!o)continue;const c=i.color,l=typeof c=="string"?c.trim():void 0;t[r]=l?{text:o,color:l}:{text:o}}return Object.keys(t).length?t:null}u(parseLabelsOrNull,"parseLabelsOrNull");function parseDerive(e){if(e==null)return{background:null};if(!isPlainObject(e))throw new Error("parseM0cFile: invalid derive (expected object or null)");const n=e.background;if(n==null)return{background:null};if(typeof n!="string")throw new Error("parseM0cFile: invalid derive.background (expected string or null)");const t=n.trim();return{background:t===""?null:t}}u(parseDerive,"parseDerive");function parseMasksOrNull(e){if(e==null)return null;if(!isPlainObject(e)||Array.isArray(e))throw new Error("parseM0cFile: invalid masks (expected object map or null)");const n=e,t={};for(const[r,i]of Object.entries(n)){if(!r)continue;if(i===null){t[r]=null;continue}if(!isPlainObject(i))throw new Error(`parseM0cFile: invalid masks["${r}"] (expected object or null)`);const s=i.localPath;if(typeof s!="string"||s.trim()==="")throw new Error(`parseM0cFile: invalid masks["${r}"].localPath (expected non-empty string)`);const o=i.bounds;if(!isPlainObject(o))throw new Error(`parseM0cFile: invalid masks["${r}"].bounds (expected object)`);const c=o.x,l=o.y,a=o.width,f=o.height;if(typeof c!="number"||typeof l!="number"||typeof a!="number"||typeof f!="number"||!Number.isFinite(c)||!Number.isFinite(l)||!Number.isFinite(a)||!Number.isFinite(f))throw new Error(`parseM0cFile: invalid masks["${r}"].bounds (x/y/width/height must be finite numbers)`);t[r]={localPath:s,bounds:{x:c,y:l,width:a,height:f}}}return Object.keys(t).length?t:null}u(parseMasksOrNull,"parseMasksOrNull");function parseFillOrNull(e){if(e==null)return null;if(!isPlainObject(e)||Array.isArray(e))throw new Error("parseM0cFile: invalid fill (expected object map or null)");const n=e,t={};for(const[r,i]of Object.entries(n)){if(!r)continue;if(!isPlainObject(i))throw new Error(`parseM0cFile: invalid fill["${r}"] (expected object)`);const s=i.color,o=i.mediaRef,c=typeof s=="string"?s.trim():"",l=typeof o=="string"?o.trim():"";if(!c&&!l)continue;const a={};c&&(a.color=c),l&&(a.mediaRef=l),t[r]=a}return Object.keys(t).length?t:null}u(parseFillOrNull,"parseFillOrNull");function parseInsetsOrNull(e){if(e==null)return null;if(!isPlainObject(e)||Array.isArray(e))throw new Error("parseM0cFile: invalid insets (expected object map or null)");const n=e,t={};for(const[r,i]of Object.entries(n)){if(!r)continue;if(!isPlainObject(i))throw new Error(`parseM0cFile: invalid insets["${r}"] (expected object)`);const s={};for(const o of INSET_EDGES){const c=i[o];if(typeof c!="number"||!Number.isFinite(c))throw new Error(`parseM0cFile: invalid insets["${r}"].${o} (expected finite number)`);s[o]=c}INSET_EDGES.every(o=>s[o]===0)||(t[r]={top:s.top,right:s.right,bottom:s.bottom,left:s.left})}return Object.keys(t).length?t:null}u(parseInsetsOrNull,"parseInsetsOrNull");function parseRankSetsOrNull(e){if(e==null)return null;if(!isPlainObject(e)||Array.isArray(e))throw new Error("parseM0cFile: invalid rankSets (expected object map or null)");const n=e,t={};for(const[r,i]of Object.entries(n)){if(!r)continue;if(i===null){t[r]=null;continue}if(!isPlainObject(i))throw new Error(`parseM0cFile: invalid rankSets["${r}"] (expected object or null)`);const s=i.mode,o=s===void 0?void 0:typeof s=="string"?s:(()=>{throw new Error(`parseM0cFile: invalid rankSets["${r}"].mode (expected string or absent)`)})(),c=i.ranks;if(!isPlainObject(c)||Array.isArray(c))throw new Error(`parseM0cFile: invalid rankSets["${r}"].ranks (expected object map keyed by stableKey)`);const l={};for(const[a,f]of Object.entries(c))if(a){if(f===null){l[a]=null;continue}if(typeof f!="number"||!Number.isFinite(f))throw new Error(`parseM0cFile: invalid rankSets["${r}"].ranks["${a}"] (expected finite number or null)`);l[a]=f}t[r]=o!==void 0?{mode:o,ranks:l}:{ranks:l}}return Object.keys(t).length?t:null}u(parseRankSetsOrNull,"parseRankSetsOrNull");function isPlainObject(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}u(isPlainObject,"isPlainObject");

package/node_modules/@m0saic/dsl-file-formats/dist/cjs/types.js

@@ -1 +1 @@
-"use strict";var n=Object.defineProperty;var e=(t,r)=>n(t,"name",{value:r,configurable:!0});Object.defineProperty(exports,"__esModule",{value:!0}),exports.mintAgentId=void 0;var momo_types_1=require("@m0saic/momo-types");Object.defineProperty(exports,"mintAgentId",{enumerable:!0,get:e(function(){return momo_types_1.mintAgentId},"get")});
+"use strict";var n=Object.defineProperty;var e=(t,r)=>n(t,"name",{value:r,configurable:!0});Object.defineProperty(exports,"__esModule",{value:!0}),exports.normalizeCandidateContext=exports.normalizeAgentProse=exports.collapseAgentProse=exports.mintAgentId=void 0;var agent_1=require("./agent");Object.defineProperty(exports,"mintAgentId",{enumerable:!0,get:e(function(){return agent_1.mintAgentId},"get")}),Object.defineProperty(exports,"collapseAgentProse",{enumerable:!0,get:e(function(){return agent_1.collapseAgentProse},"get")}),Object.defineProperty(exports,"normalizeAgentProse",{enumerable:!0,get:e(function(){return agent_1.normalizeAgentProse},"get")}),Object.defineProperty(exports,"normalizeCandidateContext",{enumerable:!0,get:e(function(){return agent_1.normalizeCandidateContext},"get")});

package/node_modules/@m0saic/dsl-file-formats/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m0saic/dsl-file-formats",
-  "version": "1.1.0",
+  "version": "2.0.1",
   "main": "./dist/cjs/index.js",
   "exports": {
     ".": {

package/node_modules/@m0saic/dsl-stdlib/dist/cjs/builders/bakeM0cInsets.js

@@ -0,0 +1 @@
+"use strict";var S=Object.defineProperty;var c=(e,n)=>S(e,"name",{value:n,configurable:!0});Object.defineProperty(exports,"__esModule",{value:!0}),exports.bakeM0cInsets=bakeM0cInsets,exports.lowerM0cToM0=lowerM0cToM0;const dsl_file_formats_1=require("@m0saic/dsl-file-formats"),rebuildRects_1=require("./rebuildRects"),packLeafRects_1=require("./_internal/packLeafRects"),queryFrames_1=require("../queries/queryFrames"),output_1=require("../transforms/_internal/output"),INSET_EDGES=["top","right","bottom","left"];function isMeaningfulInset(e){if(!e||typeof e!="object")return!1;const n=e;return INSET_EDGES.some(s=>typeof n[s]!="number"||!Number.isFinite(n[s]))?!1:INSET_EDGES.some(s=>n[s]>0)}c(isMeaningfulInset,"isMeaningfulInset");function insetRect(e,n){const s=Math.floor(n.left*e.w),u=Math.floor(n.right*e.w),r=Math.floor(n.top*e.h),a=Math.floor(n.bottom*e.h);return{x:e.x+s,y:e.y+r,w:Math.max(1,e.w-(s+u)),h:Math.max(1,e.h-(r+a))}}c(insetRect,"insetRect");function sameRect(e,n){return e.x===n.x&&e.y===n.y&&e.w===n.w&&e.h===n.h}c(sameRect,"sameRect");function carryMap(e,n,s){if(!e)return e;const u={};let r=!1;for(const[a,d]of Object.entries(e)){const f=n.get(a)??a;if(!s.has(f)){r=!0;continue}f!==a&&(r=!0),u[f]=d}return r?u:e}c(carryMap,"carryMap");function bakeM0cInsets(e,n={}){const s=Object.entries(e.insets??{}).filter(([,t])=>isMeaningfulInset(t)),u=c((t,o)=>({file:e.insets==null?e:{...e,insets:null},rekey:[],liveKeys:[],meta:{changed:!1,frameCount:t,insetCount:0,orphanInsetKeys:o,dslLengthBefore:e.m0.length,dslLengthAfter:e.m0.length}}),"unchanged");if(s.length===0)return u(0,[]);const r=e.size;if(!r||!Number.isInteger(r.width)||!Number.isInteger(r.height)||r.width<1||r.height<1)throw new Error("bakeM0cInsets: the file carries insets but no canvas size \u2014 insets are fractions of a canvas, so `size` must be set before they can be baked");const{width:a,height:d}=r,f=(0,output_1.validateInputOrThrow)("bakeM0cInsets",e.m0),y=(0,queryFrames_1.queryFrames)(f,{width:a,height:d}),m=y.render();if(m.length===0)throw new Error("bakeM0cInsets: document has no rendered frames");const w=new Map;for(const t of m)w.set(t.logicalIndex,{x:Math.max(0,Math.round(t.x)),y:Math.max(0,Math.round(t.y)),w:Math.max(1,Math.round(t.width)),h:Math.max(1,Math.round(t.height))});const x=new Map;for(const t of y.editor().filter(packLeafRects_1.isRenderedLeaf)){if(t.logicalIndex==null)continue;const o=w.get(t.logicalIndex);o&&x.set(String(t.meta.stableKey),o)}const p={},M=[];let b=0;for(const[t,o]of s){const l=x.get(t);if(!l){M.push(t);continue}const i=insetRect(l,o);sameRect(i,l)||(p[t]=i,b++)}if(b===0)return u(m.length,M);const h=(0,rebuildRects_1.rebuildRects)({m0:f,width:a,height:d,overrides:p,reduceSplits:n.reduceSplits??!0}),g=new Map(h.rekey.map(t=>[t.from,t.to])),k=new Set(h.liveKeys);let I=e.rankSets;if(e.rankSets){let t=!1;const o={};for(const[l,i]of Object.entries(e.rankSets)){if(i?.ranks){const _=carryMap(i.ranks,g,k);if(_!==i.ranks){o[l]={...i,ranks:_??{}},t=!0;continue}}o[l]=i}t&&(I=o)}return{file:{...e,m0:h.m0,labels:carryMap(e.labels,g,k)??null,...e.masks!==void 0?{masks:carryMap(e.masks,g,k)}:{},...e.fill!==void 0?{fill:carryMap(e.fill,g,k)}:{},insets:null,...e.rankSets!==void 0?{rankSets:I}:{}},rekey:h.rekey,liveKeys:h.liveKeys,meta:{changed:!0,frameCount:m.length,insetCount:b,orphanInsetKeys:M,dslLengthBefore:f.length,dslLengthAfter:h.m0.length}}}c(bakeM0cInsets,"bakeM0cInsets");function lowerM0cToM0(e,n={}){const s=bakeM0cInsets(e,n);return{file:(0,dsl_file_formats_1.downgradeM0cToM0)(s.file),baked:s.meta}}c(lowerM0cToM0,"lowerM0cToM0");

package/node_modules/@m0saic/dsl-stdlib/dist/cjs/builders/index.js

@@ -1 +1 @@
-"use strict";var n=Object.defineProperty;var e=(t,r)=>n(t,"name",{value:r,configurable:!0});Object.defineProperty(exports,"__esModule",{value:!0}),exports.formatTick=exports.categoryCenters=exports.project=exports.linearScale=exports.niceNum=exports.compactLossless=exports.bakeInsets=exports.rebuildRects=exports.compactDocument=exports.goldenRect=exports.goldenSpiral=exports.goldenSplit=exports.snapGridEnumerate=exports.snapGridFind=exports.snapGridFit=exports.rankedList=exports.comparison=exports.spotlight=exports.safeCanvas=exports.aspectSafeGrid=exports.placeInsetRects=exports.placeOptimizedRects=exports.snapRectPrecision=exports.placeRects=exports.placeRect=exports.aspectFit=exports.strip=exports.grid=exports.container=exports.weightedSplit=exports.weightedTokens=exports.equalSplit=void 0;var equalSplit_1=require("./equalSplit");Object.defineProperty(exports,"equalSplit",{enumerable:!0,get:e(function(){return equalSplit_1.equalSplit},"get")});var weightedTokens_1=require("./weightedTokens");Object.defineProperty(exports,"weightedTokens",{enumerable:!0,get:e(function(){return weightedTokens_1.weightedTokens},"get")});var weightedSplit_1=require("./weightedSplit");Object.defineProperty(exports,"weightedSplit",{enumerable:!0,get:e(function(){return weightedSplit_1.weightedSplit},"get")});var container_1=require("./container");Object.defineProperty(exports,"container",{enumerable:!0,get:e(function(){return container_1.container},"get")});var grid_1=require("./grid");Object.defineProperty(exports,"grid",{enumerable:!0,get:e(function(){return grid_1.grid},"get")});var strip_1=require("./strip");Object.defineProperty(exports,"strip",{enumerable:!0,get:e(function(){return strip_1.strip},"get")});var aspectFit_1=require("./aspectFit");Object.defineProperty(exports,"aspectFit",{enumerable:!0,get:e(function(){return aspectFit_1.aspectFit},"get")});var placeRect_1=require("./placeRect");Object.defineProperty(exports,"placeRect",{enumerable:!0,get:e(function(){return placeRect_1.placeRect},"get")});var placeRects_1=require("./placeRects");Object.defineProperty(exports,"placeRects",{enumerable:!0,get:e(function(){return placeRects_1.placeRects},"get")});var snapRectPrecision_1=require("./snapRectPrecision");Object.defineProperty(exports,"snapRectPrecision",{enumerable:!0,get:e(function(){return snapRectPrecision_1.snapRectPrecision},"get")});var placeOptimizedRects_1=require("./placeOptimizedRects");Object.defineProperty(exports,"placeOptimizedRects",{enumerable:!0,get:e(function(){return placeOptimizedRects_1.placeOptimizedRects},"get")});var placeInsetRects_1=require("./placeInsetRects");Object.defineProperty(exports,"placeInsetRects",{enumerable:!0,get:e(function(){return placeInsetRects_1.placeInsetRects},"get")});var aspectSafeGrid_1=require("./aspectSafeGrid");Object.defineProperty(exports,"aspectSafeGrid",{enumerable:!0,get:e(function(){return aspectSafeGrid_1.aspectSafeGrid},"get")});var safeCanvas_1=require("./safeCanvas");Object.defineProperty(exports,"safeCanvas",{enumerable:!0,get:e(function(){return safeCanvas_1.safeCanvas},"get")});var spotlight_1=require("./spotlight");Object.defineProperty(exports,"spotlight",{enumerable:!0,get:e(function(){return spotlight_1.spotlight},"get")});var comparison_1=require("./comparison");Object.defineProperty(exports,"comparison",{enumerable:!0,get:e(function(){return comparison_1.comparison},"get")});var rankedList_1=require("./rankedList");Object.defineProperty(exports,"rankedList",{enumerable:!0,get:e(function(){return rankedList_1.rankedList},"get")});var snapGrid_1=require("./snapGrid");Object.defineProperty(exports,"snapGridFit",{enumerable:!0,get:e(function(){return snapGrid_1.snapGridFit},"get")}),Object.defineProperty(exports,"snapGridFind",{enumerable:!0,get:e(function(){return snapGrid_1.snapGridFind},"get")}),Object.defineProperty(exports,"snapGridEnumerate",{enumerable:!0,get:e(function(){return snapGrid_1.snapGridEnumerate},"get")});var golden_1=require("./golden");Object.defineProperty(exports,"goldenSplit",{enumerable:!0,get:e(function(){return golden_1.goldenSplit},"get")}),Object.defineProperty(exports,"goldenSpiral",{enumerable:!0,get:e(function(){return golden_1.goldenSpiral},"get")}),Object.defineProperty(exports,"goldenRect",{enumerable:!0,get:e(function(){return golden_1.goldenRect},"get")});var compactDocument_1=require("./compactDocument");Object.defineProperty(exports,"compactDocument",{enumerable:!0,get:e(function(){return compactDocument_1.compactDocument},"get")});var rebuildRects_1=require("./rebuildRects");Object.defineProperty(exports,"rebuildRects",{enumerable:!0,get:e(function(){return rebuildRects_1.rebuildRects},"get")});var bakeInsets_1=require("./bakeInsets");Object.defineProperty(exports,"bakeInsets",{enumerable:!0,get:e(function(){return bakeInsets_1.bakeInsets},"get")});var compactLossless_1=require("./compactLossless");Object.defineProperty(exports,"compactLossless",{enumerable:!0,get:e(function(){return compactLossless_1.compactLossless},"get")});var scale_1=require("./scale");Object.defineProperty(exports,"niceNum",{enumerable:!0,get:e(function(){return scale_1.niceNum},"get")}),Object.defineProperty(exports,"linearScale",{enumerable:!0,get:e(function(){return scale_1.linearScale},"get")}),Object.defineProperty(exports,"project",{enumerable:!0,get:e(function(){return scale_1.project},"get")}),Object.defineProperty(exports,"categoryCenters",{enumerable:!0,get:e(function(){return scale_1.categoryCenters},"get")}),Object.defineProperty(exports,"formatTick",{enumerable:!0,get:e(function(){return scale_1.formatTick},"get")});
+"use strict";var n=Object.defineProperty;var e=(r,t)=>n(r,"name",{value:t,configurable:!0});Object.defineProperty(exports,"__esModule",{value:!0}),exports.formatTick=exports.categoryCenters=exports.project=exports.linearScale=exports.niceNum=exports.compactLossless=exports.bakeInsets=exports.rebuildRects=exports.compactDocument=exports.goldenRect=exports.goldenSpiral=exports.goldenSplit=exports.snapGridEnumerate=exports.snapGridFind=exports.snapGridFit=exports.rankedList=exports.comparison=exports.spotlight=exports.safeCanvas=exports.aspectSafeGrid=exports.lowerM0cToM0=exports.bakeM0cInsets=exports.placeInsetRects=exports.placeOptimizedRects=exports.snapRectPrecision=exports.placeRects=exports.placeRect=exports.aspectFit=exports.strip=exports.grid=exports.container=exports.weightedSplit=exports.weightedTokens=exports.equalSplit=void 0;var equalSplit_1=require("./equalSplit");Object.defineProperty(exports,"equalSplit",{enumerable:!0,get:e(function(){return equalSplit_1.equalSplit},"get")});var weightedTokens_1=require("./weightedTokens");Object.defineProperty(exports,"weightedTokens",{enumerable:!0,get:e(function(){return weightedTokens_1.weightedTokens},"get")});var weightedSplit_1=require("./weightedSplit");Object.defineProperty(exports,"weightedSplit",{enumerable:!0,get:e(function(){return weightedSplit_1.weightedSplit},"get")});var container_1=require("./container");Object.defineProperty(exports,"container",{enumerable:!0,get:e(function(){return container_1.container},"get")});var grid_1=require("./grid");Object.defineProperty(exports,"grid",{enumerable:!0,get:e(function(){return grid_1.grid},"get")});var strip_1=require("./strip");Object.defineProperty(exports,"strip",{enumerable:!0,get:e(function(){return strip_1.strip},"get")});var aspectFit_1=require("./aspectFit");Object.defineProperty(exports,"aspectFit",{enumerable:!0,get:e(function(){return aspectFit_1.aspectFit},"get")});var placeRect_1=require("./placeRect");Object.defineProperty(exports,"placeRect",{enumerable:!0,get:e(function(){return placeRect_1.placeRect},"get")});var placeRects_1=require("./placeRects");Object.defineProperty(exports,"placeRects",{enumerable:!0,get:e(function(){return placeRects_1.placeRects},"get")});var snapRectPrecision_1=require("./snapRectPrecision");Object.defineProperty(exports,"snapRectPrecision",{enumerable:!0,get:e(function(){return snapRectPrecision_1.snapRectPrecision},"get")});var placeOptimizedRects_1=require("./placeOptimizedRects");Object.defineProperty(exports,"placeOptimizedRects",{enumerable:!0,get:e(function(){return placeOptimizedRects_1.placeOptimizedRects},"get")});var placeInsetRects_1=require("./placeInsetRects");Object.defineProperty(exports,"placeInsetRects",{enumerable:!0,get:e(function(){return placeInsetRects_1.placeInsetRects},"get")});var bakeM0cInsets_1=require("./bakeM0cInsets");Object.defineProperty(exports,"bakeM0cInsets",{enumerable:!0,get:e(function(){return bakeM0cInsets_1.bakeM0cInsets},"get")}),Object.defineProperty(exports,"lowerM0cToM0",{enumerable:!0,get:e(function(){return bakeM0cInsets_1.lowerM0cToM0},"get")});var aspectSafeGrid_1=require("./aspectSafeGrid");Object.defineProperty(exports,"aspectSafeGrid",{enumerable:!0,get:e(function(){return aspectSafeGrid_1.aspectSafeGrid},"get")});var safeCanvas_1=require("./safeCanvas");Object.defineProperty(exports,"safeCanvas",{enumerable:!0,get:e(function(){return safeCanvas_1.safeCanvas},"get")});var spotlight_1=require("./spotlight");Object.defineProperty(exports,"spotlight",{enumerable:!0,get:e(function(){return spotlight_1.spotlight},"get")});var comparison_1=require("./comparison");Object.defineProperty(exports,"comparison",{enumerable:!0,get:e(function(){return comparison_1.comparison},"get")});var rankedList_1=require("./rankedList");Object.defineProperty(exports,"rankedList",{enumerable:!0,get:e(function(){return rankedList_1.rankedList},"get")});var snapGrid_1=require("./snapGrid");Object.defineProperty(exports,"snapGridFit",{enumerable:!0,get:e(function(){return snapGrid_1.snapGridFit},"get")}),Object.defineProperty(exports,"snapGridFind",{enumerable:!0,get:e(function(){return snapGrid_1.snapGridFind},"get")}),Object.defineProperty(exports,"snapGridEnumerate",{enumerable:!0,get:e(function(){return snapGrid_1.snapGridEnumerate},"get")});var golden_1=require("./golden");Object.defineProperty(exports,"goldenSplit",{enumerable:!0,get:e(function(){return golden_1.goldenSplit},"get")}),Object.defineProperty(exports,"goldenSpiral",{enumerable:!0,get:e(function(){return golden_1.goldenSpiral},"get")}),Object.defineProperty(exports,"goldenRect",{enumerable:!0,get:e(function(){return golden_1.goldenRect},"get")});var compactDocument_1=require("./compactDocument");Object.defineProperty(exports,"compactDocument",{enumerable:!0,get:e(function(){return compactDocument_1.compactDocument},"get")});var rebuildRects_1=require("./rebuildRects");Object.defineProperty(exports,"rebuildRects",{enumerable:!0,get:e(function(){return rebuildRects_1.rebuildRects},"get")});var bakeInsets_1=require("./bakeInsets");Object.defineProperty(exports,"bakeInsets",{enumerable:!0,get:e(function(){return bakeInsets_1.bakeInsets},"get")});var compactLossless_1=require("./compactLossless");Object.defineProperty(exports,"compactLossless",{enumerable:!0,get:e(function(){return compactLossless_1.compactLossless},"get")});var scale_1=require("./scale");Object.defineProperty(exports,"niceNum",{enumerable:!0,get:e(function(){return scale_1.niceNum},"get")}),Object.defineProperty(exports,"linearScale",{enumerable:!0,get:e(function(){return scale_1.linearScale},"get")}),Object.defineProperty(exports,"project",{enumerable:!0,get:e(function(){return scale_1.project},"get")}),Object.defineProperty(exports,"categoryCenters",{enumerable:!0,get:e(function(){return scale_1.categoryCenters},"get")}),Object.defineProperty(exports,"formatTick",{enumerable:!0,get:e(function(){return scale_1.formatTick},"get")});

package/node_modules/@m0saic/dsl-stdlib/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m0saic/dsl-stdlib",
-  "version": "2.0.0",
+  "version": "3.1.0",
   "main": "./dist/cjs/index.js",
   "exports": {
     ".": {

package/node_modules/@m0saic/knowledge/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 m0saic LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/node_modules/@m0saic/knowledge/README.md

@@ -0,0 +1,71 @@
+# @m0saic/knowledge
+
+The m0saic knowledge base, as plain Markdown: the **m0 handbook** (grammar,
+semantics, the geometry math), the **skills** (engine mental models and
+invariants), and the **template-authoring contract**. It is the same tree the
+m0saic maintainers' agents work from, generated from the monorepo with every
+internal reference rewritten to a public one.
+
+**If you are a coding agent about to write a template: read this file, then
+[`docs/m0saic-thesis.md`](docs/m0saic-thesis.md), then follow the router in
+[`docs/README.md`](docs/README.md).** Nothing here needs a build, a network,
+or a login.
+
+## Where it lives on disk
+
+- Installed: `node_modules/@m0saic/knowledge/docs/` — the template repo
+  starters list this package as a devDependency, so `npm install` puts it
+  beside your code.
+- On GitHub: [`m0saic-project/m0saic-packages/packages/knowledge`](https://github.com/m0saic-project/m0saic-packages/tree/main/packages/knowledge).
+
+## Authority order
+
+1. `docs/handbook/` — canonical truth for the m0 language and its geometry.
+2. `docs/skills/` — mental models and invariants; subordinate to the handbook.
+3. `docs/templates/` — the template contract, construction strategy, recipes,
+   perf rules; subordinate to both.
+
+Handbook wins over skills, skills over templates, and **code wins over every
+doc**: when a document and the packages disagree, the packages are right. The
+one idea everything rests on: a layout is one string of rectangles
+(`docs/m0saic-thesis.md`).
+
+## Read code, not just prose — the three example repos
+
+| Repo | What it is | Good for |
+|---|---|---|
+| [`m0saic-project/m0saic-template-repo-starter`](https://github.com/m0saic-project/m0saic-template-repo-starter) | ~80 one-concept templates, one lesson each, zero-build | learning the shape of a template; copying a pattern in isolation |
+| [`m0saic-project/m0saic-community-templates`](https://github.com/m0saic-project/m0saic-community-templates) | the public library, one folder per publisher, signed releases | a real submission's layout, tests, registry entry, `deprecated.replacement` |
+| [`m0saic-project/m0saic-packages/packages/templates`](https://github.com/m0saic-project/m0saic-packages/tree/main/packages/templates) | the official library that ships in the product (100+ templates) | the house standard for every kind of template: brand, charts, media, data-driven, pipelines |
+
+Start your own from the scaffold:
+[`m0saic-template-repo-starter-base`](https://github.com/m0saic-project/m0saic-template-repo-starter-base)
+(rename its placeholder identity in `src/repo.ts` before you publish).
+
+## Verify before you claim it works
+
+- `validateM0String(str)` from `@m0saic/dsl` — never ship an m0 string you
+  did not validate; `isValidM0String` is the boolean form.
+- `npm run verify` in a starter clone — build, lint, tests, the loader
+  contract, the dependency policy.
+- `m0saic doctor <repo>` — the CLI's convention audit over a template repo;
+  its `latticeSmooth` finding is blocking.
+- `m0saic make <id> --template-repo <repo> --validate-only` — the plan
+  without the render.
+
+## What is deliberately not here
+
+The engine's internals — filtergraph construction, the cost model, the
+ffmpeg walls and their mitigations, the private app internals. Where a page
+would have cited one it says so in plain text ("absent in the shipped copy")
+and stands on its own. Every author-facing consequence of those internals is
+distilled into [`docs/templates/patterns/perf-authoring-rules.md`](docs/templates/patterns/perf-authoring-rules.md).
+
+## Maintenance
+
+`docs/` is generated — do not edit it here. The source is the maintainers'
+knowledge tree in the m0saic monorepo; a sync script regenerates this copy
+and fails if any reference to private code survives. Found something wrong?
+Open an issue on the mirror repo.
+
+MIT — see LICENSE.

package/node_modules/@m0saic/knowledge/dist/index.js

@@ -0,0 +1 @@
+"use strict";const path=require("path"),docsDir=path.join(__dirname,"..","docs");module.exports={docsDir,readme:path.join(__dirname,"..","README.md"),thesis:path.join(docsDir,"m0saic-thesis.md"),router:path.join(docsDir,"README.md")};