npm - aimeat - Versions diffs - 1.40.1 → 2.0.0 - Mend

aimeat 1.40.1 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1567) hide show

package/dist/src/data/library-packs/vendored.js ADDED Viewed

@@ -0,0 +1,381 @@
+export const VENDORED_PACKS = [
+    {
+        id: 'styling',
+        kind: 'bundle',
+        category: 'ui',
+        title: 'Styling stack (Tailwind + daisyUI)',
+        description: 'Self-hosted Tailwind CSS v4 (in-browser JIT) + daisyUI v5 component classes + the AIMEAT theme bridge — utility-class styling without hand-rolled CSS, follows the AIMEAT light/dark theme.',
+        url: '/lib/tailwindcss@4.js',
+        include: [
+            '<link href="{{BASE_URL}}/lib/daisyui@5.css" rel="stylesheet" type="text/css" />',
+            '<link href="{{BASE_URL}}/lib/aimeat-daisyui-bridge.css" rel="stylesheet" type="text/css" />',
+            '<script src="{{BASE_URL}}/lib/tailwindcss@4.js"></script>',
+        ],
+        requires: [],
+        version: 'tailwind 4.3.1 · daisyui 5.5.23',
+        majorPin: 'tailwindcss@4 + daisyui@5',
+        license: 'MIT',
+        sourceUrl: 'https://tailwindcss.com · https://daisyui.com',
+        apiSurface: '(CSS classes)',
+        aiDoc: [
+            'Load all three lines in the <head> (daisyUI CSS, the AIMEAT bridge, then the Tailwind browser JIT).',
+            'Style with Tailwind utility classes (flex, grid, p-4, rounded-xl, ...) and daisyUI components',
+            '(btn, btn-primary, card, badge, modal, navbar, tabs, alert, toggle, ...).',
+            'Theme: the bridge maps daisyUI themes onto the AIMEAT light/dark choice — set',
+            'data-theme="light"|"dark" on <html> from localStorage "aimeat-theme" (the standard theme snippet)',
+            'and both Tailwind and daisyUI follow it. Do not invent your own theme toggle.',
+            'The Tailwind file is an in-browser JIT compiler (~270KB): fine for single-file apps, skip it',
+            'for tiny pages where a handful of CSS variables is enough.',
+            'This is the SAME stack the app-shell templates use — prefer it over hand-rolled CSS frameworks.',
+        ].join('\n'),
+        changelog: [
+            { version: 'tailwind 4.3.1 · daisyui 5.5.23', date: '2026-06-26', summary: 'Initial vendoring: @tailwindcss/browser 4.3.1 + daisyui 5.5.23 + aimeat-daisyui-bridge.css self-hosted at /lib/ (replaces CDN loads in templates). No app-facing API changes since.' },
+        ],
+        demoTemplateId: 'shell-pure-client',
+        tierHint: 'T1',
+        interviewTriggers: ['style', 'design', 'ui', 'tailwind', 'daisyui'],
+        sizeEstimate: '~270KB JIT + ~950KB CSS',
+        status: 'stable',
+        modelTier: 'any',
+        proofs: [
+            { model: 'claude-haiku-4-5', verdict: 'pass', testSet: 'styling-smoke', evidence: 'tools/aeb/results/aeb3-smoke-proofs.md', tokens: 48575, date: '2026-07-17' },
+        ],
+    },
+    {
+        id: 'chartjs',
+        kind: 'vendored',
+        category: 'visualization',
+        title: 'Chart.js 4 (raw)',
+        description: 'Chart.js v4 UMD (window.Chart) self-hosted — full Chart.js API for custom charts; the aimeat-charts cortex wraps this same file with a simpler builder + memory schema.',
+        url: '/lib/chartjs@4.js',
+        include: ['<script src="{{BASE_URL}}/lib/chartjs@4.js"></script>'],
+        requires: [],
+        version: '4.5.1',
+        majorPin: 'chartjs@4',
+        license: 'MIT',
+        sourceUrl: 'https://www.chartjs.org',
+        apiSurface: 'window.Chart',
+        aiDoc: [
+            'Full Chart.js v4 as the window.Chart global (UMD, self-hosted — never load Chart.js from a CDN).',
+            'new Chart(canvasEl, { type, data: { labels, datasets }, options }) — all Chart.js v4 chart types,',
+            'plugins, scales, animations and mixed charts work as documented upstream.',
+            'Responsive by default; put the <canvas> in a sized container (e.g. <div class="h-64">).',
+            'Theme: read the app CSS variables for colors so charts follow light/dark',
+            '(getComputedStyle(document.documentElement).getPropertyValue("--text")).',
+            'Prefer the aimeat-charts pack when a simple declarative chart is enough (one-call builder +',
+            'chart:* memory schema); use this raw pack for custom plugins, annotations or mixed charts.',
+        ].join('\n'),
+        changelog: [
+            { version: '4.5.1', date: '2026-06-26', summary: 'Initial vendoring of chart.js 4.5.1 UMD at /lib/chartjs@4.js. The @4 filename is the compatibility contract — minor/patch updates land in place, a future v5 ships as a NEW chartjs@5.js file.' },
+        ],
+        demoTemplateId: 'shell-cortex',
+        tierHint: 'T1',
+        interviewTriggers: ['chart', 'graph', 'plot', 'dashboard', 'kaavio', 'diagrammi'],
+        sizeEstimate: '~204KB',
+        status: 'stable',
+        modelTier: 'any',
+        proofs: [
+            { model: 'claude-haiku-4-5', verdict: 'pass', testSet: 'chartjs-smoke', evidence: 'tools/aeb/results/aeb3-smoke-proofs.md', tokens: 48057, date: '2026-07-17' },
+        ],
+    },
+    {
+        id: 'mermaid',
+        kind: 'vendored',
+        category: 'diagrams',
+        title: 'Mermaid diagrams',
+        description: 'Mermaid v11 (window.mermaid) self-hosted — render flowcharts, sequence/class/state diagrams, gantt charts and mindmaps from text definitions.',
+        url: '/lib/mermaid/mermaid.min.js',
+        include: ['<script src="{{BASE_URL}}/lib/mermaid/mermaid.min.js"></script>'],
+        requires: [],
+        version: '11.15.0',
+        majorPin: 'mermaid (v11 line)',
+        license: 'MIT',
+        sourceUrl: 'https://mermaid.js.org',
+        apiSurface: 'window.mermaid',
+        aiDoc: [
+            'Mermaid v11 as the window.mermaid global (self-hosted — never load mermaid from a CDN).',
+            'Render text diagram definitions: flowchart TD/LR, sequenceDiagram, classDiagram, stateDiagram-v2,',
+            'gantt, pie, mindmap, timeline, erDiagram.',
+            'Setup once: mermaid.initialize({ startOnLoad: false, theme: dark ? "dark" : "default" });',
+            'Render: const { svg } = await mermaid.render("id-" + n, definition); el.innerHTML = svg;',
+            '(the render id must be unique per call; re-initialize with the new theme when the app theme flips).',
+            'Static/read-only diagrams only — for diagrams the USER edits by dragging nodes, use the',
+            'aimeat-flow pack instead. Note: markdown rendered with AIMEAT.md.renderRich() already renders',
+            '```mermaid fences by itself — you only need this pack for direct diagram rendering.',
+            'Errors: wrap render() in try/catch and show the message; a bad definition throws.',
+        ].join('\n'),
+        changelog: [
+            { version: '11.15.0', date: '2026-06-08', summary: 'Initial vendoring of mermaid 11.15.0 UMD at /lib/mermaid/mermaid.min.js (previously lazy-loaded only by aimeat-markdown renderRich). Promoted to a first-class pack 2026-07-16 — no API change, apps may now load it directly.' },
+            { version: '11.15.0', date: '2026-07-17', summary: 'Promoted to stable: AEB-3 run aeb3-mermaid-001 (diagram notebook task) — treatment passed 5/5 vs control 4/5 (control missed theme-following) at flat token cost, using the documented initialize/render idioms.' },
+        ],
+        demoTemplateId: 'comp-mermaid-diagram',
+        tierHint: 'T1',
+        interviewTriggers: ['diagram', 'flowchart', 'sequence', 'gantt', 'mindmap', 'kaavio', 'vuokaavio'],
+        sizeEstimate: '~3.2MB',
+        status: 'stable',
+        modelTier: 'any',
+    },
+    {
+        id: 'three',
+        kind: 'vendored',
+        category: '3d',
+        title: 'three.js (3D)',
+        description: 'three.js r128 UMD (window.THREE) self-hosted — WebGL 3D scenes: geometry, materials, lights, cameras, OrbitControls-style interaction.',
+        url: '/lib/three.min.js',
+        include: ['<script src="{{BASE_URL}}/lib/three.min.js"></script>'],
+        requires: [],
+        version: 'r128',
+        majorPin: 'three.min.js (r128 UMD)',
+        license: 'MIT',
+        sourceUrl: 'https://threejs.org',
+        apiSurface: 'window.THREE',
+        aiDoc: [
+            'three.js r128 as the window.THREE global (UMD build, self-hosted — never load three from a CDN).',
+            'IMPORTANT: this is the r128 API (2021) — use r128 idioms, NOT current ESM three.js:',
+            '- Geometry: THREE.BoxGeometry etc. (BufferGeometry-based, fine in r128)',
+            '- Renderer: new THREE.WebGLRenderer({ antialias: true }); renderer.setSize(w, h);',
+            '- Color/lighting: renderer.outputEncoding = THREE.sRGBEncoding; use AmbientLight + DirectionalLight',
+            '- Loop: renderer.setAnimationFrame? NO — use requestAnimationFrame(loop) and renderer.render(scene, camera)',
+            '- No addons/examples modules (OrbitControls is NOT bundled) — implement simple pointer-drag',
+            '  camera orbit by rotating the camera position around the target yourself (10 lines).',
+            'Boilerplate: scene = new THREE.Scene(); camera = new THREE.PerspectiveCamera(60, w/h, 0.1, 1000);',
+            'Resize: on window resize update camera.aspect + camera.updateProjectionMatrix() + renderer.setSize.',
+            'Keep polycounts modest (mobile) and dispose geometries/materials you remove.',
+        ].join('\n'),
+        changelog: [
+            { version: 'r128', date: '2026-03-05', summary: 'Initial vendoring of three.js r128 UMD at /lib/three.min.js (the last classic-global era build — later three versions are ESM-only). Promoted to a first-class pack 2026-07-16 — no API change. A future upgrade ships as a NEW file (three@<rev>.module.js), never replaces this one.' },
+            { version: 'r128', date: '2026-07-17', summary: 'Promoted preview -> stable: AEB-3 round 5 (mid-tier model, Haiku 4.5) — with three available the pack arm completed materially MORE domain than the no-pack arm, which dropped domain features (roles, demo data, aggregation) to hand-roll a 3D view. Combined-task win (aeb3-round5-midtier-ab.md); three was load-bearing (3D overview rendered).' },
+        ],
+        demoTemplateId: 'comp-three-scene',
+        tierHint: 'T1',
+        interviewTriggers: ['3d', 'webgl', 'three'],
+        sizeEstimate: '~600KB',
+        status: 'stable',
+        modelTier: 'any',
+        proofs: [
+            { model: 'claude-haiku-4-5', verdict: 'pass', testSet: 'multi-visual', evidence: 'tools/aeb/results/aeb3-round5-midtier-ab.md', tokens: 83799, date: '2026-07-17' },
+        ],
+    },
+    {
+        id: 'p5',
+        kind: 'vendored',
+        category: 'canvas',
+        title: 'p5.js (creative coding)',
+        description: 'p5.js v1 (window.p5) self-hosted — creative coding: generative art, interactive sketches, particles, simple animations with the setup()/draw() model.',
+        url: '/lib/p5@1.min.js',
+        include: ['<script src="{{BASE_URL}}/lib/p5@1.min.js"></script>'],
+        requires: [],
+        version: '1.11.13',
+        majorPin: 'p5@1',
+        license: 'LGPL-2.1',
+        sourceUrl: 'https://p5js.org',
+        apiSurface: 'window.p5',
+        aiDoc: [
+            'p5.js v1 as the window.p5 global (self-hosted — never load p5 from a CDN).',
+            'USE INSTANCE MODE in AIMEAT apps (global mode pollutes window and collides with other libs):',
+            '  new p5(function (s) {',
+            '    s.setup = function () { s.createCanvas(el.clientWidth, 400).parent(el); };',
+            '    s.draw = function () { s.background(s.color(bg)); /* s.fill, s.ellipse, s.noise... */ };',
+            '    s.mousePressed = function () { ... };',
+            '  });',
+            'Every p5 function is called on the instance (s.random, s.map, s.lerp, s.noise, s.frameCount).',
+            'Responsive: s.windowResized = () => s.resizeCanvas(el.clientWidth, 400).',
+            'Theme: read CSS variables for colors (getComputedStyle(document.documentElement).getPropertyValue("--bg")).',
+            'Persist creations by saving the PARAMETERS/seed to AIMEAT.data (not the pixels); for image export',
+            'use canvas.toBlob + AIMEAT.storage.upload.',
+            'License note: p5.js is LGPL-2.1 — fine to load as-is from /lib/, do not fork it into the app.',
+        ].join('\n'),
+        changelog: [
+            { version: '1.11.13', date: '2026-07-16', summary: 'Initial vendoring of p5 1.11.13 at /lib/p5@1.min.js. The @1 filename is the compatibility contract — p5 2.x (API changes) would ship as a NEW p5@2.min.js file.' },
+            { version: '1.11.13', date: '2026-07-17', summary: 'Promoted preview -> stable: AEB-3 round 5 (mid-tier model, Haiku 4.5) — the pack arm used p5 for the lead-flow particle band and completed more domain than the no-pack arm, which hand-rolled it and dropped domain features. Combined-task win (aeb3-round5-midtier-ab.md); p5 was load-bearing (particle band rendered).' },
+        ],
+        demoTemplateId: 'comp-p5-sketch',
+        tierHint: 'T1',
+        interviewTriggers: ['generative', 'creative', 'sketch', 'animation', 'particles', 'taide', 'animaatio'],
+        sizeEstimate: '~1MB',
+        status: 'stable',
+        modelTier: 'any',
+        proofs: [
+            { model: 'claude-haiku-4-5', verdict: 'pass', testSet: 'multi-visual', evidence: 'tools/aeb/results/aeb3-round5-midtier-ab.md', tokens: 83799, date: '2026-07-17' },
+        ],
+    },
+    {
+        id: 'pixi',
+        kind: 'vendored',
+        category: 'canvas',
+        title: 'PixiJS 8 (2D WebGL)',
+        description: 'PixiJS v8 (window.PIXI) self-hosted — fast WebGL/WebGPU 2D rendering: sprites, particles, filters, thousands of moving objects at 60fps.',
+        url: '/lib/pixi@8.min.js',
+        include: [
+            '<script src="{{BASE_URL}}/lib/pixi@8.min.js"></script>',
+            '<script src="{{BASE_URL}}/lib/pixi-unsafe-eval@8.min.js"></script>',
+        ],
+        requires: [],
+        version: '8.19.0',
+        majorPin: 'pixi@8',
+        license: 'MIT',
+        sourceUrl: 'https://pixijs.com',
+        apiSurface: 'window.PIXI',
+        aiDoc: [
+            'PixiJS v8 as the window.PIXI global (self-hosted — never load pixi from a CDN).',
+            'Load BOTH files in order: pixi@8.min.js THEN pixi-unsafe-eval@8.min.js. The second is',
+            'REQUIRED: published AIMEAT apps run under a CSP without unsafe-eval, and PixiJS v8 refuses',
+            'to start without this companion ("Current environment does not allow unsafe-eval").',
+            'CRITICAL — v8 API, NOT the v7 idioms you likely know:',
+            '  const app = new PIXI.Application();            // no options in the constructor',
+            '  await app.init({ background: "#14141c", resizeTo: container });  // async init (v8)',
+            '  container.appendChild(app.canvas);             // app.canvas, NOT app.view (v7)',
+            'Textures: await PIXI.Assets.load(url) (NOT PIXI.Texture.from for remote loads).',
+            'Sprites/graphics: new PIXI.Sprite(texture); new PIXI.Graphics().rect(0,0,w,h).fill(0xe8564a)',
+            '  — v8 Graphics chains shape().fill(), NOT beginFill()/drawRect()/endFill() (v7, removed).',
+            'Ticker: app.ticker.add((ticker) => { thing.x += ticker.deltaTime; }).',
+            'Text: new PIXI.Text({ text: "hi", style: { fill: "#fff", fontSize: 24 } }) (options object, v8).',
+            'Rendering only — no physics/input/scene engine; for a full game engine use the phaser pack.',
+            'Clean up with app.destroy(true) when removing the view.',
+        ].join('\n'),
+        changelog: [
+            { version: '8.19.0', date: '2026-07-16', summary: 'Initial vendoring of pixi.js 8.19.0 at /lib/pixi@8.min.js. v8 has a breaking API vs the v7 most examples show (async app.init, app.canvas, Graphics chain, Assets.load) — the pack doc carries the v8 idioms. A future v9 ships as a NEW pixi@9.min.js.' },
+            { version: '8.19.0', date: '2026-07-17', summary: 'ADDED REQUIRED include: /lib/pixi-unsafe-eval@8.min.js (load after pixi). AEB-3 run aeb3-pixi-001 found PixiJS v8 cannot start under the published-app CSP (no unsafe-eval) without this companion — existing apps that load only pixi@8.min.js show a startup error and should add the second script tag.' },
+        ],
+        demoTemplateId: 'comp-pixi-stage',
+        tierHint: 'T1',
+        interviewTriggers: ['sprite', 'particle', 'webgl', '2d render', 'renderöinti'],
+        sizeEstimate: '~780KB',
+        status: 'preview',
+        modelTier: 'frontier',
+        apiCaveat: 'PixiJS v8, NOT the v7 most examples show: async `await app.init()` + `app.canvas` (not app.view); Graphics chains `new PIXI.Graphics().rect(x,y,w,h).fill(color)` — `beginFill()/drawRect()/fillRect()/lineStyle()` are REMOVED. Load pixi-unsafe-eval@8 AFTER pixi. Fetch the ai_doc before coding.',
+        proofs: [
+            { model: 'claude-haiku-4-5', verdict: 'fail', testSet: 'pixi', evidence: 'tools/aeb/results/aeb3-pixi-perpack.md', tokens: 71955, date: '2026-07-17' },
+        ],
+    },
+    {
+        id: 'phaser',
+        kind: 'vendored',
+        category: 'game',
+        title: 'Phaser 3 (game engine)',
+        description: 'Phaser v3 (window.Phaser) self-hosted — a complete 2D game engine: scenes, arcade physics, input, sprites, animations, sound, camera, scale manager.',
+        url: '/lib/phaser@3.min.js',
+        include: ['<script src="{{BASE_URL}}/lib/phaser@3.min.js"></script>'],
+        requires: [],
+        version: '3.90.0',
+        majorPin: 'phaser@3',
+        license: 'MIT',
+        sourceUrl: 'https://phaser.io',
+        apiSurface: 'window.Phaser',
+        aiDoc: [
+            'Phaser 3 as the window.Phaser global (self-hosted — never load phaser from a CDN).',
+            'Boot: new Phaser.Game({ type: Phaser.AUTO, parent: el, scale: { mode: Phaser.Scale.FIT,',
+            '  autoCenter: Phaser.Scale.CENTER_BOTH, width: 800, height: 600 },',
+            '  physics: { default: "arcade", arcade: { gravity: { y: 0 } } }, scene: { preload, create, update } });',
+            'Standard Phaser 3 idioms work: this.add.text/rectangle/sprite, this.physics.add.sprite,',
+            'this.physics.add.collider, this.input.keyboard.createCursorKeys(), this.input.on("pointerdown"),',
+            'this.tweens.add, this.time.addEvent, scene transitions via this.scene.start("next").',
+            'Assets: prefer GENERATED textures over external files in single-file apps —',
+            '  const g = this.add.graphics(); g.fillStyle(0xe8564a).fillRect(0,0,32,32);',
+            '  g.generateTexture("block", 32, 32); g.destroy();  // then this.add.sprite(x, y, "block")',
+            'High scores / saves via AIMEAT (load aimeat-auth + aimeat-data): save with',
+            '  AIMEAT.data.set("myapp.highscore", { score }, { visibility: "public" }) so a leaderboard can',
+            '  read everyone\'s entries with AIMEAT.data.search("myapp.highscore"). Gate saving on login.',
+            'Multiplayer: pair with the realtime pack (AimeatRealtime rooms) — broadcast input/state, not frames.',
+            'Pause the game loop when the tab hides (game.loop.sleep()/wake()) to be battery-friendly.',
+        ].join('\n'),
+        changelog: [
+            { version: '3.90.0', date: '2026-07-16', summary: 'Initial vendoring of phaser 3.90.0 at /lib/phaser@3.min.js. The @3 filename is the compatibility contract — Phaser 4 ships as a NEW phaser@4.min.js file.' },
+        ],
+        demoTemplateId: 'comp-phaser-arcade',
+        skillRef: 'aimeat-game-apps',
+        tierHint: 'T1',
+        interviewTriggers: ['game', 'peli', 'arcade', 'platformer', 'shooter', 'breakout'],
+        sizeEstimate: '~1.2MB',
+        status: 'preview',
+        modelTier: 'any',
+        proofs: [
+            { model: 'claude-haiku-4-5', verdict: 'pass', testSet: 'phaser-smoke', evidence: 'tools/aeb/results/aeb3-smoke-proofs.md', tokens: 49653, date: '2026-07-17' },
+        ],
+    },
+    {
+        id: 'fonts',
+        kind: 'vendored',
+        category: 'ui',
+        title: 'Display fonts (Baloo 2 + Bangers)',
+        description: 'Self-hosted display fonts for game/brand UIs — Baloo 2 (chunky rounded, variable 400-800) and Bangers (arcade/comic). Latin + latin-ext (Finnish ä/ö covered), SIL OFL 1.1. One CSS include; never load fonts from an external CDN (the app CSP and the vendoring policy both forbid it).',
+        url: '/lib/fonts.css',
+        include: ['<link href="{{BASE_URL}}/lib/fonts.css" rel="stylesheet" type="text/css" />'],
+        requires: [],
+        version: 'Baloo 2 v23 · Bangers v25',
+        majorPin: 'fonts.css (families are additive; a future family ships as a new @font-face, never a replacement)',
+        license: 'OFL-1.1',
+        sourceUrl: 'https://fonts.google.com/specimen/Baloo+2 · https://fonts.google.com/specimen/Bangers',
+        apiSurface: "(CSS) font-family: 'Baloo 2' | 'Bangers'; helper classes .font-display / .font-arcade",
+        aiDoc: [
+            'One include line in <head> gives two self-hosted display families (latin + latin-ext — ä/ö work):',
+            "- 'Baloo 2' — chunky rounded, VARIABLE weight 400-800. The default game/playful display face:",
+            '  headings, stat numbers, buttons. Use font-weight 700-800 for the chunky look.',
+            "- 'Bangers' — arcade/comic caps, single weight 400, tall and loud. Logos, TETRIS!-style",
+            '  combo shouts, one-word titles. All-caps by design; add letter-spacing (~.04em).',
+            "Helper classes: .font-display (Baloo 2 stack) and .font-arcade (Bangers stack), or set",
+            "font-family directly with a system fallback: font-family:'Baloo 2','Segoe UI',system-ui,sans-serif.",
+            'Game-look recipe: pair with extruded text (text-shadow: 8-direction outline + 0 4px 0 shade',
+            '+ soft drop) and sticker cards — the fonts carry the personality, the shadows carry the depth.',
+            'Total ~101 KB for all four woff2 subsets; font-display:swap so text renders instantly.',
+            'Never link fonts.googleapis.com or any external font CDN from an app — self-hosted only.',
+        ].join('\n'),
+        changelog: [
+            { version: 'Baloo 2 v23 · Bangers v25', date: '2026-07-19', summary: 'Initial vendoring (latin + latin-ext woff2, OFL 1.1 — see /lib/fonts/LICENSE.md). Born from pitfall app/candy-palette-alone-is-not-a-game-look: the node had no display fonts, so game UIs fell back to system faces.' },
+        ],
+        tierHint: 'T1',
+        interviewTriggers: ['game', 'font', 'fontti', 'typography', 'logo', 'arcade', 'playful'],
+        sizeEstimate: '~101KB (4 woff2 subsets)',
+        status: 'preview', // policy: new packs start preview; flip stable with an AEB result
+        modelTier: 'any',
+    },
+    {
+        id: 'realtime',
+        kind: 'vendored',
+        category: 'realtime',
+        title: 'Realtime rooms (AimeatRealtime)',
+        description: 'AimeatRealtime (window.AimeatRealtime) — WebSocket P2P rooms, WebRTC data channels and Yjs CRDT shared state for multiplayer games, live collaboration and chat. Ships SharedClock for network-synced timelines.',
+        url: '/lib/realtime.js',
+        include: ['<script src="{{BASE_URL}}/lib/realtime.js"></script>'],
+        requires: ['aimeat-auth'],
+        version: '1',
+        license: 'MIT',
+        apiSurface: 'window.AimeatRealtime, window.SharedClock',
+        aiDoc: [
+            'AimeatRealtime — rooms over the node\'s /v1/realtime WebSocket with optional WebRTC + Yjs CRDT.',
+            'Construct: const rt = new AimeatRealtime(nodeBaseUrl, session.jwt) — positional, canonical —',
+            'or new AimeatRealtime({ session }) (sugar: session.jwt + the page origin). Register EVERY',
+            'rt.on(...) handler BEFORE rt.connect(roomId, nick).',
+            'Rooms over HTTP first: await rt.createRoom({ app_type, name, is_public, max_peers, tags }) →',
+            'room.id; await rt.listRooms({ app_type }) → rooms[]. Find-or-create by app_type and pick the',
+            'LOWEST room id so concurrent creators converge on one room. Then rt.connect(room.id, nick).',
+            "Events: 'joined' (msg.peerId = you, msg.peers[] = existing {peerId, nick, state}),",
+            "'peer-joined' / 'peer-left' / 'peer-presence' ({peerId, nick, state}), 'broadcast'",
+            '(msg.payload = exactly what the sender passed to rt.broadcast(payload)), \'close\', \'error\'.',
+            'There is NO trusted sender field on broadcast — carry an op id + author INSIDE your payload',
+            'and de-dupe by id. Presence: rt.presence(state) → peers get peer-presence.',
+            'For shared documents use the Yjs CRDT surface (conflict-free concurrent edits). Throttle',
+            'high-frequency events (pointermove etc.) to ~30ms batches — send ONE batched message per',
+            'tick, not one per event (the WS is rate-limited).',
+            'SharedClock (window.SharedClock) — a network-synced timeline for sequencers/jams/animation:',
+            "  const clock = new SharedClock({ bpm: 120, steps: 16 }); clock.onStep((s) => draw(s));",
+            "  Leader: rt.broadcast(clock.start()). Joiner: rt.broadcast({type:'sync-request'}) then",
+            "  clock.adopt(payload) on 'transport'/'sync-state', clock.setBpm(bpm) on 'bpm'. It anchors",
+            "  every peer on one t0 so all clients land on the same step, and re-anchors on tempo change",
+            '  so the beat never jumps. Not music-only — steps/subdiv are just a repeating-bar division.',
+            'Simpler apps can skip rooms entirely and observe shared AIMEAT.data keys instead.',
+        ].join('\n'),
+        changelog: [
+            { version: '1', date: '2026-03-03', summary: 'Initial AIMEAT-authored realtime client at /lib/realtime.js (WS rooms + WebRTC + Yjs).' },
+            { version: '1', date: '2026-07-18', summary: 'Added SharedClock (window.SharedClock) — a network-synced t0 timeline (start/stop/step/onStep, adopt, setBpm re-anchor, transport/sync-state payloads). Additive; existing AimeatRealtime API unchanged. Extracted from the Band Jam app pattern.' },
+            { version: '1', date: '2026-07-19', summary: 'Constructor also accepts an options object ({ session } or { baseUrl, token }) — additive sugar; the positional (baseUrl, token) form is unchanged and existing apps are unaffected. ai_doc corrected: it previously showed a {session}-only constructor that did not exist (pitfall realtime/aimeatrealtime-constructor-is-baseurl-token), and now documents the full event list and find-or-create room guidance.' },
+        ],
+        demoTemplateId: 'comp-realtime-room',
+        tierHint: 'T1',
+        interviewTriggers: ['multiplayer', 'realtime', 'collaboration', 'chat', 'live', 'moninpeli', 'yhteismuokkaus'],
+        sizeEstimate: '~17KB',
+        status: 'stable',
+        modelTier: 'needs-doc',
+    },
+];
+//# sourceMappingURL=vendored.js.map

