@seedgrid/fe-components 2026.11.0 → 2026.11.2

package/dist/inputs/SgInputDateTime.js

@@ -0,0 +1,130 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from "react";
+import { SgInputText } from "./SgInputText";
+import { resolveFieldError } from "../rhf";
+import { t, useComponentsI18n } from "../i18n";
+import { useDarkFlag } from "../gadgets/clock/themes/useDarkFlag";
+import { formatWallClock, instantToWallClock, snapMinutes, validateDateTime, wallClockToInstant } from "./dateTimeLogic";
+/** Teto do atributo HTML quando nao ha `maxDate` (o <input> aceitaria ano de 6 digitos). */
+const WIDGET_MAX = "9999-12-31T23:59";
+function localOf(value, timeZone, showSeconds) {
+    return instantToWallClock(value ?? undefined, timeZone, showSeconds);
+}
+export function SgInputDateTime(props) {
+    const i18n = useComponentsI18n();
+    const isDark = useDarkFlag();
+    const { value, defaultValue, onChange, minDate, maxDate, timeZone, showSeconds = false, minuteStep, inputProps, alwaysFloat, required, requiredMessage, validateOnBlur, validation, onValidation, error, ...rest } = props;
+    const rhfManaged = Boolean(rest.control && rest.name);
+    const controlled = value !== undefined;
+    const [innerLocal, setInnerLocal] = React.useState(() => localOf(defaultValue, timeZone, showSeconds));
+    const local = controlled ? localOf(value, timeZone, showSeconds) : innerLocal;
+    const labelText = rest.labelText ?? rest.label ?? "";
+    const [internalError, setInternalError] = React.useState(null);
+    const hasError = Boolean(error ?? internalError);
+    const [hasInteracted, setHasInteracted] = React.useState(false);
+    // Segmentos digitados pela metade: o <input type="datetime-local"> entrega "" (validity.badInput). Em modo controlado o
+    // React devolveria o `value` antigo e o campo voltaria ao valor anterior; enquanto parcial, o DOM segue sem ser reescrito.
+    const [partial, setPartial] = React.useState(false);
+    React.useEffect(() => {
+        setPartial(false);
+    }, [local]);
+    const minLocal = minDate ? instantToWallClock(minDate, timeZone, showSeconds) : undefined;
+    const maxLocal = maxDate ? instantToWallClock(maxDate, timeZone, showSeconds) : undefined;
+    const effectiveStep = showSeconds ? 1 : minuteStep && minuteStep > 1 ? minuteStep * 60 : undefined;
+    const runValidation = React.useCallback((text) => {
+        const report = (message) => {
+            setInternalError(message);
+            onValidation?.(message);
+        };
+        if (!text && required)
+            return report(requiredMessage ?? t(i18n, "components.inputs.required"));
+        if (!text)
+            return report(null);
+        const custom = validation?.(text) ?? null;
+        if (custom)
+            return report(custom);
+        const code = validateDateTime(text, { required, min: minDate, max: maxDate, timeZone });
+        if (code === "invalid")
+            return report(t(i18n, "components.inputs.datetime.invalid"));
+        if (code === "min" || code === "max" || code === "range") {
+            const min = minLocal ? formatWallClock(minLocal, i18n.locale, showSeconds) : "";
+            const max = maxLocal ? formatWallClock(maxLocal, i18n.locale, showSeconds) : "";
+            return report(code === "range"
+                ? t(i18n, "components.inputs.datetime.range", { min, max })
+                : code === "min"
+                    ? t(i18n, "components.inputs.datetime.min", { min })
+                    : t(i18n, "components.inputs.datetime.max", { max }));
+        }
+        return report(null);
+    }, [i18n, maxDate, maxLocal, minDate, minLocal, onValidation, required, requiredMessage, showSeconds, timeZone, validation]);
+    const emit = (text) => {
+        onChange?.(text ? wallClockToInstant(text, timeZone) : null, text);
+    };
+    const mergedInputProps = {
+        ...inputProps,
+        placeholder: " ",
+        min: minLocal,
+        max: maxLocal ?? WIDGET_MAX,
+        step: effectiveStep,
+        ...(rhfManaged ? {} : { value: partial ? "" : local }),
+        readOnly: inputProps?.readOnly,
+        onChange: (event) => {
+            const text = event.currentTarget.value;
+            setPartial(text === "" && Boolean(event.currentTarget.validity?.badInput));
+            setHasInteracted(true);
+            if (!controlled)
+                setInnerLocal(text);
+            if (validateOnBlur === false || internalError)
+                runValidation(text);
+            emit(text);
+            inputProps?.onChange?.(event);
+        },
+        onBlur: (event) => {
+            let text = event.currentTarget.value;
+            const snapped = snapMinutes(text, showSeconds ? undefined : minuteStep);
+            if (snapped !== text) {
+                text = snapped;
+                if (!controlled)
+                    setInnerLocal(text);
+                emit(text);
+            }
+            if ((validateOnBlur ?? true) || hasInteracted)
+                runValidation(text);
+            inputProps?.onBlur?.(event);
+        }
+    };
+    const inputClassName = (() => {
+        if (mergedInputProps.className)
+            return mergedInputProps.className;
+        const elevationClass = props.elevation === "none" ? "" : props.elevation === "md" ? "shadow-md" : props.elevation === "lg" ? "shadow-lg" : "shadow-sm";
+        const baseClass = "peer h-11 w-full rounded-md bg-[var(--sg-input-bg,hsl(var(--background)))] text-[var(--sg-input-fg,hsl(var(--foreground)))] caret-[var(--sg-input-fg,hsl(var(--foreground)))] pl-3 pr-7 py-2.5 text-sm placeholder-transparent focus:outline-none";
+        const borderClass = hasError
+            ? "border border-[hsl(var(--destructive))] focus:border-[hsl(var(--destructive))] focus:ring-2 focus:ring-[hsl(var(--destructive)/0.25)]"
+            : "border border-border focus:border-[hsl(var(--primary))] focus:ring-2 focus:ring-[hsl(var(--primary)/0.25)]";
+        return [baseClass, borderClass, elevationClass].filter(Boolean).join(" ");
+    })();
+    const wrapperClassName = ["relative", isDark ? "sg-datetime-dark" : "sg-datetime-light"].join(" ");
+    return (_jsxs("div", { className: wrapperClassName, children: [_jsx("style", { children: `
+        input[type="datetime-local"]::-webkit-calendar-picker-indicator {
+          cursor: pointer;
+        }
+        .sg-datetime-dark input[type="datetime-local"] {
+          color-scheme: dark;
+        }
+        .sg-datetime-light input[type="datetime-local"] {
+          color-scheme: light;
+        }
+      ` }), labelText ? (_jsx("label", { htmlFor: rest.id, className: [
+                    "pointer-events-none absolute left-3 top-0 z-10 -translate-y-1/2 bg-[var(--sg-input-bg,hsl(var(--background)))] px-1 text-[11px] font-medium leading-none",
+                    hasError ? "text-[hsl(var(--destructive))]" : "text-foreground/70"
+                ].join(" "), children: labelText })) : null, _jsx(SgInputText, { ...rest, type: "datetime-local", error: resolveFieldError(error, internalError ?? undefined), inputProps: mergedInputProps, className: inputClassName, labelClassName: "sr-only", onClear: () => {
+                    setInternalError(null);
+                    onValidation?.(null);
+                    setPartial(false);
+                    if (!controlled)
+                        setInnerLocal("");
+                    emit("");
+                    rest.onClear?.();
+                } })] }));
+}

