@12-apps/ui 6.24.7 → 6.25.0

package/dist/types/components/form/CategorySelect/CategorySelect.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CategorySelect.styles.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/CategorySelect.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAIlF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;IAclB,yDAAyD;;CAEjD,CAAC;AAWX,sFAAsF;AACtF,eAAO,MAAM,SAAS,GAAI,OAAO,KAAK,EAAE,UAAU,OAAO,EAAE,MAAM,OAAO,KAAG,SA0B1E,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,cAAc,GAAI,OAAO,KAAK,KAAG,SAU5C,CAAC;AAEH,sDAAsD;AACtD,eAAO,MAAM,cAAc,EAAE,SAc5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,MAAM,OAAO,KAAG,SAO/C,CAAC;AAEH,0BAA0B;AAC1B,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,KAAG,SAUrC,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,KAAG,SAkBrC,CAAC;AAEH,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,EAAE,OAAO,OAAO,KAAG,SAGzD,CAAC;AAEH,eAAO,MAAM,QAAQ,GAAI,OAAO,KAAK,KAAG,SAItC,CAAC;AAEH,eAAO,MAAM,aAAa,GAAI,OAAO,KAAK,KAAG,SAQ3C,CAAC;AAEH,eAAO,MAAM,UAAU,EAAE,SAMxB,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,MAAM,GAAI,OAAO,KAAK,KAAG,SA6BrC,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,OAAO,OAAO,KAAG,SAMtC,CAAC;AAEH,iFAAiF;AACjF,eAAO,MAAM,KAAK,GAAI,OAAO,KAAK,EAAE,QAAQ,OAAO,EAAE,OAAO,OAAO,KAAG,SAsBpE,CAAC;AAEH,eAAO,MAAM,SAAS,GAAI,OAAO,KAAK,EAAE,YAAY,OAAO,KAAG,SAS5D,CAAC;AAEH,eAAO,MAAM,SAAS,GAAI,OAAO,KAAK,EAAE,UAAU,OAAO,KAAG,SAK1D,CAAC;AAEH,wCAAwC;AACxC,eAAO,MAAM,MAAM,EAAE,SAKpB,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,KAAK,EAAE,MAAM,OAAO,KAAG,SAc5D,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,UAAU,GAAI,OAAO,KAAK,EAAE,OAAO,KAAK,GAAG,SAAS,GAAG,IAAI,KAAG,SAWzE,CAAC;AAEH,6DAA6D;AAC7D,eAAO,MAAM,aAAa,GAAI,OAAO,KAAK,KAAG,SAK3C,CAAC;AAEH,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAG,SAUlD,CAAC;AAEH,eAAO,MAAM,aAAa,GAAI,OAAO,KAAK,KAAG,SAQ3C,CAAC;AAEH,eAAO,MAAM,QAAQ,GAAI,OAAO,KAAK,KAAG,SAQtC,CAAC;AAEH,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,KAAG,SAWrC,CAAC;AAEH,mDAAmD;AACnD,eAAO,MAAM,UAAU,EAAE,SAIxB,CAAC"}
+{"version":3,"file":"CategorySelect.styles.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/CategorySelect.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAIlF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;IAYlB,+CAA+C;;;;IAI/C,yDAAyD;;CAEjD,CAAC;AAWX,sFAAsF;AACtF,eAAO,MAAM,SAAS,GAAI,OAAO,KAAK,EAAE,UAAU,OAAO,EAAE,MAAM,OAAO,KAAG,SA0B1E,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,cAAc,GAAI,OAAO,KAAK,KAAG,SAU5C,CAAC;AAEH,sDAAsD;AACtD,eAAO,MAAM,cAAc,EAAE,SAc5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,MAAM,OAAO,KAAG,SAO/C,CAAC;AAEH,0BAA0B;AAC1B,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,KAAG,SAUrC,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,KAAG,SAkBrC,CAAC;AAEH,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,EAAE,OAAO,OAAO,KAAG,SAGzD,CAAC;AAEH,eAAO,MAAM,QAAQ,GAAI,OAAO,KAAK,KAAG,SAItC,CAAC;AAEH,eAAO,MAAM,aAAa,GAAI,OAAO,KAAK,KAAG,SAQ3C,CAAC;AAEH,eAAO,MAAM,UAAU,EAAE,SAMxB,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,MAAM,GAAI,OAAO,KAAK,KAAG,SA6BrC,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,OAAO,OAAO,KAAG,SAMtC,CAAC;AAEH,iFAAiF;AACjF,eAAO,MAAM,KAAK,GAAI,OAAO,KAAK,EAAE,QAAQ,OAAO,EAAE,OAAO,OAAO,KAAG,SAsBpE,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,SACgC,CAAC;AAE3E,eAAO,MAAM,SAAS,GAAI,OAAO,KAAK,EAAE,YAAY,OAAO,KAAG,SAS5D,CAAC;AAEH,eAAO,MAAM,SAAS,GAAI,OAAO,KAAK,EAAE,UAAU,OAAO,KAAG,SAK1D,CAAC;AAEH,wCAAwC;AACxC,eAAO,MAAM,MAAM,EAAE,SAKpB,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,KAAK,EAAE,MAAM,OAAO,KAAG,SAc5D,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,UAAU,GAAI,OAAO,KAAK,EAAE,OAAO,KAAK,GAAG,SAAS,GAAG,IAAI,KAAG,SAWzE,CAAC;AAEH,6DAA6D;AAC7D,eAAO,MAAM,aAAa,GAAI,OAAO,KAAK,KAAG,SAK3C,CAAC;AAEH,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAG,SAUlD,CAAC;AAEH,eAAO,MAAM,aAAa,GAAI,OAAO,KAAK,KAAG,SAQ3C,CAAC;AAEH,eAAO,MAAM,QAAQ,GAAI,OAAO,KAAK,KAAG,SAQtC,CAAC;AAEH,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,KAAG,SAWrC,CAAC;AAEH,mDAAmD;AACnD,eAAO,MAAM,UAAU,EAAE,SAIxB,CAAC"}

