@kitn.ai/ui 0.25.2 → 0.27.0

package/dist/{elements/chunks/resizable-Dpzjlvp4.js → resizable-Cp9HUYih.js}

@@ -1 +1 @@
-import{s as A,c as G,q as D,m as W,i as P,A as se,g as j,a as q,b as ce,d as ue,S as H,p as de,t as M,z as fe,e as me}from"./define-B_tXMYRm.js";import{c as E}from"./cn-CU7UAWzk.js";var U=M("<div>"),ge=M('<div><svg viewBox="0 0 4 8"fill=currentColor><circle cx=1 cy=1.5 r=0.6></circle><circle cx=3 cy=1.5 r=0.6></circle><circle cx=1 cy=4 r=0.6></circle><circle cx=3 cy=4 r=0.6></circle><circle cx=1 cy=6.5 r=0.6></circle><circle cx=3 cy=6.5 r=0.6>'),xe=M("<div class=pointer-events-none data-handle-line style=position:absolute>"),pe=M("<div role=separator aria-valuemin=0 aria-valuemax=100>");const J=fe();function L(l){if(l==null||l==="")return;if(typeof l=="number")return Number.isFinite(l)?`${l}%`:void 0;const t=l.trim();if(t==="")return;if(t.endsWith("%")||t.endsWith("px"))return t;const o=Number(t);return Number.isFinite(o)?`${o}%`:void 0}function T(l){const t=/^\s*(-?\d*\.?\d+)(px|%)\s*$/.exec(l);return t?{n:parseFloat(t[1]),unit:t[2]}:null}function K(l,t,o){if(l===void 0)return;const u=T(l),d=t===void 0?void 0:T(t),f=o===void 0?void 0:T(o);if(u&&(t===void 0||d?.unit===u.unit)&&(o===void 0||f?.unit===u.unit)){let i=u.n;return f&&(i=Math.min(i,f.n)),d&&(i=Math.max(i,d.n)),`${i}${u.unit}`}return t!==void 0&&o!==void 0?`clamp(${t}, ${l}, ${o})`:o!==void 0?`min(${l}, ${o})`:t!==void 0?`max(${t}, ${l})`:l}function ve(l){const[t,o]=A(l,["orientation","children","class"]),u=()=>t.orientation??"horizontal";return G(J.Provider,{get value(){return{orientation:u()}},get children(){var d=U();return D(d,W({get class(){return E("flex h-full w-full",u()==="vertical"?"flex-col":"flex-row",t.class)},get"data-orientation"(){return u()}},o),!1,!0),P(d,()=>t.children),d}})}function he(l){const[t,o]=A(l,["defaultSize","minSize","maxSize","locked","hidden","children","class","style"]),u=(i,v,g)=>{const m=L(i);if(m!==void 0)return m;const h=v==null?"":String(v).trim();if(h!==""){const n=parseFloat(h);if(Number.isFinite(n))return`${n}px`}const x=g==null?"":String(g).trim();if(x!==""){const n=parseFloat(x);if(Number.isFinite(n))return`${n}%`}},d=()=>{const i=o,v=u(t.minSize,i["data-min-size"],i["data-min-size-pct"]),g=u(t.maxSize,i["data-max-size"],i["data-max-size-pct"]),m=K(L(t.defaultSize),v,g);return{...m!==void 0?{"flex-basis":m,"flex-grow":"0","flex-shrink":"0"}:{flex:"1 1 0%"},display:"grid","grid-template-rows":"minmax(0, 1fr)","grid-template-columns":"minmax(0, 1fr)","min-width":"0","min-height":"0"}},f=()=>{const i={},v=(g,m,h)=>{if(g==null||g==="")return;if(typeof g=="number"){i[h]=String(g);return}const x=g.trim();x.endsWith("px")?i[m]=String(parseFloat(x)):x.endsWith("%")?i[h]=String(parseFloat(x)):Number.isFinite(Number(x))&&(i[h]=x)};return v(t.minSize,"data-min-size","data-min-size-pct"),v(t.maxSize,"data-max-size","data-max-size-pct"),v(t.defaultSize,"data-default-size","data-default-size-pct"),i};return(()=>{var i=U();return D(i,W({get class(){return E("overflow-hidden",t.class)},get style(){return{...d(),...typeof t.style=="object"?t.style:{}}},get"data-locked"(){return t.locked?"":void 0},get hidden(){return t.hidden||void 0}},f,o),!1,!0),P(i,()=>t.children),i})()}function R(l,t,o,u){const d=l.dataset[t==="min"?"minSize":"maxSize"];if(d!==void 0&&d!==""){const i=parseFloat(d);if(Number.isFinite(i))return i}const f=l.dataset[t==="min"?"minSizePct":"maxSizePct"];if(f!==void 0&&f!==""){const i=parseFloat(f);if(Number.isFinite(i))return i/100*o}return u}function ye(l){const[t,o]=A(l,["handle","onPanelResize","class","keyboardStep","static","orientation"]),u=se(J),d=()=>t.orientation??u?.orientation??"horizontal",[f,i]=j(!1),[v,g]=j(!1),m=()=>!!t.static,h=()=>t.handle??"line";let x=0,n=null,s=null,$=0,C=0;const y=()=>d()==="horizontal",p=()=>y()?"width":"height",O=e=>{if(m())return;const r=e.currentTarget;n=r.previousElementSibling,s=r.nextElementSibling,!(!n||!s)&&(e.preventDefault(),i(!0),r.setPointerCapture(e.pointerId),x=y()?e.clientX:e.clientY,$=n.getBoundingClientRect()[p()],C=s.getBoundingClientRect()[p()])},Q=e=>{if(!f()||!n||!s)return;const r=(y()?e.clientX:e.clientY)-x;F(r)};function F(e){var r;if(!n||!s)return!1;const a=n.parentElement,c=a?a.getBoundingClientRect()[p()]:0,w=R(n,"min",c,0),k=R(n,"max",c,999999),b=R(s,"min",c,0),B=R(s,"max",c,999999);let z=-1/0,S=1/0;if(z=Math.max(z,w-$),S=Math.min(S,k-$),z=Math.max(z,C-B),S=Math.min(S,C-b),z>S)return!1;const N=Math.max(z,Math.min(S,e)),ae=$+N,oe=C-N;return n.style.flexBasis=`${ae}px`,n.style.flexGrow="0",n.style.flexShrink="0",s.style.flexBasis=`${oe}px`,s.style.flexGrow="0",s.style.flexShrink="0",(r=t.onPanelResize)==null||r.call(t,N),!0}function X(){if(!n||!s)return;const e=n.parentElement;if(!e)return;const r=e.getBoundingClientRect()[p()];if(r<=0)return;const a=n.getBoundingClientRect()[p()]/r*100,c=s.getBoundingClientRect()[p()]/r*100;n.style.flexBasis=`${a}%`,s.style.flexBasis=`${c}%`}const V=()=>{X(),i(!1),n=null,s=null};function Y(e){const r=e.dataset.defaultSize,a=e.dataset.defaultSizePct;r!==void 0&&r!==""?(e.style.flexBasis=`${r}px`,e.style.flexGrow="0",e.style.flexShrink="0"):a!==void 0&&a!==""?(e.style.flexBasis=`${a}%`,e.style.flexGrow="0",e.style.flexShrink="0"):(e.style.flexBasis="",e.style.flexGrow="1",e.style.flexShrink="1")}const Z=e=>{var r;if(m())return;const a=e.currentTarget,c=a.previousElementSibling,w=a.nextElementSibling;!c||!w||(e.preventDefault(),Y(c),Y(w),(r=t.onPanelResize)==null||r.call(t,0))},_=j(50),[ee,te]=_;function ne(e){return n=e.previousElementSibling,s=e.nextElementSibling,!n||!s?!1:($=n.getBoundingClientRect()[p()],C=s.getBoundingClientRect()[p()],!0)}function ie(){if(!n)return;const e=n.parentElement;if(!e)return;const r=e.getBoundingClientRect()[p()];if(r<=0)return;const a=n.getBoundingClientRect()[p()]/r*100;te(Math.round(a))}const re=e=>{if(m())return;const r=e.currentTarget,a=t.keyboardStep??16,c=y(),w=c?"ArrowLeft":"ArrowUp",k=c?"ArrowRight":"ArrowDown";let b=null;if(e.key===w)b=-a;else if(e.key===k)b=a;else if(e.key==="Home")b="min";else if(e.key==="End")b="max";else return;if(e.preventDefault(),!!ne(r)){if(b==="min"){const B=n.parentElement,z=B?B.getBoundingClientRect()[p()]:0,S=R(n,"min",z,0);F(S-$)}else if(b==="max"){const B=n.parentElement,z=B?B.getBoundingClientRect()[p()]:0,S=R(n,"max",z,999999);F(S-$)}else F(b);ie(),X(),n=null,s=null}},I=()=>f()&&h()!=="line",le=()=>f()?"var(--color-muted, #f4f4f5)":v()?"var(--color-border, #e4e4e7)":"transparent";return(()=>{var e=pe();return e.$$keydown=re,e.$$dblclick=Z,e.addEventListener("pointerleave",()=>g(!1)),e.addEventListener("pointerenter",()=>g(!0)),e.$$pointerup=V,e.$$pointermove=Q,e.$$pointerdown=O,D(e,W({get class(){return E("relative flex items-center justify-center",t.class)},get style(){return{cursor:m()?"default":y()?"col-resize":"row-resize",[y()?"width":"height"]:"8px",background:I()?"var(--color-muted-foreground, #98989f)":"transparent",opacity:I()?"0.3":"1"}},get tabIndex(){return m()?void 0:0},get"data-orientation"(){return d()},get"data-static"(){return m()?"":void 0},get"aria-orientation"(){return y()?"vertical":"horizontal"},get"aria-valuenow"(){return ee()}},o),!1,!0),P(e,G(H,{get when(){return h()==="grip"},get children(){var r=ge(),a=r.firstChild;return q(c=>{var w=E("z-10 flex items-center justify-center",y()?"h-6 w-3 flex-col":"h-3 w-6 flex-row"),k=E("text-muted-foreground/40",y()?"h-3 w-2":"h-2 w-3 rotate-90");return w!==c.e&&ce(r,c.e=w),k!==c.t&&ue(a,"class",c.t=k),c},{e:void 0,t:void 0}),r}}),null),P(e,G(H,{get when(){return h()==="line"},get children(){var r=xe();return q(a=>de(r,{background:le(),...y()?{top:"0",bottom:"0",left:"50%",width:"1px",transform:"translateX(-0.5px)"}:{left:"0",right:"0",top:"50%",height:"1px",transform:"translateY(-0.5px)"}},a)),r}}),null),e})()}me(["pointerdown","pointermove","pointerup","dblclick","keydown"]);export{ve as R,he as a,ye as b,K as c,L as n};
+import{s as G,G as se,g as A,p as D,q as W,i as P,c as j,a as q,b as ce,d as ue,S as H,n as de,B as fe,t as M,e as me}from"./define-CGGX-7Vg.js";import{c as E}from"./cn-DN5AWfiS.js";var U=M("<div>"),xe=M('<div><svg viewBox="0 0 4 8"fill=currentColor><circle cx=1 cy=1.5 r=0.6></circle><circle cx=3 cy=1.5 r=0.6></circle><circle cx=1 cy=4 r=0.6></circle><circle cx=3 cy=4 r=0.6></circle><circle cx=1 cy=6.5 r=0.6></circle><circle cx=3 cy=6.5 r=0.6>'),ge=M("<div class=pointer-events-none data-handle-line style=position:absolute>"),pe=M("<div role=separator aria-valuemin=0 aria-valuemax=100>");const J=fe();function L(l){if(l==null||l==="")return;if(typeof l=="number")return Number.isFinite(l)?`${l}%`:void 0;const t=l.trim();if(t==="")return;if(t.endsWith("%")||t.endsWith("px"))return t;const o=Number(t);return Number.isFinite(o)?`${o}%`:void 0}function T(l){const t=/^\s*(-?\d*\.?\d+)(px|%)\s*$/.exec(l);return t?{n:parseFloat(t[1]),unit:t[2]}:null}function K(l,t,o){if(l===void 0)return;const u=T(l),d=t===void 0?void 0:T(t),f=o===void 0?void 0:T(o);if(u&&(t===void 0||d?.unit===u.unit)&&(o===void 0||f?.unit===u.unit)){let i=u.n;return f&&(i=Math.min(i,f.n)),d&&(i=Math.max(i,d.n)),`${i}${u.unit}`}return t!==void 0&&o!==void 0?`clamp(${t}, ${l}, ${o})`:o!==void 0?`min(${l}, ${o})`:t!==void 0?`max(${t}, ${l})`:l}function ve(l){const[t,o]=G(l,["orientation","children","class"]),u=()=>t.orientation??"horizontal";return j(J.Provider,{get value(){return{orientation:u()}},get children(){var d=U();return D(d,W({get class(){return E("flex h-full w-full",u()==="vertical"?"flex-col":"flex-row",t.class)},get"data-orientation"(){return u()}},o),!1,!0),P(d,()=>t.children),d}})}function he(l){const[t,o]=G(l,["defaultSize","minSize","maxSize","locked","hidden","children","class","style"]),u=(i,v,x)=>{const m=L(i);if(m!==void 0)return m;const h=v==null?"":String(v).trim();if(h!==""){const n=parseFloat(h);if(Number.isFinite(n))return`${n}px`}const g=x==null?"":String(x).trim();if(g!==""){const n=parseFloat(g);if(Number.isFinite(n))return`${n}%`}},d=()=>{const i=o,v=u(t.minSize,i["data-min-size"],i["data-min-size-pct"]),x=u(t.maxSize,i["data-max-size"],i["data-max-size-pct"]),m=K(L(t.defaultSize),v,x);return{...m!==void 0?{"flex-basis":m,"flex-grow":"0","flex-shrink":"0"}:{flex:"1 1 0%"},display:"grid","grid-template-rows":"minmax(0, 1fr)","grid-template-columns":"minmax(0, 1fr)","min-width":"0","min-height":"0"}},f=()=>{const i={},v=(x,m,h)=>{if(x==null||x==="")return;if(typeof x=="number"){i[h]=String(x);return}const g=x.trim();g.endsWith("px")?i[m]=String(parseFloat(g)):g.endsWith("%")?i[h]=String(parseFloat(g)):Number.isFinite(Number(g))&&(i[h]=g)};return v(t.minSize,"data-min-size","data-min-size-pct"),v(t.maxSize,"data-max-size","data-max-size-pct"),v(t.defaultSize,"data-default-size","data-default-size-pct"),i};return(()=>{var i=U();return D(i,W({get class(){return E("overflow-hidden",t.class)},get style(){return{...d(),...typeof t.style=="object"?t.style:{}}},get"data-locked"(){return t.locked?"":void 0},get hidden(){return t.hidden||void 0}},f,o),!1,!0),P(i,()=>t.children),i})()}function R(l,t,o,u){const d=l.dataset[t==="min"?"minSize":"maxSize"];if(d!==void 0&&d!==""){const i=parseFloat(d);if(Number.isFinite(i))return i}const f=l.dataset[t==="min"?"minSizePct":"maxSizePct"];if(f!==void 0&&f!==""){const i=parseFloat(f);if(Number.isFinite(i))return i/100*o}return u}function ye(l){const[t,o]=G(l,["handle","onPanelResize","class","keyboardStep","static","orientation"]),u=se(J),d=()=>t.orientation??u?.orientation??"horizontal",[f,i]=A(!1),[v,x]=A(!1),m=()=>!!t.static,h=()=>t.handle??"line";let g=0,n=null,s=null,$=0,C=0;const y=()=>d()==="horizontal",p=()=>y()?"width":"height",O=e=>{if(m())return;const r=e.currentTarget;n=r.previousElementSibling,s=r.nextElementSibling,!(!n||!s)&&(e.preventDefault(),i(!0),r.setPointerCapture(e.pointerId),g=y()?e.clientX:e.clientY,$=n.getBoundingClientRect()[p()],C=s.getBoundingClientRect()[p()])},Q=e=>{if(!f()||!n||!s)return;const r=(y()?e.clientX:e.clientY)-g;F(r)};function F(e){var r;if(!n||!s)return!1;const a=n.parentElement,c=a?a.getBoundingClientRect()[p()]:0,z=R(n,"min",c,0),k=R(n,"max",c,999999),b=R(s,"min",c,0),B=R(s,"max",c,999999);let S=-1/0,w=1/0;if(S=Math.max(S,z-$),w=Math.min(w,k-$),S=Math.max(S,C-B),w=Math.min(w,C-b),S>w)return!1;const N=Math.max(S,Math.min(w,e)),ae=$+N,oe=C-N;return n.style.flexBasis=`${ae}px`,n.style.flexGrow="0",n.style.flexShrink="0",s.style.flexBasis=`${oe}px`,s.style.flexGrow="0",s.style.flexShrink="0",(r=t.onPanelResize)==null||r.call(t,N),!0}function X(){if(!n||!s)return;const e=n.parentElement;if(!e)return;const r=e.getBoundingClientRect()[p()];if(r<=0)return;const a=n.getBoundingClientRect()[p()]/r*100,c=s.getBoundingClientRect()[p()]/r*100;n.style.flexBasis=`${a}%`,s.style.flexBasis=`${c}%`}const V=()=>{X(),i(!1),n=null,s=null};function Y(e){const r=e.dataset.defaultSize,a=e.dataset.defaultSizePct;r!==void 0&&r!==""?(e.style.flexBasis=`${r}px`,e.style.flexGrow="0",e.style.flexShrink="0"):a!==void 0&&a!==""?(e.style.flexBasis=`${a}%`,e.style.flexGrow="0",e.style.flexShrink="0"):(e.style.flexBasis="",e.style.flexGrow="1",e.style.flexShrink="1")}const Z=e=>{var r;if(m())return;const a=e.currentTarget,c=a.previousElementSibling,z=a.nextElementSibling;!c||!z||(e.preventDefault(),Y(c),Y(z),(r=t.onPanelResize)==null||r.call(t,0))},_=A(50),[ee,te]=_;function ne(e){return n=e.previousElementSibling,s=e.nextElementSibling,!n||!s?!1:($=n.getBoundingClientRect()[p()],C=s.getBoundingClientRect()[p()],!0)}function ie(){if(!n)return;const e=n.parentElement;if(!e)return;const r=e.getBoundingClientRect()[p()];if(r<=0)return;const a=n.getBoundingClientRect()[p()]/r*100;te(Math.round(a))}const re=e=>{if(m())return;const r=e.currentTarget,a=t.keyboardStep??16,c=y(),z=c?"ArrowLeft":"ArrowUp",k=c?"ArrowRight":"ArrowDown";let b=null;if(e.key===z)b=-a;else if(e.key===k)b=a;else if(e.key==="Home")b="min";else if(e.key==="End")b="max";else return;if(e.preventDefault(),!!ne(r)){if(b==="min"){const B=n.parentElement,S=B?B.getBoundingClientRect()[p()]:0,w=R(n,"min",S,0);F(w-$)}else if(b==="max"){const B=n.parentElement,S=B?B.getBoundingClientRect()[p()]:0,w=R(n,"max",S,999999);F(w-$)}else F(b);ie(),X(),n=null,s=null}},I=()=>f()&&h()!=="line",le=()=>f()?"var(--color-muted, #f4f4f5)":v()?"var(--color-border, #e4e4e7)":"transparent";return(()=>{var e=pe();return e.$$keydown=re,e.$$dblclick=Z,e.addEventListener("pointerleave",()=>x(!1)),e.addEventListener("pointerenter",()=>x(!0)),e.$$pointerup=V,e.$$pointermove=Q,e.$$pointerdown=O,D(e,W({get class(){return E("relative flex items-center justify-center",t.class)},get style(){return{cursor:m()?"default":y()?"col-resize":"row-resize",[y()?"width":"height"]:"8px","flex-shrink":"0",background:I()?"var(--color-muted-foreground, #98989f)":"transparent",opacity:I()?"0.3":"1"}},get tabIndex(){return m()?void 0:0},get"data-orientation"(){return d()},get"data-static"(){return m()?"":void 0},get"aria-orientation"(){return y()?"vertical":"horizontal"},get"aria-valuenow"(){return ee()}},o),!1,!0),P(e,j(H,{get when(){return h()==="grip"},get children(){var r=xe(),a=r.firstChild;return q(c=>{var z=E("z-10 flex items-center justify-center",y()?"h-6 w-3 flex-col":"h-3 w-6 flex-row"),k=E("text-muted-foreground/40",y()?"h-3 w-2":"h-2 w-3 rotate-90");return z!==c.e&&ce(r,c.e=z),k!==c.t&&ue(a,"class",c.t=k),c},{e:void 0,t:void 0}),r}}),null),P(e,j(H,{get when(){return h()==="line"},get children(){var r=ge();return q(a=>de(r,{background:le(),...y()?{top:"0",bottom:"0",left:"50%",width:"1px",transform:"translateX(-0.5px)"}:{left:"0",right:"0",top:"50%",height:"1px",transform:"translateY(-0.5px)"}},a)),r}}),null),e})()}me(["pointerdown","pointermove","pointerup","dblclick","keydown"]);export{ye as R,he as a,ve as b,K as c,L as n};

