@ktbsh/ui 0.2.0 → 0.3.0

package/dist/vanilla/theme-toggle.src.js

@@ -0,0 +1,242 @@
+
+import { render, html } from 'uhtml';
+
+const sheet = new CSSStyleSheet();
+sheet.replaceSync("\n\n    :host {\n      display: inline-block;\n      font-family: var(--kb-font-family-sans);\n    }\n    button {\n      box-sizing: border-box;\n      margin: 0;\n      min-height: 2.25rem;\n      padding: 0.45rem 0.8rem;\n      border: 1px solid var(--kb-color-border-default);\n      border-radius: var(--kb-radius-sm);\n      background: var(--kb-color-bg-subtle);\n      color: var(--kb-color-accent-default);\n      font: inherit;\n      font-size: var(--kb-font-size-sm);\n      font-weight: var(--kb-font-weight-medium);\n      line-height: 1;\n      letter-spacing: 0.08em;\n      text-transform: lowercase;\n      cursor: pointer;\n      transition:\n        color 0.2s ease,\n        background-color 0.2s ease,\n        border-color 0.2s ease;\n    }\n    button:hover {\n      color: var(--kb-color-fg-default);\n      background: var(--kb-color-bg-surface);\n      border-color: var(--kb-color-border-focus);\n    }\n    button:focus-visible {\n      outline: 2px solid var(--kb-color-border-focus);\n      outline-offset: 2px;\n      color: var(--kb-color-fg-default);\n      background: var(--kb-color-bg-surface);\n    }\n    /* Segmented group (set by kitbash-toggle-group) */\n    :host([data-group-pos=\"start\"]) button {\n      border-top-right-radius: 0;\n      border-bottom-right-radius: 0;\n      border-right-width: 0;\n    }\n    :host([data-group-pos=\"end\"]) button {\n      border-top-left-radius: 0;\n      border-bottom-left-radius: 0;\n    }\n    :host([data-group-pos=\"mid\"]) button {\n      border-radius: 0;\n      border-right-width: 0;\n    }\n    :host([data-group-pos]:hover),\n    :host([data-group-pos]:focus-within) {\n      position: relative;\n      z-index: 1;\n    }\n    @media (prefers-reduced-motion: reduce) {\n      button {\n        transition: none;\n      }\n    }\n  ");
+
+export class KitbashThemeToggle extends HTMLElement {
+  
+  static get observedAttributes() {
+    return ["value","storageKey"];
+  }
+  
+  static get propTypes() {
+    return {"value":"String","storageKey":"String"};
+  }
+
+
+  get value() {
+    return this._props['value'];
+  }
+  set value(val) {
+    // External / framework property writes: re-render, do not emit kitbash-change
+    // (caller already knows the value they set).
+    this._assignProp('value', val);
+    this.update();
+  }
+
+  get storageKey() {
+    return this._props['storageKey'];
+  }
+  set storageKey(val) {
+    // External / framework property writes: re-render, do not emit kitbash-change
+    // (caller already knows the value they set).
+    this._assignProp('storageKey', val);
+    this.update();
+  }
+
+
+  constructor() {
+    super();
+    this.attachShadow({ mode: 'open', delegatesFocus: true });
+    
+    this.shadowRoot.adoptedStyleSheets = [sheet];
+    
+    this._defaults = {"value":"","storageKey":"theme"};
+    
+    this._state = {};
+    this._props = { ...this._defaults };
+    this._eventHandlers = { 'click button': function(_e, { props, commit }) {
+      const next = (props.value === "light" || props.value === "dark" ? props.value : typeof document < "u" && document.documentElement.dataset.theme === "light" ? "light" : "dark") === "light" ? "dark" : "light";
+      if (typeof document < "u")
+        document.documentElement.dataset.theme = next;
+      const key = typeof props.storageKey === "string" ? props.storageKey : "theme";
+      if (key && typeof localStorage < "u")
+        try {
+          localStorage.setItem(key, next);
+        } catch {}
+      commit({ props: { value: next } });
+    } };
+    this._eventCleanup = [];
+    this._renderFn = function({ props, html }) {
+    let theme = props.value === "light" || props.value === "dark" ? props.value : "";
+    if (!theme && typeof document < "u")
+      theme = document.documentElement.dataset.theme === "light" ? "light" : "dark";
+    if (!theme)
+      theme = "dark";
+    const isLight = theme === "light";
+    return html`
+      <button
+        part="toggle-root"
+        type="button"
+        aria-pressed=${isLight ? "true" : "false"}
+        aria-label=${isLight ? "Switch to dark theme" : "Switch to light theme"}
+      >
+        ${isLight ? "theme=light" : "theme=night"}
+      </button>
+    `;
+  };
+    this._reflecting = false;
+  }
+
+  connectedCallback() {
+    // Initial attribute values are parsed by attributeChangedCallback before connectedCallback fires
+    this.update();
+    
+  }
+
+  disconnectedCallback() {
+    this.cleanupEvents();
+  }
+
+  attributeChangedCallback(name, oldValue, newValue) {
+    // Skip when we caused the attribute write ourselves (avoids double update)
+    if (this._reflecting) return;
+    if (oldValue === newValue) return;
+
+    const type = this.constructor.propTypes[name];
+    
+    let parsedValue = newValue;
+    if (newValue === null || newValue === undefined) {
+      parsedValue = this._defaults[name];
+    } else if (type === 'Number' && newValue !== '') {
+      // Match property coercion: empty string is not Number('') → 0
+      parsedValue = Number(newValue);
+    } else if (type === 'Boolean') {
+      parsedValue = newValue !== null && newValue !== 'false';
+    }
+    
+    this._props[name] = parsedValue;
+    
+    this.update();
+  }
+
+  /** Coerce + reflect a single prop; no re-render (caller decides). */
+  _assignProp(key, val) {
+    const type = this.constructor.propTypes[key];
+    let next = val;
+    if (type === 'Boolean') {
+      next = val === true || val === '';
+    } else if (type === 'Number' && val !== null && val !== undefined && val !== '') {
+      next = Number(val);
+    }
+    this._props[key] = next;
+
+    // Only reflect primitives — objects/arrays stay as properties (no [object Object] attrs)
+    const isPrimitive =
+      next === null ||
+      next === undefined ||
+      typeof next === 'string' ||
+      typeof next === 'number' ||
+      typeof next === 'boolean';
+
+    this._reflecting = true;
+    try {
+      if (type === 'Boolean') {
+        if (next) this.setAttribute(key, '');
+        else this.removeAttribute(key);
+      } else if (!isPrimitive) {
+        // property-only; drop stale attribute if any
+        this.removeAttribute(key);
+      } else if (next === null || next === undefined) {
+        this.removeAttribute(key);
+      } else {
+        this.setAttribute(key, String(next));
+      }
+    } finally {
+      this._reflecting = false;
+    }
+    
+  }
+
+  _emitChange() {
+    // Shallow-copy both bags so listeners cannot mutate internal state/props via event.detail
+    this.dispatchEvent(new CustomEvent('kitbash-change', {
+      detail: {
+        state: { ...this._state },
+        props: { ...this._props },
+      },
+      bubbles: true,
+      composed: true
+    }));
+  }
+
+  /**
+   * Batch props and/or state: one uhtml update, one kitbash-change.
+   * Prefer this in event handlers (e.g. controlled inputs).
+   */
+  commit(patch) {
+    const p = patch || {};
+    if (p.props) {
+      const allowed = this.constructor.propTypes || {};
+      for (const key of Object.keys(p.props)) {
+        // Only declared props — ignore typos / stray keys
+        if (!Object.prototype.hasOwnProperty.call(allowed, key)) continue;
+        this._assignProp(key, p.props[key]);
+      }
+    }
+    if (p.state) {
+      this._state = { ...this._state, ...p.state };
+    }
+    this.update();
+    this._emitChange();
+  }
+
+  setState(newState) {
+    this.commit({ state: newState });
+  }
+
+  setProps(nextProps) {
+    this.commit({ props: nextProps });
+  }
+
+  _handlerCtx() {
+    // Snapshots so handlers/render cannot mutate internal bags by accident
+    return {
+      props: { ...this._props },
+      state: { ...this._state },
+      setState: this.setState.bind(this),
+      setProps: this.setProps.bind(this),
+      commit: this.commit.bind(this),
+    };
+  }
+  
+  cleanupEvents() {
+    this._eventCleanup.forEach(cleanup => cleanup());
+    this._eventCleanup = [];
+  }
+
+  update() {
+    // Run the uhtml DOM diffing render cycle
+    render(this.shadowRoot, this._renderFn({ 
+      ...this._handlerCtx(),
+      html 
+    }));
+    this.cleanupEvents();
+    this.bindEvents();
+    
+  }
+
+
+
+  bindEvents() {
+    Object.keys(this._eventHandlers).forEach(eventSelector => {
+      const parts = eventSelector.split(' ');
+      const eventName = parts[0];
+      const selector = parts.slice(1).join(' ');
+      
+      const targets = selector ? this.shadowRoot.querySelectorAll(selector) : [this];
+      targets.forEach(target => {
+        const handler = (e) => {
+          this._eventHandlers[eventSelector](e, this._handlerCtx());
+        };
+        target.addEventListener(eventName, handler);
+        this._eventCleanup.push(() => target.removeEventListener(eventName, handler));
+      });
+    });
+  }
+}
+
+if (!customElements.get('kitbash-theme-toggle')) {
+  customElements.define('kitbash-theme-toggle', KitbashThemeToggle);
+}