package/dist/types/components/form/CategorySelect/CategorySelect.types.d.ts

@@ -20,10 +20,18 @@ export interface CategorySelectOption {
      */
     count?: number;
 }
-/** A top-level category together with the subcategories nested under it. */
+/**
+ * One node of the category tree: an option together with whatever sits under it.
+ *
+ * Recursive rather than "a category and its flat subcategories" because the tree
+ * a caller hands over is not always two deep — a picker can file ITEMS under a
+ * subcategory, and the level below still has to nest, fold and search like the
+ * one above it. A node with an empty `subcategories` is the leaf.
+ */
 export interface CategoryGroup {
     category: CategorySelectOption;
-    subcategories: CategorySelectOption[];
+    /** The nodes directly below it, each a group in its own right. */
+    subcategories: CategoryGroup[];
 }
 /** One entry in the "selected" summary: a whole category, or a single leaf. */
 export interface CategorySelectionChip {

package/dist/types/components/form/CategorySelect/CategorySelect.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CategorySelect.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/CategorySelect.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,aAAa,EAAE,oBAAoB,EAAE,CAAC;CACvC;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,6DAA6D;IAC7D,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sEAAsE;IACtE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAyB,SAAQ,uBAAuB;IACvE,kEAAkE;IAClE,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kEAAkE;IAClE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACpC;AAED,iFAAiF;AACjF,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB;IACxE,kEAAkE;IAClE,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,wDAAwD;IACxD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wDAAwD;IACxD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,MAAM,mBAAmB,GAAG,wBAAwB,GAAG,yBAAyB,CAAC"}
+{"version":3,"file":"CategorySelect.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/CategorySelect.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,kEAAkE;IAClE,aAAa,EAAE,aAAa,EAAE,CAAC;CAChC;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,6DAA6D;IAC7D,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sEAAsE;IACtE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAyB,SAAQ,uBAAuB;IACvE,kEAAkE;IAClE,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kEAAkE;IAClE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACpC;AAED,iFAAiF;AACjF,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB;IACxE,kEAAkE;IAClE,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,wDAAwD;IACxD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wDAAwD;IACxD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,MAAM,mBAAmB,GAAG,wBAAwB,GAAG,yBAAyB,CAAC"}

package/dist/types/components/form/CategorySelect/category-keyboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"category-keyboard.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/category-keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,wDAAwD;AACxD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,2EAA2E;IAC3E,MAAM,EAAE,OAAO,CAAC;IAChB,8EAA8E;IAC9E,oBAAoB,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,cAAc,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C,iBAAiB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B;AAoHD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,iBAAiB,EAAE,OAAO,EAC1B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAMT"}
+{"version":3,"file":"category-keyboard.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/category-keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,wDAAwD;AACxD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,2EAA2E;IAC3E,MAAM,EAAE,OAAO,CAAC;IAChB,8EAA8E;IAC9E,oBAAoB,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,cAAc,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C,iBAAiB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B;AAgHD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,iBAAiB,EAAE,OAAO,EAC1B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAMT"}

package/dist/types/components/form/CategorySelect/category-tree.d.ts

