@seedgrid/fe-components 2026.8.5 → 2026.8.7

package/dist/commons/SgSkeleton.meta.js

@@ -60,9 +60,9 @@ export const sgMeta = {
     states: ["loading", "static"],
     examples: [
         {
-            id: "basic",
-            title: "Basico",
-            file: "apps/showcase/src/app/components/sg-skeleton/samples/basico.tsx.sample",
+            id: "basic-shapes",
+            title: "Formas basicas",
+            file: "apps/showcase/src/app/components/sg-skeleton/samples/basic-shapes.tsx.sample",
             kind: "sample"
         },
         {

package/dist/commons/SgToastHost.meta.js

@@ -18,7 +18,7 @@ export const sgMeta = {
     ],
     states: ["inactive", "active-host"],
     examples: [
-        { id: "basic", title: "Basico", file: "apps/showcase/src/app/components/sg-toast-host/samples/basico.tsx.sample", kind: "sample" },
+        { id: "base-setup", title: "Setup basico", file: "apps/showcase/src/app/components/sg-toast-host/samples/base-setup.tsx.sample", kind: "sample" },
         { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/sg-toast-host/sg-toast-host.tsx.playground", kind: "playground" }
     ],
     showcase: { route: "/components/sg-toast-host", hasPlayground: true, hasPropsTable: true },

package/dist/commons/SgToaster.meta.js

@@ -21,7 +21,7 @@ export const sgMeta = {
     ],
     states: ["idle", "showing-toasts"],
     examples: [
-        { id: "basic", title: "Basico", file: "apps/showcase/src/app/components/sg-toaster/samples/basico.tsx.sample", kind: "sample" },
+        { id: "base-setup", title: "Setup basico", file: "apps/showcase/src/app/components/sg-toaster/samples/base-setup.tsx.sample", kind: "sample" },
         { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/sg-toaster/sg-toaster.tsx.playground", kind: "playground" }
     ],
     showcase: { route: "/components/sg-toaster", hasPlayground: true, hasPropsTable: true },

package/dist/commons/SgWhistleHost.meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SgWhistleHost.meta.d.ts","sourceRoot":"","sources":["../../src/commons/SgWhistleHost.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,MAAM,EAAE,QA2BpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAoBrB,CAAC"}
+{"version":3,"file":"SgWhistleHost.meta.d.ts","sourceRoot":"","sources":["../../src/commons/SgWhistleHost.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,MAAM,EAAE,QA4BpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAoBrB,CAAC"}

package/dist/commons/SgWhistleHost.meta.js

@@ -13,6 +13,7 @@ export const sgMeta = {
     fieldSemantics: ["alertHost", "persistentFeedback", "stackedAlerts"],
     props: [
         { name: "max", type: "number", default: 4, description: "Quantidade maxima de whistle items visiveis neste host.", semanticRole: "behavior", bindable: true },
+        { name: "duration", type: "number", default: 4000, description: "Duracao padrao aplicada aos whistles deste host, em milissegundos (mesmo default do SgToastHost). Cada whistle sobrescreve com options.duration, que tem prioridade; use 0 (ou negativo) para que nada suma sozinho. Whistle 'loading' nunca expira. Com varios hosts montados, vale o do host ATIVO (o ultimo montado).", semanticRole: "behavior", bindable: true },
         { name: "newestOnTop", type: "boolean", default: false, description: "Inverte a ordem visual para mostrar os mais novos primeiro.", semanticRole: "behavior", bindable: true },
         { name: "gap", type: "number", default: 12, description: "Espacamento entre os avisos renderizados.", semanticRole: "appearance", bindable: true },
         { name: "rounded", type: "boolean", default: true, description: "Arredonda os cantos de cada whistle (desligue para cantos retos).", semanticRole: "appearance", bindable: true }

package/dist/commons/SgWhistler.d.ts

@@ -9,6 +9,16 @@ export type SgWhistlerProps = Omit<React.HTMLAttributes<HTMLDivElement>, "childr
     max?: number;
     newestOnTop?: boolean;
     gap?: number;
+    /**
+     * Duracao padrao, em milissegundos, dos whistles deste host. Cada whistle pode sobrescrever
+     * com `options.duration`, que tem PRIORIDADE. Use 0 (ou negativo) para que nada suma sozinho
+     * por padrao. Whistle `loading` nunca expira, qualquer que seja o valor.
+     *
+     * Espelha o `duration` do SgToaster/SgToastHost — mesmo default e mesma precedencia. Antes o
+     * valor era fixo no codigo e nao havia como mudar o padrao sem repetir `duration` em toda
+     * chamada de sgWhistle.
+     */
+    duration?: number;
     /** Arredonda os cantos de cada whistle (rounded-lg). Desligue para cantos retos. */
     rounded?: boolean;
     customColors?: Partial<Record<SgWhistleSeverity, SgWhistleColors>>;

package/dist/commons/SgWhistler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SgWhistler.d.ts","sourceRoot":"","sources":["../../src/commons/SgWhistler.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAOrB,KAAK,eAAe,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,GAAG;IACrF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC,CAAC;CACpE,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,wBAA6B,CAAC;AA2GhE,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,kDA6IhD"}
+{"version":3,"file":"SgWhistler.d.ts","sourceRoot":"","sources":["../../src/commons/SgWhistler.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAOrB,KAAK,eAAe,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,GAAG;IACrF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC,CAAC;CACpE,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,wBAA6B,CAAC;AA2GhE,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,kDAiJhD"}

package/dist/commons/SgWhistler.js

@@ -96,7 +96,11 @@ function renderWhistleContent(whistle) {
 }
 export function SgWhistler(props) {
     const renderedByHost = React.useContext(SgWhistlerHostContext);
-    const { max = 4, newestOnTop = false, gap = 12, rounded = true, customColors, className, style, ...rest } = props;
+    const { max = 4, 
+    // Mesmo default do SgToaster: os dois pares (toast/host e whistle/host) expoem o mesmo
+    // contrato de duracao, entao o numero tambem tem que bater. O 5000 anterior era um valor
+    // cravado no efeito, sem prop e sem documentacao — nao uma escolha.
+    duration = 4000, newestOnTop = false, gap = 12, rounded = true, customColors, className, style, ...rest } = props;
     const i18n = useComponentsI18n();
     const [whistles, setWhistles] = React.useState([]);
     const timersRef = React.useRef({});
@@ -126,7 +130,7 @@ export function SgWhistler(props) {
             if (whistle.severity === "loading") {
                 return;
             }
-            const timeout = whistle.duration ?? 5000;
+            const timeout = whistle.duration ?? duration;
             if (timeout <= 0) {
                 return;
             }
@@ -142,7 +146,7 @@ export function SgWhistler(props) {
             clearTimeout(timeoutRef);
             delete timersRef.current[id];
         });
-    }, [visible]);
+    }, [visible, duration]);
     React.useEffect(() => {
         return () => {
             Object.values(timersRef.current).forEach((timeoutRef) => clearTimeout(timeoutRef));
@@ -163,6 +167,6 @@ export function SgWhistler(props) {
                 }, role: "status", "aria-live": "polite", children: [whistle.icon ? _jsx("div", { className: "shrink-0 pt-0.5", children: whistle.icon }) : null, renderWhistleContent(whistle), whistle.action ? (_jsx("button", { type: "button", className: "shrink-0 rounded border border-current/25 px-2 py-1 text-xs font-medium", onClick: () => {
                             whistle.action?.onClick();
                             dismissSgWhistle(whistle.id);
-                        }, children: whistle.action.label })) : null, dismissible ? (_jsx("button", { type: "button", className: "shrink-0 rounded px-1 py-0.5 text-sm leading-none opacity-80", "aria-label": t(i18n, "components.toaster.close"), onClick: () => dismissSgWhistle(whistle.id), children: "x" })) : null] }, whistle.id));
+                        }, children: whistle.action.label })) : null, dismissible ? (_jsx("button", { type: "button", className: "shrink-0 rounded px-1 py-0.5 text-sm leading-none opacity-80", "aria-label": t(i18n, "components.whistler.close"), onClick: () => dismissSgWhistle(whistle.id), children: "x" })) : null] }, whistle.id));
         }) }));
 }

