decaframe 0.1.0

package/LICENSE

@@ -0,0 +1,32 @@
+decaframe Licence
+
+Copyright (c) 2026 decaframe. All rights reserved.
+
+This is proprietary software. It is licensed, not sold.
+
+1. Grant. Subject to these terms, you may install and use the decaframe package as
+   distributed through the npm registry, including the command it provides and the editor
+   and browser it ships with, to create, edit and export documents for your own purposes,
+   including commercial ones.
+
+2. Restrictions. You may not copy, modify, adapt, translate, reverse engineer, decompile,
+   disassemble or create derivative works of the software or any part of it; redistribute,
+   sublicense, rent, lease or lend it; or use it to build a competing product or service. The
+   software carries no source code, and no licence to any is granted.
+
+3. Your documents are yours. Nothing here claims any right in the content you author or
+   export with the software.
+
+4. Third-party components. The software includes open-source components under their own
+   licences, whose notices travel with it, and a Chromium-based browser licensed under the
+   terms distributed beside it. Those terms govern those components.
+
+5. No warranty. The software is provided "as is", without warranty of any kind, express or
+   implied, including merchantability, fitness for a particular purpose and non-infringement.
+   To the fullest extent permitted by law, decaframe is not liable for any damages arising
+   from its use.
+
+6. Termination. This licence ends automatically if you breach it. On termination you must
+   stop using the software and delete every copy.
+
+For any other use, contact decaframe.

package/README.md

@@ -0,0 +1,55 @@
+# decaframe
+
+Agents author. Humans edit. The frame lints.
+
+`decaframe` is an MCP server that lets a coding agent write presentations, reports and one-pagers
+as visual documents, a WYSIWYG editor a person opens on the same file, and an export to one HTML
+file that opens anywhere.
+
+## Install
+
+```bash
+npm install -g decaframe
+```
+
+Node 22 or later. The headless browser the export renders with is downloaded once, in the background, the
+first time `deca` runs, about 100 MB from Playwright's own servers. Until it lands, an export says so.
+
+## Connect an agent
+
+Add the server to your client. For Claude Code, Cursor, Windsurf and most others the entry is:
+
+```json
+{ "mcpServers": { "decaframe": { "command": "npx", "args": ["-y", "decaframe", "mcp"] } } }
+```
+
+Then ask for a deck. The document is written to `document.json` in the folder the agent works in;
+set `DECAFRAME_DOC` to put it elsewhere.
+
+The skill that teaches an agent to design with the tools installs into every agent on the machine:
+
+```bash
+npx skills add decaframe/decaframe
+```
+
+## Open a document yourself
+
+```bash
+deca open document.json
+```
+
+Serves the editor on a free port and opens it in a window. An agent and the editor may hold the
+same file at once: what either saves, the other sees.
+
+## Export
+
+Ask the agent for `export_html`, or from the editor's menu. The file expects the internet for its
+fonts, pictures and video, and degrades gracefully without it.
+
+## Documentation
+
+https://github.com/decaframe/decaframe
+
+## Licence
+
+Commercial. See LICENSE.

package/dist/archetype.js