package/dist/inputs/SgInputDateTime.meta.d.ts

@@ -0,0 +1,4 @@
+import type { SgAiHintsV0, SgMetaV0 } from "../ai-meta/types";
+export declare const sgMeta: SgMetaV0;
+export declare const aiHints: SgAiHintsV0;
+//# sourceMappingURL=SgInputDateTime.meta.d.ts.map

package/dist/inputs/SgInputDateTime.meta.d.ts.map

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

package/dist/inputs/SgInputDateTime.meta.js

@@ -0,0 +1,73 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "form.input.datetime",
+    package: "@seedgrid/fe-components",
+    exportName: "SgInputDateTime",
+    slug: "sg-input-date-time",
+    displayName: "SgInputDateTime",
+    category: "input",
+    subcategory: "datetime",
+    description: "Campo de data e hora que entrega e recebe instantes ISO 8601 em UTC, exibindo a hora no fuso escolhido, com limites, passo de minutos e validacao.",
+    tags: ["form", "date", "time", "datetime", "rhf"],
+    capabilities: ["rhf", "controlled", "min-max", "time-zone", "minute-step", "iso-utc"],
+    fieldSemantics: ["dateTime", "timestamp", "schedule", "appointment", "deadline"],
+    props: [
+        { name: "id", type: "string", required: true, description: "Identificador unico do campo.", semanticRole: "data", bindable: false },
+        { name: "name", type: "string", description: "Nome do campo para formularios.", semanticRole: "data", bindable: true },
+        { name: "label", type: "string", description: "Rotulo principal exibido ao usuario.", semanticRole: "label", bindable: true },
+        { name: "value", type: "string | Date | null", description: "Instante controlado (ISO 8601 ou Date).", semanticRole: "data", bindable: true },
+        { name: "defaultValue", type: "string | Date | null", description: "Instante inicial (nao controlado).", semanticRole: "data", bindable: true },
+        { name: "required", type: "boolean", default: false, description: "Marca o campo como obrigatorio.", semanticRole: "validation", bindable: true },
+        { name: "minDate", type: "string | Date", description: "Menor instante permitido.", semanticRole: "validation", bindable: true },
+        { name: "maxDate", type: "string | Date", description: "Maior instante permitido.", semanticRole: "validation", bindable: true },
+        { name: "timeZone", type: "string", default: "local", description: "Fuso do campo: local, UTC, deslocamento (+03:00) ou nome IANA.", semanticRole: "data", bindable: true },
+        { name: "showSeconds", type: "boolean", default: false, description: "Mostra e aceita segundos.", semanticRole: "appearance", bindable: true },
+        { name: "minuteStep", type: "number", description: "Passo dos minutos (5, 10, 15, 30).", semanticRole: "validation", bindable: true },
+        { name: "onChange", type: "(value: string | null, local: string) => void", description: "Instante ISO UTC (ou null) e texto local do campo.", semanticRole: "event", bindable: false }
+    ],
+    states: ["default", "focused", "disabled", "readOnly", "error"],
+    examples: [
+        {
+            id: "basic",
+            title: "Basico",
+            file: "apps/showcase/src/app/components/sg-input-date-time/samples/basico.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "playground",
+            title: "Playground",
+            file: "apps/showcase/src/app/components/sg-input-date-time/sg-input-date-time.tsx.playground",
+            kind: "playground"
+        }
+    ],
+    showcase: {
+        route: "/components/sg-input-date-time",
+        hasPlayground: true,
+        hasPropsTable: true
+    },
+    sdui: {
+        rendererType: "field.datetime",
+        acceptsDataBinding: true,
+        defaultProps: { labelPosition: "float", clearButton: true }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Agendamentos, compromissos e prazos que exigem data e hora.",
+        "Campos de timestamp que precisam trafegar como instante UTC.",
+        "Formularios com limites de data e hora e fuso explicito."
+    ],
+    avoidUseCases: [
+        "Somente data; prefira SgInputDate.",
+        "Somente hora do dia sem data; prefira um campo de hora.",
+        "Texto livre; prefira SgInputText."
+    ],
+    synonyms: ["datetime input", "date time picker", "timestamp field", "appointment field"],
+    relatedEntityFields: ["createdAt", "scheduledAt", "startsAt", "endsAt", "dueAt", "timestamp"],
+    compositionHints: [
+        "Combinar dois campos (inicio/fim) com minDate/maxDate para intervalos.",
+        "Usar dentro de SgPanel em formularios de agenda."
+    ],
+    rankingSignals: { freeText: 0, structuredChoice: 0.1, date: 0.95, number: 0, denseLayout: 0.7 }
+};