package/dist/commons/SgWhistler.meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SgWhistler.meta.d.ts","sourceRoot":"","sources":["../../src/commons/SgWhistler.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,MAAM,EAAE,QA2BpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAmBrB,CAAC"}
+{"version":3,"file":"SgWhistler.meta.d.ts","sourceRoot":"","sources":["../../src/commons/SgWhistler.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,MAAM,EAAE,QA4BpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAmBrB,CAAC"}

package/dist/commons/SgWhistler.meta.js

@@ -13,6 +13,7 @@ export const sgMeta = {
     fieldSemantics: ["alertRenderer", "persistentFeedback", "stackedAlerts"],
     props: [
         { name: "max", type: "number", default: 4, description: "Quantidade maxima de whistle items visiveis.", semanticRole: "behavior", bindable: true },
+        { name: "duration", type: "number", default: 4000, description: "Duracao padrao dos whistles em milissegundos (mesmo default do SgToaster). Cada whistle sobrescreve com options.duration, que tem prioridade; use 0 (ou negativo) para que nada suma sozinho. Whistle 'loading' nunca expira.", semanticRole: "behavior", bindable: true },
         { name: "newestOnTop", type: "boolean", default: false, description: "Inverte a ordem visual para mostrar os mais novos primeiro.", semanticRole: "behavior", bindable: true },
         { name: "gap", type: "number", default: 12, description: "Espacamento entre os avisos renderizados.", semanticRole: "appearance", bindable: true },
         { name: "rounded", type: "boolean", default: true, description: "Arredonda os cantos de cada whistle (desligue para cantos retos).", semanticRole: "appearance", bindable: true }

package/dist/commons/dismissSgToast.meta.js

@@ -25,18 +25,18 @@ export const sgMeta = {
         {
             id: "dismiss-one",
             title: "Fechar um toast especifico",
-            file: "apps/showcase/src/app/components/toasts/samples/dismiss-one.tsx.sample",
+            file: "apps/showcase/src/app/components/sg-toaster/samples/dismiss-one.tsx.sample",
             kind: "sample"
         },
         {
             id: "dismiss-all",
             title: "Fechar todos os toasts",
-            file: "apps/showcase/src/app/components/toasts/samples/dismiss-all.tsx.sample",
+            file: "apps/showcase/src/app/components/sg-toaster/samples/dismiss-all.tsx.sample",
             kind: "sample"
         }
     ],
     showcase: {
-        route: "/components/toasts",
+        route: "/components/sg-toaster",
         hasPlayground: true,
         hasPropsTable: true
     }

package/dist/commons/dismissSgWhistle.meta.js

@@ -25,18 +25,18 @@ export const sgMeta = {
         {
             id: "dismiss-one",
             title: "Fechar um whistle especifico",
-            file: "apps/showcase/src/app/components/whistles/samples/dismiss-one.tsx.sample",
+            file: "apps/showcase/src/app/components/sg-whistler/samples/dismiss-one.tsx.sample",
             kind: "sample"
         },
         {
             id: "dismiss-all",
             title: "Fechar todos os whistles",
-            file: "apps/showcase/src/app/components/whistles/samples/dismiss-all.tsx.sample",
+            file: "apps/showcase/src/app/components/sg-whistler/samples/dismiss-all.tsx.sample",
             kind: "sample"
         }
     ],
     showcase: {
-        route: "/components/whistles",
+        route: "/components/sg-whistler",
         hasPlayground: true,
         hasPropsTable: true
     }

package/dist/commons/subscribeSgToasts.meta.js

@@ -26,18 +26,18 @@ export const sgMeta = {
         {
             id: "basic",
             title: "Monitorar mudancas de toasts",
-            file: "apps/showcase/src/app/components/toasts/samples/subscribe.tsx.sample",
+            file: "apps/showcase/src/app/components/sg-toaster/samples/subscribe.tsx.sample",
             kind: "sample"
         },
         {
             id: "in-effect",
             title: "Usar em useEffect",
-            file: "apps/showcase/src/app/components/toasts/samples/subscribe-effect.tsx.sample",
+            file: "apps/showcase/src/app/components/sg-toaster/samples/subscribe-effect.tsx.sample",
             kind: "sample"
         }
     ],
     showcase: {
-        route: "/components/toasts",
+        route: "/components/sg-toaster",
         hasPlayground: false,
         hasPropsTable: true
     }

package/dist/commons/subscribeSgWhistles.meta.js

@@ -26,18 +26,18 @@ export const sgMeta = {
         {
             id: "basic",
             title: "Monitorar mudancas de whistles",
-            file: "apps/showcase/src/app/components/whistles/samples/subscribe.tsx.sample",
+            file: "apps/showcase/src/app/components/sg-whistler/samples/subscribe.tsx.sample",
             kind: "sample"
         },
         {
             id: "in-effect",
             title: "Usar em useEffect",
-            file: "apps/showcase/src/app/components/whistles/samples/subscribe-effect.tsx.sample",
+            file: "apps/showcase/src/app/components/sg-whistler/samples/subscribe-effect.tsx.sample",
             kind: "sample"
         }
     ],
     showcase: {
-        route: "/components/whistles",
+        route: "/components/sg-whistler",
         hasPlayground: false,
         hasPropsTable: true
     }

package/dist/commons/toast.meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toast.meta.d.ts","sourceRoot":"","sources":["../../src/commons/toast.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,MAAM,EAAE,QA6GpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WA4BrB,CAAC"}
+{"version":3,"file":"toast.meta.d.ts","sourceRoot":"","sources":["../../src/commons/toast.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,MAAM,EAAE,QAkIpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WA4BrB,CAAC"}

package/dist/commons/toast.meta.js

@@ -45,8 +45,11 @@ export const sgMeta = {
         {
             name: "options.duration",
             type: "number",
-            default: 3000,
-            description: "Duracao em milissegundos antes de auto-fechar (0 = permanente).",
+            // SEM default de proposito: a opcao por toast nao tem valor proprio no codigo
+            // (`toast.duration ?? duration`), quem tem default e' o host. O antigo `default: 3000`
+            // era um terceiro numero que nao existe em lugar nenhum. Espelha `options.duration` do
+            // sgWhistle, que ja' era assim.
+            description: "Duracao em milissegundos deste toast; tem PRIORIDADE sobre o host. Omitir NAO significa permanente: cai no `duration` do SgToaster/SgToastHost, cujo default e' 4000 (4s), igual ao par whistle/SgWhistleHost. Use 0 (ou negativo) para permanente, ate' o usuario fechar. Toast do tipo 'loading' nunca fecha sozinho, qualquer que seja o valor.",
             semanticRole: "behavior",
             bindable: true
         },
@@ -83,26 +86,44 @@ export const sgMeta = {
     states: ["success", "error", "warning", "info", "loading", "default"],
     examples: [
         {
-            id: "basic",
-            title: "Toast simples",
-            file: "apps/showcase/src/app/components/toasts/samples/basic.tsx.sample",
+            id: "base-setup",
+            title: "Setup basico (host + toast)",
+            file: "apps/showcase/src/app/components/sg-toaster/samples/base-setup.tsx.sample",
             kind: "sample"
         },
         {
-            id: "with-action",
-            title: "Toast com acao",
-            file: "apps/showcase/src/app/components/toasts/samples/with-action.tsx.sample",
+            id: "toast-types",
+            title: "Tipos de toast",
+            file: "apps/showcase/src/app/components/sg-toaster/samples/toast-types.tsx.sample",
             kind: "sample"
         },
         {
-            id: "promise",
+            id: "options-per-toast",
+            title: "Opcoes por toast (duration, etc.)",
+            file: "apps/showcase/src/app/components/sg-toaster/samples/options-per-toast.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "actions-and-custom-toast",
+            title: "Acao e toast customizado",
+            file: "apps/showcase/src/app/components/sg-toaster/samples/actions-and-custom-toast.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "loading-by-id-update-same-toast",
+            title: "Loading atualizado pelo id",
+            file: "apps/showcase/src/app/components/sg-toaster/samples/loading-by-id-update-same-toast.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "toast-promise",
             title: "Toast com promise",
-            file: "apps/showcase/src/app/components/toasts/samples/promise.tsx.sample",
+            file: "apps/showcase/src/app/components/sg-toaster/samples/toast-promise.tsx.sample",
             kind: "sample"
         }
     ],
     showcase: {
-        route: "/components/toasts",
+        route: "/components/sg-toaster",
         hasPlayground: true,
         hasPropsTable: true
     }

package/dist/commons/whistle.meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"whistle.meta.d.ts","sourceRoot":"","sources":["../../src/commons/whistle.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,MAAM,EAAE,QAyIpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WA4BrB,CAAC"}
+{"version":3,"file":"whistle.meta.d.ts","sourceRoot":"","sources":["../../src/commons/whistle.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,MAAM,EAAE,QA2JpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WA4BrB,CAAC"}

package/dist/commons/whistle.meta.js

@@ -52,7 +52,7 @@ export const sgMeta = {
         {
             name: "options.duration",
             type: "number",
-            description: "Duracao em milissegundos (0 = permanente, padrao = permanente).",
+            description: "Duracao em milissegundos deste whistle; tem PRIORIDADE sobre o host. Omitir NAO significa permanente: cai no `duration` do SgWhistler/SgWhistleHost, cujo default e' 4000 (4s), igual ao par toast/SgToastHost. Use 0 (ou negativo) para permanente, ate' o usuario fechar no x — obrigatorio quando o aviso bloqueia uma acao ou carrega um botao de acao, porque sumir leva embora a informacao e o caminho de saida junto. Severidade 'loading' nunca expira sozinha.",
             semanticRole: "behavior",
             bindable: true
         },
@@ -111,26 +111,44 @@ export const sgMeta = {
     states: ["default", "success", "info", "warning", "error", "loading"],
     examples: [
         {
-            id: "basic",
-            title: "Whistle simples",
-            file: "apps/showcase/src/app/components/whistles/samples/basic.tsx.sample",
+            id: "base-setup",
+            title: "Setup basico (host + sgWhistle)",
+            file: "apps/showcase/src/app/components/sg-whistler/samples/base-setup.tsx.sample",
             kind: "sample"
         },
         {
-            id: "with-action",
-            title: "Whistle com acao",
-            file: "apps/showcase/src/app/components/whistles/samples/with-action.tsx.sample",
+            id: "severities-and-stack",
+            title: "Severidades e empilhamento",
+            file: "apps/showcase/src/app/components/sg-whistler/samples/severities-and-stack.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "actions-border-opacity",
+            title: "Acao, borda e opacidade",
+            file: "apps/showcase/src/app/components/sg-whistler/samples/actions-border-opacity.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "update-by-id",
+            title: "Substituir/atualizar pelo id",
+            file: "apps/showcase/src/app/components/sg-whistler/samples/update-by-id.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "custom-renderer-and-colors",
+            title: "Renderer e cores customizados",
+            file: "apps/showcase/src/app/components/sg-whistler/samples/custom-renderer-and-colors.tsx.sample",
             kind: "sample"
         },
         {
             id: "promise",
             title: "Whistle com promise",
-            file: "apps/showcase/src/app/components/whistles/samples/promise.tsx.sample",
+            file: "apps/showcase/src/app/components/sg-whistler/samples/promise.tsx.sample",
             kind: "sample"
         }
     ],
     showcase: {
-        route: "/components/whistles",
+        route: "/components/sg-whistler",
         hasPlayground: true,
         hasPropsTable: true
     }

package/dist/digits/fade-digit/SgFadeDigit.meta.js

@@ -20,7 +20,7 @@ export const sgMeta = {
     ],
     states: ["idle", "animating"],
     examples: [
-        { id: "basic", title: "Basico", file: "apps/showcase/src/app/components/digits/sg-fade-digit/samples/basico.tsx.sample", kind: "sample" },
+        { id: "basico-0-9", title: "Basico (0-9)", file: "apps/showcase/src/app/components/digits/sg-fade-digit/samples/basico-0-9.tsx.sample", kind: "sample" },
         { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/digits/sg-fade-digit/sg-fade-digit.tsx.playground", kind: "playground" }
     ],
     showcase: { route: "/components/digits/sg-fade-digit", hasPlayground: true, hasPropsTable: true },

package/dist/digits/matrix-digit/SgMatrixDigit.meta.js

@@ -20,7 +20,7 @@ export const sgMeta = {
     ],
     states: ["idle", "animating"],
     examples: [
-        { id: "basic", title: "Basico", file: "apps/showcase/src/app/components/digits/sg-matrix-digit/samples/basico.tsx.sample", kind: "sample" },
+        { id: "basico-0-9", title: "Basico (0-9)", file: "apps/showcase/src/app/components/digits/sg-matrix-digit/samples/basico-0-9.tsx.sample", kind: "sample" },
         { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/digits/sg-matrix-digit/sg-matrix-digit.tsx.playground", kind: "playground" }
     ],
     showcase: { route: "/components/digits/sg-matrix-digit", hasPlayground: true, hasPropsTable: true },

package/dist/digits/roller3d-digit/SgRoller3DDigit.meta.js

@@ -20,7 +20,7 @@ export const sgMeta = {
     ],
     states: ["idle", "animating"],
     examples: [
-        { id: "basic", title: "Basico", file: "apps/showcase/src/app/components/digits/sg-roller3d-digit/samples/basico.tsx.sample", kind: "sample" },
+        { id: "basico-0-9", title: "Basico (0-9)", file: "apps/showcase/src/app/components/digits/sg-roller3d-digit/samples/basico-0-9.tsx.sample", kind: "sample" },
         { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/digits/sg-roller3d-digit/sg-roller3d-digit.tsx.playground", kind: "playground" }
     ],
     showcase: { route: "/components/digits/sg-roller3d-digit", hasPlayground: true, hasPropsTable: true },

package/dist/digits/segment-digit/SgSegmentDigit.meta.js

@@ -20,7 +20,7 @@ export const sgMeta = {
     ],
     states: ["idle"],
     examples: [
-        { id: "basic", title: "Basico", file: "apps/showcase/src/app/components/digits/sg-segment-digit/samples/basico.tsx.sample", kind: "sample" },
+        { id: "basico-0-9", title: "Basico (0-9)", file: "apps/showcase/src/app/components/digits/sg-segment-digit/samples/basico-0-9.tsx.sample", kind: "sample" },
         { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/digits/sg-segment-digit/sg-segment-digit.tsx.playground", kind: "playground" }
     ],
     showcase: { route: "/components/digits/sg-segment-digit", hasPlayground: true, hasPropsTable: true },

package/dist/digits/seven-segment-digit/SgSevenSegmentDigit.meta.js

@@ -20,7 +20,7 @@ export const sgMeta = {
     ],
     states: ["idle"],
     examples: [
-        { id: "basic", title: "Basico", file: "apps/showcase/src/app/components/digits/sg-seven-segment-digit/samples/basico.tsx.sample", kind: "sample" },
+        { id: "basico-0-9", title: "Basico (0-9)", file: "apps/showcase/src/app/components/digits/sg-seven-segment-digit/samples/basico-0-9.tsx.sample", kind: "sample" },
         { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/digits/sg-seven-segment-digit/sg-seven-segment-digit.tsx.playground", kind: "playground" }
     ],
     showcase: { route: "/components/digits/sg-seven-segment-digit", hasPlayground: true, hasPropsTable: true },

package/dist/environment/useSgEnvironment.meta.js

@@ -51,15 +51,15 @@ export const sgMeta = {
     states: ["default", "custom", "persisted"],
     examples: [
         {
-            id: "basic",
-            title: "Acessar config de ambiente",
-            file: "apps/showcase/src/app/components/hooks/use-sg-environment/samples/basic.tsx.sample",
+            id: "default-sem-provider",
+            title: "Default sem provider",
+            file: "apps/showcase/src/app/components/hooks/use-sg-environment/samples/default-sem-provider.tsx.sample",
             kind: "sample"
         },
         {
-            id: "with-namespace",
-            title: "Com namespace customizado",
-            file: "apps/showcase/src/app/components/hooks/use-sg-environment/samples/with-namespace.tsx.sample",
+            id: "com-provider",
+            title: "Com provider",
+            file: "apps/showcase/src/app/components/hooks/use-sg-environment/samples/com-provider.tsx.sample",
             kind: "sample"
         }
     ],

package/dist/environment/useSgNamespaceProvider.meta.js

@@ -25,12 +25,12 @@ export const sgMeta = {
         {
             id: "basic",
             title: "Obter namespace atual",
-            file: "apps/showcase/src/app/components/hooks/use-sg-namespace-provider/samples/basic.tsx.sample",
+            file: "apps/showcase/src/app/components/providers/sg-environment-provider/samples/namespace-provider-hook.tsx.sample",
             kind: "sample"
         }
     ],
     showcase: {
-        route: "/components/hooks/use-sg-namespace-provider",
+        route: "/components/providers/sg-environment-provider",
         hasPlayground: false,
         hasPropsTable: true
     }

package/dist/environment/useSgPersistence.meta.js

@@ -65,15 +65,15 @@ export const sgMeta = {
     states: ["idle", "loading", "saving", "error"],
     examples: [
         {
-            id: "basic",
-            title: "Carregar e salvar estado",
-            file: "apps/showcase/src/app/components/hooks/use-sg-persistence/samples/basic.tsx.sample",
+            id: "uso-basico",
+            title: "Uso basico",
+            file: "apps/showcase/src/app/components/hooks/use-sg-persistence/samples/uso-basico.tsx.sample",
             kind: "sample"
         },
         {
-            id: "form-state",
-            title: "Persistir estado de formulario",
-            file: "apps/showcase/src/app/components/hooks/use-sg-persistence/samples/form-state.tsx.sample",
+            id: "quando-usar-vs-persistent-state",
+            title: "Quando usar vs useSgPersistentState",
+            file: "apps/showcase/src/app/components/hooks/use-sg-persistence/samples/quando-usar-vs-persistent-state.tsx.sample",
             kind: "sample"
         }
     ],

package/dist/environment/useSgPersistentState.meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSgPersistentState.meta.d.ts","sourceRoot":"","sources":["../../src/environment/useSgPersistentState.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,MAAM,EAAE,QAsFpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WA2BrB,CAAC"}
+{"version":3,"file":"useSgPersistentState.meta.d.ts","sourceRoot":"","sources":["../../src/environment/useSgPersistentState.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,MAAM,EAAE,QA4FpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WA2BrB,CAAC"}

package/dist/environment/useSgPersistentState.meta.js

@@ -60,21 +60,27 @@ export const sgMeta = {
     states: ["loading", "loaded", "saving", "error"],
     examples: [
         {
-            id: "basic",
-            title: "Estado persistido simples",
-            file: "apps/showcase/src/app/components/hooks/use-sg-persistent-state/samples/basic.tsx.sample",
+            id: "uso-basico",
+            title: "Uso basico",
+            file: "apps/showcase/src/app/components/hooks/use-sg-persistent-state/samples/uso-basico.tsx.sample",
             kind: "sample"
         },
         {
-            id: "with-serialization",
-            title: "Com serializacao customizada",
-            file: "apps/showcase/src/app/components/hooks/use-sg-persistent-state/samples/with-serialization.tsx.sample",
+            id: "serializacao-customizada",
+            title: "Serializacao customizada",
+            file: "apps/showcase/src/app/components/hooks/use-sg-persistent-state/samples/serialize-e-deserialize-customizados.tsx.sample",
             kind: "sample"
         },
         {
-            id: "form-state",
-            title: "Estado persistido de formulario",
-            file: "apps/showcase/src/app/components/hooks/use-sg-persistent-state/samples/form-state.tsx.sample",
+            id: "com-isolamento-por-namespace",
+            title: "Isolamento por namespace",
+            file: "apps/showcase/src/app/components/hooks/use-sg-persistent-state/samples/com-isolamento-por-namespace.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "versionamento-de-estado",
+            title: "Versionamento de estado",
+            file: "apps/showcase/src/app/components/hooks/use-sg-persistent-state/samples/versionamento-de-estado.tsx.sample",
             kind: "sample"
         }
     ],

package/dist/gadgets/calendar/SgCalendar.meta.js

@@ -23,7 +23,7 @@ export const sgMeta = {
     ],
     states: ["default", "multi-month", "disabled-dates", "controlled"],
     examples: [
-        { id: "basic", title: "Basico", file: "apps/showcase/src/app/components/gadgets/sg-calendar/samples/basico.tsx.sample", kind: "sample" },
+        { id: "basico-mes-atual", title: "Basico (mes atual)", file: "apps/showcase/src/app/components/gadgets/sg-calendar/samples/basico-mes-atual.tsx.sample", kind: "sample" },
         { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/gadgets/sg-calendar/sg-calendar.tsx.playground", kind: "playground" }
     ],
     showcase: { route: "/components/gadgets/sg-calendar", hasPlayground: true, hasPropsTable: true },

package/dist/gadgets/clock/themes/useSgClockThemeResolver.meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSgClockThemeResolver.meta.d.ts","sourceRoot":"","sources":["../../../../src/gadgets/clock/themes/useSgClockThemeResolver.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEpE,eAAO,MAAM,MAAM,EAAE,QA0DpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAwBrB,CAAC"}
+{"version":3,"file":"useSgClockThemeResolver.meta.d.ts","sourceRoot":"","sources":["../../../../src/gadgets/clock/themes/useSgClockThemeResolver.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEpE,eAAO,MAAM,MAAM,EAAE,QAoEpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAwBrB,CAAC"}

package/dist/gadgets/clock/themes/useSgClockThemeResolver.meta.js

@@ -13,45 +13,52 @@ export const sgMeta = {
     fieldSemantics: ["themeResolver", "clockTheme", "dynamicStyling"],
     props: [
         {
-            name: "returns.resolveMode",
-            type: "SgClockThemeResolveMode",
-            description: "Modo de resolucao do tema (auto, light, dark, custom).",
-            semanticRole: "behavior",
-            bindable: true
+            name: "returns",
+            type: "SgClockThemeResolver | null",
+            description: "Resolvedor do SgClockThemeProvider mais proximo. Fora de um provider o hook devolve null — nao ha fallback implicito.",
+            semanticRole: "data",
+            bindable: false
         },
         {
-            name: "returns.resolveTheme",
-            type: "(themeId: string) => SgClockTheme | null",
-            description: "Funcao para resolver um tema pelo ID.",
+            name: "returns.resolve",
+            type: "(id: string) => SgClockTheme | null",
+            description: "Resolve um tema pelo id. No modo fallback do provider, um id desconhecido cai no fallbackThemeId; no modo strict devolve null.",
             semanticRole: "data",
             bindable: false
         },
         {
-            name: "returns.currentTheme",
-            type: "SgClockTheme | null",
-            description: "Tema atualmente ativo.",
+            name: "returns.list",
+            type: "() => SgClockTheme[]",
+            description: "Temas visiveis para esta arvore: os globais do registry mais os locais do provider, ordenados por `order`.",
             semanticRole: "data",
             bindable: false
         },
         {
-            name: "returns.setResolveMode",
-            type: "(mode: SgClockThemeResolveMode) => void",
-            description: "Alterar modo de resolucao do tema.",
+            name: "returns.registerLocal",
+            type: "(theme: SgClockTheme) => void",
+            description: "Registra um tema apenas nesta arvore, sem tocar no registry global.",
+            semanticRole: "behavior",
+            bindable: false
+        },
+        {
+            name: "returns.registerManyLocal",
+            type: "(themes: SgClockTheme[]) => void",
+            description: "Mesma coisa que registerLocal, para uma lista.",
             semanticRole: "behavior",
             bindable: false
         }
     ],
-    states: ["auto", "light", "dark", "custom"],
+    states: ["fallback", "strict", "sem-provider"],
     examples: [
         {
             id: "basic",
             title: "Resolver e alternar temas",
-            file: "apps/showcase/src/app/components/hooks/use-sg-clock-theme-resolver/samples/basic.tsx.sample",
+            file: "apps/showcase/src/app/components/providers/sg-clock-theme-provider/samples/resolver-hook.tsx.sample",
             kind: "sample"
         }
     ],
     showcase: {
-        route: "/components/hooks/use-sg-clock-theme-resolver",
+        route: "/components/providers/sg-clock-theme-provider",
         hasPlayground: true,
         hasPropsTable: true
     }