@@ -0,0 +1 @@
+import{carryDesign as w}from"./design.js";import{mintId as T}from"./id.js";import{PROSE_FIELDS as _}from"./prose.js";import{TABLE_FIELDS as b}from"./table.js";import{SERIES_FIELDS as B}from"./chart.js";import{DIAGRAM_FIELDS as N}from"./diagram.js";import{slotContent as z,slotText as A}from"./text.js";const u={item:[["meta","itemMeta"],["title","itemTitle"],["body","itemBody"]],stat:[["label","statLabel"],["value","statValue"],["note","statNote"]],mediaItem:[["caption","mediaCaption"],["title","mediaTitle"],["body","mediaBody"]]},h={item:["icon","emphasis"],stat:[],mediaItem:["src","alt","focusX","focusY","zoom"]},R={item:[],stat:["value"],mediaItem:["src"]},C=t=>t==="items"||t==="stats"||t==="media",M={items:"item",stats:"stat",media:"mediaItem"},L=t=>M[t]??"item",O={items:"items",stats:"stats",media:"media",prose:"content",table:"table",chart:"chart",diagram:"diagram"},J=t=>O[t]??"items",P=t=>{if(t==="prose")return _;if(t==="table")return b;if(t==="chart")return B;if(t==="diagram")return N;if(!C(t))return[];const e=L(t);return["id",...(u[e]??u.item).map(([o])=>o),...h[e]??[]]},Z=(t,e)=>(u[t]??u.item).find(([,o])=>o===e)?.[0],Y=t=>C(t)?R[L(t)]??[]:[],W=t=>C(t)?(u[L(t)]??u.item).map(([e])=>e):[],v=t=>typeof t!="string"||t.trim()==="",$=(t,e)=>{const o=e,r=W(t);return!r.length||Y(t).some(f=>!v(o[f]))?!1:r.every(f=>v(o[f]))};function tt(t){const e=t.firstChild?.type.name??"item",o=u[e]??u.item,r=h[e]??[],f=[];return t.forEach(i=>{const m={id:i.attrs.id};i.forEach(s=>{const l=o.find(([,p])=>p===s.type.name);l&&(m[l[0]]=A(s))});for(const s of r)i.attrs[s]!=null&&(m[s]=i.attrs[s]);f.push(m)}),f}const K=(t,e,o)=>t.nodes[e].create(null,z(t,o,e));function y(t,e,o,r){const f=u[e]??u.item,i=o,m=f.filter(([p])=>typeof i[p]=="string").map(([p,x])=>K(t,x,i[p])),s=h[e]??[],l={id:i.id??T(e),...w(r?.attrs,s)};for(const p of s)l[p]=i[p]??null;return t.nodes[e].createChecked(l,m)}function et(t,e,o){try{for(const r of o)y(t,e,r);return!0}catch{return!1}}function nt(t,e,o){return o.map(r=>y(t,e,r))}function q(t,e,o,r,f,i){const m=u[i]??u.item,s=f;for(const[d,g]of m){const n=typeof s[d]=="string",a=r.content.content.some(c=>c.type.name===g);if(n!==a)return!1}const l=h[i]??[];if(l.some(d=>(s[d]??null)!==(r.attrs[d]??null)&&s[d]!==void 0)){const d={...r.attrs};for(const g of l)s[g]!==void 0&&(d[g]=s[g]??null);t.setNodeMarkup(t.mapping.slice(e).map(o),void 0,d)}const x=[];let I=o+1;r.forEach(d=>{x.push([d,I]),I+=d.nodeSize});for(let d=x.length-1;d>=0;d--){const[g,n]=x[d],a=m.find(([,D])=>D===g.type.name);if(!a)continue;const c=s[a[0]];if(typeof c!="string"||c===A(g))continue;const E=t.mapping.slice(e),F=E.map(n+1),S=E.map(n+g.nodeSize-1);t.replaceWith(F,S,z(t.doc.type.schema,c,g.type.name))}return!0}function ot(t,e,o){const r=t.doc.nodeAt(e);if(!r)return;const f=t.steps.length,i=r.firstChild?.type.name??"item",m=t.doc.type.schema,s=new Map;let l=e+1;r.forEach((n,a,c)=>{n.attrs.id&&s.set(n.attrs.id,{node:n,pos:l,index:c}),l+=n.nodeSize});const p=o.map(n=>n.id?s.get(n.id)?.index:void 0).filter(n=>n!==void 0),x=p.every((n,a)=>a===0||n>p[a-1]),I=p.length===0;if(!x||I){const n=o.map(a=>{const c=a.id?s.get(a.id):void 0;return c?G(c.node,a,i)?c.node:y(m,i,a,c.node):y(m,i,a)});t.replaceWith(e+1,e+r.content.size+1,n);return}const d=new Set(o.map(n=>n.id).filter(Boolean)),g=[...s.values()].filter(n=>!d.has(n.node.attrs.id));for(const n of g.sort((a,c)=>c.pos-a.pos))t.delete(n.pos,n.pos+n.node.nodeSize);for(let n=0;n<o.length;n++){const a=o[n],c=a.id?s.get(a.id):void 0;if(c){if(!q(t,f,c.pos,c.node,a,i)){const S=t.mapping.slice(f).map(c.pos),D=t.mapping.slice(f).map(c.pos+c.node.nodeSize);t.replaceWith(S,D,y(m,i,a,c.node))}continue}const E=o.slice(n+1).map(S=>S.id?s.get(S.id):void 0).find(Boolean),F=E?t.mapping.slice(f).map(E.pos):t.mapping.slice(f).map(e+r.content.size+1);t.insert(F,y(m,i,a))}}function G(t,e,o){const r=u[o]??u.item,f=e;for(const[i,m]of r){const s=t.content.content.find(p=>p.type.name===m),l=f[i];if(l===void 0){if(s)return!1;continue}if(!s||A(s)!==l)return!1}for(const i of h[o]??[])if(f[i]!==void 0&&(f[i]??null)!==(t.attrs[i]??null))return!1;return!0}export{ot as applyEntries,y as childFor,L as childTypeFor,nt as childrenFor,et as entriesBuildable,tt as entriesOf,$ as entryDrawsNothing,Z as fieldForSlotNode,P as fieldsFor,C as isEntryArchetype,J as payloadKeyFor,Y as requiredFor,W as textSlotsFor};