package/dist/inputs/cameraLogic.d.ts

@@ -0,0 +1,27 @@
+export type CameraFacing = "user" | "environment";
+export type CameraGuide = "none" | "oval" | "rect";
+export type CameraResolution = "low" | "medium" | "high";
+export type CameraErrorCode = "permission" | "noCamera" | "failed";
+export type GuideBox = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/** Resolucao pedida ao dispositivo (largura x altura, paisagem). */
+export declare function resolutionSize(resolution: CameraResolution): {
+    width: number;
+    height: number;
+};
+/**
+ * Caixa do guia de enquadramento, centralizada na area de pre-visualizacao `viewW` x `viewH` (px).
+ * `oval`: elipse em pe (largura/altura = 3/4), ate 70% da largura e 70% da altura.
+ * `rect`: retangulo deitado (largura/altura = 4/3), ate 90% da largura e 70% da altura.
+ * `none` => null. Valores arredondados ao pixel.
+ */
+export declare function guideBox(guide: CameraGuide, viewW: number, viewH: number): GuideBox | null;
+/** Nome do erro da plataforma (`NotAllowedError`, `CameraAccessDenied`...) => codigo do componente. */
+export declare function classifyCameraError(name: string): CameraErrorCode;
+/** Alterna entre frontal (`user`) e traseira (`environment`). */
+export declare function nextFacing(facing: CameraFacing): CameraFacing;
+//# sourceMappingURL=cameraLogic.d.ts.map