package/dist/rotate-ccw-0DLRDHH5.js

@@ -0,0 +1 @@
+import{I as o}from"./Icon-BnFKqqtY.js";import{c as e,q as r}from"./define-CGGX-7Vg.js";var t=[["path",{d:"M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8",key:"1357e3"}],["path",{d:"M3 3v5h5",key:"1xhq8a"}]],m=a=>e(o,r(a,{name:"RotateCcw",iconNode:t})),p=m;export{p as r};

package/dist/rotate-cw-DOB9IGcU.js

@@ -0,0 +1 @@
+import{I as a}from"./Icon-BnFKqqtY.js";import{c as o,q as y}from"./define-CGGX-7Vg.js";var n=[["path",{d:"M5 12h14",key:"1ays0h"}],["path",{d:"m12 5 7 7-7 7",key:"xquz4c"}]],d=e=>o(a,y(e,{name:"ArrowRight",iconNode:n})),t=d,i=[["polyline",{points:"16 18 22 12 16 6",key:"z7tu5w"}],["polyline",{points:"8 6 2 12 8 18",key:"1eg1df"}]],p=e=>o(a,y(e,{name:"Code",iconNode:i})),h=p,k=[["path",{d:"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4",key:"ih7n3h"}],["polyline",{points:"7 10 12 15 17 10",key:"2ggqvy"}],["line",{x1:"12",x2:"12",y1:"15",y2:"3",key:"1vk2je"}]],s=e=>o(a,y(e,{name:"Download",iconNode:k})),c=s,r=[["path",{d:"M2 12s3-7 10-7 10 7 10 7-3 7-10 7-10-7-10-7Z",key:"rwhkz3"}],["circle",{cx:"12",cy:"12",r:"3",key:"1v7zrd"}]],l=e=>o(a,y(e,{name:"Eye",iconNode:r})),m=l,v=[["path",{d:"M15 21v-8a1 1 0 0 0-1-1h-4a1 1 0 0 0-1 1v8",key:"5wwlr5"}],["path",{d:"M3 10a2 2 0 0 1 .709-1.528l7-5.999a2 2 0 0 1 2.582 0l7 5.999A2 2 0 0 1 21 10v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z",key:"1d0kgt"}]],M=e=>o(a,y(e,{name:"House",iconNode:v})),w=M,N=[["path",{d:"M21 12a9 9 0 1 1-9-9c2.52 0 4.93 1 6.74 2.74L21 8",key:"1p45f6"}],["path",{d:"M21 3v5h-5",key:"1q7to0"}]],g=e=>o(a,y(e,{name:"RotateCw",iconNode:N})),f=g;export{t as a,h as c,c as d,m as e,w as h,f as r};

