@formfeed/engine 0.3.10 → 0.3.12

package/types/lib/generated/frames.d.cts

@@ -0,0 +1,6 @@
+/** Bundled from src/frame/text-edit.entry.ts. */
+export declare const textEditRuntime = "\"use strict\";(()=>{var O=`\nhtml.ff-edit-mode [data-ff-edit] { cursor: text; }\nhtml.ff-edit-mode [data-ff-edit]:hover { outline: 1px dashed rgba(37,99,235,.85); outline-offset: 2px; }\nhtml.ff-edit-mode [data-ff-edit=\"t\"]:hover { outline-color: rgba(147,51,234,.9); }\n.ff-editing { outline: 2px solid #2563eb !important; outline-offset: 2px; cursor: text; }\n.ff-editing .ff-chip { background: rgba(37,99,235,.14) !important; box-shadow: inset 0 0 0 1px rgba(37,99,235,.45) !important; border-radius: 3px !important; padding: 0 1px !important; cursor: default; }\n.ff-edit-badge { position: absolute; z-index: 2147483647; font: 500 11px/1.4 system-ui, sans-serif !important; color: #fff !important; background: #2563eb !important; padding: 1px 6px !important; border-radius: 4px !important; pointer-events: none; white-space: nowrap; }\n`;function F(l,d={}){let m=d.clicks!==!1,g=d.live===!0,o=l.document,i=null,s=null,f=e=>{try{l.parent.postMessage(e,\"*\")}catch{}},v=m?o.querySelector('meta[name=\"formfeed:document\"]')?.getAttribute(\"content\")??null:null,h=!1;l.addEventListener(\"blur\",()=>{h=!0}),l.addEventListener(\"focus\",()=>{h=!1});let y=o.createElement(\"style\");y.setAttribute(\"data-formfeed\",\"edit\"),y.setAttribute(\"data-pagedjs-ignore\",\"\"),y.textContent=O,(o.head??o.documentElement).appendChild(y),m&&o.documentElement.classList.add(\"ff-edit-mode\");let M=e=>(e&&typeof e.closest==\"function\"?e:null)?.closest(\"[data-ff-edit]\")??null;o.addEventListener(\"click\",e=>{if(!m)return;if(i&&!i.done&&i.element.contains(e.target)){e.stopImmediatePropagation();return}let t=M(e.target);t&&(e.preventDefault(),e.stopImmediatePropagation(),C(t,{x:e.clientX,y:e.clientY}))},!0);function C(e,t){i&&!i.done&&x();let n=e.getAttribute(\"data-ff-src\")??\"\",r=e.getBoundingClientRect(),u=Array.from(o.querySelectorAll(`[data-ff-src=\"${n.replace(/\"/g,\"\")}\"]`));s={src:n,element:e,point:t},f({type:\"formfeed:edit-request\",src:n,doc:v,edit:e.getAttribute(\"data-ff-edit\"),text:e.textContent??\"\",elements:e.childElementCount,count:u.length,index:Math.max(0,u.indexOf(e)),split:e.hasAttribute(\"data-split-from\")||e.hasAttribute(\"data-split-to\"),rect:{left:r.left,top:r.top,width:r.width,height:r.height}})}o.addEventListener(\"keydown\",e=>{if(!m||i&&!i.done||!(e.ctrlKey||e.metaKey)||e.altKey)return;let t=e.key.toLowerCase();(t===\"z\"||t===\"y\")&&(e.preventDefault(),f({type:t===\"y\"||e.shiftKey?\"formfeed:redo\":\"formfeed:undo\"}))}),l.addEventListener(\"message\",e=>{if(e.source!==l.parent)return;let t=e.data;!t||typeof t.type!=\"string\"||(t.type===\"formfeed:edit-begin\"?P(t):t.type===\"formfeed:edit-refuse\"||t.type===\"formfeed:edit-end\"?(s=null,i&&!i.done&&E(!1)):t.type===\"formfeed:edit-open\"&&B(t))});function B(e){if(!m||typeof e.src!=\"string\"||i&&!i.done)return;let t=Array.from(o.querySelectorAll(`[data-ff-src=\"${e.src.replace(/\"/g,\"\")}\"][data-ff-edit]`)),n=Number.isInteger(e.index)?Number(e.index):0,r=t[n]??t[0];r&&C(r,null)}if(m){let e=()=>f({type:\"formfeed:edit-ready\",doc:v}),t=l;t.PagedConfig?t.formfeedEditReady=e:o.readyState===\"loading\"?o.addEventListener(\"DOMContentLoaded\",e):e()}function P(e){i&&!i.done&&E(!1);let t=e.layer?o.querySelector(`[data-ff-layer=\"${String(e.layer).replace(/\"/g,\"\")}\"] > .ff-text`):s&&s.src===e.src?s.element:o.querySelector(`[data-ff-src=\"${String(e.src).replace(/\"/g,\"\")}\"]`),n=e.at,r=e.layer?n&&Number.isFinite(n.x)&&Number.isFinite(n.y)?{x:Number(n.x),y:Number(n.y)}:null:s&&s.src===e.src?s.point:null;s=null;let u=h&&!o.hasFocus();if(!t||!Array.isArray(e.items)||u){f({type:\"formfeed:edit-cancel\",token:String(e.token)});return}let c=Array.from(t.childNodes),b=o.createDocumentFragment();for(let a of e.items)if(a.kind===\"text\")b.appendChild(o.createTextNode(String(a.text)));else if(a.kind===\"break\")b.appendChild(o.createElement(\"br\"));else if(a.kind===\"chip\"){let p=o.createElement(\"span\");p.className=\"ff-chip\",p.setAttribute(\"data-ff-chip\",String(a.index)),p.setAttribute(\"contenteditable\",\"false\"),a.title&&(p.title=String(a.title)),p.textContent=String(a.text),b.appendChild(p)}for(let a of c)t.removeChild(a);t.appendChild(b),t.contentEditable=\"true\",t.classList.add(\"ff-editing\"),t.setAttribute(\"role\",\"textbox\"),e.label&&t.setAttribute(\"aria-label\",String(e.label)),t.spellcheck=!0,i={token:String(e.token),element:t,saved:c,allowBreaks:e.allowBreaks===!0,badge:e.note?H(t,String(e.note)):null,done:!1},t.addEventListener(\"keydown\",A),t.addEventListener(\"beforeinput\",T),t.addEventListener(\"paste\",S),t.addEventListener(\"drop\",N),t.addEventListener(\"focusout\",R),g&&t.addEventListener(\"input\",k),t.focus(),e.select===\"all\"?I(t):K(t,r),f({type:\"formfeed:edit-started\",token:i.token}),typeof e.insert==\"string\"&&e.insert&&L(e.insert.replace(/\\r\\n?|\\n/g,\" \"))}function L(e){if(typeof o.execCommand==\"function\"&&o.execCommand(\"insertText\",!1,e))return;let t=l.getSelection(),n=t&&t.rangeCount?t.getRangeAt(0):null;n&&(n.deleteContents(),n.insertNode(o.createTextNode(e)),n.collapse(!1),g&&k())}function k(){i&&!i.done&&f({type:\"formfeed:edit-input\",token:i.token,items:D(i.element)})}function H(e,t){let n=o.createElement(\"div\");n.className=\"ff-edit-badge\",n.textContent=t;let r=e.getBoundingClientRect();return n.style.left=`${r.left+l.scrollX}px`,n.style.top=`${Math.max(0,r.top+l.scrollY-22)}px`,o.body.appendChild(n),n}function I(e){let t=l.getSelection();if(!t)return;let n=o.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}function K(e,t){let n=l.getSelection();if(!n)return;let r=null,u=o;if(t){if(u.caretRangeFromPoint)r=u.caretRangeFromPoint(t.x,t.y);else if(u.caretPositionFromPoint){let c=u.caretPositionFromPoint(t.x,t.y);c&&(r=o.createRange(),r.setStart(c.offsetNode,c.offset))}}if(!r||!e.contains(r.startContainer))r=o.createRange(),r.selectNodeContents(e),r.collapse(!1);else if(t){let c=r.startContainer,a=(c.nodeType===1?c:c.parentElement)?.closest(\"[data-ff-chip]\")??null;if(a&&a!==e&&e.contains(a)){let p=a.getBoundingClientRect();r=o.createRange(),t.x<p.left+p.width/2?r.setStartBefore(a):r.setStartAfter(a),r.collapse(!0)}}n.removeAllRanges(),n.addRange(r)}function A(e){let t=e.key;t===\"Escape\"?(e.preventDefault(),E(!0)):t===\"Enter\"&&!e.shiftKey?(e.preventDefault(),x()):t===\"Enter\"?(e.preventDefault(),i?.allowBreaks&&q()):t===\"Tab\"?(e.preventDefault(),x()):(e.ctrlKey||e.metaKey)&&[\"b\",\"i\",\"u\"].includes(t.toLowerCase())&&(e.preventDefault(),g&&i&&!e.altKey&&f({type:\"formfeed:edit-style\",token:i.token,key:t.toLowerCase()}))}function T(e){let t=e.inputType??\"\";(t.startsWith(\"format\")||t===\"insertFromDrop\"||t===\"insertParagraph\"||t===\"insertLineBreak\")&&e.preventDefault()}function S(e){e.preventDefault(),L((e.clipboardData?.getData(\"text/plain\")??\"\").replace(/\\r\\n?|\\n/g,\" \"))}function N(e){e.preventDefault()}function R(){l.setTimeout(()=>{i&&!i.done&&(!o.hasFocus()||!i.element.contains(o.activeElement))&&x()},0)}function q(){let e=l.getSelection();if(!e||!e.rangeCount)return;let t=e.getRangeAt(0);t.deleteContents();let n=o.createElement(\"br\");t.insertNode(n),n.nextSibling||n.parentNode?.appendChild(o.createElement(\"br\"));let r=o.createRange();r.setStartAfter(n),r.collapse(!0),e.removeAllRanges(),e.addRange(r)}function w(e){e.done=!0;let t=e.element;t.removeEventListener(\"keydown\",A),t.removeEventListener(\"beforeinput\",T),t.removeEventListener(\"paste\",S),t.removeEventListener(\"drop\",N),t.removeEventListener(\"focusout\",R),t.removeEventListener(\"input\",k),t.removeAttribute(\"contenteditable\"),t.removeAttribute(\"role\"),t.removeAttribute(\"aria-label\"),t.classList.remove(\"ff-editing\"),e.badge?.remove(),i===e&&(i=null)}function x(){let e=i;if(!e||e.done)return;let t=D(e.element);w(e),f({type:\"formfeed:edit-commit\",token:e.token,items:t})}function E(e){let t=i;if(!t||t.done)return;let n=t.element;for(;n.firstChild;)n.removeChild(n.firstChild);for(let r of t.saved)n.appendChild(r);w(t),e&&f({type:\"formfeed:edit-cancel\",token:t.token})}}function D(l){let d=[],m=o=>{let i=d[d.length-1];i?.kind===\"text\"?i.text+=o:o&&d.push({kind:\"text\",text:o})},g=o=>{for(let i of Array.from(o.childNodes))if(i.nodeType===3)m(i.data);else if(i.nodeType===1){let s=i,f=s.getAttribute(\"data-ff-chip\");f!==null?d.push({kind:\"chip\",index:Number(f)}):s.tagName===\"BR\"?d.push({kind:\"break\"}):((s.tagName===\"DIV\"||s.tagName===\"P\")&&d.length&&d.push({kind:\"break\"}),g(s))}};for(g(l);d[d.length-1]?.kind===\"break\";)d.pop();return d}F(window);})();";
+/** Bundled from src/frame/fit.entry.ts. */
+export declare const fitRuntime = "\"use strict\";(()=>{function a(t,e,n){if(e===t)return t.scrollHeight<=t.clientHeight+.5&&t.scrollWidth<=t.clientWidth+.5;let o=n.getComputedStyle(t),i=t.clientHeight-(parseFloat(o.paddingTop)||0)-(parseFloat(o.paddingBottom)||0);return e.scrollHeight<=i+.5&&e.scrollWidth<=e.clientWidth+.5}function m(t,e){let n=t.firstElementChild??t;n.style.fontSize=\"\";let o=parseFloat(e.getComputedStyle(n).fontSize)||16,i=Math.min(o,parseFloat(t.getAttribute(\"data-ff-fit-min\")??\"\")||o/2);if(a(t,n,e))return o;let l=i,s=o;for(let d=0;d<14;d++){let r=(l+s)/2;n.style.fontSize=`${r}px`,a(t,n,e)?l=r:s=r}let f=Math.floor(l*100)/100;return n.style.fontSize=`${f}px`,f}function c(t){let e=()=>{for(let o of Array.from(t.document.querySelectorAll('[data-ff-fit=\"shrink\"]')))m(o,t);t.document.documentElement.setAttribute(\"data-ff-fit\",\"done\")};t.formfeedFit=e;let n=t.document.fonts;n?n.ready.then(e):t.addEventListener(\"load\",e)}c(window);})();";
+/** Bundled from src/frame/stage.entry.ts. */
+export declare const stageRuntime = "\"use strict\";(()=>{var W=`\nhtml.ff-edit-mode [data-ff-edit] { cursor: text; }\nhtml.ff-edit-mode [data-ff-edit]:hover { outline: 1px dashed rgba(37,99,235,.85); outline-offset: 2px; }\nhtml.ff-edit-mode [data-ff-edit=\"t\"]:hover { outline-color: rgba(147,51,234,.9); }\n.ff-editing { outline: 2px solid #2563eb !important; outline-offset: 2px; cursor: text; }\n.ff-editing .ff-chip { background: rgba(37,99,235,.14) !important; box-shadow: inset 0 0 0 1px rgba(37,99,235,.45) !important; border-radius: 3px !important; padding: 0 1px !important; cursor: default; }\n.ff-edit-badge { position: absolute; z-index: 2147483647; font: 500 11px/1.4 system-ui, sans-serif !important; color: #fff !important; background: #2563eb !important; padding: 1px 6px !important; border-radius: 4px !important; pointer-events: none; white-space: nowrap; }\n`;function H(a,l={}){let f=l.clicks!==!1,p=l.live===!0,n=a.document,o=null,d=null,u=e=>{try{a.parent.postMessage(e,\"*\")}catch{}},m=f?n.querySelector('meta[name=\"formfeed:document\"]')?.getAttribute(\"content\")??null:null,s=!1;a.addEventListener(\"blur\",()=>{s=!0}),a.addEventListener(\"focus\",()=>{s=!1});let g=n.createElement(\"style\");g.setAttribute(\"data-formfeed\",\"edit\"),g.setAttribute(\"data-pagedjs-ignore\",\"\"),g.textContent=W,(n.head??n.documentElement).appendChild(g),f&&n.documentElement.classList.add(\"ff-edit-mode\");let x=e=>(e&&typeof e.closest==\"function\"?e:null)?.closest(\"[data-ff-edit]\")??null;n.addEventListener(\"click\",e=>{if(!f)return;if(o&&!o.done&&o.element.contains(e.target)){e.stopImmediatePropagation();return}let t=x(e.target);t&&(e.preventDefault(),e.stopImmediatePropagation(),v(t,{x:e.clientX,y:e.clientY}))},!0);function v(e,t){o&&!o.done&&L();let r=e.getAttribute(\"data-ff-src\")??\"\",i=e.getBoundingClientRect(),b=Array.from(n.querySelectorAll(`[data-ff-src=\"${r.replace(/\"/g,\"\")}\"]`));d={src:r,element:e,point:t},u({type:\"formfeed:edit-request\",src:r,doc:m,edit:e.getAttribute(\"data-ff-edit\"),text:e.textContent??\"\",elements:e.childElementCount,count:b.length,index:Math.max(0,b.indexOf(e)),split:e.hasAttribute(\"data-split-from\")||e.hasAttribute(\"data-split-to\"),rect:{left:i.left,top:i.top,width:i.width,height:i.height}})}n.addEventListener(\"keydown\",e=>{if(!f||o&&!o.done||!(e.ctrlKey||e.metaKey)||e.altKey)return;let t=e.key.toLowerCase();(t===\"z\"||t===\"y\")&&(e.preventDefault(),u({type:t===\"y\"||e.shiftKey?\"formfeed:redo\":\"formfeed:undo\"}))}),a.addEventListener(\"message\",e=>{if(e.source!==a.parent)return;let t=e.data;!t||typeof t.type!=\"string\"||(t.type===\"formfeed:edit-begin\"?B(t):t.type===\"formfeed:edit-refuse\"||t.type===\"formfeed:edit-end\"?(d=null,o&&!o.done&&S(!1)):t.type===\"formfeed:edit-open\"&&E(t))});function E(e){if(!f||typeof e.src!=\"string\"||o&&!o.done)return;let t=Array.from(n.querySelectorAll(`[data-ff-src=\"${e.src.replace(/\"/g,\"\")}\"][data-ff-edit]`)),r=Number.isInteger(e.index)?Number(e.index):0,i=t[r]??t[0];i&&v(i,null)}if(f){let e=()=>u({type:\"formfeed:edit-ready\",doc:m}),t=a;t.PagedConfig?t.formfeedEditReady=e:n.readyState===\"loading\"?n.addEventListener(\"DOMContentLoaded\",e):e()}function B(e){o&&!o.done&&S(!1);let t=e.layer?n.querySelector(`[data-ff-layer=\"${String(e.layer).replace(/\"/g,\"\")}\"] > .ff-text`):d&&d.src===e.src?d.element:n.querySelector(`[data-ff-src=\"${String(e.src).replace(/\"/g,\"\")}\"]`),r=e.at,i=e.layer?r&&Number.isFinite(r.x)&&Number.isFinite(r.y)?{x:Number(r.x),y:Number(r.y)}:null:d&&d.src===e.src?d.point:null;d=null;let b=s&&!n.hasFocus();if(!t||!Array.isArray(e.items)||b){u({type:\"formfeed:edit-cancel\",token:String(e.token)});return}let y=Array.from(t.childNodes),k=n.createDocumentFragment();for(let c of e.items)if(c.kind===\"text\")k.appendChild(n.createTextNode(String(c.text)));else if(c.kind===\"break\")k.appendChild(n.createElement(\"br\"));else if(c.kind===\"chip\"){let h=n.createElement(\"span\");h.className=\"ff-chip\",h.setAttribute(\"data-ff-chip\",String(c.index)),h.setAttribute(\"contenteditable\",\"false\"),c.title&&(h.title=String(c.title)),h.textContent=String(c.text),k.appendChild(h)}for(let c of y)t.removeChild(c);t.appendChild(k),t.contentEditable=\"true\",t.classList.add(\"ff-editing\"),t.setAttribute(\"role\",\"textbox\"),e.label&&t.setAttribute(\"aria-label\",String(e.label)),t.spellcheck=!0,o={token:String(e.token),element:t,saved:y,allowBreaks:e.allowBreaks===!0,badge:e.note?I(t,String(e.note)):null,done:!1},t.addEventListener(\"keydown\",T),t.addEventListener(\"beforeinput\",N),t.addEventListener(\"paste\",w),t.addEventListener(\"drop\",R),t.addEventListener(\"focusout\",F),p&&t.addEventListener(\"input\",C),t.focus(),e.select===\"all\"?q(t):K(t,i),u({type:\"formfeed:edit-started\",token:o.token}),typeof e.insert==\"string\"&&e.insert&&A(e.insert.replace(/\\r\\n?|\\n/g,\" \"))}function A(e){if(typeof n.execCommand==\"function\"&&n.execCommand(\"insertText\",!1,e))return;let t=a.getSelection(),r=t&&t.rangeCount?t.getRangeAt(0):null;r&&(r.deleteContents(),r.insertNode(n.createTextNode(e)),r.collapse(!1),p&&C())}function C(){o&&!o.done&&u({type:\"formfeed:edit-input\",token:o.token,items:D(o.element)})}function I(e,t){let r=n.createElement(\"div\");r.className=\"ff-edit-badge\",r.textContent=t;let i=e.getBoundingClientRect();return r.style.left=`${i.left+a.scrollX}px`,r.style.top=`${Math.max(0,i.top+a.scrollY-22)}px`,n.body.appendChild(r),r}function q(e){let t=a.getSelection();if(!t)return;let r=n.createRange();r.selectNodeContents(e),t.removeAllRanges(),t.addRange(r)}function K(e,t){let r=a.getSelection();if(!r)return;let i=null,b=n;if(t){if(b.caretRangeFromPoint)i=b.caretRangeFromPoint(t.x,t.y);else if(b.caretPositionFromPoint){let y=b.caretPositionFromPoint(t.x,t.y);y&&(i=n.createRange(),i.setStart(y.offsetNode,y.offset))}}if(!i||!e.contains(i.startContainer))i=n.createRange(),i.selectNodeContents(e),i.collapse(!1);else if(t){let y=i.startContainer,c=(y.nodeType===1?y:y.parentElement)?.closest(\"[data-ff-chip]\")??null;if(c&&c!==e&&e.contains(c)){let h=c.getBoundingClientRect();i=n.createRange(),t.x<h.left+h.width/2?i.setStartBefore(c):i.setStartAfter(c),i.collapse(!0)}}r.removeAllRanges(),r.addRange(i)}function T(e){let t=e.key;t===\"Escape\"?(e.preventDefault(),S(!0)):t===\"Enter\"&&!e.shiftKey?(e.preventDefault(),L()):t===\"Enter\"?(e.preventDefault(),o?.allowBreaks&&$()):t===\"Tab\"?(e.preventDefault(),L()):(e.ctrlKey||e.metaKey)&&[\"b\",\"i\",\"u\"].includes(t.toLowerCase())&&(e.preventDefault(),p&&o&&!e.altKey&&u({type:\"formfeed:edit-style\",token:o.token,key:t.toLowerCase()}))}function N(e){let t=e.inputType??\"\";(t.startsWith(\"format\")||t===\"insertFromDrop\"||t===\"insertParagraph\"||t===\"insertLineBreak\")&&e.preventDefault()}function w(e){e.preventDefault(),A((e.clipboardData?.getData(\"text/plain\")??\"\").replace(/\\r\\n?|\\n/g,\" \"))}function R(e){e.preventDefault()}function F(){a.setTimeout(()=>{o&&!o.done&&(!n.hasFocus()||!o.element.contains(n.activeElement))&&L()},0)}function $(){let e=a.getSelection();if(!e||!e.rangeCount)return;let t=e.getRangeAt(0);t.deleteContents();let r=n.createElement(\"br\");t.insertNode(r),r.nextSibling||r.parentNode?.appendChild(n.createElement(\"br\"));let i=n.createRange();i.setStartAfter(r),i.collapse(!0),e.removeAllRanges(),e.addRange(i)}function M(e){e.done=!0;let t=e.element;t.removeEventListener(\"keydown\",T),t.removeEventListener(\"beforeinput\",N),t.removeEventListener(\"paste\",w),t.removeEventListener(\"drop\",R),t.removeEventListener(\"focusout\",F),t.removeEventListener(\"input\",C),t.removeAttribute(\"contenteditable\"),t.removeAttribute(\"role\"),t.removeAttribute(\"aria-label\"),t.classList.remove(\"ff-editing\"),e.badge?.remove(),o===e&&(o=null)}function L(){let e=o;if(!e||e.done)return;let t=D(e.element);M(e),u({type:\"formfeed:edit-commit\",token:e.token,items:t})}function S(e){let t=o;if(!t||t.done)return;let r=t.element;for(;r.firstChild;)r.removeChild(r.firstChild);for(let i of t.saved)r.appendChild(i);M(t),e&&u({type:\"formfeed:edit-cancel\",token:t.token})}}function D(a){let l=[],f=n=>{let o=l[l.length-1];o?.kind===\"text\"?o.text+=n:n&&l.push({kind:\"text\",text:n})},p=n=>{for(let o of Array.from(n.childNodes))if(o.nodeType===3)f(o.data);else if(o.nodeType===1){let d=o,u=d.getAttribute(\"data-ff-chip\");u!==null?l.push({kind:\"chip\",index:Number(u)}):d.tagName===\"BR\"?l.push({kind:\"break\"}):((d.tagName===\"DIV\"||d.tagName===\"P\")&&l.length&&l.push({kind:\"break\"}),p(d))}};for(p(a);l[l.length-1]?.kind===\"break\";)l.pop();return l}function O(a,l){return Array.from(a.querySelectorAll(\"[data-ff-layer]\")).map(f=>{let p=f.querySelector(\":scope > .ff-text\"),n=!1;if(p&&f.style.height!==\"auto\"){let o=l.getComputedStyle(f),d=f.clientHeight-(parseFloat(o.paddingTop)||0)-(parseFloat(o.paddingBottom)||0);n=o.overflow===\"hidden\"&&(p.scrollHeight>d+1||p.scrollWidth>p.clientWidth+1)}return{id:f.getAttribute(\"data-ff-layer\")??\"\",width:f.offsetWidth,height:f.offsetHeight,overflow:n}})}function P(a){let l=a.document,f=m=>{try{a.parent.postMessage(m,\"*\")}catch{}},p=m=>typeof m==\"string\"?l.querySelector(`[data-ff-layer=\"${m.replace(/\"/g,\"\")}\"]`):null,n=()=>{for(let m of Array.from(l.querySelectorAll(\"[data-ff-layer]\")))for(let s of[\"left\",\"top\",\"width\",\"height\",\"transform\"])m.style.removeProperty(s)},o=()=>{a.formfeedFit?.(),f({type:\"formfeed:ready\",layers:O(l,a)})};a.addEventListener(\"message\",m=>{if(m.source!==a.parent)return;let s=m.data;if(!(!s||typeof s.type!=\"string\")){if(s.type===\"formfeed:layer-style\"){let g=p(s.id);if(!g)return;let x=(v,E)=>{typeof E==\"number\"&&Number.isFinite(E)&&g.style.setProperty(v,`${E}px`)};x(\"left\",s.left),x(\"top\",s.top),x(\"width\",s.width),x(\"height\",s.height),typeof s.rotation==\"number\"&&Number.isFinite(s.rotation)&&g.style.setProperty(\"transform\",s.rotation?`rotate(${s.rotation}deg)`:\"none\")}else if(s.type===\"formfeed:layer-style-clear\")n();else if(s.type===\"formfeed:css\"&&typeof s.css==\"string\"){let g=l.querySelector('style[data-formfeed=\"template\"]');g&&(g.textContent=s.css),n(),o()}}}),H(a,{clicks:!1,live:!0});let d=l.fonts,u=()=>d?void d.ready.then(o):o();l.readyState===\"complete\"?u():a.addEventListener(\"load\",u)}P(window);})();";

