@seedgrid/fe-components 2026.11.1 → 2026.11.2

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

package/dist/inputs/fileUploadLogic.js

@@ -0,0 +1,254 @@
+// Logica pura do SgFileUpload (P141): tipos de midia (`mediaType`), tamanho com unidade ("1.5MB"), tipo do arquivo
+// pelo CONTEUDO (assinatura) e a regra de quantos arquivos entram (maxFiles, por arquivo, total). Sem DOM: os vetores
+// de paridade com o Flutter (`seedgrid_components/test/widgets/file_upload_vectors`) sao gerados DESTE modulo.
+export const MEDIA_TYPES = {
+    image: { group: "image/", extensions: ["png", "jpg", "jpeg", "jfif", "jpe", "gif", "webp", "bmp", "svg", "heic", "heif", "avif", "tif", "tiff", "ico"] },
+    video: { group: "video/", extensions: ["mp4", "webm", "mov", "mkv", "avi", "ogv", "m4v"] },
+    audio: { group: "audio/", extensions: ["mp3", "wav", "ogg", "oga", "m4a", "aac", "flac", "weba"] },
+    pdf: { mime: "application/pdf", extensions: ["pdf"] },
+    doc: { mime: "application/msword", extensions: ["doc"] },
+    docx: { mime: "application/vnd.openxmlformats-officedocument.wordprocessingml.document", extensions: ["docx"] },
+    xls: { mime: "application/vnd.ms-excel", extensions: ["xls"] },
+    xlsx: { mime: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", extensions: ["xlsx"] },
+    ppt: { mime: "application/vnd.ms-powerpoint", extensions: ["ppt"] },
+    pptx: { mime: "application/vnd.openxmlformats-officedocument.presentationml.presentation", extensions: ["pptx"] },
+    csv: { mime: "text/csv", extensions: ["csv"] },
+    txt: { mime: "text/plain", extensions: ["txt"] },
+    zip: { mime: "application/zip", extensions: ["zip"] }
+};
+const EXTENSION_MIME = {
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    jfif: "image/jpeg",
+    jpe: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp",
+    bmp: "image/bmp",
+    svg: "image/svg+xml",
+    heic: "image/heic",
+    heif: "image/heif",
+    avif: "image/avif",
+    tif: "image/tiff",
+    tiff: "image/tiff",
+    ico: "image/x-icon",
+    mp4: "video/mp4",
+    m4v: "video/mp4",
+    webm: "video/webm",
+    mov: "video/quicktime",
+    mkv: "video/x-matroska",
+    avi: "video/x-msvideo",
+    ogv: "video/ogg",
+    mp3: "audio/mpeg",
+    wav: "audio/wav",
+    ogg: "audio/ogg",
+    oga: "audio/ogg",
+    m4a: "audio/mp4",
+    aac: "audio/aac",
+    flac: "audio/flac",
+    weba: "audio/webm",
+    pdf: "application/pdf",
+    doc: "application/msword",
+    docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    xls: "application/vnd.ms-excel",
+    xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    ppt: "application/vnd.ms-powerpoint",
+    pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    csv: "text/csv",
+    txt: "text/plain",
+    zip: "application/zip"
+};
+const ZIP = "application/zip";
+const OLE = "application/x-ole-storage";
+const ZIP_BASED = new Set(["docx", "xlsx", "pptx", "zip"]);
+const OLE_BASED = new Set(["doc", "xls", "ppt"]);
+/** Extensao em minusculas (sem ponto), ou "" quando nao ha. */
+export function extensionOf(name) {
+    const i = name.lastIndexOf(".");
+    return i < 0 || i === name.length - 1 ? "" : name.slice(i + 1).toLowerCase();
+}
+/** Tipo MIME so pela extensao do nome; "" se desconhecida. */
+export function mimeFromName(name) {
+    return EXTENSION_MIME[extensionOf(name)] ?? "";
+}
+function startsWith(b, sig, at = 0) {
+    if (b.length < at + sig.length)
+        return false;
+    for (let i = 0; i < sig.length; i += 1)
+        if (b[i + at] !== sig[i])
+            return false;
+    return true;
+}
+function ascii(b, from, to) {
+    let s = "";
+    for (let i = from; i < Math.min(to, b.length); i += 1)
+        s += String.fromCharCode(b[i] ?? 0);
+    return s;
+}
+/** Tipo MIME pela assinatura do arquivo (primeiros bytes; ate 256 bastam); "" se nao reconhecida. */
+export function sniffMime(b) {
+    if (startsWith(b, [0x89, 0x50, 0x4e, 0x47]))
+        return "image/png";
+    if (startsWith(b, [0xff, 0xd8, 0xff]))
+        return "image/jpeg";
+    if (startsWith(b, [0x47, 0x49, 0x46, 0x38]))
+        return "image/gif";
+    if (startsWith(b, [0x52, 0x49, 0x46, 0x46]) && startsWith(b, [0x57, 0x45, 0x42, 0x50], 8))
+        return "image/webp";
+    if (startsWith(b, [0x52, 0x49, 0x46, 0x46]) && startsWith(b, [0x57, 0x41, 0x56, 0x45], 8))
+        return "audio/wav";
+    if (startsWith(b, [0x42, 0x4d]))
+        return "image/bmp";
+    if (startsWith(b, [0x49, 0x49, 0x2a, 0x00]) || startsWith(b, [0x4d, 0x4d, 0x00, 0x2a]))
+        return "image/tiff";
+    if (startsWith(b, [0x00, 0x00, 0x01, 0x00]))
+        return "image/x-icon";
+    if (startsWith(b, [0x25, 0x50, 0x44, 0x46]))
+        return "application/pdf";
+    if (startsWith(b, [0x50, 0x4b, 0x03, 0x04]))
+        return ZIP;
+    if (startsWith(b, [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1]))
+        return OLE;
+    if (startsWith(b, [0x1a, 0x45, 0xdf, 0xa3]))
+        return "video/webm";
+    if (startsWith(b, [0x4f, 0x67, 0x67, 0x53]))
+        return "audio/ogg";
+    if (startsWith(b, [0x66, 0x4c, 0x61, 0x43]))
+        return "audio/flac";
+    if (startsWith(b, [0x49, 0x44, 0x33]) || startsWith(b, [0xff, 0xfb]) || startsWith(b, [0xff, 0xf3]) || startsWith(b, [0xff, 0xf2]))
+        return "audio/mpeg";
+    if (startsWith(b, [0x66, 0x74, 0x79, 0x70], 4)) {
+        const brand = ascii(b, 8, 12);
+        if (brand.startsWith("avif") || brand.startsWith("avis"))
+            return "image/avif";
+        if (brand.startsWith("hei") || brand.startsWith("mif"))
+            return "image/heic";
+        if (brand.startsWith("M4A"))
+            return "audio/mp4";
+        if (brand.startsWith("qt"))
+            return "video/quicktime";
+        return "video/mp4";
+    }
+    if (ascii(b, 0, 256).toLowerCase().includes("<svg"))
+        return "image/svg+xml";
+    return "";
+}
+/**
+ * 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 function resolveMime(name, declared, head) {
+    const ext = extensionOf(name);
+    const byName = EXTENSION_MIME[ext] ?? "";
+    const sig = sniffMime(head);
+    if (sig === ZIP)
+        return ZIP_BASED.has(ext) ? byName : ZIP;
+    if (sig === OLE)
+        return OLE_BASED.has(ext) ? byName : OLE;
+    if (sig)
+        return sig;
+    return byName || declared.toLowerCase();
+}
+/** Texto `accept` livre: `.png`, `image/png`, `image/*`, separados por virgula. */
+function matchesAcceptToken(name, mime, accept) {
+    const tokens = accept
+        .split(",")
+        .map((t) => t.trim().toLowerCase())
+        .filter(Boolean);
+    if (tokens.length === 0)
+        return false;
+    const lowerName = name.toLowerCase();
+    return tokens.some((token) => {
+        if (token.startsWith("."))
+            return lowerName.endsWith(token);
+        if (token.endsWith("/*"))
+            return mime.startsWith(token.slice(0, -1));
+        return mime === token;
+    });
+}
+/** O tipo efetivo satisfaz `mediaType` (lista) ou `accept` (texto livre)? Sem nenhum dos dois, tudo passa. */
+export function matchesMedia(name, mime, mediaType, accept) {
+    const hasMedia = Boolean(mediaType && mediaType.length > 0);
+    const hasAccept = Boolean(accept && accept.trim());
+    if (!hasMedia && !hasAccept)
+        return true;
+    if (hasMedia) {
+        for (const m of mediaType) {
+            if (m === "all")
+                return true;
+            const info = MEDIA_TYPES[m];
+            if (!info)
+                continue;
+            if (info.group && mime.startsWith(info.group))
+                return true;
+            if (info.mime && mime === info.mime)
+                return true;
+        }
+    }
+    return hasAccept ? matchesAcceptToken(name, mime, accept) : false;
+}
+const UNITS = { b: 1, kb: 1024, mb: 1024 ** 2, gb: 1024 ** 3, tb: 1024 ** 4 };
+/**
+ * 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 function parseSize(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value === "number")
+        return Number.isFinite(value) && value >= 0 ? Math.floor(value) : undefined;
+    const m = /^\s*(\d+(?:\.\d+)?)\s*([a-zA-Z]*)\s*$/.exec(value);
+    if (!m)
+        return undefined;
+    const unitText = m[2] ?? "";
+    const unit = unitText === "" ? "b" : unitText.toLowerCase();
+    const factor = UNITS[unit];
+    return factor === undefined ? undefined : Math.floor(Number(m[1] ?? 0) * factor);
+}
+/**
+ * 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 function planAdd(currentSizes, picked, rules = {}) {
+    const maxFiles = Math.max(1, Math.floor(rules.maxFiles ?? 1));
+    const perFile = parseSize(rules.maxSizePerFile);
+    const total = parseSize(rules.maxSizeTotal);
+    const replace = maxFiles === 1;
+    let count = replace ? 0 : currentSizes.length;
+    let sum = replace ? 0 : currentSizes.reduce((a, b) => a + b, 0);
+    const accepted = [];
+    const rejected = [];
+    picked.forEach((file, index) => {
+        const mime = resolveMime(file.name, file.type, file.head);
+        let code = null;
+        if (!matchesMedia(file.name, mime, rules.mediaType, rules.accept))
+            code = "type";
+        else if (perFile !== undefined && file.size > perFile)
+            code = "size";
+        else if (count >= maxFiles)
+            code = "count";
+        else if (total !== undefined && sum + file.size > total)
+            code = "total";
+        if (code) {
+            rejected.push({ index, code });
+            return;
+        }
+        accepted.push(index);
+        count += 1;
+        sum += file.size;
+    });
+    return { accepted, rejected, replace };
+}
+/** `1536` => "1,5 KB" (virgula fora do en-US). Base 1024; ate TB. */
+export function formatFileSize(bytes, locale = "en-US") {
+    const units = ["B", "KB", "MB", "GB", "TB"];
+    let value = Math.max(0, bytes);
+    let unit = 0;
+    while (value >= 1024 && unit < units.length - 1) {
+        value /= 1024;
+        unit += 1;
+    }
+    const text = unit === 0 ? String(Math.round(value)) : value.toFixed(1);
+    return `${locale === "en-US" ? text : text.replace(".", ",")} ${units[unit]}`;
+}

package/dist/inputs/imageUploadLogic.d.ts

@@ -0,0 +1,31 @@
+export type ImageErrorCode = "type" | "size" | "dimension" | "aspect";
+export type ImageFacts = {
+    name: string;
+    /** Tipo MIME (`image/png`); pode vir vazio. */
+    type: string;
+    size: number;
+    /** Dimensoes em px; ausentes quando nao foi possivel ler (as regras de dimensao/proporcao so rodam se existirem). */
+    width?: number;
+    height?: number;
+};
+export type ImageRules = {
+    /** Lista separada por virgula: `image/*`, `image/png`, `.png`. Padrao: `image/*`. */
+    accept?: string;
+    maxSizeBytes?: number;
+    minWidth?: number;
+    minHeight?: number;
+    /** Proporcao largura/altura exigida (`1`, `16 / 9`). */
+    aspect?: number;
+    /** Tolerancia relativa da proporcao (padrao 0.02 = 2%). */
+    aspectTolerance?: number;
+};
+export declare const DEFAULT_ACCEPT = "image/*";
+/** O arquivo satisfaz `accept`? Compara extensao (`.png`), tipo exato (`image/png`) e curinga (`image/*`). */
+export declare function matchesAccept(name: string, type: string, accept?: string): boolean;
+/** Primeiro erro encontrado (ordem: tipo, tamanho, dimensao, proporcao) ou `null`. */
+export declare function validateImage(file: ImageFacts, rules?: ImageRules): ImageErrorCode | null;
+/** `1536` => "1,5 KB" (virgula fora do en-US). Usa 1024 como base; ate GB. */
+export declare function formatBytes(bytes: number, locale?: string): string;
+/** Texto da proporcao para a mensagem: inteiros viram "16:9"; senao 2 casas ("1.78"). */
+export declare function formatAspect(aspect: number): string;
+//# sourceMappingURL=imageUploadLogic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"imageUploadLogic.d.ts","sourceRoot":"","sources":["../../src/inputs/imageUploadLogic.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEtE,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,qHAAqH;IACrH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC,8GAA8G;AAC9G,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAalF;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,GAAE,UAAe,GAAG,cAAc,GAAG,IAAI,CAiB7F;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAU,GAAG,MAAM,CAUnE;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAYnD"}

package/dist/inputs/imageUploadLogic.js

@@ -0,0 +1,70 @@
+// Logica pura do SgImageUpload (P133): tipos aceitos, validacao (tipo, tamanho, dimensao minima, proporcao) e
+// texto de tamanho. Sem DOM: os vetores de paridade com o Flutter (`seedgrid_components/test/widgets/
+// image_upload_vectors`) sao gerados DESTE modulo.
+export const DEFAULT_ACCEPT = "image/*";
+/** O arquivo satisfaz `accept`? Compara extensao (`.png`), tipo exato (`image/png`) e curinga (`image/*`). */
+export function matchesAccept(name, type, accept) {
+    const tokens = (accept ?? DEFAULT_ACCEPT)
+        .split(",")
+        .map((t) => t.trim().toLowerCase())
+        .filter(Boolean);
+    if (tokens.length === 0)
+        return true;
+    const lowerName = name.toLowerCase();
+    const lowerType = type.toLowerCase();
+    return tokens.some((token) => {
+        if (token.startsWith("."))
+            return lowerName.endsWith(token);
+        if (token.endsWith("/*"))
+            return lowerType.startsWith(token.slice(0, -1));
+        return lowerType === token;
+    });
+}
+/** Primeiro erro encontrado (ordem: tipo, tamanho, dimensao, proporcao) ou `null`. */
+export function validateImage(file, rules = {}) {
+    if (!matchesAccept(file.name, file.type, rules.accept))
+        return "type";
+    if (rules.maxSizeBytes !== undefined && file.size > rules.maxSizeBytes)
+        return "size";
+    const { width, height } = file;
+    if (width !== undefined && height !== undefined) {
+        if ((rules.minWidth !== undefined && width < rules.minWidth) ||
+            (rules.minHeight !== undefined && height < rules.minHeight)) {
+            return "dimension";
+        }
+        if (rules.aspect !== undefined && rules.aspect > 0 && height > 0) {
+            const tolerance = rules.aspectTolerance ?? 0.02;
+            if (Math.abs(width / height - rules.aspect) / rules.aspect > tolerance)
+                return "aspect";
+        }
+    }
+    return null;
+}
+/** `1536` => "1,5 KB" (virgula fora do en-US). Usa 1024 como base; ate GB. */
+export function formatBytes(bytes, locale = "en-US") {
+    const units = ["B", "KB", "MB", "GB"];
+    let value = Math.max(0, bytes);
+    let unit = 0;
+    while (value >= 1024 && unit < units.length - 1) {
+        value /= 1024;
+        unit += 1;
+    }
+    const text = unit === 0 ? String(Math.round(value)) : value.toFixed(1);
+    return `${locale === "en-US" ? text : text.replace(".", ",")} ${units[unit]}`;
+}
+/** Texto da proporcao para a mensagem: inteiros viram "16:9"; senao 2 casas ("1.78"). */
+export function formatAspect(aspect) {
+    const known = [
+        [1, "1:1"],
+        [4 / 3, "4:3"],
+        [3 / 2, "3:2"],
+        [16 / 9, "16:9"],
+        [3 / 4, "3:4"],
+        [2 / 3, "2:3"],
+        [9 / 16, "9:16"]
+    ];
+    for (const [value, text] of known)
+        if (Math.abs(value - aspect) < 1e-9)
+            return text;
+    return aspect.toFixed(2);
+}

package/dist/menus/SgDockMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SgDockMenu.d.ts","sourceRoot":"","sources":["../../src/menus/SgDockMenu.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,MAAM,MAAM,kBAAkB,GAC1B,UAAU,GAAG,aAAa,GAAG,aAAa,GAC1C,YAAY,GAAG,eAAe,GAC9B,WAAW,GAAG,cAAc,GAAG,cAAc,CAAC;AAElD,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE9D,MAAM,MAAM,cAAc,GAAG;IAC3B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IACtB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,yCAAyC;IACzC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,MAAM,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC,mBAAmB;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AA0BD,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,eAAe,CAAC,2CAyf1D"}
+{"version":3,"file":"SgDockMenu.d.ts","sourceRoot":"","sources":["../../src/menus/SgDockMenu.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,MAAM,MAAM,kBAAkB,GAC1B,UAAU,GAAG,aAAa,GAAG,aAAa,GAC1C,YAAY,GAAG,eAAe,GAC9B,WAAW,GAAG,cAAc,GAAG,cAAc,CAAC;AAElD,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE9D,MAAM,MAAM,cAAc,GAAG;IAC3B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IACtB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,yCAAyC;IACzC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,MAAM,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC,mBAAmB;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AA0BD,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,eAAe,CAAC,2CA2f1D"}

package/dist/menus/SgDockMenu.js

@@ -282,6 +282,8 @@ export function SgDockMenu(props) {
     });
     return (_jsxs(_Fragment, { children: [_jsx("div", { ref: containerRef, id: id, className: `sg-dock ${className} ${ELEV_CLS[elevation]}`, style: {
                     ...containerStyleState.style,
+                    // A sombra (ELEV_CLS) fica neste wrapper: sem o raio ela desenhava um retangulo quadrado atras do dock (P140).
+                    borderRadius: `${borderRadius}px`,
                     ...style,
                     transform: containerStyleState.transform,
                     cursor: enableDragDrop ? (isDragging ? "grabbing" : "grab") : "default",