package/dist/schemas/form.schema.json

@@ -11,7 +11,27 @@
     "description": { "type": "string" },
     "required": { "type": "array", "items": { "type": "string" } },
     "properties": {
-      "type": "object"
+      "type": "object",
+      "description": "The fields to collect, keyed by property name. Each value is a JSON Schema field definition (type, title, description, enum, minimum/maximum, minLength/maxLength, pattern, items) plus optional x-kai-* UI hints. Only the display-format hints are spelled out below; the rest of a field definition is ordinary JSON Schema.",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "x-kai-format": {
+            "description": "Display format for a string field. `tel`, `ssn` and `credit-card` apply that type's standard mask and submit digits only; `custom` masks with `x-kai-mask` and submits the formatted value. Omit it for a plain text field.",
+            "enum": ["tel", "ssn", "credit-card", "custom"]
+          },
+          "x-kai-mask": {
+            "description": "The mask pattern, used only with `x-kai-format: \"custom\"`: `#` one digit, `@` one letter or digit, `*` one letter or digit that may be obscured; every other character is a literal shown as typed, e.g. `CHG-####`.",
+            "type": "string",
+            "maxLength": 64
+          },
+          "x-kai-mask-guide": {
+            "description": "Placeholder text shown at the unfilled positions of the mask, aligned character for character with the pattern (`mm/dd/yyyy` for `##/##/####`). Derived from the pattern when omitted.",
+            "type": "string",
+            "maxLength": 64
+          }
+        }
+      }
     },
     "x-kai-order": { "type": "array", "items": { "type": "string" } },
     "x-kai-inlineMax": { "type": "integer", "minimum": 1 },

