@gruum/cli 0.1.6 → 0.1.7

package/gruum.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import{chmodSync as kc,existsSync as Ee,rmSync as Pn}from"node:fs";import V from"node:path";import{createInterface as On}from"node:readline";var $o=new Set(["display","position","inset","top","right","bottom","left","z-index","order","flex","flex-grow","flex-shrink","flex-basis","align-self","justify-self","align-items","justify-content","place-items","place-content","gap","text-align","min-width","max-width","overflow","white-space","cursor"]),Co=new Set(["page","index","layout","route","default"]);function So(t){return $o.has(t.property)||/^(margin|transition|grid-)/.test(t.property)?!0:(t.property==="width"||t.property==="height")&&/^(100%|auto)$/.test(t.value)}function Dt(t){return t.flatMap(e=>e.declarations.filter(n=>!So(n)).map(n=>`${e.state}|${e.context}|${n.property}:${n.value}`)).sort().join(";")}function Ro(t){return Dt(t.states)}function Ao(t){return t.states.filter(e=>e.state==="default"&&e.context==="").flatMap(e=>e.declarations)}function Vn(t){return t.charAt(0).toUpperCase()+t.slice(1)}function _o(t){let e=t.via?/^bg-([\w-]+?)(?:\/(\d+))?$/.exec(t.via):null;if(e){let s=e[1].replace(/-/g," ");return Vn(e[2]?`${s} ${e[2]}%`:s)}let n=/var\(\s*--(?:color-)?([\w-]+)/.exec(t.value)?.[1];return Vn((n??t.value).replace(/-/g," "))}function Eo(t){let e=Ao(t),n=u=>e.findLast(f=>f.property===u),s=n("background-color")??n("background"),r=s!==void 0&&!/^(transparent|none|initial|inherit)\b/.test(s.value),o=n("border-width")?.value,i=o!==void 0&&!/^0(px)?$/.test(o)&&n("border-style")?.value!=="none",a=n("width")?.value,l=a!==void 0&&a===n("height")?.value&&!/^(auto|100%|fit-content)$/.test(a);return n("inset")?.value==="0"?"Overlay":i?l?"Outline icon":"Outline":r?`${_o(s)} ${l?"icon":"fill"}`:l?"Icon":e.some(u=>u.property.startsWith("padding")||u.property==="border-radius"||u.property==="height"&&u.value!=="auto")?"Ghost":"Text"}function jo(t){let e=t.split("/"),n=(e.pop()??t).replace(/\.[^.]+$/,""),s=e.pop();return Co.has(n)&&s?`${s}/${n}`:n}function Io(t){let e=[...new Set(t.map(s=>jo(s.path)))],n=e.slice(0,2).join(", ");return e.length>2?`${n} +${e.length-2}`:n}var Bn=(t,e)=>t.path.localeCompare(e.path)||t.line-e.line;function Fn(t){let e=new Map;for(let r of t){let o=Eo(r.variant),i=e.get(o)??new Map,a=Ro(r.variant),l=i.get(a)??{looks:[],sites:[]};l.looks.push(r.variant),l.sites.push(...r.sites),i.set(a,l),e.set(o,i)}let n=[],s=new Map;for(let[r,o]of e){let i=[...o.values()];for(let b of i)b.sites.sort(Bn);i.sort((b,k)=>k.sites.length-b.sites.length||Bn(b.sites[0],k.sites[0]));let[a,...l]=i,c=a.looks[0],u=l.map(b=>Io(b.sites)),f=l.map((b,k)=>{let w=b.looks[0],g={title:u.filter(p=>p===u[k]).length>1?`${u[k]} \xB7 line ${b.sites[0].line}`:u[k],selector:w.selector,path:b.sites[0].path,line:b.sites[0].line,element:w.element,usage:w.usage,states:w.states,alike:!0};return s.set(g,b.sites),g}),m={...c,title:r,axis:null,base:!1,path:a.sites[0].path,line:a.sites[0].line,markup:!0,...f.length?{modifiers:f}:{}};s.set(m,a.sites),n.push(m)}return{variants:n,sites:s}}var Wn=1,Gn=["style.new","state.changed","state.missing","token.unknown","value.hardcoded","native.element","prop.unknown","style.removed","guidance.rule"],Oe={"style.new":"block","state.changed":"block","state.missing":"block","token.unknown":"block","value.hardcoded":"block","native.element":"block","prop.unknown":"block","style.removed":"warn","guidance.rule":"warn"};function De(t){let e=0;for(let n=0;n<t.length;n++)e=e*33+t.charCodeAt(n)>>>0;return e.toString(36)}function zn(t){let e=`${t.path}::${t.selector}`;return`v2-style-${e.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"").slice(0,48)}-${De(e)}`}function ot(t){return t.context?`${t.state} @ ${t.context}`:t.state}var Mo=/var\(\s*(--[\w-]+)/g;function Lo(t){let e=new Set;for(let n of t)for(let s of n.declarations)for(let r of s.value.matchAll(Mo))e.add(r[1]);return[...e].sort()}function Po(t){let e=new Map;for(let n of t)e.set(n.property,n.value.trim());return[...e].map(([n,s])=>({property:n,value:s})).sort((n,s)=>n.property.localeCompare(s.property))}function Oo(t){let e=new Map;for(let n of t){let s=ot(n),r=e.get(s),o=Po([...r?.declarations??[],...n.declarations]);e.set(s,{state:n.state,context:n.context,declarations:o})}return[...e.values()]}function Hn(t){let e=new Map,n=(s,r,o)=>{let i=zn(s),a=e.get(i),l=Oo([...a?Do(a.states):[],...r]),c=a?.stateLines??new Map;for(let u of r)c.has(ot(u))||c.set(ot(u),u.line);e.set(i,{...a??s,id:i,states:l,tokens:Lo(l),line:a?.line??o,stateLines:c})};for(let s of t){let r=zn(s);n({kind:"look",title:s.title,selector:s.selector,path:s.path,axis:s.axis,...s.usage.via?{selectedBy:s.usage.via}:{},...s.element?{element:s.element.tag}:{},...s.markup?{markup:!0}:{}},s.states,s.line);for(let o of s.modifiers??[])n({kind:"modifier",title:`${s.title} \xB7 ${o.title}`,selector:o.selector,path:o.path,hostId:r,...o.usage.via?{selectedBy:o.usage.via}:{},...o.element?{element:o.element.tag}:{},...o.alike?{markup:!0}:{}},o.states,o.line);for(let o of s.contexts??[])n({kind:"context",title:`${s.title} in ${o.selector}`,selector:o.selector,path:o.path,hostId:r,role:o.role,...o.element?{element:o.element.tag}:{}},o.states,o.line)}return e}function Do(t){return t.map(e=>({state:e.state,context:e.context,line:0,declarations:e.declarations}))}function To(t){let e=new Map,n=/^:root\{([^}]*)\}/.exec(t);if(!n)return e;for(let s of n[1].split(";")){let r=s.indexOf(":");if(r<=0)continue;let o=s.slice(0,r).trim();o.startsWith("--")&&e.set(o,s.slice(r+1).trim())}return e}var Un=/^(\d+) native /;function No(t,e){if(t==="native")return`native:${e.refs[0]?.path??""}`;if(e.styles?.length){let n=[...new Set(e.refs.map(s=>s.path))].sort().join(",");return`${t}:${[...e.styles].sort().join(",")}:${n}`}return`${t}:${e.refs.map(n=>n.path).join(",")}:${e.message}`}var Xt={hardcoded:"value.hardcoded",native:"native.element",props:"prop.unknown"},Vo=new Set(Object.values(Xt));var Bo={"value.hardcoded":()=>"Replace each literal with the spec token named, or with a spec token for that property.","native.element":t=>`Render ${t.components[0]??"the shared component"} instead of a raw <button>, or ask for an exception.`,"prop.unknown":()=>"Use one of the values listed, or ask for an exception to add the look."};function Kn(t){let e=[];for(let n of t.audit)if(n.status==="attention")for(let s of n.findings)e.push({check:n.id,finding:s,key:No(n.id,s)});return e}function Me(t){return`${t.path}#${De(t.text.replace(/\s+/g," ").trim())}`}function Jn(t,e={}){let n=To(t.previewCss),s=[...Hn(t.variants).values()].map(({line:o,stateLines:i,...a})=>a),r=[];for(let o of t.guidance.files)if(o.kind!=="record")for(let i of o.passages)i.rule&&r.push({path:i.path,headings:i.headings,text:i.text,styles:i.styles});return{schema:Wn,concept:t.concept,label:t.label,version:e.version??0,sourceRef:t.repo.ref,publishedAt:e.publishedAt??null,components:[...t.components].sort(),tokens:t.tokens.map(o=>{let i=n.get(o.name);return i===void 0?{name:o.name}:{name:o.name,value:i}}).sort((o,i)=>o.name.localeCompare(i.name)),styles:s,rules:r,content:t.content.map(o=>o.id),acceptedFindings:Kn(t).filter(({check:o})=>o in Xt).map(({check:o,finding:i,key:a})=>({check:o,key:a,message:i.message})),settings:{severity:{...Oe,...e.settings?.severity??{}}}}}function Fo(t,e){let n=new Map(t.map(o=>[o.property,o.value])),s=new Map(e.map(o=>[o.property,o.value])),r=[];for(let[o,i]of s){let a=n.get(o);a===void 0?r.push(`added ${o}: ${i}`):a!==i&&r.push(`${o}: ${a} \u2192 ${i}`)}for(let[o,i]of n)s.has(o)||r.push(`removed ${o}: ${i}`);return r}function Pe(t){return t.map(e=>`${e.property}: ${e.value}`).join("; ")}function Le(t,e){return t.length>e?`${t.slice(0,e).join(", ")}, and ${t.length-e} more`:t.join(", ")}function zo(t,e){let n=t.replace(/^--/,"").split("-")[0]??"",s=n?e.filter(r=>r.startsWith(`--${n}`)):[];return(s.length?s:e).slice(0,3)}function Zn(t,e){let n={...Oe,...e.settings.severity},s=[],r=(p,d="")=>{s.push({id:`${p.kind}:${De(`${p.styleId??""}|${p.state??""}|${d}`)}`,severity:n[p.kind],...p})},o=Hn(t.variants),i=new Map(e.styles.map(p=>[p.id,p])),a=e.styles.filter(p=>p.kind==="look"),l=new Set(e.tokens.map(p=>p.name)),c=[...l],u=new Map;for(let p of e.styles)p.markup&&u.set(Dt(p.states),p);let f=new Map;for(let p of o.values()){if(!p.markup)continue;let d=u.get(Dt(p.states));d&&f.set(p.id,d)}let m=new Set([...f.values()].map(p=>p.id)),b=p=>p.markup?`${p.title} (as in ${p.path})`:p.selector;for(let p of o.values()){if(i.has(p.id)||f.has(p.id))continue;let d=p.hostId?i.get(p.hostId):void 0,y=p.markup?a.filter(j=>j.markup):a,v=y.filter(j=>j.path===p.path),x=(v.length?v:y).map(b),C=p.markup?`This one-off ${p.element??"button"} (${Le((p.states[0]?.declarations??[]).map(j=>`${j.property}: ${j.value}`),3)})`:p.selector,I=p.markup?e.components.length?`render ${e.components[0]} with a spec look,`:x.length?`copy ${Le(x,3)},`:"use a spec style,":d?`restyle ${d.selector} only through spec modifiers`:x.length?`use ${Le(x,3)},`:"use a spec style,";r({kind:"style.new",styleId:p.id,title:`${p.title} is not in the spec`,baseline:null,observed:{declarations:p.states[0]?.declarations??[],states:p.states,...p.markup?{markup:!0}:{}},refs:[{path:p.path,line:p.line}],fix:`${C} is not in the spec; ${I} or ask for an exception.`},p.markup?Dt(p.states):p.selector)}for(let p of o.values()){let d=i.get(p.id);if(!d)continue;let y=new Map(d.states.map(v=>[ot(v),v]));for(let v of p.states){let x=ot(v),C=y.get(x),I=Fo(C?.declarations??[],v.declarations);I.length!==0&&r({kind:"state.changed",styleId:p.id,title:C?`${p.title}: ${x} changed`:`${p.title}: new ${x} state`,state:x,baseline:C?{declarations:C.declarations}:null,observed:{declarations:v.declarations},refs:[{path:p.path,line:p.stateLines.get(x)??p.line}],fix:C?`Restore ${p.selector} ${x} to the spec (${I.slice(0,3).join("; ")}), or ask for an exception.`:`${x} is not a spec state of ${p.selector}; remove it, or ask for an exception.`},Pe(v.declarations))}}for(let p of o.values()){let d=i.get(p.id);if(!d)continue;let y=new Set(p.states.map(ot));for(let v of d.states){let x=ot(v);y.has(x)||r({kind:"state.missing",styleId:p.id,title:`${p.title}: ${x} state is missing`,state:x,baseline:{declarations:v.declarations},observed:null,refs:[{path:p.path,line:p.line}],fix:`Define ${p.selector} ${x} again: ${Pe(v.declarations)||"as in the spec"}.`})}}for(let p of o.values())for(let d of p.tokens){if(l.has(d))continue;let y=zo(d,c);r({kind:"token.unknown",styleId:p.id,title:`${p.title} reads ${d}, which is not a spec token`,baseline:null,observed:{token:d},refs:[{path:p.path,line:p.line}],fix:y.length?`Use a spec token such as ${y.join(", ")} instead of ${d}, or ask for an exception.`:`${d} is not a spec token; ask for an exception to add it.`},d)}let k=new Map;for(let p of e.acceptedFindings)k.set(p.key,[...k.get(p.key)??[],p]);let w=Kn(t).filter(({check:p})=>p in Xt);for(let p of Gn)if(Vo.has(p))for(let{check:d,finding:y,key:v}of w){if(Xt[d]!==p)continue;let x=k.get(v)??[];if(x.some(A=>!Uo(d,A.message,y.message)))continue;let C=x[0],I=y.styles?.[0],j=I?[...o.values()].find(A=>A.title===I):void 0;r({kind:p,styleId:j?.id??null,title:y.message,baseline:C?{message:C.message}:null,observed:{message:y.message,...p==="native.element"?{element:"button"}:{}},waiverKey:v,refs:y.refs.map(({path:A,line:R})=>({path:A,line:R})),fix:Bo[p](e)},v)}for(let p of e.styles)o.has(p.id)||m.has(p.id)||r({kind:"style.removed",styleId:p.id,title:p.markup?`${p.title} is in the spec but no longer written anywhere`:`${p.title} is in the spec but no longer in CSS`,baseline:{declarations:p.states[0]?.declarations??[]},observed:null,refs:[{path:p.path,line:0}],fix:p.markup?`Nothing renders ${p.title} any more; ask the designer to retire it from the spec if that is intended.`:`Restore ${p.selector} in ${p.path}, or ask the designer to retire it from the spec.`});let $=new Map(t.guidance.files.map(p=>[p.path,p])),g=new Set;for(let p of t.guidance.files)for(let d of p.passages)d.rule&&g.add(Me(d));for(let p of e.rules){if(g.has(Me(p)))continue;let d=$.get(p.path);d&&d.total>d.passages.length||r({kind:"guidance.rule",styleId:null,title:`A written rule in ${p.path} changed or was removed`,baseline:{text:p.text},observed:null,refs:[{path:p.path,line:0}],fix:`Restore the rule under ${p.headings.join(" \u203A ")||p.path}, or publish a new spec.`},Me(p))}return s}function Uo(t,e,n){if(e===n)return!1;if(t==="native"){let s=Un.exec(e)?.[1],r=Un.exec(n)?.[1];if(s&&r)return Number(r)>Number(s)}return!0}var Wo={product:"Gruum button spec",what:"The designer-published spec for this repository's buttons. Write buttons against it; drift from it is checked deterministically.",howToUse:["Use the components listed in `components`; do not render a raw <button> where a component exists.","Pick a look from `looks`. `selectedBy` says which prop or attribute value selects it.","Use only the tokens listed in `tokens`. Do not write a literal color or size a token already has.","Follow `rules`; they are the repository's written rules, quoted.","Do not add a look, modifier, or state, and do not change a state's declarations.","If the spec has no button for the job, ask for an exception with a reason instead of inventing one. Never edit generated Gruum files to make a check pass."]};function Te(t){let e=(n,s)=>t.styles.filter(r=>r.hostId===n&&r.kind===s).map(r=>r.selector);return{about:{...Wo,drift:Gn.map(n=>({kind:n,severity:t.settings.severity[n]??Oe[n]}))},spec:{concept:t.concept,version:t.version,sourceRef:t.sourceRef,components:t.components,looks:t.styles.filter(n=>n.kind==="look").map(n=>({title:n.title,selector:n.selector,path:n.path,...n.selectedBy?{selectedBy:n.selectedBy}:{},tokens:n.tokens,states:Object.fromEntries(n.states.map(s=>[ot(s),Pe(s.declarations)])),modifiers:e(n.id,"modifier"),contexts:e(n.id,"context")})),tokens:t.tokens,rules:t.rules.map(n=>({path:n.path,under:n.headings.join(" \u203A "),text:n.text}))}}}function qt(t){if(!t||typeof t!="object")return null;let e=t;return e.schema!==Wn||typeof e.concept!="string"||!Array.isArray(e.styles)||!Array.isArray(e.tokens)||!Array.isArray(e.acceptedFindings)||!Array.isArray(e.rules)||!e.settings?.severity?null:e}function Go(t){let e=new Map;for(let n of t){let s=n.refs[0]?.path??"(no file)";e.set(s,[...e.get(s)??[],n])}return[...e].sort(([n],[s])=>n.localeCompare(s))}function Ne(t,e){if(e.length===0)return t;let n=new Set(e.map(s=>s.replace(/^\.\//,"")));return t.filter(s=>s.refs.some(r=>n.has(r.path)))}function Xn(t,e,n={}){let s=[];if(t.length===0)return s.push(`No drift against spec v${e.baselineVersion} (${e.files} files indexed, ${e.skipped} skipped).`),s.join(`
+import{chmodSync as kc,existsSync as Ee,rmSync as Pn}from"node:fs";import V from"node:path";import{createInterface as On}from"node:readline";var $o=new Set(["display","position","inset","top","right","bottom","left","z-index","order","flex","flex-grow","flex-shrink","flex-basis","align-self","justify-self","align-items","justify-content","place-items","place-content","gap","text-align","min-width","max-width","overflow","white-space","cursor"]),Co=new Set(["page","index","layout","route","default"]);function So(t){return $o.has(t.property)||/^(margin|transition|grid-)/.test(t.property)?!0:(t.property==="width"||t.property==="height")&&/^(100%|auto)$/.test(t.value)}function Dt(t){return t.flatMap(e=>e.declarations.filter(n=>!So(n)).map(n=>`${e.state}|${e.context}|${n.property}:${n.value}`)).sort().join(";")}function Ro(t){return Dt(t.states)}function Ao(t){return t.states.filter(e=>e.state==="default"&&e.context==="").flatMap(e=>e.declarations)}function Vn(t){return t.charAt(0).toUpperCase()+t.slice(1)}function _o(t){let e=t.via?/^bg-([\w-]+?)(?:\/(\d+))?$/.exec(t.via):null;if(e){let s=e[1].replace(/-/g," ");return Vn(e[2]?`${s} ${e[2]}%`:s)}let n=/var\(\s*--(?:color-)?([\w-]+)/.exec(t.value)?.[1];return Vn((n??t.value).replace(/-/g," "))}function Eo(t){let e=Ao(t),n=u=>e.findLast(f=>f.property===u),s=n("background-color")??n("background"),r=s!==void 0&&!/^(transparent|none|initial|inherit)\b/.test(s.value),o=n("border-width")?.value,i=o!==void 0&&!/^0(px)?$/.test(o)&&n("border-style")?.value!=="none",a=n("width")?.value,l=a!==void 0&&a===n("height")?.value&&!/^(auto|100%|fit-content)$/.test(a);return n("inset")?.value==="0"?"Overlay":i?l?"Outline icon":"Outline":r?`${_o(s)} ${l?"icon":"fill"}`:l?"Icon":e.some(u=>u.property.startsWith("padding")||u.property==="border-radius"||u.property==="height"&&u.value!=="auto")?"Ghost":"Text"}function jo(t){let e=t.split("/"),n=(e.pop()??t).replace(/\.[^.]+$/,""),s=e.pop();return Co.has(n)&&s?`${s}/${n}`:n}function Io(t){let e=[...new Set(t.map(s=>jo(s.path)))],n=e.slice(0,2).join(", ");return e.length>2?`${n} +${e.length-2}`:n}var Bn=(t,e)=>t.path.localeCompare(e.path)||t.line-e.line;function Fn(t){let e=new Map;for(let r of t){let o=Eo(r.variant),i=e.get(o)??new Map,a=Ro(r.variant),l=i.get(a)??{looks:[],sites:[]};l.looks.push(r.variant),l.sites.push(...r.sites),i.set(a,l),e.set(o,i)}let n=[],s=new Map;for(let[r,o]of e){let i=[...o.values()];for(let b of i)b.sites.sort(Bn);i.sort((b,k)=>k.sites.length-b.sites.length||Bn(b.sites[0],k.sites[0]));let[a,...l]=i,c=a.looks[0],u=l.map(b=>Io(b.sites)),f=l.map((b,k)=>{let w=b.looks[0],g={title:u.filter(p=>p===u[k]).length>1?`${u[k]} \xB7 line ${b.sites[0].line}`:u[k],selector:w.selector,path:b.sites[0].path,line:b.sites[0].line,element:w.element,usage:w.usage,states:w.states,alike:!0};return s.set(g,b.sites),g}),m={...c,title:r,axis:null,base:!1,path:a.sites[0].path,line:a.sites[0].line,markup:!0,...f.length?{modifiers:f}:{}};s.set(m,a.sites),n.push(m)}return{variants:n,sites:s}}var Wn=1,Gn=["style.new","state.changed","state.missing","token.unknown","value.hardcoded","native.element","prop.unknown","style.removed","guidance.rule"],Oe={"style.new":"block","state.changed":"block","state.missing":"block","token.unknown":"block","value.hardcoded":"block","native.element":"block","prop.unknown":"block","style.removed":"warn","guidance.rule":"warn"};function De(t){let e=0;for(let n=0;n<t.length;n++)e=e*33+t.charCodeAt(n)>>>0;return e.toString(36)}function zn(t){let e=`${t.path}::${t.selector}`;return`v2-style-${e.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"").slice(0,48)}-${De(e)}`}function ot(t){return t.context?`${t.state} @ ${t.context}`:t.state}var Mo=/var\(\s*(--[\w-]+)/g;function Lo(t){let e=new Set;for(let n of t)for(let s of n.declarations)for(let r of s.value.matchAll(Mo))e.add(r[1]);return[...e].sort()}function Po(t){let e=new Map;for(let n of t)e.set(n.property,n.value.trim());return[...e].map(([n,s])=>({property:n,value:s})).sort((n,s)=>n.property.localeCompare(s.property))}function Oo(t){let e=new Map;for(let n of t){let s=ot(n),r=e.get(s),o=Po([...r?.declarations??[],...n.declarations]);e.set(s,{state:n.state,context:n.context,declarations:o})}return[...e.values()]}function Hn(t){let e=new Map,n=(s,r,o)=>{let i=zn(s),a=e.get(i),l=Oo([...a?Do(a.states):[],...r]),c=a?.stateLines??new Map;for(let u of r)c.has(ot(u))||c.set(ot(u),u.line);e.set(i,{...a??s,id:i,states:l,tokens:Lo(l),line:a?.line??o,stateLines:c})};for(let s of t){let r=zn(s);n({kind:"look",title:s.title,selector:s.selector,path:s.path,axis:s.axis,...s.usage.via?{selectedBy:s.usage.via}:{},...s.element?{element:s.element.tag}:{},...s.markup?{markup:!0}:{}},s.states,s.line);for(let o of s.modifiers??[])n({kind:"modifier",title:`${s.title} \xB7 ${o.title}`,selector:o.selector,path:o.path,hostId:r,...o.usage.via?{selectedBy:o.usage.via}:{},...o.element?{element:o.element.tag}:{},...o.alike?{markup:!0}:{}},o.states,o.line);for(let o of s.contexts??[])n({kind:"context",title:`${s.title} in ${o.selector}`,selector:o.selector,path:o.path,hostId:r,role:o.role,...o.element?{element:o.element.tag}:{}},o.states,o.line)}return e}function Do(t){return t.map(e=>({state:e.state,context:e.context,line:0,declarations:e.declarations}))}function To(t){let e=new Map,n=/^:root\{([^}]*)\}/.exec(t);if(!n)return e;for(let s of n[1].split(";")){let r=s.indexOf(":");if(r<=0)continue;let o=s.slice(0,r).trim();o.startsWith("--")&&e.set(o,s.slice(r+1).trim())}return e}var Un=/^(\d+) native /;function No(t,e){if(t==="native")return`native:${e.refs[0]?.path??""}`;if(e.styles?.length){let n=[...new Set(e.refs.map(s=>s.path))].sort().join(",");return`${t}:${[...e.styles].sort().join(",")}:${n}`}return`${t}:${e.refs.map(n=>n.path).join(",")}:${e.message}`}var Xt={hardcoded:"value.hardcoded",native:"native.element",props:"prop.unknown"},Vo=new Set(Object.values(Xt));var Bo={"value.hardcoded":()=>"Replace each literal with the spec token named, or with a spec token for that property.","native.element":t=>`Render ${t.components[0]??"the shared component"} instead of a raw <button>, or ask for an exception.`,"prop.unknown":()=>"Use one of the values listed, or ask for an exception to add the look."};function Kn(t){let e=[];for(let n of t.audit)if(n.status==="attention")for(let s of n.findings)e.push({check:n.id,finding:s,key:No(n.id,s)});return e}function Me(t){return`${t.path}#${De(t.text.replace(/\s+/g," ").trim())}`}function Jn(t,e={}){let n=To(t.previewCss),s=[...Hn(t.variants).values()].map(({line:i,stateLines:a,...l})=>l),r=new Set(t.tokens.map(i=>i.name)),o=[];for(let i of t.guidance.files)if(i.kind!=="record")for(let a of i.passages)a.rule&&o.push({path:a.path,headings:a.headings,text:a.text,styles:a.styles});return{schema:Wn,concept:t.concept,label:t.label,version:e.version??0,sourceRef:t.repo.ref,publishedAt:e.publishedAt??null,components:[...t.components].sort(),tokens:[...new Set([...t.tokens.map(i=>i.name),...s.flatMap(i=>i.tokens).filter(i=>!r.has(i))])].map(i=>{let a=n.get(i);return a===void 0?{name:i}:{name:i,value:a}}).sort((i,a)=>i.name.localeCompare(a.name)),styles:s,rules:o,content:t.content.map(i=>i.id),acceptedFindings:Kn(t).filter(({check:i})=>i in Xt).map(({check:i,finding:a,key:l})=>({check:i,key:l,message:a.message})),settings:{severity:{...Oe,...e.settings?.severity??{}}}}}function Fo(t,e){let n=new Map(t.map(o=>[o.property,o.value])),s=new Map(e.map(o=>[o.property,o.value])),r=[];for(let[o,i]of s){let a=n.get(o);a===void 0?r.push(`added ${o}: ${i}`):a!==i&&r.push(`${o}: ${a} \u2192 ${i}`)}for(let[o,i]of n)s.has(o)||r.push(`removed ${o}: ${i}`);return r}function Pe(t){return t.map(e=>`${e.property}: ${e.value}`).join("; ")}function Le(t,e){return t.length>e?`${t.slice(0,e).join(", ")}, and ${t.length-e} more`:t.join(", ")}function zo(t,e){let n=t.replace(/^--/,"").split("-")[0]??"",s=n?e.filter(r=>r.startsWith(`--${n}`)):[];return(s.length?s:e).slice(0,3)}function Zn(t,e){let n={...Oe,...e.settings.severity},s=[],r=(p,d="")=>{s.push({id:`${p.kind}:${De(`${p.styleId??""}|${p.state??""}|${d}`)}`,severity:n[p.kind],...p})},o=Hn(t.variants),i=new Map(e.styles.map(p=>[p.id,p])),a=e.styles.filter(p=>p.kind==="look"),l=new Set([...e.tokens.map(p=>p.name),...e.styles.flatMap(p=>p.tokens)]),c=[...l],u=new Map;for(let p of e.styles)p.markup&&u.set(Dt(p.states),p);let f=new Map;for(let p of o.values()){if(!p.markup)continue;let d=u.get(Dt(p.states));d&&f.set(p.id,d)}let m=new Set([...f.values()].map(p=>p.id)),b=p=>p.markup?`${p.title} (as in ${p.path})`:p.selector;for(let p of o.values()){if(i.has(p.id)||f.has(p.id))continue;let d=p.hostId?i.get(p.hostId):void 0,y=p.markup?a.filter(j=>j.markup):a,v=y.filter(j=>j.path===p.path),x=(v.length?v:y).map(b),C=p.markup?`This one-off ${p.element??"button"} (${Le((p.states[0]?.declarations??[]).map(j=>`${j.property}: ${j.value}`),3)})`:p.selector,I=p.markup?e.components.length?`render ${e.components[0]} with a spec look,`:x.length?`copy ${Le(x,3)},`:"use a spec style,":d?`restyle ${d.selector} only through spec modifiers`:x.length?`use ${Le(x,3)},`:"use a spec style,";r({kind:"style.new",styleId:p.id,title:`${p.title} is not in the spec`,baseline:null,observed:{declarations:p.states[0]?.declarations??[],states:p.states,...p.markup?{markup:!0}:{}},refs:[{path:p.path,line:p.line}],fix:`${C} is not in the spec; ${I} or ask for an exception.`},p.markup?Dt(p.states):p.selector)}for(let p of o.values()){let d=i.get(p.id);if(!d)continue;let y=new Map(d.states.map(v=>[ot(v),v]));for(let v of p.states){let x=ot(v),C=y.get(x),I=Fo(C?.declarations??[],v.declarations);I.length!==0&&r({kind:"state.changed",styleId:p.id,title:C?`${p.title}: ${x} changed`:`${p.title}: new ${x} state`,state:x,baseline:C?{declarations:C.declarations}:null,observed:{declarations:v.declarations},refs:[{path:p.path,line:p.stateLines.get(x)??p.line}],fix:C?`Restore ${p.selector} ${x} to the spec (${I.slice(0,3).join("; ")}), or ask for an exception.`:`${x} is not a spec state of ${p.selector}; remove it, or ask for an exception.`},Pe(v.declarations))}}for(let p of o.values()){let d=i.get(p.id);if(!d)continue;let y=new Set(p.states.map(ot));for(let v of d.states){let x=ot(v);y.has(x)||r({kind:"state.missing",styleId:p.id,title:`${p.title}: ${x} state is missing`,state:x,baseline:{declarations:v.declarations},observed:null,refs:[{path:p.path,line:p.line}],fix:`Define ${p.selector} ${x} again: ${Pe(v.declarations)||"as in the spec"}.`})}}for(let p of o.values())for(let d of p.tokens){if(l.has(d))continue;let y=zo(d,c);r({kind:"token.unknown",styleId:p.id,title:`${p.title} reads ${d}, which is not a spec token`,baseline:null,observed:{token:d},refs:[{path:p.path,line:p.line}],fix:y.length?`Use a spec token such as ${y.join(", ")} instead of ${d}, or ask for an exception.`:`${d} is not a spec token; ask for an exception to add it.`},d)}let k=new Map;for(let p of e.acceptedFindings)k.set(p.key,[...k.get(p.key)??[],p]);let w=Kn(t).filter(({check:p})=>p in Xt);for(let p of Gn)if(Vo.has(p))for(let{check:d,finding:y,key:v}of w){if(Xt[d]!==p)continue;let x=k.get(v)??[];if(x.some(A=>!Uo(d,A.message,y.message)))continue;let C=x[0],I=y.styles?.[0],j=I?[...o.values()].find(A=>A.title===I):void 0;r({kind:p,styleId:j?.id??null,title:y.message,baseline:C?{message:C.message}:null,observed:{message:y.message,...p==="native.element"?{element:"button"}:{}},waiverKey:v,refs:y.refs.map(({path:A,line:R})=>({path:A,line:R})),fix:Bo[p](e)},v)}for(let p of e.styles)o.has(p.id)||m.has(p.id)||r({kind:"style.removed",styleId:p.id,title:p.markup?`${p.title} is in the spec but no longer written anywhere`:`${p.title} is in the spec but no longer in CSS`,baseline:{declarations:p.states[0]?.declarations??[]},observed:null,refs:[{path:p.path,line:0}],fix:p.markup?`Nothing renders ${p.title} any more; ask the designer to retire it from the spec if that is intended.`:`Restore ${p.selector} in ${p.path}, or ask the designer to retire it from the spec.`});let $=new Map(t.guidance.files.map(p=>[p.path,p])),g=new Set;for(let p of t.guidance.files)for(let d of p.passages)d.rule&&g.add(Me(d));for(let p of e.rules){if(g.has(Me(p)))continue;let d=$.get(p.path);d&&d.total>d.passages.length||r({kind:"guidance.rule",styleId:null,title:`A written rule in ${p.path} changed or was removed`,baseline:{text:p.text},observed:null,refs:[{path:p.path,line:0}],fix:`Restore the rule under ${p.headings.join(" \u203A ")||p.path}, or publish a new spec.`},Me(p))}return s}function Uo(t,e,n){if(e===n)return!1;if(t==="native"){let s=Un.exec(e)?.[1],r=Un.exec(n)?.[1];if(s&&r)return Number(r)>Number(s)}return!0}var Wo={product:"Gruum button spec",what:"The designer-published spec for this repository's buttons. Write buttons against it; drift from it is checked deterministically.",howToUse:["Use the components listed in `components`; do not render a raw <button> where a component exists.","Pick a look from `looks`. `selectedBy` says which prop or attribute value selects it.","Use only the tokens listed in `tokens`. Do not write a literal color or size a token already has.","Follow `rules`; they are the repository's written rules, quoted.","Do not add a look, modifier, or state, and do not change a state's declarations.","If the spec has no button for the job, ask for an exception with a reason instead of inventing one. Never edit generated Gruum files to make a check pass."]};function Te(t){let e=(n,s)=>t.styles.filter(r=>r.hostId===n&&r.kind===s).map(r=>r.selector);return{about:{...Wo,drift:Gn.map(n=>({kind:n,severity:t.settings.severity[n]??Oe[n]}))},spec:{concept:t.concept,version:t.version,sourceRef:t.sourceRef,components:t.components,looks:t.styles.filter(n=>n.kind==="look").map(n=>({title:n.title,selector:n.selector,path:n.path,...n.selectedBy?{selectedBy:n.selectedBy}:{},tokens:n.tokens,states:Object.fromEntries(n.states.map(s=>[ot(s),Pe(s.declarations)])),modifiers:e(n.id,"modifier"),contexts:e(n.id,"context")})),tokens:t.tokens,rules:t.rules.map(n=>({path:n.path,under:n.headings.join(" \u203A "),text:n.text}))}}}function qt(t){if(!t||typeof t!="object")return null;let e=t;return e.schema!==Wn||typeof e.concept!="string"||!Array.isArray(e.styles)||!Array.isArray(e.tokens)||!Array.isArray(e.acceptedFindings)||!Array.isArray(e.rules)||!e.settings?.severity?null:e}function Go(t){let e=new Map;for(let n of t){let s=n.refs[0]?.path??"(no file)";e.set(s,[...e.get(s)??[],n])}return[...e].sort(([n],[s])=>n.localeCompare(s))}function Ne(t,e){if(e.length===0)return t;let n=new Set(e.map(s=>s.replace(/^\.\//,"")));return t.filter(s=>s.refs.some(r=>n.has(r.path)))}function Xn(t,e,n={}){let s=[];if(t.length===0)return s.push(`No drift against spec v${e.baselineVersion} (${e.files} files indexed, ${e.skipped} skipped).`),s.join(`
 `);for(let[o,i]of Go(t)){s.push(o);for(let a of i){let l=a.refs[0]?.line,c=n[a.id],u=c?`${a.severity}, exception ${c}`:a.severity;s.push(`  ${l?`${l}: `:""}[${u}] ${a.kind}  ${a.title}`),s.push(`      fix: ${a.fix}`)}s.push("")}let r=t.filter(o=>o.severity==="block").length;return s.push(`${t.length} drift item${t.length===1?"":"s"} against spec v${e.baselineVersion}: ${r} block, ${t.length-r} warn (${e.files} files indexed, ${e.skipped} skipped).`),s.join(`
 `)}function qn(t){return{schema:1,checkedAt:t,baselineVersion:null,items:[],followups:{}}}function Yn(t,e){if(!t||typeof t!="object")return qn(e);let n=t;return n.schema!==1||!Array.isArray(n.items)?qn(e):{schema:1,checkedAt:typeof n.checkedAt=="string"?n.checkedAt:e,baselineVersion:typeof n.baselineVersion=="number"?n.baselineVersion:null,items:n.items,followups:n.followups&&typeof n.followups=="object"?n.followups:{}}}function Tt(t,e={}){return t.filter(n=>{if(n.severity!=="block")return!1;let s=e[n.id];return s!=="pending"&&s!=="accepted"})}var Ct={exceptions:!1,denyGit:["commit","push"],maxFollowups:2},Ve=8;function Qn(t){let e=t.slice(0,Ve).map(n=>{let s=n.refs[0],r=s?` (${s.path}${s.line?`:${s.line}`:""})`:"";return`- ${n.title}${r}. ${n.fix}`});return t.length>Ve&&e.push(`- and ${t.length-Ve} more; run \`gruum check\`.`),e.join(`
 `)}function ts(t){return t.exceptions?"Fix each to the spec (call gruum_button_spec), or call gruum_request_exception with a reason when the spec has no button for the job.":"Fix each to the spec (call gruum_button_spec). If the spec has no button for the job, stop and tell the developer which exception you need; do not invent a style."}function es(t,e,n=Ct,s={}){let r=Tt(t.items,s),o=e.conversation_id??"",i=typeof e.loop_count=="number"?e.loop_count:t.followups[o]??0;return r.length===0||e.status==="aborted"?{output:{},ledger:t}:i>=n.maxFollowups?{output:{},ledger:t}:{output:{followup_message:`Gruum found ${r.length} button${r.length===1?"":"s"} that drift from the published spec:
@@ -77,7 +77,7 @@ ${k}
 `)}catch{process.stderr.write(`gruum: couldn't reach Gruum to report this check. The local result still stands.
 `)}}async function uo(t,e,n){let s=await Ln(t);if(!s)return{ok:!1,text:"Sign in with gruum login before requesting an exception."};let r=Ae(t.repoDir);if(!r)return{ok:!1,text:"This folder is not on a named git branch."};try{let o=await st(s.credentials,`/api/v2/cli/projects/${encodeURIComponent(s.project.id)}/drift`,{method:"POST",body:JSON.stringify({action:"request",concept:"button",branch:r,commit:ro(t.repoDir),reason:n,item:e})}),i=await o.json().catch(()=>({}));if(!o.ok)return{ok:!1,text:i.error||`Request failed (${o.status}).`};let a=i.reviewUrl?`${In(s.credentials)}${i.reviewUrl}`:"",l=i.created?`Exception request ${i.id} is pending review.`:`An exception for this change is already pending (${i.id}).`;return{ok:!0,text:a?`${l}
 ${a}`:l}}catch{return{ok:!1,text:"Couldn't reach Gruum to request an exception."}}}async function po(t,e){let n=await Ln(t);if(!n)return{ok:!1,text:"Sign in with gruum login to see exception status."};let s=Ae(t.repoDir);try{let r=await st(n.credentials,`/api/v2/cli/projects/${encodeURIComponent(n.project.id)}/drift?concept=button&branch=${encodeURIComponent(s)}`);if(!r.ok)return{ok:!1,text:`Couldn't load exceptions (${r.status}).`};let o=await r.json(),i=Array.isArray(o.requests)?o.requests:[],a=e?i.filter(l=>l.id===e):i;return a.length===0?{ok:!0,text:e?`No exception request ${e} on ${s||"this branch"}.`:`No exception requests on ${s||"this branch"}.`}:{ok:!0,text:a.map(l=>`${l.id}  ${l.status}  ${l.title}  (${l.branch})`).join(`
-`)}}catch{return{ok:!1,text:"Couldn't reach Gruum to read exception status."}}}var Ie="0.1.6",fo=`gruum ${Ie}: keep buttons on the Gruum spec
+`)}}catch{return{ok:!1,text:"Couldn't reach Gruum to read exception status."}}}var Ie="0.1.7",fo=`gruum ${Ie}: keep buttons on the Gruum spec
 
 Run it as \`npx @gruum/cli <command>\`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gruum/cli",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Keep buttons on the Gruum spec: a local drift check, Cursor hooks, and an MCP server.",
   "type": "module",
   "bin": {