package/dist/inputs/cameraLogic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraLogic.d.ts","sourceRoot":"","sources":["../../src/inputs/cameraLogic.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,aAAa,CAAC;AAClD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AACnD,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AACzD,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEnE,MAAM,MAAM,QAAQ,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,UAAU,EAAE,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAS9F;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAa1F;AAYD,uGAAuG;AACvG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAKjE;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAE7D"}

package/dist/inputs/cameraLogic.js

@@ -0,0 +1,57 @@
+// Logica pura do SgCameraCapture (P134): resolucao, guia de enquadramento, classificacao de erro e troca de camera.
+// Sem DOM: os vetores de paridade com o Flutter (`seedgrid_components/test/widgets/camera_vectors`) sao gerados
+// DESTE modulo. O contrato das props e o mesmo nas duas plataformas.
+/** Resolucao pedida ao dispositivo (largura x altura, paisagem). */
+export function resolutionSize(resolution) {
+    switch (resolution) {
+        case "low":
+            return { width: 640, height: 480 };
+        case "high":
+            return { width: 1920, height: 1080 };
+        default:
+            return { width: 1280, height: 720 };
+    }
+}
+/**
+ * Caixa do guia de enquadramento, centralizada na area de pre-visualizacao `viewW` x `viewH` (px).
+ * `oval`: elipse em pe (largura/altura = 3/4), ate 70% da largura e 70% da altura.
+ * `rect`: retangulo deitado (largura/altura = 4/3), ate 90% da largura e 70% da altura.
+ * `none` => null. Valores arredondados ao pixel.
+ */
+export function guideBox(guide, viewW, viewH) {
+    if (guide === "none" || viewW <= 0 || viewH <= 0)
+        return null;
+    const ratio = guide === "oval" ? 3 / 4 : 4 / 3;
+    const maxW = viewW * (guide === "oval" ? 0.7 : 0.9);
+    const maxH = viewH * 0.7;
+    const width = Math.min(maxW, maxH * ratio);
+    const height = width / ratio;
+    return {
+        x: Math.round((viewW - width) / 2),
+        y: Math.round((viewH - height) / 2),
+        width: Math.round(width),
+        height: Math.round(height)
+    };
+}
+const PERMISSION_NAMES = new Set([
+    "notallowederror",
+    "permissiondeniederror",
+    "securityerror",
+    "cameraaccessdenied",
+    "cameraaccessdeniedwithoutprompt",
+    "cameraaccessrestricted"
+]);
+const NO_CAMERA_NAMES = new Set(["notfounderror", "devicesnotfounderror", "nocamera", "notreadableerror_nocamera"]);
+/** Nome do erro da plataforma (`NotAllowedError`, `CameraAccessDenied`...) => codigo do componente. */
+export function classifyCameraError(name) {
+    const key = name.trim().toLowerCase();
+    if (PERMISSION_NAMES.has(key))
+        return "permission";
+    if (NO_CAMERA_NAMES.has(key))
+        return "noCamera";
+    return "failed";
+}
+/** Alterna entre frontal (`user`) e traseira (`environment`). */
+export function nextFacing(facing) {
+    return facing === "user" ? "environment" : "user";
+}