package/dist/schemas/index.d.ts

@@ -37,7 +37,7 @@ export type { EmbedCardData, EmbedCardEnvelope, EmbedProvider } from '../primiti
 export type { LinkPreviewData, LinkPreviewEnvelope } from '../primitives/link-preview.js';
 export { cardFromToolCall, isCardTool, cardTypeFromToolName, toolNameForCardType, KAI_TOOL_PREFIX } from './from-tool-call.js';
 export { CARD_TOOL_DESCRIPTIONS, UnsupportedCardToolSchemaError, cardTools, toAnthropicTools, toJsonSchemaTools, toOpenAITools, } from './tool-defs.js';
-export type { AnthropicToolDef, CardToolInput, CardToolOptions, CardToolSource, JsonSchemaToolDef, OpenAIToolDef, ToolDef, ToolDefFor, ToolParameters, ToolProvider, UnsupportedCardTool, } from './tool-defs.js';
+export type { AnthropicToolDef, CardRequireRule, CardToolInput, CardToolOptions, CardToolSource, JsonSchemaToolDef, OpenAIToolDef, ToolDef, ToolDefFor, ToolParameters, ToolProvider, UnsupportedCardTool, } from './tool-defs.js';
 export { createCardRegistry } from './registry.js';
 export type { CardRegistry, CardRegistrySpec, CustomCardSpec, IncompletePolicy } from './registry.js';
 export { cardValidationMessage, validateCardData } from '../primitives/card-validate-cards.js';