@@ -9,15 +9,17 @@ import type { CategoryGroup, CategorySelectionChip, CategorySelectOption } from
  */
 export declare function foldText(text: string): string;
 /**
- * Group a flat `parentId` list into top level + children, preserving input order.
+ * Nest a flat `parentId` list into a tree of ANY depth, preserving input order
+ * at every level.
  *
- * An option whose `parentId` names no top-level row is promoted to top level
- * rather than dropped — a category is never invisible just because its parent
- * was filtered out of the payload, or because the tree is deeper than two levels.
+ * An option whose `parentId` names nothing in the payload is promoted to top
+ * level rather than dropped — a category is never invisible just because its
+ * parent was filtered out of the response. A duplicate id keeps its first row,
+ * so a repeated payload cannot place the same node twice.
  */
 export declare function buildCategoryGroups(options: CategorySelectOption[]): CategoryGroup[];
 /**
- * Whether this category IS the leaf, because nothing sits under it.
+ * Whether this node IS the leaf, because nothing sits under it.
  *
  * The leaf-only default makes a category a heading and the subcategory the thing
  * you pick — but a childless category has no subcategory to offer instead, so
@@ -28,10 +30,34 @@ export declare function buildCategoryGroups(options: CategorySelectOption[]): Ca
  * filter while `Marcar tudo` could still select it.
  */
 export declare function isLeafCategory(group: CategoryGroup): boolean;
-/** Every selectable leaf id across all groups, in display order. */
+/** Every selectable leaf id across the whole tree, in display order. */
 export declare function collectLeafIds(groups: CategoryGroup[]): string[];
-/** The leaves a category stands for — its subcategories, or itself when childless. */
+/**
+ * The leaves a node stands for — every leaf BELOW it, or itself when childless.
+ *
+ * Recursive rather than one level down, so a category three levels deep still
+ * stands for the items at the bottom of it and not for the subcategories in
+ * between: the value a caller receives stays uniformly leaves, which is the
+ * property that lets a chip, a tri-state checkbox and `Marcar tudo` agree.
+ */
 export declare function leavesOf(group: CategoryGroup): string[];
+/** Every node that can be unfolded, at any depth — what "Expandir tudo" opens. */
+export declare function collectBranchIds(groups: CategoryGroup[]): string[];
+/** The node carrying `id`, searched at every depth. */
+export declare function findGroup(groups: CategoryGroup[], id: string): CategoryGroup | undefined;
+/**
+ * The names from the top-level category down to `id`, or `null` when absent.
+ *
+ * The single-select trigger reads this back as `Pai › Filha › Item`, so a chosen
+ * row keeps the context that tells `Massas` (mercearia) from `Massas` (pratos
+ * principais) once the panel has closed over it.
+ */
+export declare function categoryPath(groups: CategoryGroup[], id: string): string[] | null;
+/**
+ * How many levels the deepest branch has. A flat list is 1, the classic
+ * category/subcategory tree is 2, anything more is a tree with items in it.
+ */
+export declare function treeDepth(groups: CategoryGroup[]): number;
 export type CategoryCheckState = 'off' | 'partial' | 'on';
 /** Whether none, some, or all of a category's leaves are selected. */
 export declare function categoryCheckState(group: CategoryGroup, selected: ReadonlySet<string>): CategoryCheckState;
