@vcp-dev/contracts 0.6.10 → 0.7.0

package/dist/design-tokens.d.ts

@@ -4,6 +4,7 @@ export type DesignSurfaceMode = "light" | "dark";
 export interface DesignColorSeeds {
     primary?: string;
     accent?: string;
+    foreground?: string;
     neutral?: string;
     supporting?: string[];
 }

package/dist/design-tokens.js

@@ -1 +1 @@
-import{converter as H,parse as m,wcagContrast as b}from"culori";var p=H("oklch"),M=4.5,e={paper:"oklch(0.92 0.008 250)",cream:"oklch(0.90 0.035 85)",sand:"oklch(0.75 0.05 78)",stone:"oklch(0.60 0.02 75)",ash:"oklch(0.60 0.012 250)",slate:"oklch(0.45 0.025 250)",charcoal:"oklch(0.30 0.015 255)",ink:"oklch(0.25 0.04 260)",sky:"oklch(0.72 0.12 230)",blue:"oklch(0.58 0.17 250)","medical blue":"oklch(0.58 0.12 235)",indigo:"oklch(0.50 0.18 280)",navy:"oklch(0.40 0.10 258)",ocean:"oklch(0.55 0.13 220)","slate blue":"oklch(0.46 0.06 245)",teal:"oklch(0.60 0.12 195)","soft aqua":"oklch(0.78 0.07 190)",mint:"oklch(0.78 0.10 165)",sage:"oklch(0.65 0.05 145)",green:"oklch(0.58 0.15 145)","clinical green":"oklch(0.62 0.12 155)",emerald:"oklch(0.60 0.16 155)",forest:"oklch(0.45 0.10 145)",olive:"oklch(0.58 0.08 115)",lime:"oklch(0.72 0.17 130)",yellow:"oklch(0.82 0.15 100)",gold:"oklch(0.72 0.14 85)",amber:"oklch(0.70 0.16 70)",orange:"oklch(0.66 0.18 55)",coral:"oklch(0.68 0.16 32)",terracotta:"oklch(0.55 0.12 42)",rust:"oklch(0.50 0.13 38)",brown:"oklch(0.45 0.07 55)",rose:"oklch(0.65 0.16 18)",red:"oklch(0.58 0.20 25)",crimson:"oklch(0.52 0.20 22)",wine:"oklch(0.42 0.13 18)",pink:"oklch(0.72 0.14 0)",magenta:"oklch(0.60 0.22 345)",lavender:"oklch(0.72 0.08 295)",violet:"oklch(0.58 0.19 295)",purple:"oklch(0.52 0.19 305)",plum:"oklch(0.45 0.13 325)",electric:"oklch(0.62 0.23 285)","clean white":"oklch(0.97 0.01 245)","cool gray":"oklch(0.62 0.02 245)",zinc:"oklch(0.60 0.012 250)",gray:"oklch(0.60 0.012 250)",grey:"oklch(0.60 0.012 250)",neutral:"oklch(0.60 0.005 250)",gunmetal:"oklch(0.30 0.015 255)"},q={\u84DD:e.blue,\u84DD\u8272:e.blue,\u5929\u84DD:e.sky,\u5929\u84DD\u8272:e.sky,\u6D45\u84DD:e.sky,\u6E56\u84DD:e.ocean,\u6D77\u84DD:e.ocean,\u6DF1\u84DD:e.navy,\u85CF\u84DD:e.navy,\u85CF\u9752:e.navy,\u6D77\u519B\u84DD:e.navy,\u6DF1\u6D77\u519B\u84DD:e.navy,\u5348\u591C\u84DD:e.navy,\u975B\u84DD:e.indigo,\u975B\u9752:e.indigo,\u94A2\u84DD:e["slate blue"],\u9752:e.teal,\u9752\u8272:e.teal,\u84DD\u7EFF:e.teal,\u7EFF:e.green,\u7EFF\u8272:e.green,\u6D45\u7EFF:e.mint,\u8584\u8377\u7EFF:e.mint,\u8349\u7EFF:e.lime,\u6A44\u6984\u7EFF:e.olive,\u58A8\u7EFF:e.forest,\u6DF1\u7EFF:e.forest,\u68EE\u6797\u7EFF:e.forest,\u7FE0\u7EFF:e.emerald,\u7956\u6BCD\u7EFF:e.emerald,\u9EC4:e.yellow,\u9EC4\u8272:e.yellow,\u91D1:e.gold,\u91D1\u8272:e.gold,\u91D1\u9EC4:e.gold,\u7425\u73C0:e.amber,\u7425\u73C0\u8272:e.amber,\u6A59:e.orange,\u6A59\u8272:e.orange,\u6A58\u8272:e.orange,\u6A58\u9EC4:e.orange,\u6D3B\u529B\u6A59:e.orange,\u6696\u6A59:e.orange,\u73CA\u745A:e.coral,\u73CA\u745A\u6A59:e.coral,\u9676\u571F:e.terracotta,\u8D64\u9676:e.terracotta,\u9508\u7EA2:e.rust,\u68D5:e.brown,\u68D5\u8272:e.brown,\u8910\u8272:e.brown,\u5496\u5561\u8272:e.brown,\u7EA2:e.red,\u7EA2\u8272:e.red,\u6731\u7EA2:e.red,\u7EEF\u7EA2:e.crimson,\u6DF1\u7EA2:e.crimson,\u9152\u7EA2:e.wine,\u73AB\u7470:e.rose,\u73AB\u7EA2:e.rose,\u7C89:e.pink,\u7C89\u8272:e.pink,\u7C89\u7EA2:e.pink,\u6D0B\u7EA2:e.magenta,\u54C1\u7EA2:e.magenta,\u7D2B:e.purple,\u7D2B\u8272:e.purple,\u6DE1\u7D2B:e.lavender,\u85B0\u8863\u8349:e.lavender,\u7D2B\u7F57\u5170:e.violet,\u6885\u7EA2:e.plum,\u7070:e.gray,\u7070\u8272:e.gray,\u6D45\u7070:e.gray,\u6DE1\u7070:e.gray,\u51B7\u7070:e["cool gray"],\u51B7\u7070\u767D:e["cool gray"],\u6696\u7070:e.stone,\u6DF1\u7070:e.slate,\u77F3\u58A8\u7070:e.slate,\u77F3\u677F\u7070:e.slate,\u70AD\u7070:e.charcoal,\u70AD\u9ED1:e.charcoal,\u58A8:e.ink,\u58A8\u8272:e.ink,\u9ED1:e.ink,\u9ED1\u8272:e.ink,\u767D:e["clean white"],\u767D\u8272:e["clean white"],\u7C73\u767D:e.cream,\u7C73\u8272:e.cream,\u8C61\u7259\u767D:e.cream,\u5976\u6CB9\u767D:e.cream,\u6C99\u8272:e.sand},T={...e,...q};function oe(c){let o=c.colorSeeds??{primary:"slate",accent:"blue",neutral:"zinc"},r=c.surfaceMode,n=v(o.primary||"slate"),t=l(n),s=l(v(o.accent||"blue")),u=o.neutral?v(o.neutral):W(n),a=h(u.h),d,i,k,g,S,w;r==="dark"?(d=l({mode:"oklch",l:.14,c:.03,h:a}),i=l({mode:"oklch",l:.95,c:.02,h:a}),k=l({mode:"oklch",l:.2,c:.04,h:a}),g=l({mode:"oklch",l:.29,c:.05,h:a}),S=l({mode:"oklch",l:.78,c:.02,h:a}),w=l({mode:"oklch",l:.35,c:.06,h:a})):(d=l({mode:"oklch",l:.98,c:.01,h:a}),i=l({mode:"oklch",l:.2,c:.02,h:a}),k=l({mode:"oklch",l:.96,c:.015,h:a}),g=l({mode:"oklch",l:.92,c:.02,h:a}),S=l({mode:"oklch",l:.43,c:.02,h:a}),w=l({mode:"oklch",l:.84,c:.025,h:a}));let f=c.imagePalette;if(f){let L=typeof f.background=="string"&&x(f.background),I=L&&Y(f.background,r);L&&I&&(d=l(v(f.background))),I&&typeof f.card=="string"&&x(f.card)&&(k=l(v(f.card))),I&&typeof f.muted=="string"&&x(f.muted)&&(g=l(v(f.muted))),typeof f.foreground=="string"&&x(f.foreground)?i=G(l(v(f.foreground)),d,M):L&&I&&(i=y(d)),typeof f.border=="string"&&x(f.border)&&(w=Q(l(v(f.border)),d))}let A=r!=="dark",_={"--background":d,"--foreground":i,"--card":k,"--card-foreground":i,"--muted":g,"--muted-foreground":S,"--border":w,"--input":w,"--ring":s,"--primary":t,"--primary-foreground":y(t),"--primary-hover":O(t,A),"--accent":s,"--accent-foreground":y(s),"--accent-ink":C(s,d),"--accent-subtle":X(s,A),"--accent-hover":O(s,A),"--overlay-on-dark":l({mode:"oklch",l:.96,c:.02,h:a}),"--overlay-on-light":l({mode:"oklch",l:.2,c:.02,h:a})},N=i,P=y(i),R=F(i,a),D=C(s,i),B=p(m(t)??t),$=h(B?.h),V=F(t,$),z=C(s,t);return J({..._,...{"--surface-inverse":N,"--surface-inverse-foreground":P,"--surface-inverse-muted":R,"--surface-inverse-accent-ink":D,"--surface-primary-muted":V,"--surface-primary-accent-ink":z}},o)}function J(c,o){let r=l({mode:"oklch",l:.58,c:.22,h:28}),n=l({mode:"oklch",l:.6,c:.14,h:150}),t=l({mode:"oklch",l:.75,c:.15,h:75}),s={...c,"--popover":"var(--card)","--popover-foreground":"var(--card-foreground)","--secondary":"var(--muted)","--secondary-foreground":"var(--foreground)","--destructive":r,"--destructive-foreground":y(r),"--success":n,"--success-foreground":y(n),"--warning":t,"--warning-foreground":y(t)},[u,a]=K(o,s);return s["--supporting-0"]=u,s["--supporting-1"]=a,j(s["--accent"]).forEach((i,k)=>{s[`--chart-${k+1}`]=i}),s}function K(c,o){let t=(c.supporting??[]).filter(u=>!!(u&&u.trim())).slice(0,2).map(u=>l(v(u))),s=[o["--primary"],o["--accent"]];for(;t.length<2;)t.push(s[t.length]);return[t[0],t[1]]}function x(c){let o=(c??"").trim();if(!o||o.startsWith("#")&&!/^#[0-9A-Fa-f]{3,8}$/.test(o))return!1;let r=T[o.toLowerCase()]??o;return!!m(r)}function v(c,o="paper"){let r=(c??"").trim();if(!r)return v(o);let n=T[r.toLowerCase()]??r,t=m(n);if(t){let s=p(t);if(s)return s}return U(r)}function U(c){let o=2166136261,r=c.toLowerCase();for(let u=0;u<r.length;u++)o^=r.charCodeAt(u),o=Math.imul(o,16777619)>>>0;let n=o%360,t=.08+(o>>>9)%9/100;return{mode:"oklch",l:.52+(o>>>18)%16/100,c:t,h:n}}function W(c){return{mode:"oklch",l:.6,c:.02,h:h(c.h)}}function O(c,o){let r=p(m(c)??c);if(!r)return c;let n=o?-.06:.06,t=Math.max(.06,Math.min(.97,h(r.l)+n));return l({mode:"oklch",l:t,c:h(r.c),h:h(r.h)})}function X(c,o){let r=p(m(c)??c),n=h(r?.h),t=Math.min(h(r?.c),o?.05:.06);return l({mode:"oklch",l:o?.95:.24,c:t,h:n})}function j(c){let o=p(m(c)??c),r=h(o?.h),n=Math.max(.12,Math.min(h(o?.c),.16));return[0,72,144,216,288].map(t=>l({mode:"oklch",l:.62,c:n,h:(r+t)%360}))}function y(c){let o=m(c),r=o?p(o):void 0,n=h(r?.h),t={mode:"oklch",l:.99,c:.01,h:n},s={mode:"oklch",l:.18,c:.02,h:n},u=b(o??c,t),a=b(o??c,s);return l(u>=a?t:s)}function G(c,o,r){let n=p(m(c)??c);if(!n)return y(o);if(b(c,o)>=r)return l(n);let t=p(m(o)??o),u=(t?h(t.l)>=.5:!0)?-.02:.02,a=h(n.l),d=h(n.c),i=h(n.h);for(let k=1;k<=50;k++){let g=a+u*k;if(g<=0||g>=1)break;let S={mode:"oklch",l:g,c:d,h:i};if(b(S,o)>=r)return l(S)}return y(o)}var E=1.3;function Q(c,o){let r=p(m(c)??c);if(!r)return c;if(b(c,o)>=E)return l(r);let n=p(m(o)??o),s=(n?h(n.l)>=.5:!0)?-.03:.03,u=h(r.l),a=h(r.c),d=h(r.h);for(let i=1;i<=40;i++){let k=u+s*i;if(k<=0||k>=1)break;let g={mode:"oklch",l:k,c:a,h:d};if(b(g,o)>=E)return l(g)}return c}function Y(c,o){let r=p(m(c)??c);if(!r)return!1;let n=h(r.l)>=.5;return o==="dark"?!n:n}function C(c,o){let r=p(m(c)??c);if(!r)return c;let n=h(r.h),t=h(r.c),s=h(r.l),u=p(m(o)??o),d=(u?h(u.l)>=.5:!0)?-.02:.02;for(let i=0;i<=50;i++){let k=s+d*i;if(k<=0||k>=1)break;let g={mode:"oklch",l:k,c:t,h:n};if(b(g,o)>=M)return l(g)}return y(o)}function F(c,o){let r=p(m(c)??c),t=(r?h(r.l):.5)>=.5,s=t?.75:.35,u=t?-.02:.02;for(let a=0;a<=50;a++){let d=s+u*a;if(d<=0||d>=1)break;let i={mode:"oklch",l:d,c:.02,h:o};if(b(i,c)>=M)return l(i)}return y(c)}function h(c){return typeof c=="number"&&Number.isFinite(c)?c:0}function l(c){let o=h(c.l),r=h(c.c),n=h(c.h);return`oklch(${o.toFixed(2)} ${r.toFixed(2)} ${n.toFixed(2)})`}export{T as SEMANTIC_SEED_ALIASES,C as accentInkFor,y as bestForegroundFor,h as channel,oe as deriveDesignColors,G as ensureReadableInk,x as isResolvableDesignColorSeed,l as oklchString};
+import{converter as q,parse as m,wcagContrast as b}from"culori";var p=q("oklch"),A=4.5,e={paper:"oklch(0.92 0.008 250)",cream:"oklch(0.90 0.035 85)",sand:"oklch(0.75 0.05 78)",stone:"oklch(0.60 0.02 75)",ash:"oklch(0.60 0.012 250)",slate:"oklch(0.45 0.025 250)",charcoal:"oklch(0.30 0.015 255)",ink:"oklch(0.25 0.04 260)",sky:"oklch(0.72 0.12 230)",blue:"oklch(0.58 0.17 250)","medical blue":"oklch(0.58 0.12 235)",indigo:"oklch(0.50 0.18 280)",navy:"oklch(0.40 0.10 258)",ocean:"oklch(0.55 0.13 220)","slate blue":"oklch(0.46 0.06 245)",teal:"oklch(0.60 0.12 195)","soft aqua":"oklch(0.78 0.07 190)",mint:"oklch(0.78 0.10 165)",sage:"oklch(0.65 0.05 145)",green:"oklch(0.58 0.15 145)","clinical green":"oklch(0.62 0.12 155)",emerald:"oklch(0.60 0.16 155)",forest:"oklch(0.45 0.10 145)",olive:"oklch(0.58 0.08 115)",lime:"oklch(0.72 0.17 130)",yellow:"oklch(0.82 0.15 100)",gold:"oklch(0.72 0.14 85)",amber:"oklch(0.70 0.16 70)",orange:"oklch(0.66 0.18 55)",coral:"oklch(0.68 0.16 32)",terracotta:"oklch(0.55 0.12 42)",rust:"oklch(0.50 0.13 38)",brown:"oklch(0.45 0.07 55)",rose:"oklch(0.65 0.16 18)",red:"oklch(0.58 0.20 25)",crimson:"oklch(0.52 0.20 22)",wine:"oklch(0.42 0.13 18)",pink:"oklch(0.72 0.14 0)",magenta:"oklch(0.60 0.22 345)",lavender:"oklch(0.72 0.08 295)",violet:"oklch(0.58 0.19 295)",purple:"oklch(0.52 0.19 305)",plum:"oklch(0.45 0.13 325)",electric:"oklch(0.62 0.23 285)","clean white":"oklch(0.97 0.01 245)","cool gray":"oklch(0.62 0.02 245)",zinc:"oklch(0.60 0.012 250)",gray:"oklch(0.60 0.012 250)",grey:"oklch(0.60 0.012 250)",neutral:"oklch(0.60 0.005 250)",gunmetal:"oklch(0.30 0.015 255)"},J={\u84DD:e.blue,\u84DD\u8272:e.blue,\u5929\u84DD:e.sky,\u5929\u84DD\u8272:e.sky,\u6D45\u84DD:e.sky,\u6E56\u84DD:e.ocean,\u6D77\u84DD:e.ocean,\u6DF1\u84DD:e.navy,\u85CF\u84DD:e.navy,\u85CF\u9752:e.navy,\u6D77\u519B\u84DD:e.navy,\u6DF1\u6D77\u519B\u84DD:e.navy,\u5348\u591C\u84DD:e.navy,\u975B\u84DD:e.indigo,\u975B\u9752:e.indigo,\u94A2\u84DD:e["slate blue"],\u9752:e.teal,\u9752\u8272:e.teal,\u84DD\u7EFF:e.teal,\u7EFF:e.green,\u7EFF\u8272:e.green,\u6D45\u7EFF:e.mint,\u8584\u8377\u7EFF:e.mint,\u8349\u7EFF:e.lime,\u6A44\u6984\u7EFF:e.olive,\u58A8\u7EFF:e.forest,\u6DF1\u7EFF:e.forest,\u68EE\u6797\u7EFF:e.forest,\u7FE0\u7EFF:e.emerald,\u7956\u6BCD\u7EFF:e.emerald,\u9EC4:e.yellow,\u9EC4\u8272:e.yellow,\u91D1:e.gold,\u91D1\u8272:e.gold,\u91D1\u9EC4:e.gold,\u7425\u73C0:e.amber,\u7425\u73C0\u8272:e.amber,\u6A59:e.orange,\u6A59\u8272:e.orange,\u6A58\u8272:e.orange,\u6A58\u9EC4:e.orange,\u6D3B\u529B\u6A59:e.orange,\u6696\u6A59:e.orange,\u73CA\u745A:e.coral,\u73CA\u745A\u6A59:e.coral,\u9676\u571F:e.terracotta,\u8D64\u9676:e.terracotta,\u9508\u7EA2:e.rust,\u68D5:e.brown,\u68D5\u8272:e.brown,\u8910\u8272:e.brown,\u5496\u5561\u8272:e.brown,\u7EA2:e.red,\u7EA2\u8272:e.red,\u6731\u7EA2:e.red,\u7EEF\u7EA2:e.crimson,\u6DF1\u7EA2:e.crimson,\u9152\u7EA2:e.wine,\u73AB\u7470:e.rose,\u73AB\u7EA2:e.rose,\u7C89:e.pink,\u7C89\u8272:e.pink,\u7C89\u7EA2:e.pink,\u6D0B\u7EA2:e.magenta,\u54C1\u7EA2:e.magenta,\u7D2B:e.purple,\u7D2B\u8272:e.purple,\u6DE1\u7D2B:e.lavender,\u85B0\u8863\u8349:e.lavender,\u7D2B\u7F57\u5170:e.violet,\u6885\u7EA2:e.plum,\u7070:e.gray,\u7070\u8272:e.gray,\u6D45\u7070:e.gray,\u6DE1\u7070:e.gray,\u51B7\u7070:e["cool gray"],\u51B7\u7070\u767D:e["cool gray"],\u6696\u7070:e.stone,\u6DF1\u7070:e.slate,\u77F3\u58A8\u7070:e.slate,\u77F3\u677F\u7070:e.slate,\u70AD\u7070:e.charcoal,\u70AD\u9ED1:e.charcoal,\u58A8:e.ink,\u58A8\u8272:e.ink,\u9ED1:e.ink,\u9ED1\u8272:e.ink,\u767D:e["clean white"],\u767D\u8272:e["clean white"],\u7C73\u767D:e.cream,\u7C73\u8272:e.cream,\u8C61\u7259\u767D:e.cream,\u5976\u6CB9\u767D:e.cream,\u6C99\u8272:e.sand},_={...e,...J};function oe(c){let o=c.colorSeeds??{primary:"slate",accent:"blue",neutral:"zinc"},r=c.surfaceMode,n=y(o.primary||"slate"),t=l(n),s=l(y(o.accent||"blue")),u=o.neutral?y(o.neutral):X(n),a=h(u.h),d,i,k,g,S,x;r==="dark"?(d=l({mode:"oklch",l:.14,c:.03,h:a}),i=l({mode:"oklch",l:.95,c:.02,h:a}),k=l({mode:"oklch",l:.2,c:.04,h:a}),g=l({mode:"oklch",l:.29,c:.05,h:a}),S=l({mode:"oklch",l:.78,c:.02,h:a}),x=l({mode:"oklch",l:.35,c:.06,h:a})):(d=l({mode:"oklch",l:.98,c:.01,h:a}),i=l({mode:"oklch",l:.2,c:.02,h:a}),k=l({mode:"oklch",l:.96,c:.015,h:a}),g=l({mode:"oklch",l:.92,c:.02,h:a}),S=l({mode:"oklch",l:.43,c:.02,h:a}),x=l({mode:"oklch",l:.84,c:.025,h:a}));let f=c.imagePalette;if(f){let C=typeof f.background=="string"&&w(f.background),I=C&&Y(f.background,r);C&&I&&(d=l(y(f.background))),I&&typeof f.card=="string"&&w(f.card)&&(k=l(y(f.card))),I&&typeof f.muted=="string"&&w(f.muted)&&(g=l(y(f.muted))),typeof f.foreground=="string"&&w(f.foreground)?i=E(l(y(f.foreground)),d,A):C&&I&&(i=v(d)),typeof f.border=="string"&&w(f.border)&&(x=Q(l(y(f.border)),d))}typeof o.foreground=="string"&&w(o.foreground)&&(i=E(l(y(o.foreground)),d,A));let L=r!=="dark",N={"--background":d,"--foreground":i,"--card":k,"--card-foreground":i,"--muted":g,"--muted-foreground":S,"--border":x,"--input":x,"--ring":s,"--primary":t,"--primary-foreground":v(t),"--primary-hover":O(t,L),"--accent":s,"--accent-foreground":v(s),"--accent-ink":M(s,d),"--accent-subtle":j(s,L),"--accent-hover":O(s,L),"--overlay-on-dark":l({mode:"oklch",l:.96,c:.02,h:a}),"--overlay-on-light":l({mode:"oklch",l:.2,c:.02,h:a})},P=i,R=v(i),D=T(i,a),B=M(s,i),$=p(m(t)??t),V=h($?.h),z=T(t,V),H=M(s,t);return K({...N,...{"--surface-inverse":P,"--surface-inverse-foreground":R,"--surface-inverse-muted":D,"--surface-inverse-accent-ink":B,"--surface-primary-muted":z,"--surface-primary-accent-ink":H}},o)}function K(c,o){let r=l({mode:"oklch",l:.58,c:.22,h:28}),n=l({mode:"oklch",l:.6,c:.14,h:150}),t=l({mode:"oklch",l:.75,c:.15,h:75}),s={...c,"--popover":"var(--card)","--popover-foreground":"var(--card-foreground)","--secondary":"var(--muted)","--secondary-foreground":"var(--foreground)","--destructive":r,"--destructive-foreground":v(r),"--success":n,"--success-foreground":v(n),"--warning":t,"--warning-foreground":v(t)},[u,a]=U(o,s);return s["--supporting-0"]=u,s["--supporting-1"]=a,G(s["--accent"]).forEach((i,k)=>{s[`--chart-${k+1}`]=i}),s}function U(c,o){let t=(c.supporting??[]).filter(u=>!!(u&&u.trim())).slice(0,2).map(u=>l(y(u))),s=[o["--primary"],o["--accent"]];for(;t.length<2;)t.push(s[t.length]);return[t[0],t[1]]}function w(c){let o=(c??"").trim();if(!o||o.startsWith("#")&&!/^#[0-9A-Fa-f]{3,8}$/.test(o))return!1;let r=_[o.toLowerCase()]??o;return!!m(r)}function y(c,o="paper"){let r=(c??"").trim();if(!r)return y(o);let n=_[r.toLowerCase()]??r,t=m(n);if(t){let s=p(t);if(s)return s}return W(r)}function W(c){let o=2166136261,r=c.toLowerCase();for(let u=0;u<r.length;u++)o^=r.charCodeAt(u),o=Math.imul(o,16777619)>>>0;let n=o%360,t=.08+(o>>>9)%9/100;return{mode:"oklch",l:.52+(o>>>18)%16/100,c:t,h:n}}function X(c){return{mode:"oklch",l:.6,c:.02,h:h(c.h)}}function O(c,o){let r=p(m(c)??c);if(!r)return c;let n=o?-.06:.06,t=Math.max(.06,Math.min(.97,h(r.l)+n));return l({mode:"oklch",l:t,c:h(r.c),h:h(r.h)})}function j(c,o){let r=p(m(c)??c),n=h(r?.h),t=Math.min(h(r?.c),o?.05:.06);return l({mode:"oklch",l:o?.95:.24,c:t,h:n})}function G(c){let o=p(m(c)??c),r=h(o?.h),n=Math.max(.12,Math.min(h(o?.c),.16));return[0,72,144,216,288].map(t=>l({mode:"oklch",l:.62,c:n,h:(r+t)%360}))}function v(c){let o=m(c),r=o?p(o):void 0,n=h(r?.h),t={mode:"oklch",l:.99,c:.01,h:n},s={mode:"oklch",l:.18,c:.02,h:n},u=b(o??c,t),a=b(o??c,s);return l(u>=a?t:s)}function E(c,o,r){let n=p(m(c)??c);if(!n)return v(o);if(b(c,o)>=r)return l(n);let t=p(m(o)??o),u=(t?h(t.l)>=.5:!0)?-.02:.02,a=h(n.l),d=h(n.c),i=h(n.h);for(let k=1;k<=50;k++){let g=a+u*k;if(g<=0||g>=1)break;let S={mode:"oklch",l:g,c:d,h:i};if(b(S,o)>=r)return l(S)}return v(o)}var F=1.3;function Q(c,o){let r=p(m(c)??c);if(!r)return c;if(b(c,o)>=F)return l(r);let n=p(m(o)??o),s=(n?h(n.l)>=.5:!0)?-.03:.03,u=h(r.l),a=h(r.c),d=h(r.h);for(let i=1;i<=40;i++){let k=u+s*i;if(k<=0||k>=1)break;let g={mode:"oklch",l:k,c:a,h:d};if(b(g,o)>=F)return l(g)}return c}function Y(c,o){let r=p(m(c)??c);if(!r)return!1;let n=h(r.l)>=.5;return o==="dark"?!n:n}function M(c,o){let r=p(m(c)??c);if(!r)return c;let n=h(r.h),t=h(r.c),s=h(r.l),u=p(m(o)??o),d=(u?h(u.l)>=.5:!0)?-.02:.02;for(let i=0;i<=50;i++){let k=s+d*i;if(k<=0||k>=1)break;let g={mode:"oklch",l:k,c:t,h:n};if(b(g,o)>=A)return l(g)}return v(o)}function T(c,o){let r=p(m(c)??c),t=(r?h(r.l):.5)>=.5,s=t?.75:.35,u=t?-.02:.02;for(let a=0;a<=50;a++){let d=s+u*a;if(d<=0||d>=1)break;let i={mode:"oklch",l:d,c:.02,h:o};if(b(i,c)>=A)return l(i)}return v(c)}function h(c){return typeof c=="number"&&Number.isFinite(c)?c:0}function l(c){let o=h(c.l),r=h(c.c),n=h(c.h);return`oklch(${o.toFixed(2)} ${r.toFixed(2)} ${n.toFixed(2)})`}export{_ as SEMANTIC_SEED_ALIASES,M as accentInkFor,v as bestForegroundFor,h as channel,oe as deriveDesignColors,E as ensureReadableInk,w as isResolvableDesignColorSeed,l as oklchString};

package/dist/designer-component-library.d.ts

@@ -7,6 +7,8 @@ export declare const DESIGNER_COMPONENT_LIBRARY_ERROR_CODES: {
     readonly invalidResponse: "DESIGNER_COMPONENT_LIBRARY_INVALID_RESPONSE";
     readonly incompatibleResource: "DESIGNER_COMPONENT_RESOURCE_INCOMPATIBLE";
 };
+export declare const DesignerResourceVersionSchema: z.ZodNumber;
+export type DesignerResourceVersion = z.infer<typeof DesignerResourceVersionSchema>;
 export interface DesignerComponentCategoryNode {
     readonly id: string;
     readonly key: string;
@@ -23,7 +25,7 @@ export declare const DesignerComponentCatalogItemSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodNullable<z.ZodString>;
     thumbnail_url: z.ZodNullable<z.ZodString>;
-    resolved_version: z.ZodString;
+    resolved_version: z.ZodNumber;
     category_id: z.ZodNullable<z.ZodString>;
 }, z.core.$strict>;
 export declare const DesignerComponentsDataSchema: z.ZodObject<{
@@ -33,14 +35,14 @@ export declare const DesignerComponentsDataSchema: z.ZodObject<{
         name: z.ZodString;
         description: z.ZodNullable<z.ZodString>;
         thumbnail_url: z.ZodNullable<z.ZodString>;
-        resolved_version: z.ZodString;
+        resolved_version: z.ZodNumber;
         category_id: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>>;
     next_cursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strict>;
 export declare const MockDesignerComponentInsertRequestSchema: z.ZodObject<{
     resource_id: z.ZodString;
-    resolved_version: z.ZodString;
+    resolved_version: z.ZodNumber;
     anchor_block_id: z.ZodString;
     placement: z.ZodEnum<{
         before: "before";
@@ -65,14 +67,14 @@ export type DesignerComponentsData = z.infer<typeof DesignerComponentsDataSchema
 export type MockDesignerComponentInsertRequest = z.infer<typeof MockDesignerComponentInsertRequestSchema>;
 export type MockDesignerComponentInsertData = z.infer<typeof MockDesignerComponentInsertDataSchema>;
 export type ListDesignerComponentsQuery = z.infer<typeof ListDesignerComponentsQuerySchema>;
-export declare const DesignerComponentExactVersionSchema: z.ZodString;
+export declare const DesignerComponentExactVersionSchema: z.ZodNumber;
 export declare const InstallDesignerComponentBodySchema: z.ZodObject<{
-    version: z.ZodString;
+    version: z.ZodNumber;
 }, z.core.$strict>;
 export declare const DesignerComponentInstallDataSchema: z.ZodObject<{
     resource_id: z.ZodString;
-    resolved_version: z.ZodString;
-    revision_id: z.ZodString;
+    resolved_version: z.ZodNumber;
+    revision_id: z.ZodOptional<z.ZodString>;
     digest_sha256: z.ZodString;
     materialization: z.ZodObject<{
         instanceBaseName: z.ZodString;

package/dist/designer-page-library.d.ts

@@ -8,17 +8,17 @@ export declare const DESIGNER_PAGE_LIBRARY_ERROR_CODES: {
     readonly incompatibleResource: "DESIGNER_PAGE_RESOURCE_INCOMPATIBLE";
 };
 export declare const DesignerPageResourceTypeSchema: z.ZodEnum<{
-    page: "page";
     pages: "pages";
+    page: "page";
 }>;
 export type DesignerPageResourceType = z.infer<typeof DesignerPageResourceTypeSchema>;
 export declare const DesignerPageResourceSourceSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
     }>;
-    resolved_version: z.ZodString;
+    resolved_version: z.ZodNumber;
     template_page_id: z.ZodString;
 }, z.core.$strict>;
 export type DesignerPageResourceSource = z.infer<typeof DesignerPageResourceSourceSchema>;
@@ -36,13 +36,13 @@ export declare const DesignerPageCategoriesDataSchema: z.ZodObject<{
 export declare const DesignerPageCatalogItemSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
     }>;
     name: z.ZodString;
     description: z.ZodNullable<z.ZodString>;
     thumbnail_url: z.ZodNullable<z.ZodString>;
-    resolved_version: z.ZodString;
+    resolved_version: z.ZodNumber;
     category_id: z.ZodNullable<z.ZodString>;
 }, z.core.$strict>;
 export declare const DesignerPagesDataSchema: z.ZodObject<{
@@ -50,13 +50,13 @@ export declare const DesignerPagesDataSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         resource_id: z.ZodString;
         resource_type: z.ZodEnum<{
-            page: "page";
             pages: "pages";
+            page: "page";
         }>;
         name: z.ZodString;
         description: z.ZodNullable<z.ZodString>;
         thumbnail_url: z.ZodNullable<z.ZodString>;
-        resolved_version: z.ZodString;
+        resolved_version: z.ZodNumber;
         category_id: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>>;
     next_cursor: z.ZodNullable<z.ZodString>;
@@ -74,7 +74,7 @@ export type DesignerPageCategoriesData = z.infer<typeof DesignerPageCategoriesDa
 export type DesignerPageCatalogItem = z.infer<typeof DesignerPageCatalogItemSchema>;
 export type DesignerPagesData = z.infer<typeof DesignerPagesDataSchema>;
 export type ListDesignerPagesQuery = z.infer<typeof ListDesignerPagesQuerySchema>;
-export declare const DesignerPageExactVersionSchema: z.ZodString;
+export declare const DesignerPageExactVersionSchema: z.ZodNumber;
 /**
  * Designer phase one intentionally supports one route segment only. The
  * designer owns the final route (including an optional random suffix); the
@@ -96,10 +96,10 @@ export declare const PageResourceDraftPageSchema: z.ZodObject<{
     source: z.ZodOptional<z.ZodObject<{
         resource_id: z.ZodString;
         resource_type: z.ZodEnum<{
-            page: "page";
             pages: "pages";
+            page: "page";
         }>;
-        resolved_version: z.ZodString;
+        resolved_version: z.ZodNumber;
         template_page_id: z.ZodString;
     }, z.core.$strict>>;
     blocks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -111,7 +111,7 @@ export declare const PageResourceDraftPageSchema: z.ZodObject<{
         kind: z.ZodLiteral<"component-resource">;
         instance_id: z.ZodString;
         resource_id: z.ZodString;
-        resolved_version: z.ZodString;
+        resolved_version: z.ZodNumber;
         label: z.ZodString;
     }, z.core.$strict>], "kind">>>;
     route: z.ZodObject<{
@@ -125,20 +125,20 @@ export type PageResourceDraftPage = z.infer<typeof PageResourceDraftPageSchema>;
 export declare const PageResourceDraftSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
     }>;
-    resolved_version: z.ZodString;
+    resolved_version: z.ZodNumber;
     pages: z.ZodArray<z.ZodObject<{
         template_page_id: z.ZodString;
         title: z.ZodString;
         source: z.ZodOptional<z.ZodObject<{
             resource_id: z.ZodString;
             resource_type: z.ZodEnum<{
-                page: "page";
                 pages: "pages";
+                page: "page";
             }>;
-            resolved_version: z.ZodString;
+            resolved_version: z.ZodNumber;
             template_page_id: z.ZodString;
         }, z.core.$strict>>;
         blocks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -150,7 +150,7 @@ export declare const PageResourceDraftSchema: z.ZodObject<{
             kind: z.ZodLiteral<"component-resource">;
             instance_id: z.ZodString;
             resource_id: z.ZodString;
-            resolved_version: z.ZodString;
+            resolved_version: z.ZodNumber;
             label: z.ZodString;
         }, z.core.$strict>], "kind">>>;
         route: z.ZodObject<{
@@ -164,10 +164,10 @@ export declare const PageResourceDraftSchema: z.ZodObject<{
 export type PageResourceDraft = z.infer<typeof PageResourceDraftSchema>;
 export declare const InstallDesignerPageBodySchema: z.ZodObject<{
     resource_type: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
     }>;
-    version: z.ZodString;
+    version: z.ZodNumber;
     pages: z.ZodArray<z.ZodObject<{
         template_page_id: z.ZodString;
         title: z.ZodString;
@@ -233,11 +233,11 @@ export type PageResourcePage = z.infer<typeof PageResourcePageSchema>;
 export declare const PageResourceArtifactSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
     }>;
-    resolved_version: z.ZodString;
-    revision_id: z.ZodString;
+    resolved_version: z.ZodNumber;
+    revision_id: z.ZodOptional<z.ZodString>;
     digest_sha256: z.ZodString;
     components: z.ZodArray<z.ZodObject<{
         component_id: z.ZodString;
@@ -293,11 +293,11 @@ export type PageResourceArtifact = z.infer<typeof PageResourceArtifactSchema>;
 export declare const DesignerPageInstallDataSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
     }>;
-    resolved_version: z.ZodString;
-    revision_id: z.ZodString;
+    resolved_version: z.ZodNumber;
+    revision_id: z.ZodOptional<z.ZodString>;
     digest_sha256: z.ZodString;
     components: z.ZodArray<z.ZodObject<{
         component_id: z.ZodString;
@@ -371,10 +371,10 @@ export type DesignerPageResourceTemplate = z.infer<typeof DesignerPageResourceTe
 export declare const DesignerPageResourcePreparationDataSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
     }>;
-    resolved_version: z.ZodString;
+    resolved_version: z.ZodNumber;
     pages: z.ZodArray<z.ZodObject<{
         template_page_id: z.ZodString;
         title: z.ZodString;
@@ -389,30 +389,30 @@ export declare const DesignerPageResourcePreparationDataSchema: z.ZodObject<{
 export type DesignerPageResourcePreparationData = z.infer<typeof DesignerPageResourcePreparationDataSchema>;
 export declare const PrepareDesignerPageBodySchema: z.ZodObject<{
     resource_type: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
     }>;
-    version: z.ZodString;
+    version: z.ZodNumber;
 }, z.core.$strict>;
 export type PrepareDesignerPageBody = z.infer<typeof PrepareDesignerPageBodySchema>;
 export declare const ComposeDesignerPageResourceBodySchema: z.ZodObject<{
     draft: z.ZodObject<{
         resource_id: z.ZodString;
         resource_type: z.ZodEnum<{
-            page: "page";
             pages: "pages";
+            page: "page";
         }>;
-        resolved_version: z.ZodString;
+        resolved_version: z.ZodNumber;
         pages: z.ZodArray<z.ZodObject<{
             template_page_id: z.ZodString;
             title: z.ZodString;
             source: z.ZodOptional<z.ZodObject<{
                 resource_id: z.ZodString;
                 resource_type: z.ZodEnum<{
-                    page: "page";
                     pages: "pages";
+                    page: "page";
                 }>;
-                resolved_version: z.ZodString;
+                resolved_version: z.ZodNumber;
                 template_page_id: z.ZodString;
             }, z.core.$strict>>;
             blocks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -424,7 +424,7 @@ export declare const ComposeDesignerPageResourceBodySchema: z.ZodObject<{
                 kind: z.ZodLiteral<"component-resource">;
                 instance_id: z.ZodString;
                 resource_id: z.ZodString;
-                resolved_version: z.ZodString;
+                resolved_version: z.ZodNumber;
                 label: z.ZodString;
             }, z.core.$strict>], "kind">>>;
             route: z.ZodObject<{
@@ -437,15 +437,11 @@ export declare const ComposeDesignerPageResourceBodySchema: z.ZodObject<{
     }, z.core.$strict>;
 }, z.core.$strict>;
 export type ComposeDesignerPageResourceBody = z.infer<typeof ComposeDesignerPageResourceBodySchema>;
-export declare const DesignerSitePageSchema: z.ZodObject<{
-    title: z.ZodString;
-    route_id: z.ZodString;
-}, z.core.$strict>;
-export type DesignerSitePage = z.infer<typeof DesignerSitePageSchema>;
 export declare const DesignerSitePagesDataSchema: z.ZodObject<{
-    items: z.ZodArray<z.ZodObject<{
+    groups: z.ZodArray<z.ZodObject<{
+        group_id: z.ZodString;
         title: z.ZodString;
-        route_id: z.ZodString;
+        pages: z.ZodArray<z.ZodType<import("./cms-page-directory.js").DesignerPageNode, unknown, z.core.$ZodTypeInternals<import("./cms-page-directory.js").DesignerPageNode, unknown>>>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type DesignerSitePagesData = z.infer<typeof DesignerSitePagesDataSchema>;

package/dist/e2b-preview-proxy.d.ts

@@ -0,0 +1,5 @@
+export declare function parseE2bPreviewProxyDomain(value: string | null | undefined): string | null;
+export declare function buildE2bBrowserPreviewUrl(input: {
+    sandboxId: string;
+    proxyDomain: string | null | undefined;
+}): string | null;

package/dist/external-site-edit.d.ts

@@ -0,0 +1,267 @@
+import { z } from "zod";
+/**
+ * 外部编排系统（当前是增长后台的 mastra 工作流）异步驱动改站的合同。
+ *
+ * 设计见 docs/superpowers/specs/2026-08-08-external-site-edit-api-design.md。
+ * 命名刻意不绑定具体编排器：external_run_id / external_thread_id 对应调用方
+ * 自己的运行与会话标识，VCP 只原样存储与回显，不解析其含义。
+ */
+export declare const ExternalSiteEditTaskIdSchema: z.ZodUUID;
+/** 提示词上限。改站提示词是一次任务描述，不是资料投递通道。 */
+export declare const EXTERNAL_SITE_EDIT_PROMPT_MAX_LENGTH = 4000;
+/**
+ * 结果四态。判定基准是「站点当前快照是否已推进」而非运行记录状态，
+ * 详见设计 §9.3——运行记录会在「站已改好但收口失败」时呈现为失败。
+ */
+export declare const ExternalSiteEditOutcomeSchema: z.ZodEnum<{
+    failed: "failed";
+    succeeded: "succeeded";
+    degraded: "degraded";
+    no_changes: "no_changes";
+}>;
+export type ExternalSiteEditOutcome = z.infer<typeof ExternalSiteEditOutcomeSchema>;
+/**
+ * 降级原因全集（设计 §9.4）。这些分支的共同点是：产出了真实新快照或真实副作用，
+ * 却不会让运行记录呈现为失败——即「成功外表下该改的没改成」。
+ *
+ * 注意 `sandbox_unavailable` 是唯一映射到 `failed` 的取值：沙箱起不来时那份快照
+ * 没经过任何构建校验，报成降级会让调用方以为只是有瑕疵而不再重试。
+ */
+export declare const ExternalSiteEditDegradedReasonSchema: z.ZodEnum<{
+    typecheck_unresolved: "typecheck_unresolved";
+    step_cap_reached: "step_cap_reached";
+    partial_apply_gave_up: "partial_apply_gave_up";
+    patch_protected_dropped: "patch_protected_dropped";
+    preview_build_failed: "preview_build_failed";
+    preview_runtime_degraded: "preview_runtime_degraded";
+    build_not_verified: "build_not_verified";
+    external_blocked: "external_blocked";
+    cms_reconcile_failed: "cms_reconcile_failed";
+    run_expired: "run_expired";
+    sandbox_unavailable: "sandbox_unavailable";
+}>;
+export type ExternalSiteEditDegradedReason = z.infer<typeof ExternalSiteEditDegradedReasonSchema>;
+/** 映射到可重试失败而非降级的原因。判定时优先于快照比对。 */
+export declare const EXTERNAL_SITE_EDIT_INFRASTRUCTURE_REASONS: readonly ExternalSiteEditDegradedReason[];
+export declare function isExternalSiteEditInfrastructureReason(reason: ExternalSiteEditDegradedReason | null | undefined): boolean;
+export declare const ExternalSiteEditCallbackStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    pending: "pending";
+    delivered: "delivered";
+}>;
+export type ExternalSiteEditCallbackStatus = z.infer<typeof ExternalSiteEditCallbackStatusSchema>;
+/** 任务状态：进行中，或四态终态之一。 */
+export declare const ExternalSiteEditTaskStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    succeeded: "succeeded";
+    running: "running";
+    degraded: "degraded";
+    no_changes: "no_changes";
+}>;
+export type ExternalSiteEditTaskStatus = z.infer<typeof ExternalSiteEditTaskStatusSchema>;
+export declare const CreateExternalSiteEditRequestSchema: z.ZodObject<{
+    site_id: z.ZodUUID;
+    external_run_id: z.ZodString;
+    external_thread_id: z.ZodString;
+    prompt: z.ZodString;
+}, z.core.$strict>;
+export type CreateExternalSiteEditRequest = z.infer<typeof CreateExternalSiteEditRequestSchema>;
+/**
+ * 任务描述符。提交接口与查询接口共用。
+ *
+ * `preview_url` 是沙箱临时地址：随沙箱回收失效、且无需凭据即可访问，
+ * 调用方不得持久化展示或公开投放（设计 §12.2）。
+ */
+export declare const ExternalSiteEditTaskSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    site_id: z.ZodUUID;
+    external_run_id: z.ZodString;
+    external_thread_id: z.ZodString;
+    status: z.ZodEnum<{
+        failed: "failed";
+        succeeded: "succeeded";
+        running: "running";
+        degraded: "degraded";
+        no_changes: "no_changes";
+    }>;
+    outcome: z.ZodNullable<z.ZodEnum<{
+        failed: "failed";
+        succeeded: "succeeded";
+        degraded: "degraded";
+        no_changes: "no_changes";
+    }>>;
+    degraded_reason: z.ZodNullable<z.ZodEnum<{
+        typecheck_unresolved: "typecheck_unresolved";
+        step_cap_reached: "step_cap_reached";
+        partial_apply_gave_up: "partial_apply_gave_up";
+        patch_protected_dropped: "patch_protected_dropped";
+        preview_build_failed: "preview_build_failed";
+        preview_runtime_degraded: "preview_runtime_degraded";
+        build_not_verified: "build_not_verified";
+        external_blocked: "external_blocked";
+        cms_reconcile_failed: "cms_reconcile_failed";
+        run_expired: "run_expired";
+        sandbox_unavailable: "sandbox_unavailable";
+    }>>;
+    vcp_run_id: z.ZodNullable<z.ZodUUID>;
+    base_snapshot_id: z.ZodUUID;
+    snapshot_id: z.ZodNullable<z.ZodUUID>;
+    preview_url: z.ZodNullable<z.ZodString>;
+    summary: z.ZodNullable<z.ZodString>;
+    error_code: z.ZodNullable<z.ZodString>;
+    build_verified: z.ZodNullable<z.ZodBoolean>;
+    callback_status: z.ZodEnum<{
+        failed: "failed";
+        pending: "pending";
+        delivered: "delivered";
+    }>;
+    created_at: z.ZodString;
+    started_at: z.ZodNullable<z.ZodString>;
+    finished_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type ExternalSiteEditTask = z.infer<typeof ExternalSiteEditTaskSchema>;
+export declare const CreateExternalSiteEditResponseSchema: z.ZodObject<{
+    task: z.ZodObject<{
+        id: z.ZodUUID;
+        site_id: z.ZodUUID;
+        external_run_id: z.ZodString;
+        external_thread_id: z.ZodString;
+        status: z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+            running: "running";
+            degraded: "degraded";
+            no_changes: "no_changes";
+        }>;
+        outcome: z.ZodNullable<z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+            degraded: "degraded";
+            no_changes: "no_changes";
+        }>>;
+        degraded_reason: z.ZodNullable<z.ZodEnum<{
+            typecheck_unresolved: "typecheck_unresolved";
+            step_cap_reached: "step_cap_reached";
+            partial_apply_gave_up: "partial_apply_gave_up";
+            patch_protected_dropped: "patch_protected_dropped";
+            preview_build_failed: "preview_build_failed";
+            preview_runtime_degraded: "preview_runtime_degraded";
+            build_not_verified: "build_not_verified";
+            external_blocked: "external_blocked";
+            cms_reconcile_failed: "cms_reconcile_failed";
+            run_expired: "run_expired";
+            sandbox_unavailable: "sandbox_unavailable";
+        }>>;
+        vcp_run_id: z.ZodNullable<z.ZodUUID>;
+        base_snapshot_id: z.ZodUUID;
+        snapshot_id: z.ZodNullable<z.ZodUUID>;
+        preview_url: z.ZodNullable<z.ZodString>;
+        summary: z.ZodNullable<z.ZodString>;
+        error_code: z.ZodNullable<z.ZodString>;
+        build_verified: z.ZodNullable<z.ZodBoolean>;
+        callback_status: z.ZodEnum<{
+            failed: "failed";
+            pending: "pending";
+            delivered: "delivered";
+        }>;
+        created_at: z.ZodString;
+        started_at: z.ZodNullable<z.ZodString>;
+        finished_at: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type CreateExternalSiteEditResponse = z.infer<typeof CreateExternalSiteEditResponseSchema>;
+export declare const GetExternalSiteEditResponseSchema: z.ZodObject<{
+    task: z.ZodObject<{
+        id: z.ZodUUID;
+        site_id: z.ZodUUID;
+        external_run_id: z.ZodString;
+        external_thread_id: z.ZodString;
+        status: z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+            running: "running";
+            degraded: "degraded";
+            no_changes: "no_changes";
+        }>;
+        outcome: z.ZodNullable<z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+            degraded: "degraded";
+            no_changes: "no_changes";
+        }>>;
+        degraded_reason: z.ZodNullable<z.ZodEnum<{
+            typecheck_unresolved: "typecheck_unresolved";
+            step_cap_reached: "step_cap_reached";
+            partial_apply_gave_up: "partial_apply_gave_up";
+            patch_protected_dropped: "patch_protected_dropped";
+            preview_build_failed: "preview_build_failed";
+            preview_runtime_degraded: "preview_runtime_degraded";
+            build_not_verified: "build_not_verified";
+            external_blocked: "external_blocked";
+            cms_reconcile_failed: "cms_reconcile_failed";
+            run_expired: "run_expired";
+            sandbox_unavailable: "sandbox_unavailable";
+        }>>;
+        vcp_run_id: z.ZodNullable<z.ZodUUID>;
+        base_snapshot_id: z.ZodUUID;
+        snapshot_id: z.ZodNullable<z.ZodUUID>;
+        preview_url: z.ZodNullable<z.ZodString>;
+        summary: z.ZodNullable<z.ZodString>;
+        error_code: z.ZodNullable<z.ZodString>;
+        build_verified: z.ZodNullable<z.ZodBoolean>;
+        callback_status: z.ZodEnum<{
+            failed: "failed";
+            pending: "pending";
+            delivered: "delivered";
+        }>;
+        created_at: z.ZodString;
+        started_at: z.ZodNullable<z.ZodString>;
+        finished_at: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type GetExternalSiteEditResponse = z.infer<typeof GetExternalSiteEditResponseSchema>;
+/**
+ * 回调载荷。**投递语义是至少一次**：回调重试与查询接口的对账补发都可能发出同一条，
+ * 接收端必须按 task_id 幂等去重（设计 §12.1）。
+ *
+ * 安全边界：不带诊断详情、不带内部路径、不带原始追踪。`summary` 是模型自由文本，
+ * 发送前须过出站检查。
+ */
+export declare const ExternalSiteEditCallbackPayloadSchema: z.ZodObject<{
+    task_id: z.ZodUUID;
+    external_run_id: z.ZodString;
+    external_thread_id: z.ZodString;
+    site_id: z.ZodUUID;
+    vcp_run_id: z.ZodNullable<z.ZodUUID>;
+    outcome: z.ZodEnum<{
+        failed: "failed";
+        succeeded: "succeeded";
+        degraded: "degraded";
+        no_changes: "no_changes";
+    }>;
+    degraded_reason: z.ZodNullable<z.ZodEnum<{
+        typecheck_unresolved: "typecheck_unresolved";
+        step_cap_reached: "step_cap_reached";
+        partial_apply_gave_up: "partial_apply_gave_up";
+        patch_protected_dropped: "patch_protected_dropped";
+        preview_build_failed: "preview_build_failed";
+        preview_runtime_degraded: "preview_runtime_degraded";
+        build_not_verified: "build_not_verified";
+        external_blocked: "external_blocked";
+        cms_reconcile_failed: "cms_reconcile_failed";
+        run_expired: "run_expired";
+        sandbox_unavailable: "sandbox_unavailable";
+    }>>;
+    snapshot_id: z.ZodNullable<z.ZodUUID>;
+    preview_url: z.ZodNullable<z.ZodString>;
+    summary: z.ZodNullable<z.ZodString>;
+    error_code: z.ZodNullable<z.ZodString>;
+    build_verified: z.ZodNullable<z.ZodBoolean>;
+    retryable: z.ZodBoolean;
+    finished_at: z.ZodString;
+}, z.core.$strict>;
+export type ExternalSiteEditCallbackPayload = z.infer<typeof ExternalSiteEditCallbackPayloadSchema>;
+export declare const ExternalSiteEditCallbackAckSchema: z.ZodObject<{
+    received: z.ZodLiteral<true>;
+}, z.core.$strict>;
+export type ExternalSiteEditCallbackAck = z.infer<typeof ExternalSiteEditCallbackAckSchema>;