package/dist/schemas/tool-defs.d.ts

@@ -45,6 +45,51 @@ export interface CardToolOptions<P extends ToolProvider = ToolProvider> {
      * When it throws it names the card, the path and the keyword.
      */
     readonly strict?: boolean;
+    /**
+     * Narrow the DERIVED tool schema per card type, after projection.
+     *
+     * A card's authored schema is deliberately permissive — `files` is optional on an
+     * artifact, its items need only a `path` — because the card CONTRACT must accept
+     * what a host may legitimately render. A model filling the tool in, though, is
+     * often better served by a tighter tool: requiring `code` on every file, or at
+     * least one file at all, moves a class of failures from render time (a card the
+     * registry rejects) to generation time (the model literally cannot emit one).
+     *
+     * This narrows the WIRE projection only — the authored schema and
+     * `registry.validate()` are untouched, so a hand-built envelope still validates.
+     * Applied for every provider, `jsonschema` included, and merged loudly: an
+     * unknown path or a required name the node has no property for is a TypeError
+     * naming the card, the path and the field, because a tool that can never be
+     * satisfied must not ship quietly.
+     *
+     * IT CANNOT REACH A FORM CARD'S FIELDS, and that is a known limitation rather
+     * than an oversight. The form
+     * card's payload IS a JSON Schema, so `form.schema.json` describes `properties`
+     * as a map of field definitions and there is no node at `properties.ticketId`
+     * for a rule to land on — `require: { form: [{ path: 'properties.ticketId' }] }`
+     * raises the TypeError above, correctly. So an app cannot pin
+     * `x-kai-format: 'custom'` onto one field of a form the model authors. The
+     * enum on that hint is what makes a small model pick a valid token; an app that
+     * needs a guarantee checks the envelope when it arrives.
+     */
+    readonly require?: Readonly<Record<string, readonly CardRequireRule[]>>;
+}
+/**
+ * One narrowing instruction for one node of one card's projected schema.
+ *
+ * `path` is a dot-path from the envelope-data root through `properties` keys
+ * (`''` names the root node itself). On an ARRAY node, `required` narrows
+ * `items.required` and `minItems` lands on the array; on an object node,
+ * `required` lands on the node's own `required`. Existing requirements merge,
+ * never replace.
+ */
+export interface CardRequireRule {
+    /** Dot-path from the envelope-data root to a schema node, e.g. 'files'. */
+    readonly path: string;
+    /** Property names to require. On an ARRAY node this narrows `items.required`; on an object node, the node's own `required`. */
+    readonly required?: readonly string[];
+    /** Sets `minItems` (array nodes only). */
+    readonly minItems?: number;
 }
 /**
  * Where the card types come from.