@noodleseed/one 0.89.1 → 0.91.0

package/dist/devtools-design-preview.js

@@ -0,0 +1,438 @@
+import { DESIGN_STYLE_PROPERTIES } from './devtools-design-contract.js';
+/**
+ * Browser state machine for local Design mode. It owns selection interception, reversible annotation
+ * history, preview-only CSS, debounced persistence, and ready-brief finalization.
+ */
+export const DEVTOOLS_DESIGN_PREVIEW_CLIENT_JS = `
+(function(){
+  var STYLE_PROPERTIES=${JSON.stringify(DESIGN_STYLE_PROPERTIES)};
+  var config=null;
+  var data={
+    active:false,
+    selecting:false,
+    session:null,
+    selected:null,
+    hovered:null,
+    history:[],
+    future:[],
+    dirty:false,
+    unresolved:0
+  };
+  data.selectionId=0;
+  var saveTimer=null;
+  var overlay=null;
+  var styleElement=null;
+  var draftStyleElement=null;
+  var wiredDocument=null;
+
+  function snapshot(){
+    return {
+      active:data.active,
+      selecting:data.selecting,
+      selectionId:data.selectionId,
+      session:data.session,
+      selected:data.selected,
+      hovered:data.hovered,
+      historyLength:data.history.length,
+      futureLength:data.future.length,
+      dirty:data.dirty,
+      unresolved:data.unresolved
+    };
+  }
+  function changed(){
+    if(config&&typeof config.onChange==="function") config.onChange(snapshot());
+  }
+  function status(message,isError){
+    if(config&&typeof config.onStatus==="function") config.onStatus(message,Boolean(isError));
+  }
+  function frameDocument(){
+    try{return config&&config.frame&&config.frame.contentDocument;}catch(error){return null;}
+  }
+  function context(){
+    return config&&typeof config.getContext==="function"?config.getContext():null;
+  }
+  function query(){
+    var current=context()||{};
+    var params=new URLSearchParams();
+    params.set("toolName",current.toolName||"widget");
+    if(current.resourceUri) params.set("resourceUri",current.resourceUri);
+    params.set("width",String(current.width||820));
+    params.set("height",String(current.height||640));
+    params.set("device",current.device==="mobile"?"mobile":"desktop");
+    params.set("theme",current.theme==="dark"?"dark":"light");
+    return params.toString();
+  }
+  function requestJson(url,options){
+    return fetch(url,options).then(function(response){
+      return response.json().then(function(body){
+        if(!response.ok||!body||body.ok===false){
+          var message=body&&body.error&&body.error.message?body.error.message:"Design request failed.";
+          var error=new Error(message); error.status=response.status; throw error;
+        }
+        return body;
+      });
+    });
+  }
+  function ensureOverlay(doc){
+    if(overlay&&overlay.ownerDocument===doc) return overlay;
+    overlay=doc.createElement("div");
+    overlay.id="noodle-design-overlay";
+    overlay.setAttribute("aria-hidden","true");
+    overlay.style.cssText="position:fixed;top:0;left:0;display:none;z-index:2147483646;pointer-events:none;overflow:visible;border:2px solid #f97316;border-radius:3px;background:rgba(249,115,22,.12);box-shadow:0 0 0 1px rgba(255,255,255,.3),0 0 22px rgba(249,115,22,.2);transition:transform 100ms cubic-bezier(.23,1,.32,1),width 100ms cubic-bezier(.23,1,.32,1),height 100ms cubic-bezier(.23,1,.32,1);";
+    overlay.innerHTML='<span data-design-overlay-dot style="position:absolute;left:50%;top:-7px;width:12px;height:12px;transform:translateX(-50%);border-radius:999px;background:#f97316;box-shadow:0 0 0 2px #fff"></span><span data-design-overlay-label style="position:absolute;left:-2px;min-width:200px;max-width:300px;padding:7px 9px;border-radius:7px;background:#29292c;color:#fafafa;box-shadow:0 8px 28px rgba(0,0,0,.38);font:600 11px/1.4 Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;letter-spacing:0;white-space:nowrap;text-align:left"></span>';
+    (doc.body||doc.documentElement).appendChild(overlay);
+    return overlay;
+  }
+  function paintOverlay(element,state){
+    var doc=frameDocument();
+    if(!doc||!element){if(overlay) overlay.style.display="none";return;}
+    var box=element.getBoundingClientRect();
+    var layer=ensureOverlay(doc);
+    var view=doc.defaultView;
+    var computed=view&&view.getComputedStyle?view.getComputedStyle(element):null;
+    var tag=String(element.tagName||"element").toLowerCase();
+    var width=Math.max(0,Math.round(box.width));
+    var height=Math.max(0,Math.round(box.height));
+    var color=computed&&computed.color?computed.color:"unknown";
+    var fontSize=computed&&computed.fontSize?computed.fontSize:"unknown";
+    var fontFamily=computed&&computed.fontFamily?computed.fontFamily.split(",")[0].replace(/[\\"']/g,"").trim():"system";
+    var label=layer.querySelector("[data-design-overlay-label]");
+    if(label){
+      label.textContent=tag+"   "+width+"×"+height+"\\ncolor "+color+"   font "+fontSize+" "+fontFamily.slice(0,28);
+      label.style.top=box.top>72?"-58px":height+8+"px";
+      label.style.whiteSpace="pre";
+    }
+    layer.dataset.state=state==="selected"?"selected":"hover";
+    layer.style.background=state==="selected"?"rgba(249,115,22,.18)":"rgba(249,115,22,.1)";
+    layer.style.display="block";
+    layer.style.transform="translate("+Math.round(box.left)+"px,"+Math.round(box.top)+"px)";
+    layer.style.width=width+"px";
+    layer.style.height=height+"px";
+  }
+  function validValue(doc,property,value){
+    if(STYLE_PROPERTIES.indexOf(property)<0) return false;
+    if(typeof value!=="string"||!value.trim()) return false;
+    var probe=doc.createElement("div").style;
+    probe.setProperty(property,value);
+    return Boolean(probe.getPropertyValue(property));
+  }
+  function clearTargets(doc){
+    var targets=doc.querySelectorAll("[data-noodle-design-target]");
+    for(var i=0;i<targets.length;i++) targets[i].removeAttribute("data-noodle-design-target");
+    var draftTargets=doc.querySelectorAll("[data-noodle-design-draft]");
+    for(var d=0;d<draftTargets.length;d++) draftTargets[d].removeAttribute("data-noodle-design-draft");
+    var existing=doc.getElementById("noodle-design-preview-styles");
+    if(existing) existing.remove();
+    var existingDraft=doc.getElementById("noodle-design-draft-styles");
+    if(existingDraft) existingDraft.remove();
+    styleElement=null;
+    draftStyleElement=null;
+  }
+  function clearDraftPreview(){
+    var doc=frameDocument();
+    if(!doc) return;
+    var targets=doc.querySelectorAll("[data-noodle-design-draft]");
+    for(var i=0;i<targets.length;i++) targets[i].removeAttribute("data-noodle-design-draft");
+    var existing=doc.getElementById("noodle-design-draft-styles");
+    if(existing) existing.remove();
+    draftStyleElement=null;
+  }
+  function previewChanges(changes){
+    var doc=frameDocument();
+    clearDraftPreview();
+    if(!doc||!data.selected||!data.selected.element||!Array.isArray(changes)) return;
+    var declarations=[];
+    for(var i=0;i<changes.length;i++){
+      var change=changes[i];
+      if(change&&validValue(doc,change.property,change.to)){
+        declarations.push(change.property+":"+change.to+"!important");
+      }
+    }
+    if(!declarations.length) return;
+    data.selected.element.setAttribute("data-noodle-design-draft","true");
+    draftStyleElement=doc.createElement("style");
+    draftStyleElement.id="noodle-design-draft-styles";
+    draftStyleElement.textContent='[data-noodle-design-draft="true"]{'+declarations.join(";")+'}';
+    doc.head.appendChild(draftStyleElement);
+  }
+  function applyAnnotations(){
+    var doc=frameDocument();
+    if(!doc||!window.NoodleDesignElement||!data.session) return;
+    clearTargets(doc);
+    var rules=[];
+    var unresolved=0;
+    var annotations=data.session.annotations||[];
+    for(var i=0;i<annotations.length;i++){
+      var annotation=annotations[i];
+      var resolution=window.NoodleDesignElement.resolve(doc,annotation.target);
+      if(!resolution.element){unresolved++;continue;}
+      var targetId="annotation-"+i;
+      resolution.element.setAttribute("data-noodle-design-target",targetId);
+      var declarations=[];
+      for(var j=0;j<annotation.changes.length;j++){
+        var change=annotation.changes[j];
+        if(validValue(doc,change.property,change.to)){
+          declarations.push(change.property+":"+change.to+"!important");
+        }
+      }
+      if(declarations.length){
+        rules.push('[data-noodle-design-target="'+targetId+'"]{'+declarations.join(";")+'}');
+      }
+    }
+    styleElement=doc.createElement("style");
+    styleElement.id="noodle-design-preview-styles";
+    styleElement.textContent=rules.join("\\n");
+    doc.head.appendChild(styleElement);
+    data.unresolved=unresolved;
+  }
+  function selectableElement(element){
+    if(!element||!element.closest) return element;
+    var interactive=element.closest("button,a[href],input,textarea,select,[role=button],[role=link],[role=tab],[role=menuitem]");
+    if(interactive) return interactive;
+    var inlineTags={span:true,strong:true,em:true,small:true,b:true,i:true,u:true,svg:true,path:true,g:true,use:true};
+    var current=element;
+    var body=wiredDocument&&wiredDocument.body;
+    while(current&&current.parentElement&&current.parentElement!==body&&inlineTags[String(current.tagName||"").toLowerCase()]){
+      current=current.parentElement;
+    }
+    return current||element;
+  }
+  function select(element){
+    element=selectableElement(element);
+    if(!element||!window.NoodleDesignElement) return null;
+    clearDraftPreview();
+    data.selected={
+      element:element,
+      target:window.NoodleDesignElement.capture(element)
+    };
+    data.selectionId+=1;
+    paintOverlay(element,"selected");
+    changed();
+    return data.selected.target;
+  }
+  function pointerOver(event){
+    if(!data.active||!data.selecting||!event.target||event.target===overlay) return;
+    var element=selectableElement(event.target);
+    if(data.hovered===element) return;
+    data.hovered=element;
+    paintOverlay(element,"hover");
+  }
+  function pointerOut(event){
+    if(!data.active||!data.selecting||event.relatedTarget) return;
+    data.hovered=null;
+    paintOverlay(data.selected&&data.selected.element,"selected");
+  }
+  function repaintOverlay(){
+    var element=data.hovered||(data.selected&&data.selected.element);
+    paintOverlay(element,data.hovered?"hover":"selected");
+  }
+  function click(event){
+    if(!data.active||!data.selecting||!event.target||event.target===overlay) return;
+    event.preventDefault();
+    event.stopPropagation();
+    if(event.stopImmediatePropagation) event.stopImmediatePropagation();
+    select(event.target);
+  }
+  function keydown(event){
+    if(!data.active||!data.selecting) return;
+    if(event.key==="Escape"){
+      clearDraftPreview(); data.selected=null; data.hovered=null; paintOverlay(null); changed(); return;
+    }
+    if(event.key==="Enter"&&event.target&&event.target!==wiredDocument.body){
+      event.preventDefault(); event.stopPropagation(); select(event.target);
+    }
+  }
+  function wire(){
+    var doc=frameDocument();
+    if(!doc||wiredDocument===doc) return;
+    unwire();
+    wiredDocument=doc;
+    doc.addEventListener("pointerover",pointerOver,true);
+    doc.addEventListener("mousemove",pointerOver,true);
+    doc.addEventListener("pointerout",pointerOut,true);
+    doc.addEventListener("click",click,true);
+    doc.addEventListener("keydown",keydown,true);
+    if(doc.defaultView){
+      doc.defaultView.addEventListener("resize",repaintOverlay);
+      doc.defaultView.addEventListener("scroll",repaintOverlay,true);
+    }
+    ensureOverlay(doc);
+    updateCursor();
+  }
+  function updateCursor(){
+    if(!wiredDocument) return;
+    wiredDocument.documentElement.style.cursor=data.selecting
+      ? 'url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 width=%2224%22 height=%2224%22 viewBox=%220 0 24 24%22%3E%3Cpath d=%22M4 2.8v15.6l4.2-4.1 2.9 6.2 3.2-1.5-2.8-6.1h5.8L4 2.8Z%22 fill=%22%23f97316%22 stroke=%22%23fff%22 stroke-width=%221.2%22 stroke-linejoin=%22round%22/%3E%3C/svg%3E") 4 3, pointer'
+      :"";
+  }
+  function setSelecting(enabled){
+    data.selecting=Boolean(enabled);
+    if(!data.selecting){
+      clearDraftPreview();
+      data.selected=null;
+      data.hovered=null;
+      paintOverlay(null);
+    }
+    updateCursor();
+    status(data.selecting?"Select an element in the widget.":"Annotations are off.",false);
+    changed();
+  }
+  function unwire(){
+    if(!wiredDocument) return;
+    wiredDocument.removeEventListener("pointerover",pointerOver,true);
+    wiredDocument.removeEventListener("mousemove",pointerOver,true);
+    wiredDocument.removeEventListener("pointerout",pointerOut,true);
+    wiredDocument.removeEventListener("click",click,true);
+    wiredDocument.removeEventListener("keydown",keydown,true);
+    if(wiredDocument.defaultView){
+      wiredDocument.defaultView.removeEventListener("resize",repaintOverlay);
+      wiredDocument.defaultView.removeEventListener("scroll",repaintOverlay,true);
+    }
+    wiredDocument.documentElement.style.cursor="";
+    if(overlay) overlay.remove();
+    overlay=null;
+    wiredDocument=null;
+  }
+  function nextUpdatedAt(previous){
+    var now=new Date();
+    if(previous&&now.toISOString()<=previous) now=new Date(Date.parse(previous)+1);
+    return now.toISOString();
+  }
+  function persist(){
+    if(saveTimer){clearTimeout(saveTimer);saveTimer=null;}
+    if(!data.session||!data.dirty) return Promise.resolve(data.session);
+    var previous=data.session.updatedAt;
+    var pending=Object.assign({},data.session,{updatedAt:nextUpdatedAt(previous)});
+    data.session=pending;
+    return requestJson("/design/session",{
+      method:"PUT",
+      headers:{"content-type":"application/json","if-unmodified-since":previous},
+      body:JSON.stringify(pending)
+    }).then(function(body){
+      data.session=body.session; data.dirty=false; status("Design draft saved.",false); changed();
+      return data.session;
+    }).catch(function(error){
+      data.session=Object.assign({},data.session,{updatedAt:previous});
+      data.dirty=true; status(error.message||"Could not save the design draft.",true); changed(); throw error;
+    });
+  }
+  function schedulePersist(){
+    if(saveTimer) clearTimeout(saveTimer);
+    saveTimer=setTimeout(function(){persist().catch(function(){});},250);
+  }
+  function pushHistory(){
+    if(!data.session) return;
+    data.history.push(JSON.stringify(data.session.annotations||[]));
+    if(data.history.length>50) data.history.shift();
+    data.future=[];
+  }
+  function replaceAnnotations(annotations){
+    if(!data.session) return;
+    data.session=Object.assign({},data.session,{annotations:annotations});
+    data.dirty=true;
+    applyAnnotations();
+    schedulePersist();
+    changed();
+  }
+  function saveAnnotation(annotation){
+    if(!data.session||!annotation) return;
+    clearDraftPreview();
+    pushHistory();
+    var annotations=(data.session.annotations||[]).slice();
+    var index=annotations.findIndex(function(item){return item.id===annotation.id;});
+    if(index>=0) annotations[index]=annotation; else annotations.push(annotation);
+    replaceAnnotations(annotations);
+    data.selected=null;
+    data.hovered=null;
+    paintOverlay(null);
+    changed();
+    status("Annotation saved.",false);
+  }
+  function removeAnnotation(id){
+    if(!data.session) return;
+    pushHistory();
+    replaceAnnotations((data.session.annotations||[]).filter(function(item){return item.id!==id;}));
+    status("Annotation removed.",false);
+  }
+  function undo(){
+    if(!data.session||!data.history.length) return;
+    data.future.push(JSON.stringify(data.session.annotations||[]));
+    replaceAnnotations(JSON.parse(data.history.pop()));
+    status("Undid the last design change.",false);
+  }
+  function redo(){
+    if(!data.session||!data.future.length) return;
+    data.history.push(JSON.stringify(data.session.annotations||[]));
+    replaceAnnotations(JSON.parse(data.future.pop()));
+    status("Restored the design change.",false);
+  }
+  function rehydrate(){
+    if(!data.active) return Promise.resolve();
+    wire();
+    applyAnnotations();
+    if(data.selected&&data.selected.target){
+      var doc=frameDocument();
+      var resolved=doc&&window.NoodleDesignElement.resolve(doc,data.selected.target);
+      data.selected=resolved&&resolved.element?{element:resolved.element,target:data.selected.target}:null;
+      paintOverlay(data.selected&&data.selected.element,"selected");
+    }
+    changed();
+    return Promise.resolve();
+  }
+  function enter(){
+    data.active=true;
+    data.selecting=false;
+    var current=context();
+    if(!current||!current.toolName){
+      data.session=null; status("Open a widget in Preview, then return to Design.",true); changed();
+      return Promise.resolve(null);
+    }
+    return requestJson("/design/session?"+query()).then(function(body){
+      data.session=body.session;
+      data.dirty=false;
+      wire();
+      applyAnnotations();
+      status("Turn on annotations when you are ready to select an element.",false);
+      changed();
+      return data.session;
+    }).catch(function(error){
+      status(error.message||"Could not open Design.",true); changed(); throw error;
+    });
+  }
+  function leave(){
+    return persist().catch(function(){}).then(function(){
+      data.active=false; data.selected=null; data.hovered=null;
+      data.selecting=false;
+      var doc=frameDocument(); if(doc) clearTargets(doc);
+      unwire(); changed();
+    });
+  }
+  function finalize(){
+    return persist().then(function(){
+      if(!data.session) throw new Error("Open a widget before sending design feedback.");
+      return requestJson("/design/finalize",{
+        method:"POST",
+        headers:{"content-type":"application/json"},
+        body:JSON.stringify({expectedUpdatedAt:data.session.updatedAt})
+      });
+    });
+  }
+  function configure(next){config=next;}
+  window.NoodleDesign={
+    configure:configure,
+    enter:enter,
+    leave:leave,
+    select:select,
+    setSelecting:setSelecting,
+    previewChanges:previewChanges,
+    saveAnnotation:saveAnnotation,
+    removeAnnotation:removeAnnotation,
+    undo:undo,
+    redo:redo,
+    rehydrate:rehydrate,
+    persist:persist,
+    finalize:finalize,
+    state:snapshot
+  };
+})();`;
+//# sourceMappingURL=devtools-design-preview.js.map