package/dist/inputs/dateTimeLogic.d.ts

@@ -0,0 +1,22 @@
+export type DateTimeErrorCode = "required" | "invalid" | "min" | "max" | "range";
+/** Deslocamento fixo em minutos ("+03:00" => 180) ou null se nao for um deslocamento. */
+export declare function parseFixedOffset(timeZone: string): number | null;
+/** Minutos a somar ao UTC para obter o relogio de parede de `instantMs` no fuso. */
+export declare function zoneOffsetMinutes(instantMs: number, timeZone?: string): number;
+/** Instante (ISO UTC ou Date) => "YYYY-MM-DDTHH:mm[:ss]" no fuso; "" se invalido/vazio. */
+export declare function instantToWallClock(value: string | Date | undefined | null, timeZone?: string, showSeconds?: boolean): string;
+/** "YYYY-MM-DDTHH:mm[:ss]" no fuso => ISO 8601 UTC ("...Z", ms = 000); null se invalido. */
+export declare function wallClockToInstant(local: string, timeZone?: string): string | null;
+/** Arredonda os minutos ao multiplo de `step` mais proximo (passo invalido ou <= 1 mantem o valor). */
+export declare function snapMinutes(local: string, step?: number): string;
+export type DateTimeValidationInput = {
+    required?: boolean;
+    min?: string | Date;
+    max?: string | Date;
+    timeZone?: string;
+};
+/** Codigo do erro (null = valido). `local` e o texto do campo ("" = vazio). min/max sao instantes. */
+export declare function validateDateTime(local: string, input?: DateTimeValidationInput): DateTimeErrorCode | null;
+/** Texto de exibicao de um relogio de parede: dd/mm/aaaa HH:mm (en-US: aaaa-mm-dd HH:mm). */
+export declare function formatWallClock(local: string, locale: string, showSeconds?: boolean): string;
+//# sourceMappingURL=dateTimeLogic.d.ts.map

package/dist/inputs/dateTimeLogic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateTimeLogic.d.ts","sourceRoot":"","sources":["../../src/inputs/dateTimeLogic.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AASjF,yFAAyF;AACzF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMhE;AAMD,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAuB9E;AAQD,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,EACvC,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,UAAQ,GAClB,MAAM,CAMR;AAED,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBlF;AAED,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAkBhE;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,uBAA4B,GAAG,iBAAiB,GAAG,IAAI,CAY7G;AAED,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,MAAM,CAM1F"}

package/dist/inputs/dateTimeLogic.js

