@12-apps/ui 6.24.8 → 6.26.0

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":"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"}

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/data-display/Alert/Alert.base.d.ts

@@ -69,11 +69,37 @@ export interface AlertBaseFields {
      */
     animate?: boolean;
     /**
-     * ARIA role for the alert
+     * Whether this alert INTERRUPTS a screen reader, or waits its turn.
+     *
+     * Sets `role` and `aria-live` together, which is the whole point of it:
+     * those two disagree by default and the disagreement is invisible. An alert
+     * gets `role="alert"` from {@link ALERT_DEFAULTS} whatever its variant, and
+     * `role="alert"` is IMPLICITLY an assertive live region — so a `polite`
+     * `aria-live` beside it is contradicted rather than honoured, and several
+     * screen readers interrupt anyway. A caller who wants a quiet announcement
+     * has to know that the trick is `role="status"`, which is implicitly polite.
+     *
+     * `announce` is that knowledge, spelled once:
+     *
+     * | value | `role` | `aria-live` |
+     * |---|---|---|
+     * | `'assertive'` | `alert` | `assertive` |
+     * | `'polite'` | `status` | `polite` |
+     *
+     * Unset, nothing changes: the role stays `alert` and the live setting is
+     * still derived from the variant ({@link defaultAriaLive}). An explicit
+     * `role` or `aria-live` still wins over both, so an existing call site that
+     * spells either by hand keeps exactly what it spelled.
+     */
+    announce?: 'polite' | 'assertive';
+    /**
+     * ARIA role for the alert. Prefer {@link AlertBaseFields.announce}, which
+     * keeps this and `aria-live` consistent; this overrides it.
      */
     role?: string;
     /**
-     * ARIA live region setting
+     * ARIA live region setting. Prefer {@link AlertBaseFields.announce}, which
+     * keeps this and `role` consistent; this overrides it.
      */
     'aria-live'?: 'polite' | 'assertive' | 'off';
     /**

package/dist/types-native/components/data-display/Alert/Alert.base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Alert.base.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Alert/Alert.base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5F;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAE,GAC9D;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAC;IAE7C;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAEjC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE3B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,YAAY,CAAC"}
+{"version":3,"file":"Alert.base.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Alert/Alert.base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5F;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAE,GAC9D;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAElC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAC;IAE7C;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAEjC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE3B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,YAAY,CAAC"}

package/dist/types-native/components/data-display/Alert/Alert.helpers.d.ts

@@ -12,6 +12,45 @@ export type ResolvedAlertProps<P extends AlertBaseFields> = P & Required<Pick<Al
 export declare const resolveAlertProps: <P extends AlertBaseFields>(props: P) => ResolvedAlertProps<P>;
 /** `danger` announces itself; everything else waits its turn. */
 export declare const defaultAriaLive: (variant: AlertVariant) => "polite" | "assertive";
+/**
+ * The ARIA role each `announce` level is spelled with.
+ *
+ * Both roles carry an IMPLICIT live setting, and that implicit one is what
+ * assistive tech acts on — `alert` is assertive, `status` is polite. Pairing
+ * them here is what stops `role` and `aria-live` from contradicting each
+ * other, which they do by default: every alert is `role="alert"` regardless of
+ * variant, so an `info` alert asks to be polite in one attribute and to
+ * interrupt in the other.
+ */
+export declare const ANNOUNCE_ROLE: Record<NonNullable<AlertBaseFields['announce']>, string>;
+/**
+ * The two attributes that decide whether an alert interrupts, resolved TOGETHER.
+ *
+ * Both renderers therefore let `role` and `announce` leave their destructure
+ * unused (`_role`, `_announce`) and call this instead — the first because the
+ * defaults have already answered it, the second because it must never reach
+ * the DOM.
+ *
+ * Reads the caller's own props rather than the defaulted ones, because the
+ * whole question is which of them the caller actually spelled:
+ * {@link ALERT_DEFAULTS} supplies `role: 'alert'` for everything, so after the
+ * merge there is no longer any difference between an alert that asked to
+ * interrupt and one that never mentioned it.
+ *
+ * Precedence, most specific first — an explicit `role` or `aria-live` beats
+ * `announce`, so a call site that already spells either by hand is untouched:
+ *
+ *  1. `role` / `aria-live` as given;
+ *  2. {@link AlertBaseFields.announce}, which supplies both;
+ *  3. today's behaviour — `ALERT_DEFAULTS.role` and {@link defaultAriaLive}.
+ *
+ * With none of the three named, the result is byte-for-byte what it was before
+ * `announce` existed.
+ */
+export declare const resolveAnnouncement: (props: Pick<AlertBaseFields, "announce" | "role" | "aria-live">, variant: AlertVariant) => {
+    role: string;
+    "aria-live": "polite" | "assertive" | "off";
+};
 export declare const testIdFor: (base: string | undefined, suffix: string) => string;
 /**
  * The glyph each semantic variant carries, by the shared icon set's name.

package/dist/types-native/components/data-display/Alert/Alert.helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Alert.helpers.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Alert/Alert.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,KAAK,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,aAAa,CAAC;AAEzG,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC,GAAG;IAAE,QAAQ,EAAE,KAAK,CAAA;CASnG,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,GAC3D,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAYtD,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,eAAe,EAAE,OAAO,CAAC,KAAG,kBAAkB,CAAC,CAAC,CACP,CAAC;AAEtF,iEAAiE;AACjE,eAAO,MAAM,eAAe,GAAI,SAAS,YAAY,KAAG,QAAQ,GAAG,WACpB,CAAC;AAEhD,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,GAAG,SAAS,EAAE,QAAQ,MAAM,KAAG,MACrB,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAKhE,CAAC"}
+{"version":3,"file":"Alert.helpers.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Alert/Alert.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,KAAK,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,aAAa,CAAC;AAEzG,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC,GAAG;IAAE,QAAQ,EAAE,KAAK,CAAA;CASnG,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,GAC3D,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAYtD,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,eAAe,EAAE,OAAO,CAAC,KAAG,kBAAkB,CAAC,CAAC,CACP,CAAC;AAEtF,iEAAiE;AACjE,eAAO,MAAM,eAAe,GAAI,SAAS,YAAY,KAAG,QAAQ,GAAG,WACpB,CAAC;AAEhD;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,CAGlF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,MAAM,GAAG,WAAW,CAAC,EAC/D,SAAS,YAAY,KACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAA;CAM7D,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,GAAG,SAAS,EAAE,QAAQ,MAAM,KAAG,MACrB,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAKhE,CAAC"}

package/dist/types-native/components/data-display/Alert/Alert.native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Alert.native.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Alert/Alert.native.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EASL,IAAI,EAEL,MAAM,cAAc,CAAC;AActB,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,sBAAsB,CAAC;AA4KrE,eAAO,MAAM,KAAK,yEAsChB,CAAC"}
+{"version":3,"file":"Alert.native.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/Alert/Alert.native.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EASL,IAAI,EAEL,MAAM,cAAc,CAAC;AActB,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,sBAAsB,CAAC;AA4KrE,eAAO,MAAM,KAAK,yEA0ChB,CAAC"}

package/package.json

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

package/src/components/data-display/Alert/Alert.base.ts

@@ -76,12 +76,39 @@ export interface AlertBaseFields {
   animate?: boolean;
 
   /**
-   * ARIA role for the alert
+   * Whether this alert INTERRUPTS a screen reader, or waits its turn.
+   *
+   * Sets `role` and `aria-live` together, which is the whole point of it:
+   * those two disagree by default and the disagreement is invisible. An alert
+   * gets `role="alert"` from {@link ALERT_DEFAULTS} whatever its variant, and
+   * `role="alert"` is IMPLICITLY an assertive live region — so a `polite`
+   * `aria-live` beside it is contradicted rather than honoured, and several
+   * screen readers interrupt anyway. A caller who wants a quiet announcement
+   * has to know that the trick is `role="status"`, which is implicitly polite.
+   *
+   * `announce` is that knowledge, spelled once:
+   *
+   * | value | `role` | `aria-live` |
+   * |---|---|---|
+   * | `'assertive'` | `alert` | `assertive` |
+   * | `'polite'` | `status` | `polite` |
+   *
+   * Unset, nothing changes: the role stays `alert` and the live setting is
+   * still derived from the variant ({@link defaultAriaLive}). An explicit
+   * `role` or `aria-live` still wins over both, so an existing call site that
+   * spells either by hand keeps exactly what it spelled.
+   */
+  announce?: 'polite' | 'assertive';
+
+  /**
+   * ARIA role for the alert. Prefer {@link AlertBaseFields.announce}, which
+   * keeps this and `aria-live` consistent; this overrides it.
    */
   role?: string;
 
   /**
-   * ARIA live region setting
+   * ARIA live region setting. Prefer {@link AlertBaseFields.announce}, which
+   * keeps this and `role` consistent; this overrides it.
    */
   'aria-live'?: 'polite' | 'assertive' | 'off';
 

package/src/components/data-display/Alert/Alert.helpers.ts

@@ -38,6 +38,56 @@ export const resolveAlertProps = <P extends AlertBaseFields>(props: P): Resolved
 export const defaultAriaLive = (variant: AlertVariant): 'polite' | 'assertive' =>
   variant === 'danger' ? 'assertive' : 'polite';
 
+/**
+ * The ARIA role each `announce` level is spelled with.
+ *
+ * Both roles carry an IMPLICIT live setting, and that implicit one is what
+ * assistive tech acts on — `alert` is assertive, `status` is polite. Pairing
+ * them here is what stops `role` and `aria-live` from contradicting each
+ * other, which they do by default: every alert is `role="alert"` regardless of
+ * variant, so an `info` alert asks to be polite in one attribute and to
+ * interrupt in the other.
+ */
+export const ANNOUNCE_ROLE: Record<NonNullable<AlertBaseFields['announce']>, string> = {
+  assertive: 'alert',
+  polite: 'status',
+};
+
+/**
+ * The two attributes that decide whether an alert interrupts, resolved TOGETHER.
+ *
+ * Both renderers therefore let `role` and `announce` leave their destructure
+ * unused (`_role`, `_announce`) and call this instead — the first because the
+ * defaults have already answered it, the second because it must never reach
+ * the DOM.
+ *
+ * Reads the caller's own props rather than the defaulted ones, because the
+ * whole question is which of them the caller actually spelled:
+ * {@link ALERT_DEFAULTS} supplies `role: 'alert'` for everything, so after the
+ * merge there is no longer any difference between an alert that asked to
+ * interrupt and one that never mentioned it.
+ *
+ * Precedence, most specific first — an explicit `role` or `aria-live` beats
+ * `announce`, so a call site that already spells either by hand is untouched:
+ *
+ *  1. `role` / `aria-live` as given;
+ *  2. {@link AlertBaseFields.announce}, which supplies both;
+ *  3. today's behaviour — `ALERT_DEFAULTS.role` and {@link defaultAriaLive}.
+ *
+ * With none of the three named, the result is byte-for-byte what it was before
+ * `announce` existed.
+ */
+export const resolveAnnouncement = (
+  props: Pick<AlertBaseFields, 'announce' | 'role' | 'aria-live'>,
+  variant: AlertVariant,
+): { role: string; 'aria-live': 'polite' | 'assertive' | 'off' } => {
+  const announce = props.announce;
+  return {
+    role: props.role ?? (announce === undefined ? ALERT_DEFAULTS.role : ANNOUNCE_ROLE[announce]),
+    'aria-live': props['aria-live'] ?? announce ?? defaultAriaLive(variant),
+  };
+};
+
 export const testIdFor = (base: string | undefined, suffix: string): string =>
   base ? `${base}-${suffix}` : `alert-${suffix}`;
 

package/src/components/data-display/Alert/Alert.md

@@ -33,6 +33,7 @@ A beautiful and versatile Alert component with multiple variants, animations, an
 | `glow` | `boolean` | `false` | Add a glowing shadow effect |
 | `pulse` | `boolean` | `false` | Add a pulsing animation effect |
 | `animate` | `boolean` | `true` | Whether to animate the alert on mount |
+| `announce` | `'polite' \| 'assertive'` | - | Sets `role` and `aria-live` together — see [Accessibility](#accessibility) |
 | `className` | `string` | - | Additional CSS classes |
 
 ## Usage Examples
@@ -136,12 +137,39 @@ import Star from '@mui/icons-material/Star';
 The Alert component implements comprehensive accessibility features:
 
 - Uses `role="alert"` for immediate screen reader announcement
-- Implements `aria-live` regions (polite for info/success, assertive for warning/danger)
+- Derives `aria-live` from the variant: **assertive for `danger`, polite for
+  every other variant** (`defaultAriaLive`)
 - Proper focus management for closable alerts
 - Keyboard navigation support (Enter/Space to close)
 - High contrast colors meeting WCAG guidelines
 - Screen reader compatible content structure
 
+### `announce` — whether the alert interrupts
+
+`role` and `aria-live` are two attributes with one meaning between them, and by
+default they disagree. Every alert gets `role="alert"`, whatever its variant,
+and `role="alert"` is **implicitly an assertive live region** — so an `info`
+alert ships `aria-live="polite"` and an implicitly-assertive role together, and
+a reader that honours the role interrupts anyway. The escape is that
+`role="status"` is implicitly polite, which is knowledge a call site should not
+have to carry.
+
+`announce` carries it:
+
+| `announce` | `role` | `aria-live` |
+|---|---|---|
+| `'assertive'` | `alert` | `assertive` |
+| `'polite'` | `status` | `polite` |
+| unset | `alert` | from the variant, as above |
+
+```tsx
+// A sentence worth hearing, that is not worth interrupting for.
+<Alert variant="info" announce="polite" description="Mais 1 pessoa está nesta mesa agora." showIcon={false} />
+```
+
+An explicit `role` or `aria-live` still wins over `announce`, so a call site
+that already spells either by hand keeps exactly what it spelled.
+
 ## Best Practices
 
 1. Use appropriate variants for message severity

package/src/components/data-display/Alert/Alert.native.tsx

@@ -12,7 +12,7 @@ import {
   type ViewStyle,
 } from 'react-native';
 
-import { defaultAriaLive, resolveAlertProps, testIdFor, VARIANT_ICON } from './Alert.helpers';
+import { resolveAlertProps, resolveAnnouncement, testIdFor, VARIANT_ICON } from './Alert.helpers';
 import {
   actionSlotStyle,
   alertLook,
@@ -198,7 +198,10 @@ function useDismiss(onClose: (() => void) | undefined): { open: boolean; gone: b
 
 export const Alert = React.forwardRef<View, AlertProps>((alertProps, ref) => {
   const {
-    variant, color, glow, pulse, icon, showIcon, onClose, title, description, children, animate, role,
+    variant, color, glow, pulse, icon, showIcon, onClose, title, description, children, animate,
+    // `role`, `announce` and `aria-live` all leave here and are resolved
+    // TOGETHER below, off `alertProps` — see `resolveAnnouncement`.
+    role: _role, announce: _announce,
     'aria-atomic': ariaAtomic, 'aria-live': _ariaLive, closable, closeLabel, style, ...others
   } = resolveAlertProps(alertProps);
   const theme = useUiTheme();
@@ -207,14 +210,15 @@ export const Alert = React.forwardRef<View, AlertProps>((alertProps, ref) => {
   const look = alertLook(theme, { variant, color, glow, pulse });
   const fadeIn = useFadeIn(animate);
   const dismiss = useDismiss(onClose);
+  const announcement = resolveAnnouncement(alertProps, variant);
 
   if (dismiss.gone) return null;
   return (
     <Collapse open={dismiss.open} onCollapsed={dismiss.onCollapsed}>
       <Animated.View
         ref={ref}
-        role={role as Role}
-        aria-live={alertProps['aria-live'] ?? defaultAriaLive(variant)}
+        role={announcement.role as Role}
+        aria-live={announcement['aria-live']}
         {...webAria({ 'aria-atomic': ariaAtomic })}
         tabIndex={0}
         testID={testId}

package/src/components/data-display/Alert/Alert.tsx

@@ -8,7 +8,7 @@ import { alpha, styled } from '@mui/material/styles/index.js';
 import type { Theme } from '@mui/material/styles/index.js';
 import React from 'react';
 
-import { defaultAriaLive, resolveAlertProps, testIdFor } from './Alert.helpers';
+import { resolveAlertProps, resolveAnnouncement, testIdFor } from './Alert.helpers';
 import type { AlertPalette } from './Alert.metrics';
 import {
   ACTIVE,
@@ -301,7 +301,7 @@ export const Alert = React.forwardRef<HTMLDivElement, AlertProps>((alertProps, r
     description,
     children,
     animate,
-    role,
+    role: _role, announce: _announce, // resolved from `alertProps` — see `resolveAnnouncement`
     'aria-atomic': ariaAtomic,
     ...others
   } = resolveAlertProps(alertProps);
@@ -316,7 +316,7 @@ export const Alert = React.forwardRef<HTMLDivElement, AlertProps>((alertProps, r
   const props = withoutAlertOnlyProps(withoutTestIdProps(others));
 
   // Depends on `variant`, so it cannot live in the static defaults above.
-  const ariaLive = alertProps['aria-live'] ?? defaultAriaLive(variant);
+  const announcement = resolveAnnouncement(alertProps, variant);
   const [open, setOpen] = React.useState(true);
   const [isClosing, setIsClosing] = React.useState(false);
 
@@ -356,8 +356,8 @@ export const Alert = React.forwardRef<HTMLDivElement, AlertProps>((alertProps, r
         pulse={pulse}
         animate={animate}
         icon={displayIcon}
-        role={role}
-        aria-live={ariaLive}
+        role={announcement.role}
+        aria-live={announcement['aria-live']}
         aria-atomic={ariaAtomic}
         tabIndex={0}
         action={dismissButton(alertProps, dataTestId, handleClose)}

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}