package/dist/devtools-design-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-design-preview.js","sourceRoot":"","sources":["../src/devtools-design-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG;;yBAExB,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA6a1D,CAAC"}

package/dist/devtools-design-routes.d.ts

@@ -0,0 +1,14 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type DesignSessionV1 } from './devtools-design-contract.js';
+import { type DesignStore } from './devtools-design-store.js';
+export interface DesignRouteContext {
+    readonly projectRoot: string;
+    readonly entrypoint: string;
+}
+export declare function readOrCreateDesignDraft(store: DesignStore, url: URL, context: DesignRouteContext): DesignSessionV1;
+/**
+ * Handle loopback-only Design requests. The trusted filesystem context comes from the CLI process, never
+ * from the browser request.
+ */
+export declare function handleDesignRoute(req: IncomingMessage, res: ServerResponse, url: URL, context: DesignRouteContext | undefined): boolean;
+//# sourceMappingURL=devtools-design-routes.d.ts.map

package/dist/devtools-design-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-design-routes.d.ts","sourceRoot":"","sources":["../src/devtools-design-routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,WAAW,EAGjB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AA4DD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,kBAAkB,GAC1B,eAAe,CAajB;AA8CD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,kBAAkB,GAAG,SAAS,GACtC,OAAO,CAgFT"}