@@ -0,0 +1,140 @@
+// Logica pura do SgInputDateTime (P132): conversao entre instante (ISO 8601 em UTC) e "relogio de parede" no
+// fuso pedido, snap de minutos, validacao e texto de exibicao. Sem DOM: os vetores de paridade com o Flutter
+// (`seedgrid_components/test/widgets/datetime_vectors`) sao gerados DESTE modulo.
+//
+// Fusos aceitos (`timeZone`): omitido ou "local" (o do navegador/dispositivo), "UTC", deslocamento fixo
+// ("+03:00", "-0300", "+5:30") e, so no React, nome IANA ("America/Sao_Paulo"). O Flutter nao traz banco de
+// fusos (sem dependencia nova): la nome IANA cai em "local" (ver DIVERGENCIAS_DO_REACT.md).
+const LOCAL_RE = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2}))?$/;
+const OFFSET_RE = /^([+-])(\d{1,2})(?::?(\d{2}))?$/;
+function pad(n, size = 2) {
+    return String(n).padStart(size, "0");
+}
+/** Deslocamento fixo em minutos ("+03:00" => 180) ou null se nao for um deslocamento. */
+export function parseFixedOffset(timeZone) {
+    const m = OFFSET_RE.exec(timeZone.trim());
+    if (!m)
+        return null;
+    const minutes = Number(m[2]) * 60 + Number(m[3] ?? 0);
+    if (Number(m[2]) > 14 || Number(m[3] ?? 0) > 59)
+        return null;
+    return (m[1] === "-" ? -1 : 1) * minutes;
+}
+function isLocalZone(timeZone) {
+    return !timeZone || timeZone.trim() === "" || timeZone.trim().toLowerCase() === "local";
+}
+/** Minutos a somar ao UTC para obter o relogio de parede de `instantMs` no fuso. */
+export function zoneOffsetMinutes(instantMs, timeZone) {
+    if (isLocalZone(timeZone))
+        return -new Date(instantMs).getTimezoneOffset();
+    const tz = timeZone.trim();
+    if (tz.toUpperCase() === "UTC" || tz.toUpperCase() === "Z")
+        return 0;
+    const fixed = parseFixedOffset(tz);
+    if (fixed !== null)
+        return fixed;
+    try {
+        const parts = new Intl.DateTimeFormat("en-US", {
+            timeZone: tz,
+            hourCycle: "h23",
+            year: "numeric",
+            month: "2-digit",
+            day: "2-digit",
+            hour: "2-digit",
+            minute: "2-digit",
+            second: "2-digit"
+        }).formatToParts(new Date(instantMs));
+        const get = (type) => Number(parts.find((p) => p.type === type)?.value);
+        const asUtc = Date.UTC(get("year"), get("month") - 1, get("day"), get("hour"), get("minute"), get("second"));
+        return Math.round((asUtc - Math.floor(instantMs / 1000) * 1000) / 60000);
+    }
+    catch {
+        return -new Date(instantMs).getTimezoneOffset();
+    }
+}
+function toMs(value) {
+    if (value === undefined || value === null || value === "")
+        return null;
+    const ms = value instanceof Date ? value.getTime() : new Date(value).getTime();
+    return Number.isNaN(ms) ? null : ms;
+}
+/** Instante (ISO UTC ou Date) => "YYYY-MM-DDTHH:mm[:ss]" no fuso; "" se invalido/vazio. */
+export function instantToWallClock(value, timeZone, showSeconds = false) {
+    const ms = toMs(value);
+    if (ms === null)
+        return "";
+    const shifted = new Date(ms + zoneOffsetMinutes(ms, timeZone) * 60000);
+    const base = `${pad(shifted.getUTCFullYear(), 4)}-${pad(shifted.getUTCMonth() + 1)}-${pad(shifted.getUTCDate())}T${pad(shifted.getUTCHours())}:${pad(shifted.getUTCMinutes())}`;
+    return showSeconds ? `${base}:${pad(shifted.getUTCSeconds())}` : base;
+}
+/** "YYYY-MM-DDTHH:mm[:ss]" no fuso => ISO 8601 UTC ("...Z", ms = 000); null se invalido. */
+export function wallClockToInstant(local, timeZone) {
+    const m = LOCAL_RE.exec(local.trim());
+    if (!m)
+        return null;
+    const [y, mo, d, h, mi] = [m[1], m[2], m[3], m[4], m[5]].map(Number);
+    const s = Number(m[6] ?? 0);
+    if (mo < 1 || mo > 12 || d < 1 || h > 23 || mi > 59 || s > 59)
+        return null;
+    const naive = Date.UTC(y, mo - 1, d, h, mi, s);
+    if (new Date(naive).getUTCDate() !== d)
+        return null; // 31/02 e afins
+    // Resolve o deslocamento do fuso nesse relogio de parede (duas passadas cobrem a virada de horario de verao).
+    let offset = zoneOffsetMinutes(naive, timeZone);
+    let instant = naive - offset * 60000;
+    const again = zoneOffsetMinutes(instant, timeZone);
+    if (again !== offset) {
+        offset = again;
+        instant = naive - offset * 60000;
+    }
+    return new Date(instant).toISOString();
+}
+/** Arredonda os minutos ao multiplo de `step` mais proximo (passo invalido ou <= 1 mantem o valor). */
+export function snapMinutes(local, step) {
+    const m = LOCAL_RE.exec(local.trim());
+    if (!m || !step || !Number.isFinite(step) || step <= 1 || step > 60)
+        return local;
+    const minutes = Number(m[5]);
+    let snapped = Math.round(minutes / step) * step;
+    let hour = Number(m[4]);
+    let dayShift = 0;
+    if (snapped >= 60) {
+        snapped = 0;
+        hour += 1;
+    }
+    if (hour >= 24) {
+        hour = 0;
+        dayShift = 1;
+    }
+    const date = new Date(Date.UTC(Number(m[1]), Number(m[2]) - 1, Number(m[3]) + dayShift));
+    const day = `${pad(date.getUTCFullYear(), 4)}-${pad(date.getUTCMonth() + 1)}-${pad(date.getUTCDate())}`;
+    return `${day}T${pad(hour)}:${pad(snapped)}${m[6] !== undefined ? `:${m[6]}` : ""}`;
+}
+/** Codigo do erro (null = valido). `local` e o texto do campo ("" = vazio). min/max sao instantes. */
+export function validateDateTime(local, input = {}) {
+    if (!local)
+        return input.required ? "required" : null;
+    const instant = wallClockToInstant(local, input.timeZone);
+    if (!instant)
+        return "invalid";
+    const ms = new Date(instant).getTime();
+    const min = toMs(input.min);
+    const max = toMs(input.max);
+    const belowMin = min !== null && ms < min;
+    const aboveMax = max !== null && ms > max;
+    if (!belowMin && !aboveMax)
+        return null;
+    if (min !== null && max !== null)
+        return "range";
+    return belowMin ? "min" : "max";
+}
+/** Texto de exibicao de um relogio de parede: dd/mm/aaaa HH:mm (en-US: aaaa-mm-dd HH:mm). */
+export function formatWallClock(local, locale, showSeconds = false) {
+    const m = LOCAL_RE.exec(local.trim());
+    if (!m)
+        return local;
+    const time = `${m[4]}:${m[5]}${showSeconds ? `:${m[6] ?? "00"}` : ""}`;
+    if (locale === "en-US")
+        return `${m[1]}-${m[2]}-${m[3]} ${time}`;
+    return `${m[3]}/${m[2]}/${m[1]} ${time}`;
+}