package/types/lib/generated/frames.d.ts

@@ -0,0 +1,6 @@
+/** Bundled from src/frame/text-edit.entry.ts. */
+export declare const textEditRuntime = "\"use strict\";(()=>{var O=`\nhtml.ff-edit-mode [data-ff-edit] { cursor: text; }\nhtml.ff-edit-mode [data-ff-edit]:hover { outline: 1px dashed rgba(37,99,235,.85); outline-offset: 2px; }\nhtml.ff-edit-mode [data-ff-edit=\"t\"]:hover { outline-color: rgba(147,51,234,.9); }\n.ff-editing { outline: 2px solid #2563eb !important; outline-offset: 2px; cursor: text; }\n.ff-editing .ff-chip { background: rgba(37,99,235,.14) !important; box-shadow: inset 0 0 0 1px rgba(37,99,235,.45) !important; border-radius: 3px !important; padding: 0 1px !important; cursor: default; }\n.ff-edit-badge { position: absolute; z-index: 2147483647; font: 500 11px/1.4 system-ui, sans-serif !important; color: #fff !important; background: #2563eb !important; padding: 1px 6px !important; border-radius: 4px !important; pointer-events: none; white-space: nowrap; }\n`;function F(l,d={}){let m=d.clicks!==!1,g=d.live===!0,o=l.document,i=null,s=null,f=e=>{try{l.parent.postMessage(e,\"*\")}catch{}},v=m?o.querySelector('meta[name=\"formfeed:document\"]')?.getAttribute(\"content\")??null:null,h=!1;l.addEventListener(\"blur\",()=>{h=!0}),l.addEventListener(\"focus\",()=>{h=!1});let y=o.createElement(\"style\");y.setAttribute(\"data-formfeed\",\"edit\"),y.setAttribute(\"data-pagedjs-ignore\",\"\"),y.textContent=O,(o.head??o.documentElement).appendChild(y),m&&o.documentElement.classList.add(\"ff-edit-mode\");let M=e=>(e&&typeof e.closest==\"function\"?e:null)?.closest(\"[data-ff-edit]\")??null;o.addEventListener(\"click\",e=>{if(!m)return;if(i&&!i.done&&i.element.contains(e.target)){e.stopImmediatePropagation();return}let t=M(e.target);t&&(e.preventDefault(),e.stopImmediatePropagation(),C(t,{x:e.clientX,y:e.clientY}))},!0);function C(e,t){i&&!i.done&&x();let n=e.getAttribute(\"data-ff-src\")??\"\",r=e.getBoundingClientRect(),u=Array.from(o.querySelectorAll(`[data-ff-src=\"${n.replace(/\"/g,\"\")}\"]`));s={src:n,element:e,point:t},f({type:\"formfeed:edit-request\",src:n,doc:v,edit:e.getAttribute(\"data-ff-edit\"),text:e.textContent??\"\",elements:e.childElementCount,count:u.length,index:Math.max(0,u.indexOf(e)),split:e.hasAttribute(\"data-split-from\")||e.hasAttribute(\"data-split-to\"),rect:{left:r.left,top:r.top,width:r.width,height:r.height}})}o.addEventListener(\"keydown\",e=>{if(!m||i&&!i.done||!(e.ctrlKey||e.metaKey)||e.altKey)return;let t=e.key.toLowerCase();(t===\"z\"||t===\"y\")&&(e.preventDefault(),f({type:t===\"y\"||e.shiftKey?\"formfeed:redo\":\"formfeed:undo\"}))}),l.addEventListener(\"message\",e=>{if(e.source!==l.parent)return;let t=e.data;!t||typeof t.type!=\"string\"||(t.type===\"formfeed:edit-begin\"?P(t):t.type===\"formfeed:edit-refuse\"||t.type===\"formfeed:edit-end\"?(s=null,i&&!i.done&&E(!1)):t.type===\"formfeed:edit-open\"&&B(t))});function B(e){if(!m||typeof e.src!=\"string\"||i&&!i.done)return;let t=Array.from(o.querySelectorAll(`[data-ff-src=\"${e.src.replace(/\"/g,\"\")}\"][data-ff-edit]`)),n=Number.isInteger(e.index)?Number(e.index):0,r=t[n]??t[0];r&&C(r,null)}if(m){let e=()=>f({type:\"formfeed:edit-ready\",doc:v}),t=l;t.PagedConfig?t.formfeedEditReady=e:o.readyState===\"loading\"?o.addEventListener(\"DOMContentLoaded\",e):e()}function P(e){i&&!i.done&&E(!1);let t=e.layer?o.querySelector(`[data-ff-layer=\"${String(e.layer).replace(/\"/g,\"\")}\"] > .ff-text`):s&&s.src===e.src?s.element:o.querySelector(`[data-ff-src=\"${String(e.src).replace(/\"/g,\"\")}\"]`),n=e.at,r=e.layer?n&&Number.isFinite(n.x)&&Number.isFinite(n.y)?{x:Number(n.x),y:Number(n.y)}:null:s&&s.src===e.src?s.point:null;s=null;let u=h&&!o.hasFocus();if(!t||!Array.isArray(e.items)||u){f({type:\"formfeed:edit-cancel\",token:String(e.token)});return}let c=Array.from(t.childNodes),b=o.createDocumentFragment();for(let a of e.items)if(a.kind===\"text\")b.appendChild(o.createTextNode(String(a.text)));else if(a.kind===\"break\")b.appendChild(o.createElement(\"br\"));else if(a.kind===\"chip\"){let p=o.createElement(\"span\");p.className=\"ff-chip\",p.setAttribute(\"data-ff-chip\",String(a.index)),p.setAttribute(\"contenteditable\",\"false\"),a.title&&(p.title=String(a.title)),p.textContent=String(a.text),b.appendChild(p)}for(let a of c)t.removeChild(a);t.appendChild(b),t.contentEditable=\"true\",t.classList.add(\"ff-editing\"),t.setAttribute(\"role\",\"textbox\"),e.label&&t.setAttribute(\"aria-label\",String(e.label)),t.spellcheck=!0,i={token:String(e.token),element:t,saved:c,allowBreaks:e.allowBreaks===!0,badge:e.note?H(t,String(e.note)):null,done:!1},t.addEventListener(\"keydown\",A),t.addEventListener(\"beforeinput\",T),t.addEventListener(\"paste\",S),t.addEventListener(\"drop\",N),t.addEventListener(\"focusout\",R),g&&t.addEventListener(\"input\",k),t.focus(),e.select===\"all\"?I(t):K(t,r),f({type:\"formfeed:edit-started\",token:i.token}),typeof e.insert==\"string\"&&e.insert&&L(e.insert.replace(/\\r\\n?|\\n/g,\" \"))}function L(e){if(typeof o.execCommand==\"function\"&&o.execCommand(\"insertText\",!1,e))return;let t=l.getSelection(),n=t&&t.rangeCount?t.getRangeAt(0):null;n&&(n.deleteContents(),n.insertNode(o.createTextNode(e)),n.collapse(!1),g&&k())}function k(){i&&!i.done&&f({type:\"formfeed:edit-input\",token:i.token,items:D(i.element)})}function H(e,t){let n=o.createElement(\"div\");n.className=\"ff-edit-badge\",n.textContent=t;let r=e.getBoundingClientRect();return n.style.left=`${r.left+l.scrollX}px`,n.style.top=`${Math.max(0,r.top+l.scrollY-22)}px`,o.body.appendChild(n),n}function I(e){let t=l.getSelection();if(!t)return;let n=o.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}function K(e,t){let n=l.getSelection();if(!n)return;let r=null,u=o;if(t){if(u.caretRangeFromPoint)r=u.caretRangeFromPoint(t.x,t.y);else if(u.caretPositionFromPoint){let c=u.caretPositionFromPoint(t.x,t.y);c&&(r=o.createRange(),r.setStart(c.offsetNode,c.offset))}}if(!r||!e.contains(r.startContainer))r=o.createRange(),r.selectNodeContents(e),r.collapse(!1);else if(t){let c=r.startContainer,a=(c.nodeType===1?c:c.parentElement)?.closest(\"[data-ff-chip]\")??null;if(a&&a!==e&&e.contains(a)){let p=a.getBoundingClientRect();r=o.createRange(),t.x<p.left+p.width/2?r.setStartBefore(a):r.setStartAfter(a),r.collapse(!0)}}n.removeAllRanges(),n.addRange(r)}function A(e){let t=e.key;t===\"Escape\"?(e.preventDefault(),E(!0)):t===\"Enter\"&&!e.shiftKey?(e.preventDefault(),x()):t===\"Enter\"?(e.preventDefault(),i?.allowBreaks&&q()):t===\"Tab\"?(e.preventDefault(),x()):(e.ctrlKey||e.metaKey)&&[\"b\",\"i\",\"u\"].includes(t.toLowerCase())&&(e.preventDefault(),g&&i&&!e.altKey&&f({type:\"formfeed:edit-style\",token:i.token,key:t.toLowerCase()}))}function T(e){let t=e.inputType??\"\";(t.startsWith(\"format\")||t===\"insertFromDrop\"||t===\"insertParagraph\"||t===\"insertLineBreak\")&&e.preventDefault()}function S(e){e.preventDefault(),L((e.clipboardData?.getData(\"text/plain\")??\"\").replace(/\\r\\n?|\\n/g,\" \"))}function N(e){e.preventDefault()}function R(){l.setTimeout(()=>{i&&!i.done&&(!o.hasFocus()||!i.element.contains(o.activeElement))&&x()},0)}function q(){let e=l.getSelection();if(!e||!e.rangeCount)return;let t=e.getRangeAt(0);t.deleteContents();let n=o.createElement(\"br\");t.insertNode(n),n.nextSibling||n.parentNode?.appendChild(o.createElement(\"br\"));let r=o.createRange();r.setStartAfter(n),r.collapse(!0),e.removeAllRanges(),e.addRange(r)}function w(e){e.done=!0;let t=e.element;t.removeEventListener(\"keydown\",A),t.removeEventListener(\"beforeinput\",T),t.removeEventListener(\"paste\",S),t.removeEventListener(\"drop\",N),t.removeEventListener(\"focusout\",R),t.removeEventListener(\"input\",k),t.removeAttribute(\"contenteditable\"),t.removeAttribute(\"role\"),t.removeAttribute(\"aria-label\"),t.classList.remove(\"ff-editing\"),e.badge?.remove(),i===e&&(i=null)}function x(){let e=i;if(!e||e.done)return;let t=D(e.element);w(e),f({type:\"formfeed:edit-commit\",token:e.token,items:t})}function E(e){let t=i;if(!t||t.done)return;let n=t.element;for(;n.firstChild;)n.removeChild(n.firstChild);for(let r of t.saved)n.appendChild(r);w(t),e&&f({type:\"formfeed:edit-cancel\",token:t.token})}}function D(l){let d=[],m=o=>{let i=d[d.length-1];i?.kind===\"text\"?i.text+=o:o&&d.push({kind:\"text\",text:o})},g=o=>{for(let i of Array.from(o.childNodes))if(i.nodeType===3)m(i.data);else if(i.nodeType===1){let s=i,f=s.getAttribute(\"data-ff-chip\");f!==null?d.push({kind:\"chip\",index:Number(f)}):s.tagName===\"BR\"?d.push({kind:\"break\"}):((s.tagName===\"DIV\"||s.tagName===\"P\")&&d.length&&d.push({kind:\"break\"}),g(s))}};for(g(l);d[d.length-1]?.kind===\"break\";)d.pop();return d}F(window);})();";
+/** Bundled from src/frame/fit.entry.ts. */
+export declare const fitRuntime = "\"use strict\";(()=>{function a(t,e,n){if(e===t)return t.scrollHeight<=t.clientHeight+.5&&t.scrollWidth<=t.clientWidth+.5;let o=n.getComputedStyle(t),i=t.clientHeight-(parseFloat(o.paddingTop)||0)-(parseFloat(o.paddingBottom)||0);return e.scrollHeight<=i+.5&&e.scrollWidth<=e.clientWidth+.5}function m(t,e){let n=t.firstElementChild??t;n.style.fontSize=\"\";let o=parseFloat(e.getComputedStyle(n).fontSize)||16,i=Math.min(o,parseFloat(t.getAttribute(\"data-ff-fit-min\")??\"\")||o/2);if(a(t,n,e))return o;let l=i,s=o;for(let d=0;d<14;d++){let r=(l+s)/2;n.style.fontSize=`${r}px`,a(t,n,e)?l=r:s=r}let f=Math.floor(l*100)/100;return n.style.fontSize=`${f}px`,f}function c(t){let e=()=>{for(let o of Array.from(t.document.querySelectorAll('[data-ff-fit=\"shrink\"]')))m(o,t);t.document.documentElement.setAttribute(\"data-ff-fit\",\"done\")};t.formfeedFit=e;let n=t.document.fonts;n?n.ready.then(e):t.addEventListener(\"load\",e)}c(window);})();";
+/** Bundled from src/frame/stage.entry.ts. */
+export declare const stageRuntime = "\"use strict\";(()=>{var W=`\nhtml.ff-edit-mode [data-ff-edit] { cursor: text; }\nhtml.ff-edit-mode [data-ff-edit]:hover { outline: 1px dashed rgba(37,99,235,.85); outline-offset: 2px; }\nhtml.ff-edit-mode [data-ff-edit=\"t\"]:hover { outline-color: rgba(147,51,234,.9); }\n.ff-editing { outline: 2px solid #2563eb !important; outline-offset: 2px; cursor: text; }\n.ff-editing .ff-chip { background: rgba(37,99,235,.14) !important; box-shadow: inset 0 0 0 1px rgba(37,99,235,.45) !important; border-radius: 3px !important; padding: 0 1px !important; cursor: default; }\n.ff-edit-badge { position: absolute; z-index: 2147483647; font: 500 11px/1.4 system-ui, sans-serif !important; color: #fff !important; background: #2563eb !important; padding: 1px 6px !important; border-radius: 4px !important; pointer-events: none; white-space: nowrap; }\n`;function H(a,l={}){let f=l.clicks!==!1,p=l.live===!0,n=a.document,o=null,d=null,u=e=>{try{a.parent.postMessage(e,\"*\")}catch{}},m=f?n.querySelector('meta[name=\"formfeed:document\"]')?.getAttribute(\"content\")??null:null,s=!1;a.addEventListener(\"blur\",()=>{s=!0}),a.addEventListener(\"focus\",()=>{s=!1});let g=n.createElement(\"style\");g.setAttribute(\"data-formfeed\",\"edit\"),g.setAttribute(\"data-pagedjs-ignore\",\"\"),g.textContent=W,(n.head??n.documentElement).appendChild(g),f&&n.documentElement.classList.add(\"ff-edit-mode\");let x=e=>(e&&typeof e.closest==\"function\"?e:null)?.closest(\"[data-ff-edit]\")??null;n.addEventListener(\"click\",e=>{if(!f)return;if(o&&!o.done&&o.element.contains(e.target)){e.stopImmediatePropagation();return}let t=x(e.target);t&&(e.preventDefault(),e.stopImmediatePropagation(),v(t,{x:e.clientX,y:e.clientY}))},!0);function v(e,t){o&&!o.done&&L();let r=e.getAttribute(\"data-ff-src\")??\"\",i=e.getBoundingClientRect(),b=Array.from(n.querySelectorAll(`[data-ff-src=\"${r.replace(/\"/g,\"\")}\"]`));d={src:r,element:e,point:t},u({type:\"formfeed:edit-request\",src:r,doc:m,edit:e.getAttribute(\"data-ff-edit\"),text:e.textContent??\"\",elements:e.childElementCount,count:b.length,index:Math.max(0,b.indexOf(e)),split:e.hasAttribute(\"data-split-from\")||e.hasAttribute(\"data-split-to\"),rect:{left:i.left,top:i.top,width:i.width,height:i.height}})}n.addEventListener(\"keydown\",e=>{if(!f||o&&!o.done||!(e.ctrlKey||e.metaKey)||e.altKey)return;let t=e.key.toLowerCase();(t===\"z\"||t===\"y\")&&(e.preventDefault(),u({type:t===\"y\"||e.shiftKey?\"formfeed:redo\":\"formfeed:undo\"}))}),a.addEventListener(\"message\",e=>{if(e.source!==a.parent)return;let t=e.data;!t||typeof t.type!=\"string\"||(t.type===\"formfeed:edit-begin\"?B(t):t.type===\"formfeed:edit-refuse\"||t.type===\"formfeed:edit-end\"?(d=null,o&&!o.done&&S(!1)):t.type===\"formfeed:edit-open\"&&E(t))});function E(e){if(!f||typeof e.src!=\"string\"||o&&!o.done)return;let t=Array.from(n.querySelectorAll(`[data-ff-src=\"${e.src.replace(/\"/g,\"\")}\"][data-ff-edit]`)),r=Number.isInteger(e.index)?Number(e.index):0,i=t[r]??t[0];i&&v(i,null)}if(f){let e=()=>u({type:\"formfeed:edit-ready\",doc:m}),t=a;t.PagedConfig?t.formfeedEditReady=e:n.readyState===\"loading\"?n.addEventListener(\"DOMContentLoaded\",e):e()}function B(e){o&&!o.done&&S(!1);let t=e.layer?n.querySelector(`[data-ff-layer=\"${String(e.layer).replace(/\"/g,\"\")}\"] > .ff-text`):d&&d.src===e.src?d.element:n.querySelector(`[data-ff-src=\"${String(e.src).replace(/\"/g,\"\")}\"]`),r=e.at,i=e.layer?r&&Number.isFinite(r.x)&&Number.isFinite(r.y)?{x:Number(r.x),y:Number(r.y)}:null:d&&d.src===e.src?d.point:null;d=null;let b=s&&!n.hasFocus();if(!t||!Array.isArray(e.items)||b){u({type:\"formfeed:edit-cancel\",token:String(e.token)});return}let y=Array.from(t.childNodes),k=n.createDocumentFragment();for(let c of e.items)if(c.kind===\"text\")k.appendChild(n.createTextNode(String(c.text)));else if(c.kind===\"break\")k.appendChild(n.createElement(\"br\"));else if(c.kind===\"chip\"){let h=n.createElement(\"span\");h.className=\"ff-chip\",h.setAttribute(\"data-ff-chip\",String(c.index)),h.setAttribute(\"contenteditable\",\"false\"),c.title&&(h.title=String(c.title)),h.textContent=String(c.text),k.appendChild(h)}for(let c of y)t.removeChild(c);t.appendChild(k),t.contentEditable=\"true\",t.classList.add(\"ff-editing\"),t.setAttribute(\"role\",\"textbox\"),e.label&&t.setAttribute(\"aria-label\",String(e.label)),t.spellcheck=!0,o={token:String(e.token),element:t,saved:y,allowBreaks:e.allowBreaks===!0,badge:e.note?I(t,String(e.note)):null,done:!1},t.addEventListener(\"keydown\",T),t.addEventListener(\"beforeinput\",N),t.addEventListener(\"paste\",w),t.addEventListener(\"drop\",R),t.addEventListener(\"focusout\",F),p&&t.addEventListener(\"input\",C),t.focus(),e.select===\"all\"?q(t):K(t,i),u({type:\"formfeed:edit-started\",token:o.token}),typeof e.insert==\"string\"&&e.insert&&A(e.insert.replace(/\\r\\n?|\\n/g,\" \"))}function A(e){if(typeof n.execCommand==\"function\"&&n.execCommand(\"insertText\",!1,e))return;let t=a.getSelection(),r=t&&t.rangeCount?t.getRangeAt(0):null;r&&(r.deleteContents(),r.insertNode(n.createTextNode(e)),r.collapse(!1),p&&C())}function C(){o&&!o.done&&u({type:\"formfeed:edit-input\",token:o.token,items:D(o.element)})}function I(e,t){let r=n.createElement(\"div\");r.className=\"ff-edit-badge\",r.textContent=t;let i=e.getBoundingClientRect();return r.style.left=`${i.left+a.scrollX}px`,r.style.top=`${Math.max(0,i.top+a.scrollY-22)}px`,n.body.appendChild(r),r}function q(e){let t=a.getSelection();if(!t)return;let r=n.createRange();r.selectNodeContents(e),t.removeAllRanges(),t.addRange(r)}function K(e,t){let r=a.getSelection();if(!r)return;let i=null,b=n;if(t){if(b.caretRangeFromPoint)i=b.caretRangeFromPoint(t.x,t.y);else if(b.caretPositionFromPoint){let y=b.caretPositionFromPoint(t.x,t.y);y&&(i=n.createRange(),i.setStart(y.offsetNode,y.offset))}}if(!i||!e.contains(i.startContainer))i=n.createRange(),i.selectNodeContents(e),i.collapse(!1);else if(t){let y=i.startContainer,c=(y.nodeType===1?y:y.parentElement)?.closest(\"[data-ff-chip]\")??null;if(c&&c!==e&&e.contains(c)){let h=c.getBoundingClientRect();i=n.createRange(),t.x<h.left+h.width/2?i.setStartBefore(c):i.setStartAfter(c),i.collapse(!0)}}r.removeAllRanges(),r.addRange(i)}function T(e){let t=e.key;t===\"Escape\"?(e.preventDefault(),S(!0)):t===\"Enter\"&&!e.shiftKey?(e.preventDefault(),L()):t===\"Enter\"?(e.preventDefault(),o?.allowBreaks&&$()):t===\"Tab\"?(e.preventDefault(),L()):(e.ctrlKey||e.metaKey)&&[\"b\",\"i\",\"u\"].includes(t.toLowerCase())&&(e.preventDefault(),p&&o&&!e.altKey&&u({type:\"formfeed:edit-style\",token:o.token,key:t.toLowerCase()}))}function N(e){let t=e.inputType??\"\";(t.startsWith(\"format\")||t===\"insertFromDrop\"||t===\"insertParagraph\"||t===\"insertLineBreak\")&&e.preventDefault()}function w(e){e.preventDefault(),A((e.clipboardData?.getData(\"text/plain\")??\"\").replace(/\\r\\n?|\\n/g,\" \"))}function R(e){e.preventDefault()}function F(){a.setTimeout(()=>{o&&!o.done&&(!n.hasFocus()||!o.element.contains(n.activeElement))&&L()},0)}function $(){let e=a.getSelection();if(!e||!e.rangeCount)return;let t=e.getRangeAt(0);t.deleteContents();let r=n.createElement(\"br\");t.insertNode(r),r.nextSibling||r.parentNode?.appendChild(n.createElement(\"br\"));let i=n.createRange();i.setStartAfter(r),i.collapse(!0),e.removeAllRanges(),e.addRange(i)}function M(e){e.done=!0;let t=e.element;t.removeEventListener(\"keydown\",T),t.removeEventListener(\"beforeinput\",N),t.removeEventListener(\"paste\",w),t.removeEventListener(\"drop\",R),t.removeEventListener(\"focusout\",F),t.removeEventListener(\"input\",C),t.removeAttribute(\"contenteditable\"),t.removeAttribute(\"role\"),t.removeAttribute(\"aria-label\"),t.classList.remove(\"ff-editing\"),e.badge?.remove(),o===e&&(o=null)}function L(){let e=o;if(!e||e.done)return;let t=D(e.element);M(e),u({type:\"formfeed:edit-commit\",token:e.token,items:t})}function S(e){let t=o;if(!t||t.done)return;let r=t.element;for(;r.firstChild;)r.removeChild(r.firstChild);for(let i of t.saved)r.appendChild(i);M(t),e&&u({type:\"formfeed:edit-cancel\",token:t.token})}}function D(a){let l=[],f=n=>{let o=l[l.length-1];o?.kind===\"text\"?o.text+=n:n&&l.push({kind:\"text\",text:n})},p=n=>{for(let o of Array.from(n.childNodes))if(o.nodeType===3)f(o.data);else if(o.nodeType===1){let d=o,u=d.getAttribute(\"data-ff-chip\");u!==null?l.push({kind:\"chip\",index:Number(u)}):d.tagName===\"BR\"?l.push({kind:\"break\"}):((d.tagName===\"DIV\"||d.tagName===\"P\")&&l.length&&l.push({kind:\"break\"}),p(d))}};for(p(a);l[l.length-1]?.kind===\"break\";)l.pop();return l}function O(a,l){return Array.from(a.querySelectorAll(\"[data-ff-layer]\")).map(f=>{let p=f.querySelector(\":scope > .ff-text\"),n=!1;if(p&&f.style.height!==\"auto\"){let o=l.getComputedStyle(f),d=f.clientHeight-(parseFloat(o.paddingTop)||0)-(parseFloat(o.paddingBottom)||0);n=o.overflow===\"hidden\"&&(p.scrollHeight>d+1||p.scrollWidth>p.clientWidth+1)}return{id:f.getAttribute(\"data-ff-layer\")??\"\",width:f.offsetWidth,height:f.offsetHeight,overflow:n}})}function P(a){let l=a.document,f=m=>{try{a.parent.postMessage(m,\"*\")}catch{}},p=m=>typeof m==\"string\"?l.querySelector(`[data-ff-layer=\"${m.replace(/\"/g,\"\")}\"]`):null,n=()=>{for(let m of Array.from(l.querySelectorAll(\"[data-ff-layer]\")))for(let s of[\"left\",\"top\",\"width\",\"height\",\"transform\"])m.style.removeProperty(s)},o=()=>{a.formfeedFit?.(),f({type:\"formfeed:ready\",layers:O(l,a)})};a.addEventListener(\"message\",m=>{if(m.source!==a.parent)return;let s=m.data;if(!(!s||typeof s.type!=\"string\")){if(s.type===\"formfeed:layer-style\"){let g=p(s.id);if(!g)return;let x=(v,E)=>{typeof E==\"number\"&&Number.isFinite(E)&&g.style.setProperty(v,`${E}px`)};x(\"left\",s.left),x(\"top\",s.top),x(\"width\",s.width),x(\"height\",s.height),typeof s.rotation==\"number\"&&Number.isFinite(s.rotation)&&g.style.setProperty(\"transform\",s.rotation?`rotate(${s.rotation}deg)`:\"none\")}else if(s.type===\"formfeed:layer-style-clear\")n();else if(s.type===\"formfeed:css\"&&typeof s.css==\"string\"){let g=l.querySelector('style[data-formfeed=\"template\"]');g&&(g.textContent=s.css),n(),o()}}}),H(a,{clicks:!1,live:!0});let d=l.fonts,u=()=>d?void d.ready.then(o):o();l.readyState===\"complete\"?u():a.addEventListener(\"load\",u)}P(window);})();";