package/dist/src/data/library-packs/vendored.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"vendored.js","sourceRoot":"","sources":["../../../../src/data/library-packs/vendored.ts"],"names":[],"mappings":"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"}

package/dist/src/data/library-packs.d.ts ADDED Viewed

@@ -0,0 +1,151 @@
+/**
+ * @file library-packs.ts
+ * @description The library-pack registry — ONE data-driven source of truth for every
+ *   client-side library an AIMEAT app can include (SDK wrappers at /v1/libs, node-bundled
+ *   cortex libs at /v1/cortex/<n>/libs, vendored third-party assets at /lib). Every AI-facing
+ *   surface derives from this registry so the lists can never drift again:
+ *     - GET /v1/library-packs (+ /:id with the full aiDoc + changelog) — routes/library-packs.ts
+ *     - GET /v1/libs catalogue — routes/libs.ts (buildLibsCatalogue)
+ *     - the build-app prompt's library sections — services/build-app-prompt.ts (buildPromptLibrarySections)
+ *     - bootstrap sdk_libraries — routes/bootstrap.ts (buildSdkLibrariesList)
+ *     - llms.txt Client SDK Libraries table — {{LIBRARY_PACKS_TABLE}} token (buildLlmsPacksTable)
+ *   A pack = include line(s) + version + per-library AI usage doc (aiDoc) + changelog + demo
+ *   template link + interview triggers. `status:'stable'` is gated on a demo + an AEB
+ *   acceleration result (Library Acceleration Program). Versioning policy: public/lib/VENDORED.md.
+ * @structure LibraryPack · PackChange · SDK_PACKS/CORTEX_PACKS/VENDORED_PACKS (./library-packs/)
+ *   · getLibraryPacks() · getLibraryPack() · getLibraryPackIndex() · renderPackText()
+ *   · buildLibsCatalogue() · buildPromptLibrarySections() · buildSdkLibrariesList()
+ *   · buildLlmsPacksTable()
+ * @usage import { getLibraryPacks, buildPromptLibrarySections } from '../data/library-packs.js';
+ * @version-history
+ *   2026-07-19 — Self-reported acceleration proofs (AppDev KB Phase 8): community-pack + template proofs; self_reported labeling
+ *   v1.0.0 — 2026-07-16 — initial registry + surface generators (Library Acceleration Program,
+ *     Phase 1: kills the 4-way hardcoded lib-list drift).
+ */
+export interface PackChange {
+    /** The pack version this entry describes. */
+    version: string;
+    /** ISO date of the change. */
+    date: string;
+    /** Written FOR AN AI reading it later: what changed and what it means for existing apps. */
+    summary: string;
+    /** Present ONLY when existing apps must change something (rare — majors ship as new files). */
+    breaking?: string;
+}
+/**
+ * One recorded AEB proof: the pack run on ONE model, against a shared test set.
+ * The ledger is append-only — a new model's run adds an entry, never overwrites another.
+ * See tools/aeb/acceleration-tiers.md ("Add your own proof") for how these are produced.
+ */
+export interface PackProof {
+    /** Model id the run used, e.g. 'claude-haiku-4-5', 'claude-opus-4-8'. */
+    model: string;
+    /** Did the pack accelerate/render on this model, per the checklist + browser verify. */
+    verdict: 'pass' | 'fail';
+    /** The shared test set id under tools/aeb/specs/, e.g. 'pixi' → pixi.spec.md + pixi.checklist.md. */
+    testSet: string;
+    /** Repo-relative evidence file (tokens, checklist, browser findings), e.g. 'tools/aeb/results/aeb3-pixi-perpack.md'. */
+    evidence: string;
+    /** Output tokens the treatment arm spent, when recorded. */
+    tokens?: number;
+    /** ISO date of the run. */
+    date: string;
+}
+export interface LibraryPack {
+    /** Stable id, e.g. 'chartjs', 'aimeat-charts', 'styling'. */
+    id: string;
+    /** sdk = /v1/libs wrapper · cortex = node-bundled cortex lib · vendored = /lib third-party · bundle = multi-file set. */
+    kind: 'sdk' | 'cortex' | 'vendored' | 'bundle';
+    category: 'core' | 'ai' | 'ui' | 'visualization' | 'diagrams' | 'canvas' | 'game' | '3d' | 'realtime' | 'economy' | 'media';
+    title: string;
+    /** One line (English) — shown in the index, catalogue and pack pickers. */
+    description: string;
+    /** Canonical path of the main file (root-relative). */
+    url: string;
+    /** Exact include line(s) in load order; {{BASE_URL}} is substituted at render time. */
+    include: string[];
+    /** Pack ids this pack needs loaded first. */
+    requires: string[];
+    /** Pinned version (vendored/bundle) or the cortex spec.version. SDK packs omit it (always served live from the node). */
+    version?: string;
+    /** The frozen-major filename contract, e.g. 'chartjs@4' — see public/lib/VENDORED.md. */
+    majorPin?: string;
+    license: string;
+    sourceUrl?: string;
+    /** The global/API namespace an app talks to, e.g. 'AIMEAT.charts', 'window.Phaser'. */
+    apiSurface: string;
+    /** The acceleration payload: a 10–40 line usage doc an AI reads BEFORE writing code with the pack. */
+    aiDoc: string;
+    /** What changed and what it means for existing apps — newest last. */
+    changelog: PackChange[];
+    /** app-templates id of the demo that proves the pack (required for status 'stable'). */
+    demoTemplateId?: string;
+    /** node:-scoped skill carrying deep docs (@semver-pinnable), when the aiDoc is not enough. */
+    skillRef?: string;
+    /** Which app-shell tier the pack implies (cortex packs → T2 shell). */
+    tierHint: 'T1' | 'T2' | 'T3';
+    /** Idea-text keywords that pre-select this pack in the interview / catalog picker. */
+    interviewTriggers: string[];
+    sizeEstimate: string;
+    /** stable REQUIRES a demo template + a recorded AEB acceleration result. */
+    status: 'preview' | 'stable' | 'deprecated';
+    /**
+     * The strongest model-strength this pack is reliably-and-accelerated on — a WARNING label, not a
+     * gate (an unlabelled pack still ships). Driven by API-version drift from training data:
+     *   'any'       — pin == the API models know; a mid-tier model codes it correctly from memory.
+     *   'frontier'  — breaking API vs the version most examples show; weak models write the old API
+     *                 from memory and crash → carry an `apiCaveat` and prefer forcing the ai_doc.
+     *   'needs-doc' — AIMEAT-authored/wrapper, no training-data priors; must fetch the ai_doc to use
+     *                 it at all (no crash, just a silent no-op if skipped).
+     * Derivable from `proofs` (strongest model with a 'pass'); set explicitly until proofs exist.
+     * Full scheme + how a pack earns this: tools/aeb/acceleration-tiers.md.
+     */
+    modelTier?: 'any' | 'frontier' | 'needs-doc';
+    /**
+     * The per-model AEB proof ledger — which models this pack has actually been demonstrated on.
+     * Lets a client/pipeline pick a pack proven on the model it is about to use. Append-only.
+     */
+    proofs?: PackProof[];
+    /**
+     * For `modelTier:'frontier'` packs ONLY: the one-line breaking-API idiom a weak model gets wrong
+     * from stale memory. The build-app prompt INLINES this next to the pack (so a model that skips the
+     * ai_doc still gets corrected), e.g. pixi's "v8 Graphics chains .rect().fill(), NOT beginFill()/
+     * drawRect() (v7, removed)". Keep it to the single most load-bearing gotcha.
+     */
+    apiCaveat?: string;
+    /** Exact line used in the build-app prompt (sdk/cortex packs that the prompt lists). */
+    promptLine?: string;
+    /** Build-app-prompt grouping for sdk packs. */
+    promptGroup?: 'core' | 'ai' | 'economy' | 'media';
+}
+/** All library packs. */
+export declare function getLibraryPacks(): LibraryPack[];
+/** One pack by id. */
+export declare function getLibraryPack(id: string): LibraryPack | undefined;
+/** Substitute the {{BASE_URL}} placeholder in include lines / doc text. */
+export declare function renderPackText(text: string, baseUrl: string): string;
+/**
+ * Lightweight index (no aiDoc/changelog/promptLine) — for GET /v1/library-packs and pickers.
+ * Pass a lang (e.g. 'fi') for localized title/description where a translation exists.
+ */
+export declare function getLibraryPackIndex(lang?: string): Array<Pick<LibraryPack, 'id' | 'kind' | 'category' | 'title' | 'description' | 'url' | 'include' | 'requires' | 'version' | 'license' | 'apiSurface' | 'demoTemplateId' | 'skillRef' | 'tierHint' | 'interviewTriggers' | 'sizeEstimate' | 'status' | 'modelTier' | 'proofs' | 'apiCaveat'>>;
+/**
+ * The GET /v1/libs catalogue array — derived from the sdk packs. Response shape is
+ * backwards-compatible with the pre-registry hardcoded list (fields added, none removed).
+ */
+export declare function buildLibsCatalogue(baseUrl: string): Array<Record<string, unknown>>;
+/**
+ * The build-app prompt's library sections (Available Client Libraries + Ready-made UI +
+ * Optional capability packs), generated from the registry. Consumed by build-app-prompt.ts.
+ */
+export declare function buildPromptLibrarySections(nodeUrl: string): string;
+/** The bootstrap GET / `sdk_libraries` list — "<url> - <description>" per non-deprecated pack. */
+export declare function buildSdkLibrariesList(baseUrl: string): string[];
+/**
+ * The llms.txt "Client SDK Libraries" markdown table — substituted for the
+ * {{LIBRARY_PACKS_TABLE}} token in public/llms-template.txt (routes/bootstrap.ts).
+ * SDK rows carry the richer aiDoc (matching the pre-registry table cells); cortex/vendored
+ * rows carry the one-line description + a pointer to the pack detail endpoint.
+ */
+export declare function buildLlmsPacksTable(): string;
+//# sourceMappingURL=library-packs.d.ts.map

package/dist/src/data/library-packs.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"library-packs.d.ts","sourceRoot":"","sources":["../../../src/data/library-packs.ts"],"names":[],"mappings":"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"}