package/dist/inputs/fileUploadLogic.d.ts

@@ -0,0 +1,62 @@
+export type MediaType = "image" | "video" | "audio" | "pdf" | "doc" | "docx" | "xls" | "xlsx" | "ppt" | "pptx" | "csv" | "txt" | "zip" | "all";
+export type FileErrorCode = "type" | "size" | "total" | "count" | "dimension" | "aspect";
+/** Tamanho em bytes (numero) ou texto com unidade: `"1KB"`, `"1.5MB"`, `"2gb"`. */
+export type SizeLimit = number | string;
+type MediaInfo = {
+    group?: string;
+    mime?: string;
+    extensions: string[];
+};
+export declare const MEDIA_TYPES: Record<Exclude<MediaType, "all">, MediaInfo>;
+/** Extensao em minusculas (sem ponto), ou "" quando nao ha. */
+export declare function extensionOf(name: string): string;
+/** Tipo MIME so pela extensao do nome; "" se desconhecida. */
+export declare function mimeFromName(name: string): string;
+/** Tipo MIME pela assinatura do arquivo (primeiros bytes; ate 256 bastam); "" se nao reconhecida. */
+export declare function sniffMime(b: Uint8Array): string;
+/**
+ * Tipo efetivo do arquivo: a assinatura (conteudo) manda; contentores (zip, OLE) e texto puro desempatam pela
+ * extensao; sem nenhuma das duas, vale o tipo que o sistema informou (`declared`).
+ */
+export declare function resolveMime(name: string, declared: string, head: Uint8Array): string;
+/** O tipo efetivo satisfaz `mediaType` (lista) ou `accept` (texto livre)? Sem nenhum dos dois, tudo passa. */
+export declare function matchesMedia(name: string, mime: string, mediaType?: MediaType[], accept?: string): boolean;
+/**
+ * Tamanho em bytes: numero puro = bytes; texto com unidade (B, KB, MB, GB, TB; base 1024; maiusculas ou minusculas;
+ * decimal com ponto; espaco opcional). Invalido, vazio ou negativo => `undefined` (sem limite).
+ */
+export declare function parseSize(value: SizeLimit | undefined | null): number | undefined;
+export type PickedFacts = {
+    name: string;
+    type: string;
+    size: number;
+    head: Uint8Array;
+};
+export type AddRules = {
+    mediaType?: MediaType[];
+    accept?: string;
+    /** Quantos arquivos o campo guarda (padrao 1). Com 1, escolher outro SUBSTITUI o atual. */
+    maxFiles?: number;
+    maxSizePerFile?: SizeLimit;
+    maxSizeTotal?: SizeLimit;
+};
+export type AddPlan = {
+    /** Indices (em `picked`) dos arquivos que entram, na ordem. */
+    accepted: number[];
+    rejected: Array<{
+        index: number;
+        code: FileErrorCode;
+    }>;
+    /** `true` quando `maxFiles` e 1: o aceito substitui o que ja havia. */
+    replace: boolean;
+};
+/**
+ * Decide quais dos arquivos escolhidos entram (`current` = tamanhos ja no campo). Cada recusa fica no seu arquivo
+ * (`type`, `size`, `count`, `total`); os demais seguem validos. Ordem das regras: tipo, tamanho por arquivo,
+ * quantidade, tamanho total.
+ */
+export declare function planAdd(currentSizes: number[], picked: PickedFacts[], rules?: AddRules): AddPlan;
+/** `1536` => "1,5 KB" (virgula fora do en-US). Base 1024; ate TB. */
+export declare function formatFileSize(bytes: number, locale?: string): string;
+export {};
+//# sourceMappingURL=fileUploadLogic.d.ts.map

package/dist/inputs/fileUploadLogic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileUploadLogic.d.ts","sourceRoot":"","sources":["../../src/inputs/fileUploadLogic.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,OAAO,GACP,OAAO,GACP,KAAK,GACL,KAAK,GACL,MAAM,GACN,KAAK,GACL,MAAM,GACN,KAAK,GACL,MAAM,GACN,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,CAAC;AAEV,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEzF,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAExC,KAAK,SAAS,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEzE,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,SAAS,CAcpE,CAAC;AAkDF,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAcD,qGAAqG;AACrG,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CA0B/C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAQpF;AAiBD,8GAA8G;AAC9G,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAc1G;AAID;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CASjF;AAED,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzF,MAAM,MAAM,QAAQ,GAAG;IACrB,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,YAAY,CAAC,EAAE,SAAS,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;IACxD,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,GAAE,QAAa,GAAG,OAAO,CAyBpG;AAED,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAU,GAAG,MAAM,CAUtE"}