@fayz-ai/ui 0.12.0 → 0.15.0

package/dist/primitives/option-select.d.ts

@@ -0,0 +1,46 @@
+import * as React from 'react';
+export interface SelectableOption {
+    value: string;
+    label: React.ReactNode;
+    /** Second line under the label — the sentence that makes the choice obvious. */
+    hint?: React.ReactNode;
+    icon?: React.ReactNode;
+}
+interface SharedProps {
+    options: ReadonlyArray<SelectableOption>;
+    /** A string in single mode, a list in `multi` mode. */
+    value?: string | string[];
+    onChange: (value: string | string[]) => void;
+    multi?: boolean;
+    disabled?: boolean;
+    /**
+     * Bind 1–9 to the first nine options and print the digit on each one.
+     *
+     * Off by default: two shortcut-bound groups on one screen would both answer to
+     * "1". The caller decides which group owns the keys.
+     */
+    shortcuts?: boolean;
+    className?: string;
+    'aria-label'?: string;
+}
+export interface OptionCardsProps extends SharedProps {
+    /** Cards per row on wide screens. One column reads as a list — use it for long hints. */
+    columns?: 1 | 2 | 3;
+}
+/**
+ * Card picker — the answer surface for a question with a handful of options that
+ * each need a sentence of explanation.
+ *
+ * Radix has no radio-group in this package and a native radio list cannot carry a
+ * hint line, so this is a button grid with `role="radio"`/`"checkbox"` semantics
+ * layered back on.
+ */
+export declare function OptionCards({ options, value, onChange, multi, disabled, shortcuts, columns, className, ...rest }: OptionCardsProps): React.JSX.Element;
+export type OptionChipsProps = SharedProps;
+/**
+ * Pill picker — same selection model as OptionCards, for lists long enough that
+ * cards would push the question off screen (industries, channels, price bands).
+ */
+export declare function OptionChips({ options, value, onChange, multi, disabled, shortcuts, className, ...rest }: OptionChipsProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=option-select.d.ts.map

package/dist/primitives/option-select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"option-select.d.ts","sourceRoot":"","sources":["../../src/primitives/option-select.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,gFAAgF;IAChF,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CACvB;AAED,UAAU,WAAW;IACnB,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAA;IACxC,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,IAAI,CAAA;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAqED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,yFAAyF;IACzF,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CACpB;AAQD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAa,EAAE,QAAQ,EAAE,SAAiB,EAAE,OAAW,EAAE,SAAS,EAAE,GAAG,IAAI,EACtG,EAAE,gBAAgB,qBA8ClB;AAED,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAA;AAE1C;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAa,EAAE,QAAQ,EAAE,SAAiB,EAAE,SAAS,EAAE,GAAG,IAAI,EACzF,EAAE,gBAAgB,qBAoClB"}

package/dist/primitives/page-toolbar.d.ts

@@ -0,0 +1,80 @@
+import * as React from 'react';
+/**
+ * O gatilho padrão da barra: sem contorno, com o rótulo sublinhado tracejado.
+ *
+ * Contornados, os três viravam três caixas arredondadas dentro de outra caixa
+ * arredondada — a borda do vidro e a dos botões disputavam a mesma leitura, e a
+ * barra parecia um grupo de botões e não um controle. O tracejado é o traço
+ * clássico de "este valor se troca": diz que clica sem desenhar mais um limite.
+ */
+export declare const ToolbarButton: React.ForwardRefExoticComponent<Omit<import("./button").ButtonProps & React.RefAttributes<HTMLButtonElement> & {
+    icon?: React.ElementType;
+    caret?: boolean;
+}, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * O gatilho de COMANDO da barra — Exportar, Imprimir, Novo.
+ *
+ * Mesma matéria do ToolbarButton acima (sem contorno, sem fundo, fantasma) e
+ * sem o sublinhado tracejado: o tracejado promete "este valor se troca", e
+ * imprimir não é um valor. Eram botões contornados no meio de uma barra sem
+ * contorno nenhum — duas caixas arredondadas ao lado de três rótulos soltos,
+ * que é o desenho que faz a barra parecer duas barras.
+ */
+export declare const ToolbarAction: React.ForwardRefExoticComponent<Omit<import("./button").ButtonProps & React.RefAttributes<HTMLButtonElement> & {
+    icon?: React.ElementType;
+    caret?: boolean;
+}, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export interface RangeOption {
+    value: string;
+    label: string;
+}
+export interface RangeControlProps {
+    options: RangeOption[];
+    value: string;
+    onChange: (value: string) => void;
+    /** Rótulo do gatilho quando não é nenhum dos presets (ex.: "Personalizado"). */
+    label?: string;
+    /** "21 jul – 19 ago" — a janela que os números realmente cobrem. Um nome de
+     *  preset sozinho deixa a dúvida se "este mês" já inclui hoje. */
+    span?: string;
+    /** Itens extras no fim do menu (ex.: abrir uma janela personalizada). */
+    extra?: React.ReactNode;
+    /** Desenhado ao lado do gatilho (ex.: os dois seletores de data). */
+    children?: React.ReactNode;
+    icon?: React.ElementType;
+    className?: string;
+}
+/**
+ * O controle de período — um só, para o dashboard e para as análises.
+ *
+ * Puramente apresentacional: quem tem o estado (o contexto de analytics, o de
+ * dashboard) passa opções e valor. Eram dois desenhos para a mesma escolha, um
+ * segmentado de 7d/30d/90d e um menu de presets, e trocar de tela trocava a
+ * gramática do controle sem trocar o que ele faz.
+ */
+export declare function RangeControl({ options, value, onChange, label, span, extra, children, icon, className, }: RangeControlProps): React.JSX.Element;
+export interface PageToolbarProps {
+    /** O período. */
+    range?: React.ReactNode;
+    /** Filtros gerais e comparação — o que estreita a pergunta. */
+    filters?: React.ReactNode;
+    /** Filtros aplicados, como pastilhas removíveis. */
+    chips?: React.ReactNode;
+    /** Quais componentes aparecem. */
+    customize?: React.ReactNode;
+    /** Extras da tela (exportar, um relatório novo). */
+    actions?: React.ReactNode;
+    onRefresh?: () => void;
+    refreshLabel?: string;
+    /** Solta a barra do topo (dentro de um modal, ou ao imprimir). */
+    sticky?: boolean;
+    /** Alça de arrastar à esquerda. Desligue onde a barra não flutua sobre nada. */
+    movable?: boolean;
+    /** Separa a posição desta barra da compartilhada. Ver useToolbarOffset. */
+    storageKey?: string;
+    /** Rótulo acessível da alça. */
+    moveLabel?: string;
+    className?: string;
+}
+export declare function PageToolbar({ range, filters, chips, customize, actions, onRefresh, refreshLabel, sticky, movable, storageKey, moveLabel, className, }: PageToolbarProps): React.JSX.Element | null;
+//# sourceMappingURL=page-toolbar.d.ts.map

package/dist/primitives/page-toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-toolbar.d.ts","sourceRoot":"","sources":["../../src/primitives/page-toolbar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAqB9B;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;WAEuB,KAAK,CAAC,WAAW;YAAU,OAAO;mDAyBjF,CAAA;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;WAEuB,KAAK,CAAC,WAAW;YAAU,OAAO;mDAmBjF,CAAA;AAEF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;sEACkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,IAAI,CAAC,EAAE,KAAK,CAAC,WAAW,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAe,EAAE,SAAS,GACnF,EAAE,iBAAiB,qBAwBnB;AA+ID,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,oDAAoD;IACpD,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,kCAAkC;IAClC,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC3B,oDAAoD;IACpD,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kEAAkE;IAClE,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAClE,MAAa,EAAE,OAAc,EAAE,UAAqB,EAAE,SAAS,EAAE,SAAS,GAC3E,EAAE,gBAAgB,4BA0ElB"}

package/dist/primitives/search-select.d.ts

@@ -36,6 +36,8 @@ export interface SearchSelectProps {
     allowCreate?: boolean;
     /** Label for create action (default: "Add") */
     createLabel?: string;
+    /** Label for the footer's clear action (default: "Clear"). */
+    clearLabel?: string;
     /** Callback when create is clicked. Can be async — component shows optimistic state while waiting. */
     onCreate?: (query: string) => void | Promise<void>;
     /** Custom render for each option */
@@ -49,5 +51,5 @@ export interface SearchSelectProps {
     /** Disabled state */
     disabled?: boolean;
 }
-export declare function SearchSelect({ value, displayValue, onChange, onSearch, placeholder, label, required, debounce, minChars, noResultsLabel, searchingLabel, allowCreate, createLabel, onCreate, renderOption, loadOnOpen, className, disabled, }: SearchSelectProps): React.JSX.Element;
+export declare function SearchSelect({ value, displayValue, onChange, onSearch, placeholder, label, required, debounce, minChars, noResultsLabel, searchingLabel, allowCreate, createLabel, clearLabel, onCreate, renderOption, loadOnOpen, className, disabled, }: SearchSelectProps): React.JSX.Element;
 //# sourceMappingURL=search-select.d.ts.map

package/dist/primitives/search-select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-select.d.ts","sourceRoot":"","sources":["../../src/primitives/search-select.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAQ9B,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,GAAG,CAAA;CACX;AAED,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0CAA0C;IAC1C,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI,KAAK,IAAI,CAAA;IACjE,oEAAoE;IACpE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,EAAE,CAAC,GAAG,kBAAkB,EAAE,CAAA;IACjF,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;0EACsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iCAAiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sGAAsG;IACtG,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,oCAAoC;IACpC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,KAAK,CAAC,SAAS,CAAA;IAC9D;;wEAEoE;IACpE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAMD,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,WAAyB,EACzB,KAAK,EACL,QAAQ,EACR,QAAc,EACd,QAAY,EACZ,cAAc,EACd,cAA+B,EAC/B,WAAW,EACX,WAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,UAAiB,EACjB,SAAS,EACT,QAAQ,GACT,EAAE,iBAAiB,qBA+OnB"}
+{"version":3,"file":"search-select.d.ts","sourceRoot":"","sources":["../../src/primitives/search-select.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAa9B,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,GAAG,CAAA;CACX;AAED,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0CAA0C;IAC1C,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI,KAAK,IAAI,CAAA;IACjE,oEAAoE;IACpE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,EAAE,CAAC,GAAG,kBAAkB,EAAE,CAAA;IACjF,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;0EACsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iCAAiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sGAAsG;IACtG,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,oCAAoC;IACpC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,KAAK,CAAC,SAAS,CAAA;IAC9D;;wEAEoE;IACpE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAMD,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,WAAyB,EACzB,KAAK,EACL,QAAQ,EACR,QAAc,EACd,QAAY,EACZ,cAAc,EACd,cAA+B,EAC/B,WAAW,EACX,WAAmB,EACnB,UAAoB,EACpB,QAAQ,EACR,YAAY,EACZ,UAAiB,EACjB,SAAS,EACT,QAAQ,GACT,EAAE,iBAAiB,qBAySnB"}

package/dist/primitives/sheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sheet.d.ts","sourceRoot":"","sources":["../../src/primitives/sheet.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,eAAe,MAAM,wBAAwB,CAAA;AA8BzD,QAAA,MAAM,KAAK,uCAAuB,CAAA;AAClC,QAAA,MAAM,YAAY,8GAA0B,CAAA;AAC5C,QAAA,MAAM,UAAU,4GAAwB,CAAA;AACxC,QAAA,MAAM,WAAW,6CAAyB,CAAA;AAM1C,QAAA,MAAM,YAAY,8JAYhB,CAAA;AAOF,QAAA,MAAM,YAAY;IAGd,kDAAkD;YAC1C,MAAM;IACd,qCAAqC;gBACzB,OAAO;IACnB,6EAA6E;cACnE,MAAM,GAAG,KAAK,GAAG,MAAM;wCAwBnC,CAAA;AAOF,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,qBAOjF;kBAPQ,WAAW;;;AAcpB,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,qBAOjF;kBAPQ,WAAW;;;AAcpB,QAAA,MAAM,UAAU,oKASd,CAAA;AAOF,QAAA,MAAM,gBAAgB,8KASpB,CAAA;AAOF,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,qBAO/E;kBAPQ,SAAS;;;AAUlB,OAAO,EACL,KAAK,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,WAAW,EACX,UAAU,EACV,gBAAgB,GACjB,CAAA"}
+{"version":3,"file":"sheet.d.ts","sourceRoot":"","sources":["../../src/primitives/sheet.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,eAAe,MAAM,wBAAwB,CAAA;AA8BzD,QAAA,MAAM,KAAK,uCAAuB,CAAA;AAClC,QAAA,MAAM,YAAY,8GAA0B,CAAA;AAC5C,QAAA,MAAM,UAAU,4GAAwB,CAAA;AACxC,QAAA,MAAM,WAAW,6CAAyB,CAAA;AAM1C,QAAA,MAAM,YAAY,8JAYhB,CAAA;AAOF,QAAA,MAAM,YAAY;IAGd,kDAAkD;YAC1C,MAAM;IACd,qCAAqC;gBACzB,OAAO;IACnB,6EAA6E;cACnE,MAAM,GAAG,KAAK,GAAG,MAAM;wCAyCnC,CAAA;AAOF,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,qBAOjF;kBAPQ,WAAW;;;AAcpB,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,qBAOjF;kBAPQ,WAAW;;;AAcpB,QAAA,MAAM,UAAU,oKASd,CAAA;AAOF,QAAA,MAAM,gBAAgB,8KASpB,CAAA;AAOF,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,qBAO/E;kBAPQ,SAAS;;;AAUlB,OAAO,EACL,KAAK,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,WAAW,EACX,UAAU,EACV,gBAAgB,GACjB,CAAA"}

package/dist/primitives/step-progress.d.ts

@@ -0,0 +1,20 @@
+import * as React from 'react';
+export interface StepProgressProps {
+    /** How many steps the flow has. */
+    total: number;
+    /** Zero-based index of the step on screen. */
+    current: number;
+    /** Jump to a step. Only offered for steps already visited. */
+    onSelect?: (index: number) => void;
+    className?: string;
+    'aria-label'?: string;
+}
+/**
+ * Segmented progress rail — one bar per step, filled up to the current one.
+ *
+ * A single continuous bar tells you how far along you are; segments also tell you
+ * how much is LEFT, which is what stops someone abandoning a form they think is
+ * endless. Sits at the bottom of the wizard column, above the footer.
+ */
+export declare function StepProgress({ total, current, onSelect, className, ...rest }: StepProgressProps): React.JSX.Element;
+//# sourceMappingURL=step-progress.d.ts.map

package/dist/primitives/step-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-progress.d.ts","sourceRoot":"","sources":["../../src/primitives/step-progress.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,iBAAiB,qBAiC/F"}

package/dist/primitives/tabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../src/primitives/tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,aAAa,MAAM,sBAAsB,CAAA;AAIrD,QAAA,MAAM,IAAI,gGAAqB,CAAA;AAE/B,QAAA,MAAM,QAAQ,uJAYZ,CAAA;AAGF,QAAA,MAAM,WAAW,gKAYf,CAAA;AAGF,QAAA,MAAM,WAAW,0JAYf,CAAA;AAGF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAA"}
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../src/primitives/tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,aAAa,MAAM,sBAAsB,CAAA;AAIrD,QAAA,MAAM,IAAI,gGAAqB,CAAA;AAE/B,QAAA,MAAM,QAAQ,uJAcZ,CAAA;AAMF,QAAA,MAAM,WAAW,gKAYf,CAAA;AAGF,QAAA,MAAM,WAAW,0JAYf,CAAA;AAGF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAA"}

package/dist/primitives/use-row-selection.d.ts

@@ -0,0 +1,50 @@
+import * as React from 'react';
+import type { BulkAction } from './bulk-action-bar';
+/**
+ * One entry in the bar that appears when rows are ticked. It receives the
+ * selected ROWS, not their ids: an action that has to go back to the store to
+ * learn what it is acting on is an action that can act on stale data.
+ */
+export interface RowBulkAction<T> {
+    id: string;
+    label: string;
+    icon?: React.ComponentType<{
+        className?: string;
+    }>;
+    onSelect: (rows: T[]) => void | Promise<void>;
+    /** Red label. Reserved for what cannot be undone. */
+    destructive?: boolean;
+    /** Moves the action into the "…" menu instead of the button row. */
+    overflow?: boolean;
+    disabled?: boolean;
+}
+export interface UseRowSelectionOptions<T> {
+    /** The rows currently on screen — what a selection may reach. */
+    rows: T[] | null | undefined;
+    actions?: RowBulkAction<T>[];
+    /** Row identity. Defaults to `row.id`. */
+    getRowId?: (row: T) => string;
+    /** Turns checkboxes off even with actions declared (e.g. a card grid, which
+     *  has no row to hang one off). */
+    enabled?: boolean;
+}
+export interface RowSelection<T> {
+    selectedIds: string[];
+    selectedRows: T[];
+    setSelectedIds: (ids: string[]) => void;
+    clear: () => void;
+    /** Ticks every row on screen. */
+    selectAll: () => void;
+    /** Actions bound to the current selection, ready for BulkActionBar. */
+    barActions: BulkAction[];
+    /** Whether to draw the checkbox column at all. */
+    selectable: boolean;
+    /** Selection is on AND something is ticked — the bar is showing. */
+    hasSelection: boolean;
+    /** Resolved row identity, to hand back to DataTable. */
+    getRowId: (row: T) => string;
+    /** How many rows "select all" would reach. */
+    total: number;
+}
+export declare function useRowSelection<T>({ rows, actions, getRowId, enabled, }: UseRowSelectionOptions<T>): RowSelection<T>;
+//# sourceMappingURL=use-row-selection.d.ts.map

package/dist/primitives/use-row-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-row-selection.d.ts","sourceRoot":"","sources":["../../src/primitives/use-row-selection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AASnD;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClD,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,iEAAiE;IACjE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,CAAA;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAA;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAA;IAC7B;uCACmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,YAAY,EAAE,CAAC,EAAE,CAAA;IACjB,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IACvC,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,iCAAiC;IACjC,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,uEAAuE;IACvE,UAAU,EAAE,UAAU,EAAE,CAAA;IACxB,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAA;IACnB,oEAAoE;IACpE,YAAY,EAAE,OAAO,CAAA;IACrB,wDAAwD;IACxD,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAA;IAC5B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,EACjC,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,OAAc,GACf,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAuD7C"}

package/dist/stores/index.d.ts

@@ -1,4 +1,4 @@
 export { useLayoutStore } from './layout.store';
 export { useThemeStore, lightTheme, darkTheme, type ThemeTokens, type SemanticColors, type UIPerceptionTokens, type CreateThemeOptions, } from './theme.store';
-export { usePageHeader, usePageHeaderSlot, usePageHeaderStore, usePageHeaderHost, useHasPageHeaderHost, useHasPageHeaderOutlet, PageHeaderOutlet, } from './page-header.store';
+export { usePageHeader, usePageHeaderSlot, usePageHeaderStore, usePageHeaderHost, useHasPageHeaderHost, useHasPageHeaderBack, useHasPageHeaderOutlet, PageHeaderOutlet, useRegisterPageActions, useHasPageActions, } from './page-header.store';
 //# sourceMappingURL=index.d.ts.map

package/dist/stores/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stores/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EACL,aAAa,EACb,UAAU,EACV,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EACpD,iBAAiB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,gBAAgB,GAClF,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stores/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EACL,aAAa,EACb,UAAU,EACV,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EACpD,iBAAiB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,gBAAgB,EACvG,sBAAsB,EAAE,iBAAiB,GAC1C,MAAM,qBAAqB,CAAA"}

package/dist/stores/page-header.store.d.ts

@@ -5,6 +5,12 @@ interface PageHeaderState {
     /** Identity of whoever owns the slot, so a late unmount can't clear a newer
      *  owner's content — the exact race you get navigating form → form. */
     owner: string | null;
+    /** The claimed header carries a back action, i.e. what the bar is showing is
+     *  a SUBPAGE ("← Contas a Pagar / Nova"), not the module's own screen. The
+     *  module's tab band reads this to step aside: a form reached from a tab is
+     *  not one of the tabs, and leaving the strip up marks a place the user is no
+     *  longer at, one line under a back link that says so. */
+    hasBack: boolean;
     /** How many shells are currently rendering the slot. A page needs to know:
      *  with no host (minimal layout, an embedded form, a modal) its header would
      *  be claimed into the void, and the page must draw it inline instead. */
@@ -19,14 +25,27 @@ interface PageHeaderState {
      * empurrando a trilha do módulo para baixo do topo.
      */
     outlets: number;
-    claim: (owner: string, node: React.ReactNode) => void;
+    /**
+     * Quantos blocos de ações de página estão montados agora. A barra precisa
+     * saber ANTES de decidir se existe: ela some no celular de alguns produtos, e
+     * um "Novo" entregue a uma barra escondida simplesmente não aparecia.
+     */
+    actions: number;
+    claim: (owner: string, node: React.ReactNode, hasBack?: boolean) => void;
     release: (owner: string) => void;
     addHost: () => void;
     removeHost: () => void;
     addOutlet: () => void;
     removeOutlet: () => void;
+    addActions: () => void;
+    removeActions: () => void;
 }
 declare const usePageHeaderStore: import("zustand").UseBoundStore<import("zustand").StoreApi<PageHeaderState>>;
+/** Declara que esta página tem ações no topo. Chamado por PageHeaderActions. */
+export declare function useRegisterPageActions(): void;
+/** Se alguma página tem ações no topo agora. A barra usa para não sumir com
+ *  elas no celular, e para não existir vazia. */
+export declare function useHasPageActions(): boolean;
 /** Read the current override. The shell calls this; pages should not. */
 export declare function usePageHeaderSlot(): React.ReactNode | null;
 /**
@@ -64,6 +83,11 @@ export declare function PageHeaderOutlet({ className }: {
  * The node is re-claimed on every change so a breadcrumb whose label depends on
  * loaded data (a record's name) updates once it arrives.
  */
-export declare function usePageHeader(node: React.ReactNode | null): void;
+export declare function usePageHeader(node: React.ReactNode | null, options?: {
+    back?: boolean;
+}): void;
+/** True while the bar is showing a subpage's "← parent / title". See
+ *  `PageHeaderState.hasBack`. */
+export declare function useHasPageHeaderBack(): boolean;
 export { usePageHeaderStore };
 //# sourceMappingURL=page-header.store.d.ts.map

package/dist/stores/page-header.store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-header.store.d.ts","sourceRoot":"","sources":["../../src/stores/page-header.store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,UAAU,eAAe;IACvB,yEAAyE;IACzE,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAA;IAC5B;2EACuE;IACvE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;;8EAE0E;IAC1E,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;;OAQG;IACH,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAA;IACrD,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAED,QAAA,MAAM,kBAAkB,8EAarB,CAAA;AAEH,yEAAyE;AACzE,wBAAgB,iBAAiB,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAOxC;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;+BAC+B;AAC/B,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAYjG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,GAAG,IAAI,CAahE;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"page-header.store.d.ts","sourceRoot":"","sources":["../../src/stores/page-header.store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,UAAU,eAAe;IACvB,yEAAyE;IACzE,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAA;IAC5B;2EACuE;IACvE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;;;;8DAI0D;IAC1D,OAAO,EAAE,OAAO,CAAA;IAChB;;8EAE0E;IAC1E,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;;OAQG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IACxE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,YAAY,EAAE,MAAM,IAAI,CAAA;IACxB,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,aAAa,EAAE,MAAM,IAAI,CAAA;CAC1B;AAED,QAAA,MAAM,kBAAkB,8EAiBrB,CAAA;AAEH,gFAAgF;AAChF,wBAAgB,sBAAsB,IAAI,IAAI,CAO7C;AAED;iDACiD;AACjD,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAOxC;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;+BAC+B;AAC/B,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAYjG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAc9F;AAED;iCACiC;AACjC,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/styles.css

@@ -286,40 +286,77 @@
 }
 
 /* ---------------------------------------------------------------------------
- * The assistant's floating material.
+ * The floating material — of everything that hovers OVER a page.
  *
- * The FAB and the docked composer are the same object in two shapes, so they
- * are one surface: a tinted fill (the caller's, usually bg-primary), a blurred
- * backdrop, a lit top edge and a shadow deep enough to read as floating ABOVE
- * the page rather than pasted onto it.
+ * Two things do: the assistant (the FAB and the docked composer are the same
+ * object in two shapes) and the page toolbar (period, filters, which widgets).
+ * They were built apart — one glass, one an opaque card with a token blur that
+ * the `.bg-card.border` rule below quietly painted solid anyway — so the same
+ * "I am on top of the grid" claim was made in two materials on the same screen.
+ * One rule, two tints: the assistant takes the brand, the toolbar takes paper.
  *
  * It lives in CSS, not in utility classes, for two reasons: every app gets it
  * without adding Tailwind content globs, and a glass theme extends it through
  * --glass-inner-highlight instead of forking it.
  * ------------------------------------------------------------------------ */
-.fayz-assistant-surface {
+.fayz-assistant-surface,
+.fayz-floating-surface {
   position: relative;
-  border: 1px solid rgb(255 255 255 / 0.22);
-  /* Tinted glass: the page reads through the fill, the blur keeps it from being
-     legible through it. 0.84 is the floor — below that the white label starts
-     losing more contrast than the effect is worth. The utility class the caller
-     passes (bg-primary) stays as the opaque fallback for browsers, or builds,
-     that never see this rule. */
-  background-color: hsl(var(--primary) / 0.84);
-  backdrop-filter: blur(28px) saturate(1.8);
-  -webkit-backdrop-filter: blur(28px) saturate(1.8);
+  /* The blur is what makes the fill work: it turns whatever is underneath into
+     a wash, so the fill can be thin without the content reading through it. */
+  backdrop-filter: blur(40px) saturate(1.8);
+  -webkit-backdrop-filter: blur(40px) saturate(1.8);
   background-clip: padding-box;
+  transition: box-shadow 200ms ease-out, transform 200ms cubic-bezier(0.22, 1, 0.36, 1);
+}
+
+/* Double class on purpose. The caller also passes `bg-primary` as the opaque
+   fallback, and Tailwind's utility layer is emitted AFTER this file — at equal
+   specificity the utility wins, which is how the bar ended up solid with a blur
+   behind an opaque fill doing nothing. */
+.fayz-assistant-surface.fayz-assistant-surface {
+  border: 1px solid rgb(255 255 255 / 0.14);
+  /* Tinted glass: the page reads through the fill. This was 0.84 with a 28px
+     blur — thick enough that it read as a solid bar. The blur above is what
+     buys the extra transparency back: a heavier wash behind the label keeps
+     white legible on a fill this thin. The utility class the caller passes
+     (bg-primary) stays as the opaque fallback for browsers, or builds, that
+     never see this rule. */
+  background-color: hsl(var(--primary) / 0.7);
   box-shadow:
     0 10px 36px -10px rgb(0 0 0 / 0.45),
     0 2px 6px -3px rgb(0 0 0 / 0.3),
     inset 0 1px 0 rgb(255 255 255 / 0.32),
     var(--glass-inner-highlight);
-  transition: box-shadow 200ms ease-out, transform 200ms cubic-bezier(0.22, 1, 0.36, 1);
+}
+
+/* Paper, not brand: this one floats over the content grid and has to let it
+   through without competing with it. Its border is a hairline of the theme's
+   own, since a white edge disappears on a light page. */
+.fayz-floating-surface.fayz-floating-surface {
+  border: 1px solid hsl(var(--border) / 0.55);
+  background-color: hsl(var(--card) / 0.6);
+  box-shadow:
+    0 10px 30px -14px rgb(0 0 0 / 0.3),
+    0 2px 6px -3px rgb(0 0 0 / 0.14),
+    inset 0 1px 0 rgb(255 255 255 / 0.5),
+    var(--glass-inner-highlight);
+}
+
+.dark .fayz-floating-surface.fayz-floating-surface {
+  /* On ink, the lit edge is the border — a theme hairline vanishes into it. */
+  border-color: rgb(255 255 255 / 0.1);
+  box-shadow:
+    0 10px 30px -14px rgb(0 0 0 / 0.6),
+    0 2px 6px -3px rgb(0 0 0 / 0.4),
+    inset 0 1px 0 rgb(255 255 255 / 0.12),
+    var(--glass-inner-highlight);
 }
 
 /* The sheen. Negative z-index paints it over the fill but UNDER the icons and
    text, so the highlight lights the surface instead of washing out its label. */
-.fayz-assistant-surface::after {
+.fayz-assistant-surface::after,
+.fayz-floating-surface::after {
   content: '';
   position: absolute;
   inset: 0;
@@ -614,6 +651,26 @@ select.bg-card,
   to { opacity: 1; transform: translateX(0); }
 }
 
+/* The wizard replays these on every step, so a horizontal slide lands far more
+   often here than in normal navigation. Keep the crossfade, drop the travel. */
+@media (prefers-reduced-motion: reduce) {
+  .saas-nav-forward,
+  .saas-nav-back {
+    animation: page-enter 150ms linear both;
+  }
+}
+
+/* Opacity ONLY — deliberately no transform. Used on full-screen surfaces that
+   position themselves with `fixed`: a transform on the element (or any ancestor)
+   makes it the containing block, and `fixed inset-0` stops meaning the viewport. */
+.saas-fade-in {
+  animation: saas-fade-in 260ms var(--saas-transition-easing) both;
+}
+@keyframes saas-fade-in {
+  from { opacity: 0; }
+  to { opacity: 1; }
+}
+
 /* Sidebar rail push — when the whole left menu swaps context (e.g. app nav →
    settings nav) the incoming rail pulls in from one side while the outgoing
    one slides off the other, iOS-push style. The outgoing pane is absolutely

package/dist/wizard/Wizard.d.ts

@@ -0,0 +1,38 @@
+import * as React from 'react';
+import type { WizardMedia, WizardStepDef, WizardValues } from './types';
+export interface WizardLabels {
+    back: string;
+    next: string;
+    finish: string;
+    exit: string;
+    stepOf: string;
+    exitTitle: string;
+    exitDescription: string;
+    exitConfirm: string;
+    exitCancel: string;
+    /** Badge on a field a `suggest` answered rather than the user. */
+    suggested: string;
+}
+export interface WizardProps {
+    steps: ReadonlyArray<WizardStepDef>;
+    initialValues?: WizardValues;
+    draftKey?: string;
+    onSubmit: (values: WizardValues) => Promise<void> | void;
+    /** Omit to hide the exit affordance — a first-run flow with nowhere to go back to. */
+    onExit?: () => void;
+    /** Brand mark above the question. */
+    logo?: React.ReactNode;
+    /** Panel shown when the current step declares no media of its own. */
+    fallbackMedia?: WizardMedia;
+    labels?: Partial<WizardLabels>;
+    className?: string;
+}
+/**
+ * Fullscreen, data-driven wizard: form column on the left, media panel on the right.
+ *
+ * Steps and fields are plain data (`WizardStepDef[]`), so a flow changes by editing
+ * a list rather than a component — which is the whole point for questionnaires that
+ * get reworded every time we learn something about a vertical.
+ */
+export declare function Wizard({ steps, initialValues, draftKey, onSubmit, onExit, logo, fallbackMedia, labels, className, }: WizardProps): React.JSX.Element | null;
+//# sourceMappingURL=Wizard.d.ts.map

package/dist/wizard/Wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wizard.d.ts","sourceRoot":"","sources":["../../src/wizard/Wizard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAS9B,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEvE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAA;CAClB;AAgBD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IACnC,aAAa,CAAC,EAAE,YAAY,CAAA;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACxD,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,qCAAqC;IACrC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,sEAAsE;IACtE,aAAa,CAAC,EAAE,WAAW,CAAA;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAyBD;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,EACrB,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,GACzF,EAAE,WAAW,4BAgMb"}

package/dist/wizard/WizardField.d.ts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+import type { WizardFieldDef, WizardValues } from './types';
+export interface WizardFieldProps {
+    field: WizardFieldDef;
+    values: WizardValues;
+    onChange: (id: string, value: unknown) => void;
+    /** Async/validation message resolved by the wizard for this field. */
+    error?: string | null;
+    autoFocus?: boolean;
+    /** This field owns the 1–9 keys on this step. Only one field may. */
+    shortcuts?: boolean;
+    /** This field's `suggest` is in flight. */
+    busy?: boolean;
+    /** The value on screen came from a suggestion, not from the user. */
+    suggested?: boolean;
+    /** Discard the suggestion. Only rendered when `suggested`. */
+    onClearSuggestion?: () => void;
+    /** Text on the badge that marks a suggested answer. */
+    suggestedLabel?: string;
+}
+export declare function WizardField({ field, values, onChange, error, autoFocus, shortcuts, busy, suggested, onClearSuggestion, suggestedLabel, }: WizardFieldProps): React.JSX.Element;
+//# sourceMappingURL=WizardField.d.ts.map

package/dist/wizard/WizardField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WizardField.d.ts","sourceRoot":"","sources":["../../src/wizard/WizardField.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAO9B,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,cAAc,CAAA;IACrB,MAAM,EAAE,YAAY,CAAA;IACpB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9C,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAaD,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,MAAM,EACN,QAAQ,EACR,KAAK,EACL,SAAS,EACT,SAAS,EACT,IAAI,EACJ,SAAS,EACT,iBAAiB,EACjB,cAAc,GACf,EAAE,gBAAgB,qBAuHlB"}

package/dist/wizard/index.d.ts

@@ -0,0 +1,6 @@
+export { Wizard, type WizardProps, type WizardLabels } from './Wizard';
+export { WizardField, type WizardFieldProps } from './WizardField';
+export { useWizard, type UseWizardOptions, type UseWizardResult } from './useWizard';
+export { canAdvance, fieldErrors, isEmpty, parseDraft, visibleFields, visibleSteps, type WizardDraft, } from './logic';
+export type { WizardFieldDef, WizardFieldKind, WizardMedia, WizardRenderContext, WizardStepDef, WizardValues, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/wizard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wizard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAA;AACtE,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AACpF,OAAO,EACL,UAAU,EACV,WAAW,EACX,OAAO,EACP,UAAU,EACV,aAAa,EACb,YAAY,EACZ,KAAK,WAAW,GACjB,MAAM,SAAS,CAAA;AAChB,YAAY,EACV,cAAc,EACd,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,YAAY,GACb,MAAM,SAAS,CAAA"}

package/dist/wizard/index.js

@@ -0,0 +1,5 @@
+export { Wizard, WizardField, canAdvance, fieldErrors, isEmpty, parseDraft, useWizard, visibleFields, visibleSteps } from '../chunk-AASANYXN.js';
+import '../chunk-3OVZ5JJQ.js';
+import '../chunk-OKZ6WQB3.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/wizard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/wizard/logic.d.ts

@@ -0,0 +1,39 @@
+import type { WizardFieldDef, WizardStepDef, WizardValues } from './types';
+/**
+ * The wizard's decisions, without React.
+ *
+ * Which steps show, which fields show, what blocks the button — all of it is a
+ * function of the answers, so it lives here where it can be tested directly
+ * instead of through a rendered component.
+ */
+export declare function isEmpty(value: unknown): boolean;
+export declare function visibleSteps(steps: ReadonlyArray<WizardStepDef>, values: WizardValues): ReadonlyArray<WizardStepDef>;
+export declare function visibleFields(step: WizardStepDef | undefined, values: WizardValues): ReadonlyArray<WizardFieldDef>;
+/**
+ * Per-field messages for the current step.
+ *
+ * An untouched required field gets no message: a red line before someone has had
+ * a chance to type reads as a failure they caused. The disabled button says the
+ * same thing without the accusation — see `canAdvance`.
+ */
+export declare function fieldErrors(fields: ReadonlyArray<WizardFieldDef>, values: WizardValues, asyncErrors?: Record<string, string | null>): Record<string, string | null>;
+export declare function canAdvance(step: WizardStepDef | undefined, fields: ReadonlyArray<WizardFieldDef>, values: WizardValues, errors: Record<string, string | null>): boolean;
+/**
+ * Which of a `suggest`'s answers may actually land.
+ *
+ * Three refusals, each for its own reason: a field nobody asks about would sit
+ * in the answers invisibly and still get submitted; a field the user has
+ * answered is theirs, and a slow reply must not overwrite what they typed while
+ * waiting for it; an empty value would mark a field as "suggested" while
+ * changing nothing on screen.
+ */
+export declare function acceptableSuggestion(patch: WizardValues, knownFieldIds: ReadonlySet<string>, answered: ReadonlySet<string>): WizardValues;
+/** Every field id the flow asks about, across all steps — visible or not. */
+export declare function allFieldIds(steps: ReadonlyArray<WizardStepDef>): Set<string>;
+export interface WizardDraft {
+    index: number;
+    values: WizardValues;
+}
+/** Tolerant on purpose: a corrupt draft is a fresh start, never a crash. */
+export declare function parseDraft(raw: string | null): WizardDraft | null;
+//# sourceMappingURL=logic.d.ts.map

package/dist/wizard/logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logic.d.ts","sourceRoot":"","sources":["../../src/wizard/logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE1E;;;;;;GAMG;AAEH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK/C;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,EACnC,MAAM,EAAE,YAAY,GACnB,aAAa,CAAC,aAAa,CAAC,CAE9B;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,aAAa,GAAG,SAAS,EAC/B,MAAM,EAAE,YAAY,GACnB,aAAa,CAAC,cAAc,CAAC,CAE/B;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,EACrC,MAAM,EAAE,YAAY,EACpB,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAM,GAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAO/B;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,aAAa,GAAG,SAAS,EAC/B,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,EACrC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GACpC,OAAO,CAKT;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,EAClC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,YAAY,CASd;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAE5E;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,YAAY,CAAA;CACrB;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI,CASjE"}