package/dist/devtools-design-routes.js

@@ -0,0 +1,197 @@
+import { randomUUID } from 'node:crypto';
+import { DESIGN_AGENT_INSTRUCTION } from './devtools-design-brief.js';
+import { DESIGN_MAX_BODY_BYTES, validateDesignSession, } from './devtools-design-contract.js';
+import { createDesignStore, DesignStoreConflictError, DesignStoreCorruptError, } from './devtools-design-store.js';
+const DESIGN_HEADERS = {
+    'content-type': 'application/json; charset=utf-8',
+    'cache-control': 'no-store',
+    'x-content-type-options': 'nosniff',
+    'cross-origin-resource-policy': 'same-origin',
+};
+function reply(res, status, value) {
+    res.writeHead(status, DESIGN_HEADERS);
+    res.end(JSON.stringify(value));
+}
+function error(res, status, code, message) {
+    reply(res, status, { ok: false, error: { code, message } });
+}
+function boundedInteger(raw, fallback, minimum, maximum) {
+    const value = Number(raw);
+    return Number.isInteger(value) && value >= minimum && value <= maximum ? value : fallback;
+}
+function safeText(raw, fallback, maximum) {
+    if (raw === null)
+        return fallback;
+    const normalized = raw.replace(/\s+/g, ' ').trim();
+    return normalized.length > 0 ? normalized.slice(0, maximum) : fallback;
+}
+function newDraft(url, context) {
+    const now = new Date().toISOString();
+    const device = url.searchParams.get('device') === 'mobile' ? 'mobile' : 'desktop';
+    const theme = url.searchParams.get('theme') === 'dark' ? 'dark' : 'light';
+    const resourceUri = safeText(url.searchParams.get('resourceUri'), '', 500);
+    return validateDesignSession({
+        version: 1,
+        id: randomUUID(),
+        status: 'draft',
+        project: {
+            entrypoint: context.entrypoint,
+            toolName: safeText(url.searchParams.get('toolName'), 'widget', 200),
+            ...(resourceUri ? { resourceUri } : {}),
+        },
+        viewport: {
+            width: boundedInteger(url.searchParams.get('width'), 820, 280, 3840),
+            height: boundedInteger(url.searchParams.get('height'), 640, 200, 2160),
+            device,
+            theme,
+        },
+        createdAt: now,
+        updatedAt: now,
+        annotations: [],
+    });
+}
+export function readOrCreateDesignDraft(store, url, context) {
+    const current = store.readDraft();
+    if (current)
+        return current;
+    const session = newDraft(url, context);
+    try {
+        store.writeDraft(session);
+        return session;
+    }
+    catch (caught) {
+        if (!(caught instanceof DesignStoreConflictError))
+            throw caught;
+        const raced = store.readDraft();
+        if (raced)
+            return raced;
+        throw caught;
+    }
+}
+function readJsonBody(req, res, onBody) {
+    if (!(req.headers['content-type'] ?? '').toLowerCase().startsWith('application/json')) {
+        error(res, 415, 'design_media_type', 'Design requests require application/json.');
+        req.resume();
+        return;
+    }
+    const declared = Number(req.headers['content-length']);
+    if (Number.isFinite(declared) && declared > DESIGN_MAX_BODY_BYTES) {
+        error(res, 413, 'design_body_too_large', 'Design request is too large.');
+        req.resume();
+        return;
+    }
+    const chunks = [];
+    let size = 0;
+    let rejected = false;
+    req.on('data', (chunk) => {
+        if (rejected)
+            return;
+        size += chunk.byteLength;
+        if (size > DESIGN_MAX_BODY_BYTES) {
+            rejected = true;
+            error(res, 413, 'design_body_too_large', 'Design request is too large.');
+            req.destroy();
+            return;
+        }
+        chunks.push(chunk);
+    });
+    req.on('end', () => {
+        if (rejected)
+            return;
+        try {
+            const parsed = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+            if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+                throw new Error('body must be an object');
+            }
+            onBody(parsed);
+        }
+        catch {
+            error(res, 400, 'design_invalid_json', 'Design request contains invalid JSON.');
+        }
+    });
+}
+/**
+ * Handle loopback-only Design requests. The trusted filesystem context comes from the CLI process, never
+ * from the browser request.
+ */
+export function handleDesignRoute(req, res, url, context) {
+    if (!url.pathname.startsWith('/design/'))
+        return false;
+    if (!context) {
+        error(res, 409, 'design_project_missing', 'Design needs a local Noodle project.');
+        return true;
+    }
+    const store = createDesignStore(context.projectRoot);
+    try {
+        if (url.pathname === '/design/session' && req.method === 'GET') {
+            const session = readOrCreateDesignDraft(store, url, context);
+            reply(res, 200, { ok: true, session });
+            return true;
+        }
+        if (url.pathname === '/design/session' && req.method === 'PUT') {
+            readJsonBody(req, res, (body) => {
+                try {
+                    const session = validateDesignSession(body);
+                    const expectedUpdatedAt = typeof req.headers['if-unmodified-since'] === 'string'
+                        ? req.headers['if-unmodified-since']
+                        : undefined;
+                    store.writeDraft(session, expectedUpdatedAt);
+                    reply(res, 200, { ok: true, session });
+                }
+                catch (caught) {
+                    if (caught instanceof DesignStoreCorruptError) {
+                        error(res, 500, 'design_storage_invalid', 'Local Design storage needs recovery.');
+                        return;
+                    }
+                    if (caught instanceof DesignStoreConflictError) {
+                        error(res, 409, 'design_conflict', 'The design draft changed in another tab.');
+                        return;
+                    }
+                    error(res, 400, 'design_invalid_session', 'Design Session is invalid.');
+                }
+            });
+            return true;
+        }
+        if (url.pathname === '/design/finalize' && req.method === 'POST') {
+            readJsonBody(req, res, (body) => {
+                try {
+                    const current = store.readDraft();
+                    if (!current) {
+                        error(res, 409, 'design_draft_missing', 'No design draft is ready to finalize.');
+                        return;
+                    }
+                    const expectedUpdatedAt = typeof body.expectedUpdatedAt === 'string' ? body.expectedUpdatedAt : undefined;
+                    if (!expectedUpdatedAt || current.updatedAt !== expectedUpdatedAt) {
+                        error(res, 409, 'design_conflict', 'The design draft changed in another tab.');
+                        return;
+                    }
+                    store.finalize(current);
+                    reply(res, 200, {
+                        ok: true,
+                        delivery: { kind: 'clipboard', instruction: DESIGN_AGENT_INSTRUCTION },
+                    });
+                }
+                catch (caught) {
+                    if (caught instanceof DesignStoreCorruptError) {
+                        error(res, 500, 'design_storage_invalid', 'Local Design storage needs recovery.');
+                        return;
+                    }
+                    error(res, 409, 'design_not_ready', 'Add at least one design change before continuing.');
+                }
+            });
+            return true;
+        }
+        error(res, 405, 'design_method_not_allowed', 'This Design request method is not supported.');
+        return true;
+    }
+    catch (caught) {
+        if (caught instanceof DesignStoreCorruptError) {
+            error(res, 500, 'design_storage_invalid', 'Local Design storage needs recovery.');
+        }
+        else {
+            error(res, 500, 'design_storage_failed', 'Could not access local Design storage.');
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=devtools-design-routes.js.map

package/dist/devtools-design-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-design-routes.js","sourceRoot":"","sources":["../src/devtools-design-routes.ts"],"names":[],"mappings":"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"}