@@ -40,23 +66,26 @@ export declare function toggleCategoryLeaves(group: CategoryGroup, selected: Rea
 /** Add an id when absent, remove it when present. */
 export declare function toggleLeaf(id: string, selected: ReadonlySet<string>): Set<string>;
 /**
- * Collapse a raw id set into the chips a human reads: a category that is fully
- * selected becomes ONE chip bearing the category's name, rather than one chip
- * per subcategory — "Bebidas" instead of six drinks.
+ * Collapse a raw id set into the chips a human reads: a node that is fully
+ * selected becomes ONE chip bearing its name, rather than one chip per leaf —
+ * "Bebidas" instead of six drinks.
+ *
+ * A partly-selected node hands the question down to its own children, so the
+ * chip that appears is always the DEEPEST node that is completely selected.
  */
 export declare function summarizeSelection(groups: CategoryGroup[], selected: ReadonlySet<string>): CategorySelectionChip[];
 /**
- * Drop the leaves a chip stands for. A `whole` chip removes the whole category;
- * any other chip removes just that leaf.
+ * Drop the leaves a chip stands for. A chip naming a node removes everything
+ * under it; a chip naming nothing in the tree removes just that id.
  */
 export declare function removeChip(groups: CategoryGroup[], chipId: string, selected: ReadonlySet<string>): Set<string>;
 /**
- * Search across BOTH levels, keeping every hit under its parent.
+ * Search every level, keeping each hit under its parents.
  *
- * A category that matches keeps all of its subcategories, so "Bebidas" shows the
- * whole group. A category that does not match keeps only the subcategories that
- * do — the hit still arrives with its parent visible above it, which is the
- * context that tells "Massas" (mercearia) from "Massas" (pratos principais).
+ * A node that matches keeps its whole subtree, so "Bebidas" shows the entire
+ * group. A node that does not match keeps only the descendants that do — the hit
+ * still arrives with its parents visible above it, which is the context that
+ * tells "Massas" (mercearia) from "Massas" (pratos principais).
  */
 export declare function filterCategoryGroups(groups: CategoryGroup[], query: string): CategoryGroup[];
 /** A run of text, flagged when it is the part that matched the query. */
@@ -74,12 +103,15 @@ interface HighlightSegment {
 export declare function highlightSegments(text: string, query: string): HighlightSegment[];
 /** A flattened row, so keyboard navigation can walk what is actually on screen. */
 export interface CategoryRowRef {
-    kind: 'category' | 'subcategory';
     id: string;
-    /** Owning category id — lets ← jump from a subcategory back to its parent. */
+    /** 0 for a top-level category, one more for each level below it. */
+    depth: number;
+    /** True when the row has children to unfold — what → and ← act on. */
+    branch: boolean;
+    /** Owning node id — lets ← jump from a child back to its parent. */
     parentId?: string;
 }
-/** The visible rows, in order, honouring which categories are expanded. */
+/** The visible rows, in order, honouring which nodes are expanded. */
 export declare function flattenRows(groups: CategoryGroup[], isExpanded: (categoryId: string) => boolean): CategoryRowRef[];
 export {};
 //# sourceMappingURL=category-tree.d.ts.map

package/dist/types/components/form/CategorySelect/category-tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"category-tree.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/category-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,aAAa,EAAE,CAmBpF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE5D;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAEhE;AAED,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,EAAE,CAEvD;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC;AAE1D,sEAAsE;AACtE,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,kBAAkB,CAKpB;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,GAAG,CAAC,MAAM,CAAC,CAMb;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAIjF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EAAE,EACvB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,qBAAqB,EAAE,CAWzB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,aAAa,EAAE,EACvB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,GAAG,CAAC,MAAM,CAAC,CASb;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,CAU5F;AAED,yEAAyE;AACzE,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAUjF;AAED,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,GAAG,aAAa,CAAC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EAAE,EACvB,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,GAC1C,cAAc,EAAE,CAelB"}
+{"version":3,"file":"category-tree.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/category-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK7C;AA0BD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,aAAa,EAAE,CAiBpF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE5D;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAEhE;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,EAAE,CAGvD;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAIlE;AAED,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAOxF;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAOjF;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAKzD;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC;AAE1D,sEAAsE;AACtE,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,kBAAkB,CAKpB;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,GAAG,CAAC,MAAM,CAAC,CAMb;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAIjF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EAAE,EACvB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,qBAAqB,EAAE,CAczB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,aAAa,EAAE,EACvB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,GAAG,CAAC,MAAM,CAAC,CASb;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,CAU5F;AAED,yEAAyE;AACzE,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAUjF;AAED,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,MAAM,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EAAE,EACvB,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,GAC1C,cAAc,EAAE,CAUlB"}

package/dist/types/components/form/CategorySelect/index.d.ts

@@ -1,4 +1,4 @@
 export { CategorySelect } from './CategorySelect';
 export type { CategoryGroup, CategoryMultiSelectProps, CategorySelectBaseProps, CategorySelectionChip, CategorySelectOption, CategorySelectProps, CategorySingleSelectProps, } from './CategorySelect.types';
-export { buildCategoryGroups, categoryCheckState, collectLeafIds, filterCategoryGroups, foldText, leavesOf, summarizeSelection, } from './category-tree';
+export { buildCategoryGroups, categoryCheckState, categoryPath, collectBranchIds, collectLeafIds, filterCategoryGroups, findGroup, foldText, leavesOf, summarizeSelection, treeDepth, } from './category-tree';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/components/form/CategorySelect/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,aAAa,EACb,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,QAAQ,EACR,QAAQ,EACR,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,aAAa,EACb,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,kBAAkB,EAClB,SAAS,GACV,MAAM,iBAAiB,CAAC"}

package/dist/types/components/form/CategorySelect/useCategorySelect.d.ts

@@ -22,6 +22,8 @@ export interface CategorySelectState extends ExpansionState, DraftState {
     visibleGroups: CategoryGroup[];
     /** All groups, unfiltered — the basis for chips and "select all". */
     allGroups: CategoryGroup[];
+    /** True when the tree runs deeper than category/subcategory. */
+    deepTree: boolean;
     rows: CategoryRowRef[];
     activeIndex: number;
     setQuery: (next: string) => void;

package/dist/types/components/form/CategorySelect/useCategorySelect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCategorySelect.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/useCategorySelect.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAElF,oEAAoE;AACpE,UAAU,cAAc;IACtB,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,cAAc,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;CAC9C;AA0CD,+DAA+D;AAC/D,UAAU,UAAU;IAClB,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAC9C,cAAc,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C,iBAAiB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAkBD,4EAA4E;AAC5E,MAAM,WAAW,mBAAoB,SAAQ,cAAc,EAAE,UAAU;IACrE,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,aAAa,EAAE,aAAa,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACvD;AAED,UAAU,qBAAqB;IAC7B,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,OAAO,EACP,QAAQ,GACT,EAAE,qBAAqB,GAAG,mBAAmB,CAqD7C"}
+{"version":3,"file":"useCategorySelect.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/useCategorySelect.ts"],"names":[],"mappings":"AAEA,OAAO,EAQL,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAElF,oEAAoE;AACpE,UAAU,cAAc;IACtB,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,cAAc,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;CAC9C;AAiDD,+DAA+D;AAC/D,UAAU,UAAU;IAClB,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAC9C,cAAc,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C,iBAAiB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAkBD,4EAA4E;AAC5E,MAAM,WAAW,mBAAoB,SAAQ,cAAc,EAAE,UAAU;IACrE,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,aAAa,EAAE,aAAa,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACvD;AAED,UAAU,qBAAqB;IAC7B,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,OAAO,EACP,QAAQ,GACT,EAAE,qBAAqB,GAAG,mBAAmB,CAwD7C"}

package/dist/types-native/components/form/Button/Button.metrics.d.ts

@@ -17,6 +17,31 @@ export interface ButtonSizeMetrics {
 export declare const BUTTON_SIZES: Record<SizeValue, ButtonSizeMetrics>;
 /** A button that is only an icon is square: uniform padding, no min-width. */
 export declare const ICON_ONLY_PADDING: Record<SizeValue, number>;
+/**
+ * The start/end icon slot's font-size, in px — MUI's `medium` value, pinned
+ * (12-74).
+ *
+ * MUI sizes that slot off its OWN `size` prop, writing 18/20/22 onto the first
+ * child of `.MuiButton-startIcon`. We never passed a `size`, so every button in
+ * every size has always drawn medium's 20px; now that `size` IS forwarded — so
+ * the rendered class finally names the size the button actually is — the number
+ * would start moving with it.
+ *
+ * WHAT THAT ACTUALLY REACHES, measured in a browser rather than assumed: this
+ * Button renders its own wrapper span around the icon (it carries the child
+ * test id), so MUI's rule lands on the WRAPPER and reaches the glyph only when
+ * the glyph takes its size by inheritance — `fontSize="inherit"`, an em-sized
+ * SVG, a text or emoji glyph. With the pin removed, such a glyph measured 18px
+ * at `xs`/`sm` and 22px at `lg`/`xl` against the 20px it has always been. An
+ * icon carrying an absolute size of its own does not move at all: a default
+ * `SvgIcon` stayed 24×24 across all five.
+ *
+ * A silent resize of the inherited case is still a design decision arriving as
+ * a side effect of a class-name fix, so it is pinned to what shipped before —
+ * `Button.tsx` puts it on that same wrapper. Scaling the glyph with the button
+ * is a ticket of its own.
+ */
+export declare const BUTTON_ICON_GLYPH_SIZE = 20;
 export declare const BUTTON_FONT_WEIGHT = 500;
 /** `theme.spacing(1)`. */
 export declare const BUTTON_RADIUS_UNITS = 1;

package/dist/types-native/components/form/Button/Button.metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.metrics.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Button/Button.metrics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErE;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAM7D,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAMvD,CAAC;AAEF,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,0BAA0B;AAC1B,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,uFAAuF;AACvF,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,GAAG,cAAc,CAU/E;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,EAAE,SAAS,cAAc,KAAG,MACc,CAAC;AAElF,sFAAsF;AACtF,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,cAAc,GACtB,CAAC,MAAM,EAAE,MAAM,CAAC,CAclB"}
+{"version":3,"file":"Button.metrics.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Button/Button.metrics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErE;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAM7D,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAMvD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,0BAA0B;AAC1B,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,uFAAuF;AACvF,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,GAAG,cAAc,CAU/E;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,EAAE,SAAS,cAAc,KAAG,MACc,CAAC;AAElF,sFAAsF;AACtF,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,cAAc,GACtB,CAAC,MAAM,EAAE,MAAM,CAAC,CAclB"}

package/dist/user-avatar.js

@@ -1,7 +1,7 @@
 import {
   UserAvatar,
   UserMenu
-} from "./chunk-ZRPGVHTR.js";
+} from "./chunk-GGI7GM5O.js";
 import "./chunk-UDQSIRAP.js";
 import "./chunk-JUHUKZGU.js";
 import "./chunk-NA7MIEG6.js";
@@ -15,9 +15,9 @@ import "./chunk-BEBLRL5D.js";
 import "./chunk-6Q6T3FW5.js";
 import "./chunk-FKUYRQSP.js";
 import "./chunk-BA4RHQ3B.js";
-import "./chunk-YTOYMJPM.js";
-import "./chunk-JT6TERQL.js";
-import "./chunk-ITGG5OKP.js";
+import "./chunk-SLVQ33AN.js";
+import "./chunk-BB2OUERT.js";
+import "./chunk-5LQ7PKMW.js";
 import "./chunk-TAMIZE4Q.js";
 import "./chunk-73BEVJCS.js";
 import "./chunk-343TTIHD.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12-apps/ui",
-  "version": "6.24.7",
+  "version": "6.25.0",
   "license": "MIT",
   "packageManager": "pnpm@10.34.5",
   "type": "module",

package/src/components/form/Button/Button.md

@@ -12,6 +12,8 @@ The Button component is a versatile and highly customizable interactive element
 - **Special Effects**: glow, pulse animations
 - **Loading States**: Built-in loading spinner
 - **Icon Support**: Leading icons with automatic loading state handling
+- **Renders As Anything**: `component` swaps the element, carrying that
+  component's own props through the types (a router link, an `<a>`, a label)
 - **Accessibility**: Full ARIA support, keyboard navigation
 - **Responsive Design**: Adapts to different screen sizes
 
@@ -37,6 +39,14 @@ import { Button } from '@procurement/ui';
 <Button variant="gradient" glow pulse>
   Special Button
 </Button>
+
+// As a navigation, painted as a button
+<Button component={Link} to="/orders/42">
+  Track my order
+</Button>
+
+// Or a plain anchor, when there is no router in the tree
+<Button href="/orders/42">Track my order</Button>
 ```
 
 ## Props
@@ -60,6 +70,35 @@ import { Button } from '@procurement/ui';
 | `onBlur`     | `(event: FocusEvent) => void`                                                 | -           | Blur event handler                        |
 | `children`   | `ReactNode`                                                                   | -           | Button content                            |
 | `className`  | `string`                                                                      | -           | Additional CSS classes                    |
+| `component`  | `ElementType`                                                                 | `'button'`  | Render as this element/component instead  |
+| `href`       | `string`                                                                      | -           | Renders an `<a>` (MUI's own behaviour)    |
+
+## Rendering as something else
+
+`component` swaps the element the button renders as, and the button's props are
+typed against it — so the target's own props are checked at the call site rather
+than silently dropped:
+
+```tsx
+import { Link } from 'react-router-dom';
+
+<Button component={Link} to="/orders/42" variant="solid" size="lg">
+  Track my order
+</Button>;
+```
+
+Three things are worth knowing:
+
+- **`to` is typed.** `Button` is an `OverridableComponent`, so the generic
+  carries the target's props through. Misspell `to` and it fails to compile.
+- **The paint does not change.** Measured against the same button rendered as a
+  `<button>`: identical box, background, padding, radius and type; hover still
+  darkens; the class still names the size.
+- **`href` alone is enough** when there is no router involved — MUI renders an
+  `<a>` for it without a `component`.
+
+The event handlers are typed on `HTMLElement` rather than `HTMLButtonElement`
+for this reason: the element under the pointer is not always a button.
 
 ## Variants
 

package/src/components/form/Button/Button.metrics.ts

@@ -34,6 +34,32 @@ export const ICON_ONLY_PADDING: Record<SizeValue, number> = {
   xl: 11,
 };
 
+/**
+ * The start/end icon slot's font-size, in px — MUI's `medium` value, pinned
+ * (12-74).
+ *
+ * MUI sizes that slot off its OWN `size` prop, writing 18/20/22 onto the first
+ * child of `.MuiButton-startIcon`. We never passed a `size`, so every button in
+ * every size has always drawn medium's 20px; now that `size` IS forwarded — so
+ * the rendered class finally names the size the button actually is — the number
+ * would start moving with it.
+ *
+ * WHAT THAT ACTUALLY REACHES, measured in a browser rather than assumed: this
+ * Button renders its own wrapper span around the icon (it carries the child
+ * test id), so MUI's rule lands on the WRAPPER and reaches the glyph only when
+ * the glyph takes its size by inheritance — `fontSize="inherit"`, an em-sized
+ * SVG, a text or emoji glyph. With the pin removed, such a glyph measured 18px
+ * at `xs`/`sm` and 22px at `lg`/`xl` against the 20px it has always been. An
+ * icon carrying an absolute size of its own does not move at all: a default
+ * `SvgIcon` stayed 24×24 across all five.
+ *
+ * A silent resize of the inherited case is still a design decision arriving as
+ * a side effect of a class-name fix, so it is pinned to what shipped before —
+ * `Button.tsx` puts it on that same wrapper. Scaling the glyph with the button
+ * is a ticket of its own.
+ */
+export const BUTTON_ICON_GLYPH_SIZE = 20;
+
 export const BUTTON_FONT_WEIGHT = 500;
 /** `theme.spacing(1)`. */
 export const BUTTON_RADIUS_UNITS = 1;

package/src/components/form/Button/Button.tsx

@@ -4,6 +4,7 @@ import { styled } from '@mui/material/styles/index.js';
 import * as React from 'react';
 
 import { resolveButtonProps } from './Button.helpers';
+import { BUTTON_ICON_GLYPH_SIZE } from './Button.metrics';
 import { childTestId, resolveTestId, withoutTestIdProps } from '../../../platform/test-id';
 import {
   buttonEmphasisStyles,
@@ -12,7 +13,7 @@ import {
   iconAlignmentStyles,
   buttonSize,
 } from './Button.styles';
-import type { ButtonProps } from './Button.types';
+import type { ButtonComponent, ButtonProps } from './Button.types';
 
 const StyledButton = styled(MuiButton, {
   shouldForwardProp: (prop) =>
@@ -49,12 +50,53 @@ const muiVariantFor = (variant?: string): 'outlined' | 'text' | 'contained' => {
 
 type MuiButtonColor = 'inherit' | 'primary' | 'secondary' | 'success' | 'warning' | 'info' | 'error';
 
+/**
+ * Our five sizes collapse onto MUI's three, so the rendered class NAMES the
+ * size the button actually is (12-74).
+ *
+ * It was never forwarded, so every button — `xs` through `xl` — carried
+ * `MuiButton-sizeMedium`. The pixels were right (they come from `buttonSize`'s
+ * `sx`, which still decides them) but the DOM said "medium" about a large
+ * button: a test could never assert the size, and devtools lied to whoever
+ * opened them.
+ *
+ * MUI's own size styles are padding, font-size and the icon glyph. The first
+ * two are overridden by that same `sx`; the third is pinned by
+ * `BUTTON_ICON_GLYPH_SIZE`, so forwarding this moves nothing on screen.
+ */
+const muiSizeFor = (size: NonNullable<ButtonProps['size']>): 'small' | 'medium' | 'large' => {
+  if (size === 'xs' || size === 'sm') return 'small';
+  return size === 'md' ? 'medium' : 'large';
+};
+
 /** `danger` and `neutral` are ours; the rest are MUI's own names already. */
 const muiColorFor = (color: NonNullable<ButtonProps['color']>): MuiButtonColor => {
   if (color === 'danger') return 'error';
   return color === 'neutral' ? 'inherit' : color;
 };
 
+/**
+ * The icon slot's font-size, pinned on the wrapper this component already owns
+ * (12-74).
+ *
+ * MUI writes 18/20/22 there off its own `size`, and that prop is now forwarded,
+ * so a glyph that takes its size by INHERITANCE would start moving with the
+ * button — measured at 18px on `xs` and 22px on `lg` against the 20px every
+ * size has always drawn. See {@link BUTTON_ICON_GLYPH_SIZE} for what that does
+ * and does not reach.
+ *
+ * Written as an inline style rather than a selector in `sx` because MUI's own
+ * rule sits on the start/end-icon span itself. Beating it from the root means
+ * winning a specificity contest at a distance — true in a browser, but not
+ * something a test can hold, since jsdom resolves `getComputedStyle` by
+ * document order and never by specificity. Inline wins both, and it sits on the
+ * one element we already render for this glyph.
+ *
+ * A number, not `px()`: React writes `font-size: 20px`, which is exactly the
+ * declaration MUI was emitting before.
+ */
+const ICON_GLYPH_STYLE = { fontSize: BUTTON_ICON_GLYPH_SIZE } as const;
+
 /**
  * An icon and nothing else — the shape that should render square.
  *
@@ -71,7 +113,26 @@ function isIconOnly({
   return !loading && icon != null && children == null;
 }
 
-export const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
+/**
+ * The design system's button.
+ *
+ * Typed as an `OverridableComponent` (12-70) rather than a plain `forwardRef`,
+ * which is how MUI models a component that can render as something else. The
+ * practical difference is one line at a call site:
+ *
+ * ```tsx
+ * <Button component={Link} to="/account/compras/42">Acompanhar pedido</Button>
+ * ```
+ *
+ * `to` is typed here because the generic carries the target component's own
+ * props through. A plain `component?: React.ElementType` — what this was —
+ * accepts the component and throws its props away, so `to` typechecked
+ * nowhere even though it arrived intact at runtime. A host wanting a router
+ * navigation painted as a button had to choose between a type assertion and
+ * losing the `href`; both were shipped, and both are the reason this ticket
+ * exists.
+ */
+const ButtonRoot = React.forwardRef<HTMLButtonElement, ButtonProps>(
   (rawProps, ref) => {
     const {
       variant,
@@ -99,7 +160,11 @@ export const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
 
     // Wrap icon with testId if provided
     const iconWithTestId =
-      !loading && icon ? <span data-testid={testId('icon')}>{icon}</span> : undefined;
+      !loading && icon ? (
+        <span data-testid={testId('icon')} style={ICON_GLYPH_STYLE}>
+          {icon}
+        </span>
+      ) : undefined;
 
     // Only an icon, so the button is a square rather than a 64px slab.
     const iconOnly = isIconOnly({ loading, icon, children });
@@ -112,6 +177,7 @@ export const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
         ref={ref}
         variant={muiVariantFor(variant)}
         color={muiColorFor(color)}
+        size={muiSizeFor(size)}
         customVariant={variant}
         customColor={color}
         glow={glow}
@@ -139,4 +205,11 @@ export const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
   },
 );
 
-Button.displayName = 'Button';
+ButtonRoot.displayName = 'Button';
+
+/**
+ * The cast is what publishes the generic — `forwardRef` cannot express
+ * "renders as C, and takes C's props" on its own, so MUI's own components do
+ * exactly this. `ButtonRoot` above is the implementation and is not exported.
+ */
+export const Button = ButtonRoot as ButtonComponent;

package/src/components/form/Button/Button.types.ts

@@ -1,25 +1,67 @@
 import type { ButtonProps as MuiButtonProps } from '@mui/material/Button/index.js';
+import type { OverridableComponent, OverrideProps } from '@mui/material/OverridableComponent/index.js';
 import type * as React from 'react';
 
 import type { ButtonBaseProps } from './Button.base';
 
 export type { ButtonBaseProps, ButtonVariant } from './Button.base';
 
-export interface ButtonProps
+/**
+ * Everything this Button adds, WITHOUT the element it renders as.
+ *
+ * `component` is deliberately omitted here and reintroduced by the type map
+ * below: MUI models "render as something else" with a generic, and taking
+ * `component?: React.ElementType` as a plain prop is exactly what threw the
+ * target's own props away (12-70).
+ */
+export interface ButtonOwnProps
   extends ButtonBaseProps,
-    Omit<MuiButtonProps, 'variant' | 'color' | 'size' | keyof ButtonBaseProps> {
+    Omit<MuiButtonProps, 'variant' | 'color' | 'size' | 'component' | keyof ButtonBaseProps> {
   /**
    * Click handler
    */
-  onClick?: React.MouseEventHandler<HTMLButtonElement>;
+  onClick?: React.MouseEventHandler<HTMLElement>;
 
   /**
    * Focus handler
    */
-  onFocus?: React.FocusEventHandler<HTMLButtonElement>;
+  onFocus?: React.FocusEventHandler<HTMLElement>;
 
   /**
    * Blur handler
    */
-  onBlur?: React.FocusEventHandler<HTMLButtonElement>;
+  onBlur?: React.FocusEventHandler<HTMLElement>;
 }
+
+/**
+ * What `Button` renders as, and what that brings with it.
+ *
+ * This is the shape MUI's `OverridableComponent` reads. Handing `component` a
+ * router `Link` now also hands the call site that Link's OWN props — `to`,
+ * `replace`, `state` — typed, which is the whole point of 12-70. Before this,
+ * `component` was `React.ElementType` and `to` typechecked nowhere, so a host
+ * that wanted a navigation painted as a button had to reach for a type
+ * assertion or throw the `href` away.
+ */
+export interface ButtonTypeMap<
+  AdditionalProps = object,
+  RootComponent extends React.ElementType = 'button',
+> {
+  props: AdditionalProps & ButtonOwnProps;
+  defaultComponent: RootComponent;
+}
+
+/**
+ * The props of a Button rendered as `RootComponent` — `button` by default.
+ *
+ * Generic WITH defaults, so every existing `ButtonProps` (no arguments) keeps
+ * meaning exactly what it meant before this change: the button-rendered case.
+ */
+export type ButtonProps<
+  RootComponent extends React.ElementType = 'button',
+  AdditionalProps = object,
+> = OverrideProps<ButtonTypeMap<AdditionalProps, RootComponent>, RootComponent> & {
+  component?: React.ElementType;
+};
+
+export type ButtonComponent = OverridableComponent<ButtonTypeMap>;

package/src/components/form/CategorySelect/CategoryPanel.tsx

@@ -94,6 +94,7 @@ export function CategoryPanel({
         loading={loading}
         showCounts={showCounts}
         allowParentSelection={allowParentSelection}
+        deepTree={state.deepTree}
         isExpanded={state.isExpanded}
         onToggleExpanded={state.toggleExpanded}
         onActivateCategory={onActivateCategory}