package/dist/vanilla/toggle-group.d.ts

@@ -0,0 +1,2 @@
+/** Side-effect import — registers the custom element. */
+export {};

package/dist/vanilla/toggle-group.js

@@ -0,0 +1,19 @@
+var d=(_,U,B,Y,z)=>{let J=B.length,O=U.length,I=J,Q=0,$=0,X=null;while(Q<O||$<I)if(O===Q){let W=I<J?$?Y(B[$-1],-0).nextSibling:Y(B[I],0):z;while($<I)_.insertBefore(Y(B[$++],1),W)}else if(I===$)while(Q<O){if(!X||!X.has(U[Q]))_.removeChild(Y(U[Q],-1));Q++}else if(U[Q]===B[$])Q++,$++;else if(U[O-1]===B[I-1])O--,I--;else if(U[Q]===B[I-1]&&B[$]===U[O-1]){let W=Y(U[--O],-0).nextSibling;_.insertBefore(Y(B[$++],1),Y(U[Q++],-0).nextSibling),_.insertBefore(Y(B[--I],1),W),U[O]=B[I]}else{if(!X){X=new Map;let W=$;while(W<I)X.set(B[W],W++)}if(X.has(U[Q])){let W=X.get(U[Q]);if($<W&&W<I){let Z=Q,K=1;while(++Z<O&&Z<I&&X.get(U[Z])===W+K)K++;if(K>W-$){let M=Y(U[Q],0);while($<W)_.insertBefore(Y(B[$++],1),M)}else _.replaceChild(Y(B[$++],1),Y(U[Q++],-1))}else Q++}else _.removeChild(Y(U[Q++],-1))}return B};var{isArray:E}=Array,{getPrototypeOf:D1,getOwnPropertyDescriptor:M1}=Object;var m="http://www.w3.org/2000/svg",q=[],N=()=>document.createRange(),G=(_,U,B)=>{return _.set(U,B),B},i=(_,U)=>{let B;do B=M1(_,U);while(!B&&(_=D1(_)));return B},o=(_,U)=>U.reduceRight(G1,_),G1=(_,U)=>_.childNodes[U];var s=1;var r=8;var l=11;var{setPrototypeOf:T1}=Object,n=(_)=>{function U(B){return T1(B,new.target.prototype)}return U.prototype=_.prototype,U};var T,V=(_,U,B)=>{if(!T)T=N();if(B)T.setStartAfter(_);else T.setStartBefore(_);return T.setEndAfter(U),T.deleteContents(),_};var x=({firstChild:_,lastChild:U},B)=>V(_,U,B),t=!1,j=(_,U)=>t&&_.nodeType===l?1/U<0?U?x(_,!0):_.lastChild:U?_.valueOf():_.firstChild:_,a=(_)=>document.createComment(_);class w extends n(DocumentFragment){#U=a("<>");#B=a("</>");#_=q;constructor(_){super(_);this.replaceChildren(...[this.#U,..._.childNodes,this.#B]),t=!0}get firstChild(){return this.#U}get lastChild(){return this.#B}get parentNode(){return this.#U.parentNode}remove(){x(this,!1)}replaceWith(_){x(this,!0).replaceWith(_)}valueOf(){let{parentNode:_}=this;if(_===this){if(this.#_===q)this.#_=[...this.childNodes]}else{if(_){let{firstChild:U,lastChild:B}=this;this.#_=[U];while(U!==B)this.#_.push(U=U.nextSibling)}this.replaceChildren(...this.#_)}return this}}var e=(_,U,B)=>_.setAttribute(U,B),P=(_,U)=>_.removeAttribute(U),H1=(_,U)=>{for(let B in U){let Y=U[B],z=B==="role"?B:`aria-${B}`;if(Y==null)P(_,z);else e(_,z,Y)}return U},C,P1=(_,U,B)=>{if(B=B.slice(1),!C)C=new WeakMap;let Y=C.get(_)||G(C,_,{}),z=Y[B];if(z&&z[0])_.removeEventListener(B,...z);if(z=E(U)?U:[U,!1],Y[B]=z,z[0])_.addEventListener(B,...z);return U};var L=(_,U)=>{let{t:B,n:Y}=_,z=!1;switch(typeof U){case"object":if(U!==null){(Y||B).replaceWith(_.n=U.valueOf());break}case"undefined":z=!0;default:if(B.data=z?"":U,Y)_.n=null,Y.replaceWith(B);break}return U},F1=(_,U)=>f(_,U,U==null?"class":"className"),A1=(_,U)=>{let{dataset:B}=_;for(let Y in U)if(U[Y]==null)delete B[Y];else B[Y]=U[Y];return U},k=(_,U,B)=>_[B]=U,E1=(_,U,B)=>k(_,U,B.slice(1)),f=(_,U,B)=>U==null?(P(_,B),U):k(_,U,B),_1=(_,U)=>(typeof U==="function"?U(_):U.current=_,U),y=(_,U,B)=>(U==null?P(_,B):e(_,B,U),U),N1=(_,U)=>U==null?f(_,U,"style"):k(_.style,U,"cssText"),V1=(_,U,B)=>(_.toggleAttribute(B.slice(1),U),U),D=(_,U,B)=>{let{length:Y}=U;if(_.data=`[${Y}]`,Y)return d(_.parentNode,B,U,j,_);switch(B.length){case 1:B[0].remove();case 0:break;default:V(j(B[0],0),j(B.at(-1),-0),!1);break}return q},U1=new Map([["aria",H1],["class",F1],["data",A1],["ref",_1],["style",N1]]),B1=(_,U,B)=>{switch(U[0]){case".":return E1;case"?":return V1;case"@":return P1;default:return B||"ownerSVGElement"in _?U==="ref"?_1:y:U1.get(U)||(U in _?U.startsWith("on")?k:i(_,U)?.set?f:y:y)}},Y1=(_,U)=>(_.textContent=U==null?"":U,U);var H=(_,U,B)=>({a:_,b:U,c:B}),z1=(_,U)=>({b:_,c:U}),I1=(_,U,B,Y)=>({v:q,u:_,t:U,n:B,c:Y}),R=()=>H(null,null,q);var b=(_)=>(U,B)=>{let{a:Y,b:z,c:J}=_(U,B),O=document.importNode(Y,!0),I=q;if(z!==q){I=[];for(let Q,$,X=0;X<z.length;X++){let{a:W,b:Z,c:K}=z[X],M=W===$?Q:Q=o(O,$=W);I[X]=I1(Z,M,K,Z===D?[]:Z===L?R():null)}}return z1(J?O.firstChild:new w(O),I)};var J1=/^(?:plaintext|script|style|textarea|title|xmp)$/i,O1=/^(?:area|base|br|col|embed|hr|img|input|keygen|link|menuitem|meta|param|source|track|wbr)$/i;var j1=/<([a-zA-Z0-9]+[a-zA-Z0-9:._-]*)([^>]*?)(\/?)>/g,C1=/([^\s\\>"'=]+)\s*=\s*(['"]?)\x01/g,k1=/[\x01\x02]/g,Q1=(_,U,B)=>{let Y=0;return _.join("\x01").trim().replace(j1,(z,J,O,I)=>`<${J}${O.replace(C1,"\x02=$2$1").trimEnd()}${I?B||O1.test(J)?" /":`></${J}`:""}>`).replace(k1,(z)=>z==="\x01"?`<!--${U+Y++}-->`:U+Y++)};var S=document.createElement("template"),g,h,W1=(_,U)=>{if(U){if(!g)g=document.createElementNS(m,"svg"),h=N(),h.selectNodeContents(g);return h.createContextualFragment(_)}S.innerHTML=_;let{content:B}=S;return S=S.cloneNode(!1),B};var c=(_)=>{let U=[],B;while(B=_.parentNode)U.push(U.indexOf.call(B.childNodes,_)),_=B;return U},X1=()=>document.createTextNode(""),S1=(_,U,B)=>{let Y=W1(Q1(_,F,B),B),{length:z}=_,J=q;if(z>1){let Q=[],$=document.createTreeWalker(Y,129),X=0,W=`${F}${X++}`;J=[];while(X<z){let Z=$.nextNode();if(Z.nodeType===r){if(Z.data===W){let K=E(U[X-1])?D:L;if(K===L)Q.push(Z);J.push(H(c(Z),K,null)),W=`${F}${X++}`}}else{let K;while(Z.hasAttribute(W)){if(!K)K=c(Z);let M=Z.getAttribute(W);J.push(H(K,B1(Z,M,B),M)),P(Z,W),W=`${F}${X++}`}if(!B&&J1.test(Z.localName)&&Z.textContent.trim()===`<!--${W}-->`)J.push(H(K||c(Z),Y1,null)),W=`${F}${X++}`}}for(X=0;X<Q.length;X++)Q[X].replaceWith(X1())}let{childNodes:O}=Y,{length:I}=O;if(I<1)I=1,Y.appendChild(X1());else if(I===1&&z!==1&&O[0].nodeType!==s)I=0;return G($1,_,H(Y,J,I===1))},$1=new WeakMap,F="isµ",v=(_)=>(U,B)=>$1.get(U)||S1(U,B,_);var x1=b(v(!1)),w1=b(v(!0)),p=(_,{s:U,t:B,v:Y})=>{if(_.a!==B){let{b:z,c:J}=(U?w1:x1)(B,Y);_.a=B,_.b=z,_.c=J}for(let{c:z}=_,J=0;J<z.length;J++){let O=Y[J],I=z[J];switch(I.u){case D:I.v=D(I.t,y1(I.c,O),I.v);break;case L:let Q=O instanceof A?p(I.c||(I.c=R()),O):(I.c=null,O);if(Q!==I.v)I.v=L(I,Q);break;default:if(O!==I.v)I.v=I.u(I.t,O,I.n,I.v);break}}return _.b},y1=(_,U)=>{let B=0,{length:Y}=U;if(Y<_.length)_.splice(Y);for(;B<Y;B++){let z=U[B];if(z instanceof A)U[B]=p(_[B]||(_[B]=R()),z);else _[B]=null}return U};class A{constructor(_,U,B){this.s=_,this.t=U,this.v=B}toDOM(_=R()){return p(_,this)}}var Z1=new WeakMap,u=(_,U)=>{let B=Z1.get(_)||G(Z1,_,R()),{b:Y}=B;if(Y!==(typeof U==="function"?U():U).toDOM(B))_.replaceChildren(B.b.valueOf());return _};/*! (c) Andrea Giammarchi - MIT */var K1=(_)=>(U,...B)=>new A(_,U,B),q1=K1(!1),C_=K1(!0);var L1=new CSSStyleSheet;L1.replaceSync(`
+
+    :host {
+      display: inline-block;
+      font-family: var(--kb-font-family-sans);
+    }
+    [part='group-root'] {
+      display: inline-flex;
+      align-items: center;
+      flex-wrap: wrap;
+    }
+    slot {
+      display: contents;
+    }
+  `);class R1 extends HTMLElement{static get observedAttributes(){return[]}static get propTypes(){return{}}constructor(){super();this.attachShadow({mode:"open",delegatesFocus:!1}),this.shadowRoot.adoptedStyleSheets=[L1],this._defaults={},this._state={},this._props={...this._defaults},this._eventHandlers={"slotchange slot":function(_){let U=_.target.assignedElements({flatten:!0}).filter((Y)=>Y instanceof HTMLElement),B=U.length;U.forEach((Y,z)=>{if(B===1){Y.removeAttribute("data-group-pos");return}let J="mid";if(z===0)J="start";else if(z===B-1)J="end";Y.setAttribute("data-group-pos",J)})}},this._eventCleanup=[],this._renderFn=function({html:_}){return _`
+      <div part="group-root" role="group" aria-label="Display options">
+        <slot></slot>
+      </div>
+    `},this._reflecting=!1}connectedCallback(){this.update()}disconnectedCallback(){this.cleanupEvents()}attributeChangedCallback(_,U,B){if(this._reflecting)return;if(U===B)return;let Y=this.constructor.propTypes[_],z=B;if(B===null||B===void 0)z=this._defaults[_];else if(Y==="Number"&&B!=="")z=Number(B);else if(Y==="Boolean")z=B!==null&&B!=="false";this._props[_]=z,this.update()}_assignProp(_,U){let B=this.constructor.propTypes[_],Y=U;if(B==="Boolean")Y=U===!0||U==="";else if(B==="Number"&&U!==null&&U!==void 0&&U!=="")Y=Number(U);this._props[_]=Y;let z=Y===null||Y===void 0||typeof Y==="string"||typeof Y==="number"||typeof Y==="boolean";this._reflecting=!0;try{if(B==="Boolean")if(Y)this.setAttribute(_,"");else this.removeAttribute(_);else if(!z)this.removeAttribute(_);else if(Y===null||Y===void 0)this.removeAttribute(_);else this.setAttribute(_,String(Y))}finally{this._reflecting=!1}}_emitChange(){this.dispatchEvent(new CustomEvent("kitbash-change",{detail:{state:{...this._state},props:{...this._props}},bubbles:!0,composed:!0}))}commit(_){let U=_||{};if(U.props){let B=this.constructor.propTypes||{};for(let Y of Object.keys(U.props)){if(!Object.prototype.hasOwnProperty.call(B,Y))continue;this._assignProp(Y,U.props[Y])}}if(U.state)this._state={...this._state,...U.state};this.update(),this._emitChange()}setState(_){this.commit({state:_})}setProps(_){this.commit({props:_})}_handlerCtx(){return{props:{...this._props},state:{...this._state},setState:this.setState.bind(this),setProps:this.setProps.bind(this),commit:this.commit.bind(this)}}cleanupEvents(){this._eventCleanup.forEach((_)=>_()),this._eventCleanup=[]}update(){u(this.shadowRoot,this._renderFn({...this._handlerCtx(),html:q1})),this.cleanupEvents(),this.bindEvents()}bindEvents(){Object.keys(this._eventHandlers).forEach((_)=>{let U=_.split(" "),B=U[0],Y=U.slice(1).join(" ");(Y?this.shadowRoot.querySelectorAll(Y):[this]).forEach((J)=>{let O=(I)=>{this._eventHandlers[_](I,this._handlerCtx())};J.addEventListener(B,O),this._eventCleanup.push(()=>J.removeEventListener(B,O))})})}}if(!customElements.get("kitbash-toggle-group"))customElements.define("kitbash-toggle-group",R1);export{R1 as KitbashToggleGroup};

package/dist/vanilla/toggle-group.src.js

@@ -0,0 +1,215 @@
+
+import { render, html } from 'uhtml';
+
+const sheet = new CSSStyleSheet();
+sheet.replaceSync("\n\n    :host {\n      display: inline-block;\n      font-family: var(--kb-font-family-sans);\n    }\n    [part='group-root'] {\n      display: inline-flex;\n      align-items: center;\n      flex-wrap: wrap;\n    }\n    slot {\n      display: contents;\n    }\n  ");
+
+export class KitbashToggleGroup extends HTMLElement {
+  
+  static get observedAttributes() {
+    return [];
+  }
+  
+  static get propTypes() {
+    return {};
+  }
+
+
+
+  constructor() {
+    super();
+    this.attachShadow({ mode: 'open', delegatesFocus: false });
+    
+    this.shadowRoot.adoptedStyleSheets = [sheet];
+    
+    this._defaults = {};
+    
+    this._state = {};
+    this._props = { ...this._defaults };
+    this._eventHandlers = { 'slotchange slot': function(e) {
+      const els = e.target.assignedElements({ flatten: !0 }).filter((n) => n instanceof HTMLElement), n = els.length;
+      els.forEach((el, i) => {
+        if (n === 1) {
+          el.removeAttribute("data-group-pos");
+          return;
+        }
+        let pos = "mid";
+        if (i === 0)
+          pos = "start";
+        else if (i === n - 1)
+          pos = "end";
+        el.setAttribute("data-group-pos", pos);
+      });
+    } };
+    this._eventCleanup = [];
+    this._renderFn = function({ html }) {
+    return html`
+      <div part="group-root" role="group" aria-label="Display options">
+        <slot></slot>
+      </div>
+    `;
+  };
+    this._reflecting = false;
+  }
+
+  connectedCallback() {
+    // Initial attribute values are parsed by attributeChangedCallback before connectedCallback fires
+    this.update();
+    
+  }
+
+  disconnectedCallback() {
+    this.cleanupEvents();
+  }
+
+  attributeChangedCallback(name, oldValue, newValue) {
+    // Skip when we caused the attribute write ourselves (avoids double update)
+    if (this._reflecting) return;
+    if (oldValue === newValue) return;
+
+    const type = this.constructor.propTypes[name];
+    
+    let parsedValue = newValue;
+    if (newValue === null || newValue === undefined) {
+      parsedValue = this._defaults[name];
+    } else if (type === 'Number' && newValue !== '') {
+      // Match property coercion: empty string is not Number('') → 0
+      parsedValue = Number(newValue);
+    } else if (type === 'Boolean') {
+      parsedValue = newValue !== null && newValue !== 'false';
+    }
+    
+    this._props[name] = parsedValue;
+    
+    this.update();
+  }
+
+  /** Coerce + reflect a single prop; no re-render (caller decides). */
+  _assignProp(key, val) {
+    const type = this.constructor.propTypes[key];
+    let next = val;
+    if (type === 'Boolean') {
+      next = val === true || val === '';
+    } else if (type === 'Number' && val !== null && val !== undefined && val !== '') {
+      next = Number(val);
+    }
+    this._props[key] = next;
+
+    // Only reflect primitives — objects/arrays stay as properties (no [object Object] attrs)
+    const isPrimitive =
+      next === null ||
+      next === undefined ||
+      typeof next === 'string' ||
+      typeof next === 'number' ||
+      typeof next === 'boolean';
+
+    this._reflecting = true;
+    try {
+      if (type === 'Boolean') {
+        if (next) this.setAttribute(key, '');
+        else this.removeAttribute(key);
+      } else if (!isPrimitive) {
+        // property-only; drop stale attribute if any
+        this.removeAttribute(key);
+      } else if (next === null || next === undefined) {
+        this.removeAttribute(key);
+      } else {
+        this.setAttribute(key, String(next));
+      }
+    } finally {
+      this._reflecting = false;
+    }
+    
+  }
+
+  _emitChange() {
+    // Shallow-copy both bags so listeners cannot mutate internal state/props via event.detail
+    this.dispatchEvent(new CustomEvent('kitbash-change', {
+      detail: {
+        state: { ...this._state },
+        props: { ...this._props },
+      },
+      bubbles: true,
+      composed: true
+    }));
+  }
+
+  /**
+   * Batch props and/or state: one uhtml update, one kitbash-change.
+   * Prefer this in event handlers (e.g. controlled inputs).
+   */
+  commit(patch) {
+    const p = patch || {};
+    if (p.props) {
+      const allowed = this.constructor.propTypes || {};
+      for (const key of Object.keys(p.props)) {
+        // Only declared props — ignore typos / stray keys
+        if (!Object.prototype.hasOwnProperty.call(allowed, key)) continue;
+        this._assignProp(key, p.props[key]);
+      }
+    }
+    if (p.state) {
+      this._state = { ...this._state, ...p.state };
+    }
+    this.update();
+    this._emitChange();
+  }
+
+  setState(newState) {
+    this.commit({ state: newState });
+  }
+
+  setProps(nextProps) {
+    this.commit({ props: nextProps });
+  }
+
+  _handlerCtx() {
+    // Snapshots so handlers/render cannot mutate internal bags by accident
+    return {
+      props: { ...this._props },
+      state: { ...this._state },
+      setState: this.setState.bind(this),
+      setProps: this.setProps.bind(this),
+      commit: this.commit.bind(this),
+    };
+  }
+  
+  cleanupEvents() {
+    this._eventCleanup.forEach(cleanup => cleanup());
+    this._eventCleanup = [];
+  }
+
+  update() {
+    // Run the uhtml DOM diffing render cycle
+    render(this.shadowRoot, this._renderFn({ 
+      ...this._handlerCtx(),
+      html 
+    }));
+    this.cleanupEvents();
+    this.bindEvents();
+    
+  }
+
+
+
+  bindEvents() {
+    Object.keys(this._eventHandlers).forEach(eventSelector => {
+      const parts = eventSelector.split(' ');
+      const eventName = parts[0];
+      const selector = parts.slice(1).join(' ');
+      
+      const targets = selector ? this.shadowRoot.querySelectorAll(selector) : [this];
+      targets.forEach(target => {
+        const handler = (e) => {
+          this._eventHandlers[eventSelector](e, this._handlerCtx());
+        };
+        target.addEventListener(eventName, handler);
+        this._eventCleanup.push(() => target.removeEventListener(eventName, handler));
+      });
+    });
+  }
+}
+
+if (!customElements.get('kitbash-toggle-group')) {
+  customElements.define('kitbash-toggle-group', KitbashToggleGroup);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ktbsh/ui",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Framework-agnostic design system components built with @ktbsh/sdk (vanilla CE + React wrappers).",
   "type": "module",
   "license": "MIT",