package/types/lib/preview.d.cts

@@ -22,6 +22,20 @@ export declare function paperOf(settings: TemplateSettings): {
  * the element stays so its styling applies.
  */
 export declare const pageNumberSpans: (html: string, page: string, total: string) => string;
+/** Options of the flow and paged previews. */
+export interface PreviewOptions {
+    /**
+     * The editor's edit mode: text in elements marked `data-ff-edit` (`annotateSourcePositions` with
+     * `editable`) can be edited in place, and the frame talks to the editor about it by message.
+     */
+    editing?: boolean;
+    /**
+     * A name the editor gives this document, which the edit session's messages carry back
+     * (`formfeed:document` in the head). The editor has the next document ready a moment before the
+     * frame takes it; with the name it can tell a click that still came from the one before.
+     */
+    document?: string;
+}
 /** What the preview frame reports about content wider than the page, or `null` when nothing is. */
 export interface PreviewOverflow {
     /** How far the widest element reaches past the right edge of the page's content area. */
@@ -43,8 +57,14 @@ export interface PreviewOverflow {
  * The office quick preview's frame uses the same script.
  */
 export declare const zoomGestureScript = "<script>\n(function () {\n  var say = function (message) { try { parent.postMessage(message, '*'); } catch (e) {} };\n  window.addEventListener('wheel', function (event) {\n    if (!event.ctrlKey && !event.metaKey) return;\n    event.preventDefault();\n    say({ type: 'formfeed:zoom', deltaY: event.deltaY, deltaMode: event.deltaMode });\n  }, { passive: false });\n  window.addEventListener('keydown', function (event) {\n    if (!(event.ctrlKey || event.metaKey) || event.altKey) return;\n    var step = event.key === '+' || event.key === '=' ? 'in' : event.key === '-' ? 'out' : event.key === '0' ? 'reset' : null;\n    if (!step) return;\n    event.preventDefault();\n    say({ type: 'formfeed:zoom', step: step });\n  });\n})();\n</script>";
-export declare function flowDocument(draft: RenderedDraft): string;
-export interface PagedOptions {
+export declare function flowDocument(draft: RenderedDraft, options?: PreviewOptions): string;
+/**
+ * The design stage's document (plan 16 §4.6): the assembled image template exactly as rendered, with
+ * no preview chrome around it (the stage draws its own background), and the stage runtime, which
+ * measures layers and takes drag styles and stylesheet patches by message.
+ */
+export declare function canvasDocument(draft: RenderedDraft): string;
+export interface PagedOptions extends PreviewOptions {
     /** URL of the Paged.js polyfill the frame can load. */
     pagedScriptUrl: string;
 }

package/types/lib/preview.d.ts

@@ -22,6 +22,20 @@ export declare function paperOf(settings: TemplateSettings): {
  * the element stays so its styling applies.
  */
 export declare const pageNumberSpans: (html: string, page: string, total: string) => string;
+/** Options of the flow and paged previews. */
+export interface PreviewOptions {
+    /**
+     * The editor's edit mode: text in elements marked `data-ff-edit` (`annotateSourcePositions` with
+     * `editable`) can be edited in place, and the frame talks to the editor about it by message.
+     */
+    editing?: boolean;
+    /**
+     * A name the editor gives this document, which the edit session's messages carry back
+     * (`formfeed:document` in the head). The editor has the next document ready a moment before the
+     * frame takes it; with the name it can tell a click that still came from the one before.
+     */
+    document?: string;
+}
 /** What the preview frame reports about content wider than the page, or `null` when nothing is. */
 export interface PreviewOverflow {
     /** How far the widest element reaches past the right edge of the page's content area. */
@@ -43,8 +57,14 @@ export interface PreviewOverflow {
  * The office quick preview's frame uses the same script.
  */
 export declare const zoomGestureScript = "<script>\n(function () {\n  var say = function (message) { try { parent.postMessage(message, '*'); } catch (e) {} };\n  window.addEventListener('wheel', function (event) {\n    if (!event.ctrlKey && !event.metaKey) return;\n    event.preventDefault();\n    say({ type: 'formfeed:zoom', deltaY: event.deltaY, deltaMode: event.deltaMode });\n  }, { passive: false });\n  window.addEventListener('keydown', function (event) {\n    if (!(event.ctrlKey || event.metaKey) || event.altKey) return;\n    var step = event.key === '+' || event.key === '=' ? 'in' : event.key === '-' ? 'out' : event.key === '0' ? 'reset' : null;\n    if (!step) return;\n    event.preventDefault();\n    say({ type: 'formfeed:zoom', step: step });\n  });\n})();\n</script>";
-export declare function flowDocument(draft: RenderedDraft): string;
-export interface PagedOptions {
+export declare function flowDocument(draft: RenderedDraft, options?: PreviewOptions): string;
+/**
+ * The design stage's document (plan 16 §4.6): the assembled image template exactly as rendered, with
+ * no preview chrome around it (the stage draws its own background), and the stage runtime, which
+ * measures layers and takes drag styles and stylesheet patches by message.
+ */
+export declare function canvasDocument(draft: RenderedDraft): string;
+export interface PagedOptions extends PreviewOptions {
     /** URL of the Paged.js polyfill the frame can load. */
     pagedScriptUrl: string;
 }

package/types/lib/source-edit.d.cts

@@ -0,0 +1,117 @@
+import type { EngineId } from './types.cjs';
+/**
+ * Editing text from the preview (plan 16 §3). An element whose content is literal text, output tags,
+ * inline children and line breaks — nothing that decides what is printed — is an *editable region*:
+ * the preview shows its text editable and everything else as atomic chips, and the edit comes back
+ * here to be written into the source. Text the user did not change keeps its source bytes, so
+ * indentation, line breaks and character references survive a one-word edit; changed text is
+ * HTML-escaped, and a `{` that could open template syntax is written as `{`. Every result is
+ * parsed again and compared with what the user typed before it is returned.
+ */
+export type RegionRefusal = 'not-an-element' | 'dynamic-tag' | 'void' | 'raw-text' | 'control-flow' | 'block-child' | 'unclosed' | 'no-text' | 'too-large';
+export type ChipKind = 'expression' | 'element' | 'comment' | 'entity';
+export type RegionPart = {
+    kind: 'text';
+    start: number;
+    end: number;
+} | {
+    kind: 'break';
+    start: number;
+    end: number;
+} | {
+    kind: 'chip';
+    start: number;
+    end: number;
+    chip: ChipKind;
+    label: string;
+    inner?: string;
+};
+export interface EditableRegion {
+    /** `t`: the whole content is one `t()` call, and the edit goes into the dictionary. */
+    kind: 'text' | 't';
+    tag: string;
+    /** Offset of the start tag's `<`. */
+    tagStart: number;
+    /** First character of the content, and the `<` of the end tag. */
+    start: number;
+    end: number;
+    /** After the end tag's `>`. */
+    outerEnd: number;
+    parts: RegionPart[];
+    /** `t` regions: the dictionary key and each parameter's expression by name. */
+    key?: string;
+    params?: Record<string, string>;
+}
+/** What the preview shows and sends back: text, a chip by its index among the region's chips, a line break. */
+export type EditItem = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'chip';
+    index: number;
+} | {
+    kind: 'break';
+};
+export interface RegionChip {
+    index: number;
+    kind: ChipKind;
+    /** What the chip stands for: the expression, `<strong>`, a character reference. */
+    label: string;
+    source: string;
+}
+export type ApplyResult = {
+    source: string;
+} | {
+    error: 'chips' | 'invalid';
+};
+/** A region, or why the element at that place is none. */
+export type RegionLookup = EditableRegion | {
+    reason: RegionRefusal;
+};
+/** The region whose start tag's `<` is at `line`/`column` (1-based, as `data-ff-src` names it). */
+export declare function editableRegion(source: string, engine: EngineId, location: {
+    line: number;
+    column: number;
+}): RegionLookup;
+/** The region whose start tag's `<` is at `at`. */
+export declare function editableRegionAt(source: string, engine: EngineId, at: number): RegionLookup;
+/**
+ * The region again after the source changed around it (someone typed in the code editor while the
+ * preview was being edited): found by its unique original markup, or null.
+ */
+export declare function findRegionAgain(source: string, engine: EngineId, outer: string): EditableRegion | null;
+/** Where a region's start tag is, as `data-ff-src` names it: line and column, both 1-based. */
+export declare function regionPosition(source: string, region: EditableRegion): {
+    line: number;
+    column: number;
+};
+/** The chips of a region in order, with what they stand for. */
+export declare function regionChips(source: string, region: EditableRegion): RegionChip[];
+/** What the preview shows while editing: decoded text (whitespace as written), chips and breaks. */
+export declare function regionItems(source: string, region: EditableRegion): EditItem[];
+/**
+ * Writes edited items back into the region. Chips may be deleted, never reordered or repeated. Text
+ * between the same two chips is diffed against what it was, so only the changed stretch is
+ * rewritten; if the result does not read back as the items (a kept `{` meeting a typed `%`), the
+ * whole content is written anew with every brace escaped.
+ */
+export declare function applyRegionEdit(source: string, engine: EngineId, region: EditableRegion, items: EditItem[]): ApplyResult;
+/** A dictionary text as items: `{name}` placeholders become chips, in order of appearance. */
+export declare function translationItems(text: string): {
+    items: EditItem[];
+    names: string[];
+};
+/** Edited dictionary items back into text: chips become their placeholders again, breaks spaces. */
+export declare function translationText(items: EditItem[], names: string[]): string;
+/**
+ * The value each chip shows while editing, read off the element's rendered text: the text between
+ * the chips must appear in it in order, and exactly one way of placing them must exist. Null when
+ * there is none or more than one (an empty value, a value that repeats a literal): the chips then
+ * show their labels.
+ */
+export declare function chipValues(rendered: string, items: EditItem[]): string[] | null;
+/**
+ * Literal text for a template's HTML, as the design emitter writes it: escaped like an edit from the
+ * preview, so a `{` that could open template syntax is written as `&#123;`.
+ */
+export declare function encodeTemplateText(text: string): string;

package/types/lib/source-edit.d.ts

@@ -0,0 +1,117 @@
+import type { EngineId } from './types.js';
+/**
+ * Editing text from the preview (plan 16 §3). An element whose content is literal text, output tags,
+ * inline children and line breaks — nothing that decides what is printed — is an *editable region*:
+ * the preview shows its text editable and everything else as atomic chips, and the edit comes back
+ * here to be written into the source. Text the user did not change keeps its source bytes, so
+ * indentation, line breaks and character references survive a one-word edit; changed text is
+ * HTML-escaped, and a `{` that could open template syntax is written as `{`. Every result is
+ * parsed again and compared with what the user typed before it is returned.
+ */
+export type RegionRefusal = 'not-an-element' | 'dynamic-tag' | 'void' | 'raw-text' | 'control-flow' | 'block-child' | 'unclosed' | 'no-text' | 'too-large';
+export type ChipKind = 'expression' | 'element' | 'comment' | 'entity';
+export type RegionPart = {
+    kind: 'text';
+    start: number;
+    end: number;
+} | {
+    kind: 'break';
+    start: number;
+    end: number;
+} | {
+    kind: 'chip';
+    start: number;
+    end: number;
+    chip: ChipKind;
+    label: string;
+    inner?: string;
+};
+export interface EditableRegion {
+    /** `t`: the whole content is one `t()` call, and the edit goes into the dictionary. */
+    kind: 'text' | 't';
+    tag: string;
+    /** Offset of the start tag's `<`. */
+    tagStart: number;
+    /** First character of the content, and the `<` of the end tag. */
+    start: number;
+    end: number;
+    /** After the end tag's `>`. */
+    outerEnd: number;
+    parts: RegionPart[];
+    /** `t` regions: the dictionary key and each parameter's expression by name. */
+    key?: string;
+    params?: Record<string, string>;
+}
+/** What the preview shows and sends back: text, a chip by its index among the region's chips, a line break. */
+export type EditItem = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'chip';
+    index: number;
+} | {
+    kind: 'break';
+};
+export interface RegionChip {
+    index: number;
+    kind: ChipKind;
+    /** What the chip stands for: the expression, `<strong>`, a character reference. */
+    label: string;
+    source: string;
+}
+export type ApplyResult = {
+    source: string;
+} | {
+    error: 'chips' | 'invalid';
+};
+/** A region, or why the element at that place is none. */
+export type RegionLookup = EditableRegion | {
+    reason: RegionRefusal;
+};
+/** The region whose start tag's `<` is at `line`/`column` (1-based, as `data-ff-src` names it). */
+export declare function editableRegion(source: string, engine: EngineId, location: {
+    line: number;
+    column: number;
+}): RegionLookup;
+/** The region whose start tag's `<` is at `at`. */
+export declare function editableRegionAt(source: string, engine: EngineId, at: number): RegionLookup;
+/**
+ * The region again after the source changed around it (someone typed in the code editor while the
+ * preview was being edited): found by its unique original markup, or null.
+ */
+export declare function findRegionAgain(source: string, engine: EngineId, outer: string): EditableRegion | null;
+/** Where a region's start tag is, as `data-ff-src` names it: line and column, both 1-based. */
+export declare function regionPosition(source: string, region: EditableRegion): {
+    line: number;
+    column: number;
+};
+/** The chips of a region in order, with what they stand for. */
+export declare function regionChips(source: string, region: EditableRegion): RegionChip[];
+/** What the preview shows while editing: decoded text (whitespace as written), chips and breaks. */
+export declare function regionItems(source: string, region: EditableRegion): EditItem[];
+/**
+ * Writes edited items back into the region. Chips may be deleted, never reordered or repeated. Text
+ * between the same two chips is diffed against what it was, so only the changed stretch is
+ * rewritten; if the result does not read back as the items (a kept `{` meeting a typed `%`), the
+ * whole content is written anew with every brace escaped.
+ */
+export declare function applyRegionEdit(source: string, engine: EngineId, region: EditableRegion, items: EditItem[]): ApplyResult;
+/** A dictionary text as items: `{name}` placeholders become chips, in order of appearance. */
+export declare function translationItems(text: string): {
+    items: EditItem[];
+    names: string[];
+};
+/** Edited dictionary items back into text: chips become their placeholders again, breaks spaces. */
+export declare function translationText(items: EditItem[], names: string[]): string;
+/**
+ * The value each chip shows while editing, read off the element's rendered text: the text between
+ * the chips must appear in it in order, and exactly one way of placing them must exist. Null when
+ * there is none or more than one (an empty value, a value that repeats a literal): the chips then
+ * show their labels.
+ */
+export declare function chipValues(rendered: string, items: EditItem[]): string[] | null;
+/**
+ * Literal text for a template's HTML, as the design emitter writes it: escaped like an edit from the
+ * preview, so a `{` that could open template syntax is written as `&#123;`.
+ */
+export declare function encodeTemplateText(text: string): string;

package/types/lib/source-positions.d.cts

@@ -5,16 +5,21 @@ import type { EngineId } from './types.cjs';
  * rendered element says where it came from instead of the editor searching the template for it.
  * Elements from a loop all point at the loop body, which is the line that wrote them.
  *
+ * With `editable`, a start tag whose content is a region the preview can edit (plan 16 §3.1,
+ * `editableRegionAt`) also gets `data-ff-edit="text"`, or `data-ff-edit="t"` when its whole content
+ * is one `t()` call.
+ *
  * The annotation must never change what the template means: tags inside template syntax, in
  * blocks whose output is captured or filtered as a string (`{% set %}…{% endset %}`, `{% filter %}`,
  * `{% capture %}`), in raw and comment blocks, in `<script>`/`<style>`/`<textarea>`/`<title>` and
  * HTML comments, closing tags, declarations, tags whose name is built by template syntax and tags
- * that already carry the attribute stay untouched. Removing the attribute from the rendered output
+ * that already carry the attribute stay untouched. Removing the attributes from the rendered output
  * gives the document of the original source. Preview only: saved versions, API renders and the
- * render-worker never see it.
+ * render-worker never see them.
  */
 export type SourceFile = 'body' | 'header' | 'footer';
 export declare const sourceAttribute = "data-ff-src";
+export declare const editAttribute = "data-ff-edit";
 export interface SourceLocation {
     file: SourceFile;
     /** 1-based, as Monaco counts. */
@@ -22,6 +27,10 @@ export interface SourceLocation {
     /** 1-based UTF-16 column of the tag's `<`. */
     column: number;
 }
+export interface AnnotateOptions {
+    /** Mark editable regions with `data-ff-edit` as well (the preview's edit mode). */
+    editable?: boolean;
+}
 /** Parses a `data-ff-src` value; null when it is not one. */
 export declare function parseSourceAttribute(value: string | null | undefined): SourceLocation | null;
-export declare function annotateSourcePositions(source: string, engine: EngineId, file: SourceFile): string;
+export declare function annotateSourcePositions(source: string, engine: EngineId, file: SourceFile, options?: AnnotateOptions): string;

package/types/lib/source-positions.d.ts

@@ -5,16 +5,21 @@ import type { EngineId } from './types.js';
  * rendered element says where it came from instead of the editor searching the template for it.
  * Elements from a loop all point at the loop body, which is the line that wrote them.
  *
+ * With `editable`, a start tag whose content is a region the preview can edit (plan 16 §3.1,
+ * `editableRegionAt`) also gets `data-ff-edit="text"`, or `data-ff-edit="t"` when its whole content
+ * is one `t()` call.
+ *
  * The annotation must never change what the template means: tags inside template syntax, in
  * blocks whose output is captured or filtered as a string (`{% set %}…{% endset %}`, `{% filter %}`,
  * `{% capture %}`), in raw and comment blocks, in `<script>`/`<style>`/`<textarea>`/`<title>` and
  * HTML comments, closing tags, declarations, tags whose name is built by template syntax and tags
- * that already carry the attribute stay untouched. Removing the attribute from the rendered output
+ * that already carry the attribute stay untouched. Removing the attributes from the rendered output
  * gives the document of the original source. Preview only: saved versions, API renders and the
- * render-worker never see it.
+ * render-worker never see them.
  */
 export type SourceFile = 'body' | 'header' | 'footer';
 export declare const sourceAttribute = "data-ff-src";
+export declare const editAttribute = "data-ff-edit";
 export interface SourceLocation {
     file: SourceFile;
     /** 1-based, as Monaco counts. */
@@ -22,6 +27,10 @@ export interface SourceLocation {
     /** 1-based UTF-16 column of the tag's `<`. */
     column: number;
 }
+export interface AnnotateOptions {
+    /** Mark editable regions with `data-ff-edit` as well (the preview's edit mode). */
+    editable?: boolean;
+}
 /** Parses a `data-ff-src` value; null when it is not one. */
 export declare function parseSourceAttribute(value: string | null | undefined): SourceLocation | null;
-export declare function annotateSourcePositions(source: string, engine: EngineId, file: SourceFile): string;
+export declare function annotateSourcePositions(source: string, engine: EngineId, file: SourceFile, options?: AnnotateOptions): string;

package/types/lib/source-scan.d.cts

@@ -0,0 +1,61 @@
+import type { EngineId } from './types.cjs';
+/**
+ * A template source read as HTML with template constructs in it: the scanner that finds start tags
+ * for click-to-source (`source-positions.ts`) and the regions text can be edited in from the preview
+ * (`source-edit.ts`). It knows each engine's delimiters, string literals inside expressions, raw and
+ * comment blocks, and blocks whose output is captured as a string. Internal to the engine.
+ */
+export declare const tagName: RegExp;
+/** Elements whose content the HTML parser reads as text, so a `<b>` inside is not an element. */
+export declare const rawTextElements: Set<string>;
+/**
+ * What a template construct is, for a reader that has to tell output from control flow: `output` is
+ * a value printed in place (`{{ x }}`, `{{{ x }}}`, `{{t 'k'}}`), `comment` prints nothing, and
+ * `statement` is everything that decides what is printed (`{% if %}`, `{{#each}}`, `{{else}}`,
+ * `{{> partial}}`, raw blocks).
+ */
+export type TemplateConstruct = {
+    type: 'output';
+    end: number;
+    inner: string;
+} | {
+    type: 'comment';
+    end: number;
+} | {
+    type: 'statement';
+    end: number;
+    keyword?: string;
+};
+export declare class Scanner {
+    private readonly source;
+    private readonly engine;
+    private readonly n;
+    private readonly escapes;
+    constructor(source: string, engine: EngineId);
+    /** End of the template construct starting at `at` (with a capturing block's body), or null. */
+    skipTemplate(at: number): number | null;
+    /** The construct starting at `at` and what kind it is, or null when `{` starts none. */
+    classify(at: number): TemplateConstruct | null;
+    /** Index after `close`, stepping over template constructs; the end of the source when missing. */
+    skipTo(from: number, close: string): number;
+    /** Index after the `>` that ends a tag, stepping over quoted values and template constructs. */
+    tagEnd(from: number): number;
+    /** Index of the `</name` that closes a raw text element. */
+    skipToClosingTag(from: number, name: string): number;
+    private captures;
+    private blockEnd;
+    private templateTag;
+    /** `{{{{raw}}}} … {{{{/raw}}}}`: the content is never parsed. */
+    private handlebarsRawBlock;
+    private indexAfter;
+    /** End of an expression or statement; a `close` inside a string literal does not end it. */
+    private expressionEnd;
+}
+/** Offsets where lines start; `\r\n`, `\n` and a lone `\r` all end a line, as in Monaco. */
+export declare function lineStarts(source: string): number[];
+export declare function locate(starts: number[], offset: number): {
+    line: number;
+    column: number;
+};
+/** The offset of a 1-based line and column, or null when the source has no such place. */
+export declare function offsetOf(starts: number[], sourceLength: number, line: number, column: number): number | null;

package/types/lib/source-scan.d.ts

@@ -0,0 +1,61 @@
+import type { EngineId } from './types.js';
+/**
+ * A template source read as HTML with template constructs in it: the scanner that finds start tags
+ * for click-to-source (`source-positions.ts`) and the regions text can be edited in from the preview
+ * (`source-edit.ts`). It knows each engine's delimiters, string literals inside expressions, raw and
+ * comment blocks, and blocks whose output is captured as a string. Internal to the engine.
+ */
+export declare const tagName: RegExp;
+/** Elements whose content the HTML parser reads as text, so a `<b>` inside is not an element. */
+export declare const rawTextElements: Set<string>;
+/**
+ * What a template construct is, for a reader that has to tell output from control flow: `output` is
+ * a value printed in place (`{{ x }}`, `{{{ x }}}`, `{{t 'k'}}`), `comment` prints nothing, and
+ * `statement` is everything that decides what is printed (`{% if %}`, `{{#each}}`, `{{else}}`,
+ * `{{> partial}}`, raw blocks).
+ */
+export type TemplateConstruct = {
+    type: 'output';
+    end: number;
+    inner: string;
+} | {
+    type: 'comment';
+    end: number;
+} | {
+    type: 'statement';
+    end: number;
+    keyword?: string;
+};
+export declare class Scanner {
+    private readonly source;
+    private readonly engine;
+    private readonly n;
+    private readonly escapes;
+    constructor(source: string, engine: EngineId);
+    /** End of the template construct starting at `at` (with a capturing block's body), or null. */
+    skipTemplate(at: number): number | null;
+    /** The construct starting at `at` and what kind it is, or null when `{` starts none. */
+    classify(at: number): TemplateConstruct | null;
+    /** Index after `close`, stepping over template constructs; the end of the source when missing. */
+    skipTo(from: number, close: string): number;
+    /** Index after the `>` that ends a tag, stepping over quoted values and template constructs. */
+    tagEnd(from: number): number;
+    /** Index of the `</name` that closes a raw text element. */
+    skipToClosingTag(from: number, name: string): number;
+    private captures;
+    private blockEnd;
+    private templateTag;
+    /** `{{{{raw}}}} … {{{{/raw}}}}`: the content is never parsed. */
+    private handlebarsRawBlock;
+    private indexAfter;
+    /** End of an expression or statement; a `close` inside a string literal does not end it. */
+    private expressionEnd;
+}
+/** Offsets where lines start; `\r\n`, `\n` and a lone `\r` all end a line, as in Monaco. */
+export declare function lineStarts(source: string): number[];
+export declare function locate(starts: number[], offset: number): {
+    line: number;
+    column: number;
+};
+/** The offset of a 1-based line and column, or null when the source has no such place. */
+export declare function offsetOf(starts: number[], sourceLength: number, line: number, column: number): number | null;