@umodeapporg/ui 0.0.0-canary.ca10e69

package/dist/helpers/imageFile.js

@@ -0,0 +1,108 @@
+const MAX_DIMENSION = 1280;
+const JPEG_QUALITY = 0.82;
+const OUTPUT_TYPE = "image/jpeg";
+const AI_UPLOAD_SAFE_BYTES = 7.5 * 1024 * 1024;
+const AI_UPLOAD_MAX_DIMENSION = 4096;
+const AI_UPLOAD_QUALITY = 0.95;
+const AI_UPLOAD_FALLBACK_DIMENSION = 3072;
+const AI_UPLOAD_FALLBACK_QUALITY = 0.9;
+const AI_ACCEPTED_TYPES = /* @__PURE__ */ new Set(["image/jpeg", "image/png", "image/webp"]);
+const EXTENSION_BY_TYPE = {
+  "image/jpeg": "jpg",
+  "image/png": "png",
+  "image/webp": "webp"
+};
+const loadImage = (url) => new Promise((resolve, reject) => {
+  const image = new Image();
+  image.onload = () => resolve(image);
+  image.onerror = () => reject(new Error("Failed to load image"));
+  image.src = url;
+});
+const scaledSize = (width, height, maxDimension) => {
+  const longest = Math.max(width, height);
+  if (longest <= maxDimension) return { width, height };
+  const ratio = maxDimension / longest;
+  return { width: Math.round(width * ratio), height: Math.round(height * ratio) };
+};
+const baseName = (name) => name.replace(/\.[^.]+$/, "") || name || "image";
+const imageExtensionForType = (type) => type in EXTENSION_BY_TYPE ? EXTENSION_BY_TYPE[type] : "jpg";
+const withExtension = (name, type) => `${baseName(name)}.${EXTENSION_BY_TYPE[type]}`;
+const encodeImageFile = async (file, options) => {
+  const objectUrl = URL.createObjectURL(file);
+  try {
+    const image = await loadImage(objectUrl);
+    const { width, height } = scaledSize(image.naturalWidth, image.naturalHeight, options.maxDimension);
+    const canvas = document.createElement("canvas");
+    canvas.width = width;
+    canvas.height = height;
+    const context = canvas.getContext("2d");
+    if (!context) return null;
+    if (options.outputType === "image/jpeg") {
+      context.fillStyle = "#ffffff";
+      context.fillRect(0, 0, width, height);
+    }
+    context.drawImage(image, 0, 0, width, height);
+    const blob = await new Promise(
+      (resolve) => canvas.toBlob(resolve, options.outputType, options.quality)
+    );
+    if (!blob) return null;
+    return new File([blob], withExtension(file.name, options.outputType), { type: options.outputType });
+  } catch {
+    return null;
+  } finally {
+    URL.revokeObjectURL(objectUrl);
+  }
+};
+const resizeImageFile = async (file, options = {}) => {
+  const encoded = await encodeImageFile(file, {
+    maxDimension: options.maxDimension ?? MAX_DIMENSION,
+    quality: options.quality ?? JPEG_QUALITY,
+    outputType: options.outputType ?? OUTPUT_TYPE
+  });
+  if (!encoded || encoded.size >= file.size) return file;
+  return encoded;
+};
+const fitImageToUploadBudget = async (file, { maxBytes = AI_UPLOAD_SAFE_BYTES } = {}) => {
+  const isAccepted = AI_ACCEPTED_TYPES.has(file.type);
+  if (isAccepted && file.size <= maxBytes) return file;
+  const keepsAlpha = file.type === "image/png" || file.type === "image/webp" || !isAccepted;
+  const sourceType = isAccepted ? file.type : "image/png";
+  const attempts = [
+    { maxDimension: AI_UPLOAD_MAX_DIMENSION, quality: AI_UPLOAD_QUALITY, outputType: sourceType },
+    ...keepsAlpha ? [{ maxDimension: AI_UPLOAD_MAX_DIMENSION, quality: AI_UPLOAD_QUALITY, outputType: "image/webp" }] : [],
+    { maxDimension: AI_UPLOAD_MAX_DIMENSION, quality: AI_UPLOAD_QUALITY, outputType: "image/jpeg" },
+    { maxDimension: AI_UPLOAD_FALLBACK_DIMENSION, quality: AI_UPLOAD_FALLBACK_QUALITY, outputType: "image/jpeg" }
+  ];
+  let smallest = null;
+  for (const attempt of attempts) {
+    const encoded = await encodeImageFile(file, attempt);
+    if (!encoded) continue;
+    if (encoded.size <= maxBytes) return encoded;
+    if (!smallest || encoded.size < smallest.size) smallest = encoded;
+  }
+  return smallest && smallest.size < file.size ? smallest : file;
+};
+const fileFromUrl = async (url, fileName, signal) => {
+  const blob = await (await fetch(url, { cache: "reload", mode: "cors", signal })).blob();
+  const type = blob.type || "image/jpeg";
+  return new File([blob], fileName, { type });
+};
+const measureImageDimensions = async (src) => {
+  if (!src) return null;
+  try {
+    const image = await loadImage(src);
+    if (!image.naturalWidth || !image.naturalHeight) return null;
+    return { width: image.naturalWidth, height: image.naturalHeight };
+  } catch {
+    return null;
+  }
+};
+export {
+  AI_UPLOAD_SAFE_BYTES,
+  fileFromUrl,
+  fitImageToUploadBudget,
+  imageExtensionForType,
+  measureImageDimensions,
+  resizeImageFile
+};
+//# sourceMappingURL=imageFile.js.map

package/dist/helpers/imageFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageFile.js","sources":["../../src/helpers/imageFile.ts"],"sourcesContent":["const MAX_DIMENSION = 1280;\nconst JPEG_QUALITY = 0.82;\nconst OUTPUT_TYPE = 'image/jpeg';\n\n/** Most AI upload endpoints cap files at 8 MB; this leaves room for multipart overhead. */\nexport const AI_UPLOAD_SAFE_BYTES = 7.5 * 1024 * 1024;\nconst AI_UPLOAD_MAX_DIMENSION = 4096;\nconst AI_UPLOAD_QUALITY = 0.95;\nconst AI_UPLOAD_FALLBACK_DIMENSION = 3072;\nconst AI_UPLOAD_FALLBACK_QUALITY = 0.9;\n\nexport type TImageOutputType = 'image/jpeg' | 'image/png' | 'image/webp';\n\nconst AI_ACCEPTED_TYPES = new Set<string>(['image/jpeg', 'image/png', 'image/webp']);\n\nconst EXTENSION_BY_TYPE: Record<TImageOutputType, string> = {\n  'image/jpeg': 'jpg',\n  'image/png': 'png',\n  'image/webp': 'webp',\n};\n\nexport interface IResizeImageOptions {\n  maxDimension?: number;\n  quality?: number;\n  /** Defaults to JPEG. PNG and WebP keep transparency. */\n  outputType?: TImageOutputType;\n}\n\nconst loadImage = (url: string): Promise<HTMLImageElement> =>\n  new Promise((resolve, reject) => {\n    const image = new Image();\n    image.onload = () => resolve(image);\n    image.onerror = () => reject(new Error('Failed to load image'));\n    image.src = url;\n  });\n\nconst scaledSize = (width: number, height: number, maxDimension: number): { width: number; height: number } => {\n  const longest = Math.max(width, height);\n  if (longest <= maxDimension) return { width, height };\n  const ratio = maxDimension / longest;\n  return { width: Math.round(width * ratio), height: Math.round(height * ratio) };\n};\n\nconst baseName = (name: string): string => name.replace(/\\.[^.]+$/, '') || name || 'image';\n\n/** File extension (without dot) for an image MIME type, `jpg` when unknown. */\nexport const imageExtensionForType = (type: string): string =>\n  type in EXTENSION_BY_TYPE ? EXTENSION_BY_TYPE[type as TImageOutputType] : 'jpg';\n\nconst withExtension = (name: string, type: TImageOutputType): string => `${baseName(name)}.${EXTENSION_BY_TYPE[type]}`;\n\nconst encodeImageFile = async (file: File, options: Required<IResizeImageOptions>): Promise<File | null> => {\n  const objectUrl = URL.createObjectURL(file);\n  try {\n    const image = await loadImage(objectUrl);\n    const { width, height } = scaledSize(image.naturalWidth, image.naturalHeight, options.maxDimension);\n\n    const canvas = document.createElement('canvas');\n    canvas.width = width;\n    canvas.height = height;\n    const context = canvas.getContext('2d');\n    if (!context) return null;\n    // JPEG has no alpha: without a fill, transparent pixels would turn black.\n    if (options.outputType === 'image/jpeg') {\n      context.fillStyle = '#ffffff';\n      context.fillRect(0, 0, width, height);\n    }\n    context.drawImage(image, 0, 0, width, height);\n\n    const blob = await new Promise<Blob | null>((resolve) =>\n      canvas.toBlob(resolve, options.outputType, options.quality),\n    );\n    if (!blob) return null;\n\n    return new File([blob], withExtension(file.name, options.outputType), { type: options.outputType });\n  } catch {\n    return null;\n  } finally {\n    URL.revokeObjectURL(objectUrl);\n  }\n};\n\nexport const resizeImageFile = async (file: File, options: IResizeImageOptions = {}): Promise<File> => {\n  const encoded = await encodeImageFile(file, {\n    maxDimension: options.maxDimension ?? MAX_DIMENSION,\n    quality: options.quality ?? JPEG_QUALITY,\n    outputType: options.outputType ?? OUTPUT_TYPE,\n  });\n  if (!encoded || encoded.size >= file.size) return file;\n  return encoded;\n};\n\nexport interface IFitImageToUploadBudgetOptions {\n  maxBytes?: number;\n}\n\n/**\n * Keeps the source image untouched whenever it already fits the upload budget, so an AI edit\n * works on the original pixels. Only an oversized (or non PNG/JPEG/WebP) file is re-encoded,\n * with high quality and the source format when possible, stepping down until it fits.\n */\nexport const fitImageToUploadBudget = async (\n  file: File,\n  { maxBytes = AI_UPLOAD_SAFE_BYTES }: IFitImageToUploadBudgetOptions = {},\n): Promise<File> => {\n  const isAccepted = AI_ACCEPTED_TYPES.has(file.type);\n  if (isAccepted && file.size <= maxBytes) return file;\n\n  const keepsAlpha = file.type === 'image/png' || file.type === 'image/webp' || !isAccepted;\n  const sourceType: TImageOutputType = isAccepted ? (file.type as TImageOutputType) : 'image/png';\n  const attempts: Array<Required<IResizeImageOptions>> = [\n    { maxDimension: AI_UPLOAD_MAX_DIMENSION, quality: AI_UPLOAD_QUALITY, outputType: sourceType },\n    ...(keepsAlpha\n      ? [{ maxDimension: AI_UPLOAD_MAX_DIMENSION, quality: AI_UPLOAD_QUALITY, outputType: 'image/webp' as const }]\n      : []),\n    { maxDimension: AI_UPLOAD_MAX_DIMENSION, quality: AI_UPLOAD_QUALITY, outputType: 'image/jpeg' },\n    { maxDimension: AI_UPLOAD_FALLBACK_DIMENSION, quality: AI_UPLOAD_FALLBACK_QUALITY, outputType: 'image/jpeg' },\n  ];\n\n  let smallest: File | null = null;\n  for (const attempt of attempts) {\n    const encoded = await encodeImageFile(file, attempt);\n    if (!encoded) continue;\n    if (encoded.size <= maxBytes) return encoded;\n    if (!smallest || encoded.size < smallest.size) smallest = encoded;\n  }\n\n  return smallest && smallest.size < file.size ? smallest : file;\n};\n\n// `reload` em vez de `force-cache`: a mesma imagem costuma já ter sido baixada por um <img>\n// comum, que não manda `Origin` e por isso é guardada sem `Access-Control-Allow-Origin`.\n// Reaproveitar essa entrada é o que faz o CORS falhar \"hora sim, hora não\".\nexport const fileFromUrl = async (url: string, fileName: string, signal?: AbortSignal): Promise<File> => {\n  const blob = await (await fetch(url, { cache: 'reload', mode: 'cors', signal })).blob();\n  const type = blob.type || 'image/jpeg';\n  return new File([blob], fileName, { type });\n};\n\n/**\n * Mede a imagem sem baixá-la de novo quando o navegador já a tem em cache.\n *\n * Devolve `null` em vez de lançar: medir é para AVISAR o usuário, então uma imagem que não carrega\n * aqui não pode derrubar a tela nem virar um alerta falso.\n */\nexport const measureImageDimensions = async (src: string): Promise<{ width: number; height: number } | null> => {\n  if (!src) return null;\n  try {\n    const image = await loadImage(src);\n    if (!image.naturalWidth || !image.naturalHeight) return null;\n    return { width: image.naturalWidth, height: image.naturalHeight };\n  } catch {\n    return null;\n  }\n};\n"],"names":[],"mappings":"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"}

package/dist/helpers/layeredSurfaces.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Surfaces that portal to `document.body`: they land OUTSIDE their opener in the DOM while
+ * sitting visually ON TOP of it.
+ *
+ * A dismissible surface (drawer, popover, menu) must not read a press on one of these as
+ * "the user clicked outside, close me". Confirming a dialog or picking from a select's
+ * listbox is layered work happening ABOVE the surface, not a dismissal of it.
+ *
+ * A floating panel also carries `data-layered-surface`, whatever `role` its consumer gives it:
+ * the select renders its menu panel as `role="presentation"` (the real `role="listbox"` is the
+ * options container inside it), so a role-only selector missed the search field sitting in that
+ * panel and read a press on it as a press outside.
+ */
+export declare const LAYERED_SURFACE_DATA_ATTRIBUTE = "data-layered-surface";
+export declare const LAYERED_SURFACE_ATTRIBUTE: {
+    readonly "data-layered-surface": "";
+};
+export declare const LAYERED_SURFACE_SELECTOR = "[role=\"dialog\"],[role=\"menu\"],[role=\"tooltip\"],[role=\"listbox\"],[data-layered-surface]";
+/**
+ * Whether the press landed on a surface stacked ABOVE `currentSurface`.
+ *
+ * The direction matters and checking only "is it a layered surface" is wrong: a select
+ * opened inside a drawer sits above a panel that is itself `role="dialog"`, so a press
+ * anywhere in that drawer would look layered and the select would never close. Every one of
+ * these surfaces portals to `document.body`, so the one appended LATER is the one painted on
+ * top: document order is the stacking order.
+ */
+export declare const isPressOnLayeredSurface: (target: EventTarget | null, currentSurface?: Element | null) => boolean;

package/dist/helpers/layeredSurfaces.js

@@ -0,0 +1,19 @@
+const LAYERED_SURFACE_DATA_ATTRIBUTE = "data-layered-surface";
+const LAYERED_SURFACE_ATTRIBUTE = { [LAYERED_SURFACE_DATA_ATTRIBUTE]: "" };
+const LAYERED_SURFACE_SELECTOR = `[role="dialog"],[role="menu"],[role="tooltip"],[role="listbox"],[${LAYERED_SURFACE_DATA_ATTRIBUTE}]`;
+const ALWAYS_ON_TOP_SELECTOR = ".Toastify";
+const isPressOnLayeredSurface = (target, currentSurface) => {
+  if (!(target instanceof Element)) return false;
+  if (target.closest(ALWAYS_ON_TOP_SELECTOR)) return true;
+  const pressed = target.closest(LAYERED_SURFACE_SELECTOR);
+  if (!pressed) return false;
+  if (!currentSurface || pressed === currentSurface) return false;
+  return Boolean(currentSurface.compareDocumentPosition(pressed) & Node.DOCUMENT_POSITION_FOLLOWING);
+};
+export {
+  LAYERED_SURFACE_ATTRIBUTE,
+  LAYERED_SURFACE_DATA_ATTRIBUTE,
+  LAYERED_SURFACE_SELECTOR,
+  isPressOnLayeredSurface
+};
+//# sourceMappingURL=layeredSurfaces.js.map

package/dist/helpers/layeredSurfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layeredSurfaces.js","sources":["../../src/helpers/layeredSurfaces.ts"],"sourcesContent":["/**\n * Surfaces that portal to `document.body`: they land OUTSIDE their opener in the DOM while\n * sitting visually ON TOP of it.\n *\n * A dismissible surface (drawer, popover, menu) must not read a press on one of these as\n * \"the user clicked outside, close me\". Confirming a dialog or picking from a select's\n * listbox is layered work happening ABOVE the surface, not a dismissal of it.\n *\n * A floating panel also carries `data-layered-surface`, whatever `role` its consumer gives it:\n * the select renders its menu panel as `role=\"presentation\"` (the real `role=\"listbox\"` is the\n * options container inside it), so a role-only selector missed the search field sitting in that\n * panel and read a press on it as a press outside.\n */\nexport const LAYERED_SURFACE_DATA_ATTRIBUTE = 'data-layered-surface';\nexport const LAYERED_SURFACE_ATTRIBUTE = { [LAYERED_SURFACE_DATA_ATTRIBUTE]: '' } as const;\n\nexport const LAYERED_SURFACE_SELECTOR = `[role=\"dialog\"],[role=\"menu\"],[role=\"tooltip\"],[role=\"listbox\"],[${LAYERED_SURFACE_DATA_ATTRIBUTE}]`;\n\n/**\n * Superfícies que estão acima de TUDO por construção, e não por posição no documento.\n *\n * O toast é o caso: ele vive num container próprio montado no topo da árvore do app, com\n * z-index máximo, e não é portado junto das outras superfícies. Então a comparação por ordem no\n * documento diz que ele vem ANTES de um drawer portado para o fim do `body`, e o drawer conclui\n * que o clique foi \"fora, feche-me\". Era isso que fazia o X do toast fechar o drawer do produto\n * junto com a notificação.\n *\n * Um toast nunca é dismissal de nada: ele aparece por conta própria, sobre o que estiver aberto.\n */\nconst ALWAYS_ON_TOP_SELECTOR = '.Toastify';\n\n/**\n * Whether the press landed on a surface stacked ABOVE `currentSurface`.\n *\n * The direction matters and checking only \"is it a layered surface\" is wrong: a select\n * opened inside a drawer sits above a panel that is itself `role=\"dialog\"`, so a press\n * anywhere in that drawer would look layered and the select would never close. Every one of\n * these surfaces portals to `document.body`, so the one appended LATER is the one painted on\n * top: document order is the stacking order.\n */\nexport const isPressOnLayeredSurface = (target: EventTarget | null, currentSurface?: Element | null): boolean => {\n  if (!(target instanceof Element)) return false;\n  if (target.closest(ALWAYS_ON_TOP_SELECTOR)) return true;\n\n  const pressed = target.closest(LAYERED_SURFACE_SELECTOR);\n  if (!pressed) return false;\n  if (!currentSurface || pressed === currentSurface) return false;\n\n  return Boolean(currentSurface.compareDocumentPosition(pressed) & Node.DOCUMENT_POSITION_FOLLOWING);\n};\n"],"names":[],"mappings":"AAaO,MAAM,iCAAiC;AACvC,MAAM,4BAA4B,EAAE,CAAC,8BAA8B,GAAG,GAAA;AAEtE,MAAM,2BAA2B,oEAAoE,8BAA8B;AAa1I,MAAM,yBAAyB;AAWxB,MAAM,0BAA0B,CAAC,QAA4B,mBAA6C;AAC/G,MAAI,EAAE,kBAAkB,SAAU,QAAO;AACzC,MAAI,OAAO,QAAQ,sBAAsB,EAAG,QAAO;AAEnD,QAAM,UAAU,OAAO,QAAQ,wBAAwB;AACvD,MAAI,CAAC,QAAS,QAAO;AACrB,MAAI,CAAC,kBAAkB,YAAY,eAAgB,QAAO;AAE1D,SAAO,QAAQ,eAAe,wBAAwB,OAAO,IAAI,KAAK,2BAA2B;AACnG;"}

package/dist/helpers/mathHelpers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Calculate and format a percentage from two values
+ * @param smallerValue - The numerator value
+ * @param totalValue - The denominator value
+ * @returns Formatted percentage string with 0 decimal places or '0%' if totalValue is 0
+ */
+export declare const calculatePercentage: (smallerValue: number, totalValue: number) => string;
+/**
+ * Calculate percentage as a decimal number
+ * @param value - The numerator value
+ * @param total - The denominator value
+ * @returns Percentage as a decimal number (e.g., 15.5 for 15.5%)
+ */
+export declare const getPercentage: (value: number, total: number) => number;

package/dist/helpers/mathHelpers.js

@@ -0,0 +1,13 @@
+const calculatePercentage = (smallerValue, totalValue) => {
+  if (!totalValue) return "0%";
+  const percentage = smallerValue / totalValue * 100;
+  return `${percentage.toFixed(0)}%`;
+};
+const getPercentage = (value, total) => {
+  return value / total * 100;
+};
+export {
+  calculatePercentage,
+  getPercentage
+};
+//# sourceMappingURL=mathHelpers.js.map

package/dist/helpers/mathHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mathHelpers.js","sources":["../../src/helpers/mathHelpers.ts"],"sourcesContent":["/**\n * Calculate and format a percentage from two values\n * @param smallerValue - The numerator value\n * @param totalValue - The denominator value\n * @returns Formatted percentage string with 0 decimal places or '0%' if totalValue is 0\n */\nexport const calculatePercentage = (smallerValue: number, totalValue: number): string => {\n  if (!totalValue) return '0%';\n\n  const percentage = (smallerValue / totalValue) * 100;\n  return `${percentage.toFixed(0)}%`;\n};\n\n/**\n * Calculate percentage as a decimal number\n * @param value - The numerator value\n * @param total - The denominator value\n * @returns Percentage as a decimal number (e.g., 15.5 for 15.5%)\n */\nexport const getPercentage = (value: number, total: number) => {\n  return (value / total) * 100;\n};\n"],"names":[],"mappings":"AAMO,MAAM,sBAAsB,CAAC,cAAsB,eAA+B;AACvF,MAAI,CAAC,WAAY,QAAO;AAExB,QAAM,aAAc,eAAe,aAAc;AACjD,SAAO,GAAG,WAAW,QAAQ,CAAC,CAAC;AACjC;AAQO,MAAM,gBAAgB,CAAC,OAAe,UAAkB;AAC7D,SAAQ,QAAQ,QAAS;AAC3B;"}

package/dist/helpers/mergeClasses.d.ts

@@ -0,0 +1,10 @@
+/**
+ * tailwind-merge only knows Tailwind's stock scales, and what it does not know it misfiles:
+ * `text-xxs` reads as a text COLOR and is dropped as soon as a tone follows it, `shadow-elevation1`
+ * reads as a shadow colour and survives the `shadow-none` meant to replace it, `duration-fast`
+ * and `animate-state-rise` read as foreign classes and never conflict with anything.
+ *
+ * Every class string in this library merges through here (ESLint enforces it), and the values
+ * below are the ones `tailwind.preset.js` adds; test/mergeClasses.test.ts fails when they drift.
+ */
+export declare const mergeClasses: (...classLists: import('tailwind-merge').ClassNameValue[]) => string;

package/dist/helpers/mergeClasses.js

@@ -0,0 +1,34 @@
+import { extendTailwindMerge } from "tailwind-merge";
+const mergeClasses = extendTailwindMerge({
+  extend: {
+    theme: {
+      text: ["xxs"],
+      shadow: ["elevation1", "elevation2", "elevation3", "elevation4", "focus"],
+      ease: ["enter", "exit", "standard"],
+      animate: [
+        "fade-in-up",
+        "fade-in",
+        "ai-orbit",
+        "ai-bob",
+        "ai-sweep",
+        "ai-step",
+        "pop-in",
+        "state-fade",
+        "state-rise",
+        "state-reveal",
+        "state-float",
+        "state-breathe",
+        "state-halo",
+        "state-drift"
+      ]
+    },
+    classGroups: {
+      duration: [{ duration: ["instant", "fast", "base", "slow", "highlight"] }],
+      transition: [{ transition: ["interactive"] }]
+    }
+  }
+});
+export {
+  mergeClasses
+};
+//# sourceMappingURL=mergeClasses.js.map

package/dist/helpers/mergeClasses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeClasses.js","sources":["../../src/helpers/mergeClasses.ts"],"sourcesContent":["import { extendTailwindMerge } from 'tailwind-merge';\n\n/**\n * tailwind-merge only knows Tailwind's stock scales, and what it does not know it misfiles:\n * `text-xxs` reads as a text COLOR and is dropped as soon as a tone follows it, `shadow-elevation1`\n * reads as a shadow colour and survives the `shadow-none` meant to replace it, `duration-fast`\n * and `animate-state-rise` read as foreign classes and never conflict with anything.\n *\n * Every class string in this library merges through here (ESLint enforces it), and the values\n * below are the ones `tailwind.preset.js` adds; test/mergeClasses.test.ts fails when they drift.\n */\nexport const mergeClasses = extendTailwindMerge({\n  extend: {\n    theme: {\n      text: ['xxs'],\n      shadow: ['elevation1', 'elevation2', 'elevation3', 'elevation4', 'focus'],\n      ease: ['enter', 'exit', 'standard'],\n      animate: [\n        'fade-in-up',\n        'fade-in',\n        'ai-orbit',\n        'ai-bob',\n        'ai-sweep',\n        'ai-step',\n        'pop-in',\n        'state-fade',\n        'state-rise',\n        'state-reveal',\n        'state-float',\n        'state-breathe',\n        'state-halo',\n        'state-drift',\n      ],\n    },\n    classGroups: {\n      duration: [{ duration: ['instant', 'fast', 'base', 'slow', 'highlight'] }],\n      transition: [{ transition: ['interactive'] }],\n    },\n  },\n});\n"],"names":[],"mappings":";AAWO,MAAM,eAAe,oBAAoB;AAAA,EAC9C,QAAQ;AAAA,IACN,OAAO;AAAA,MACL,MAAM,CAAC,KAAK;AAAA,MACZ,QAAQ,CAAC,cAAc,cAAc,cAAc,cAAc,OAAO;AAAA,MACxE,MAAM,CAAC,SAAS,QAAQ,UAAU;AAAA,MAClC,SAAS;AAAA,QACP;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MAAA;AAAA,IACF;AAAA,IAEF,aAAa;AAAA,MACX,UAAU,CAAC,EAAE,UAAU,CAAC,WAAW,QAAQ,QAAQ,QAAQ,WAAW,GAAG;AAAA,MACzE,YAAY,CAAC,EAAE,YAAY,CAAC,aAAa,GAAG;AAAA,IAAA;AAAA,EAC9C;AAEJ,CAAC;"}

package/dist/helpers/moduleLoadErrorHelpers.d.ts

@@ -0,0 +1 @@
+export declare const isModuleLoadError: (error: unknown) => boolean;

package/dist/helpers/moduleLoadErrorHelpers.js

@@ -0,0 +1,25 @@
+const MODULE_LOAD_ERROR_PATTERNS = [
+  "failed to fetch dynamically imported module",
+  "error loading dynamically imported module",
+  "importing a module script failed",
+  "failed to load module script",
+  "unable to preload css",
+  "chunkloaderror",
+  "loading chunk",
+  "loading css chunk"
+];
+const isModuleLoadError = (error) => {
+  if (!error) return false;
+  if (typeof error === "string") {
+    return MODULE_LOAD_ERROR_PATTERNS.some((pattern) => error.toLowerCase().includes(pattern));
+  }
+  const candidate = error;
+  const name = typeof candidate.name === "string" ? candidate.name : "";
+  const message = typeof candidate.message === "string" ? candidate.message : "";
+  const searchable = `${name} ${message}`.toLowerCase();
+  return MODULE_LOAD_ERROR_PATTERNS.some((pattern) => searchable.includes(pattern));
+};
+export {
+  isModuleLoadError
+};
+//# sourceMappingURL=moduleLoadErrorHelpers.js.map

package/dist/helpers/moduleLoadErrorHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleLoadErrorHelpers.js","sources":["../../src/helpers/moduleLoadErrorHelpers.ts"],"sourcesContent":["const MODULE_LOAD_ERROR_PATTERNS = [\n  'failed to fetch dynamically imported module',\n  'error loading dynamically imported module',\n  'importing a module script failed',\n  'failed to load module script',\n  'unable to preload css',\n  'chunkloaderror',\n  'loading chunk',\n  'loading css chunk',\n];\n\nexport const isModuleLoadError = (error: unknown): boolean => {\n  if (!error) return false;\n\n  if (typeof error === 'string') {\n    return MODULE_LOAD_ERROR_PATTERNS.some((pattern) => error.toLowerCase().includes(pattern));\n  }\n\n  const candidate = error as { name?: unknown; message?: unknown };\n  const name = typeof candidate.name === 'string' ? candidate.name : '';\n  const message = typeof candidate.message === 'string' ? candidate.message : '';\n  const searchable = `${name} ${message}`.toLowerCase();\n\n  return MODULE_LOAD_ERROR_PATTERNS.some((pattern) => searchable.includes(pattern));\n};\n"],"names":[],"mappings":"AAAA,MAAM,6BAA6B;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,oBAAoB,CAAC,UAA4B;AAC5D,MAAI,CAAC,MAAO,QAAO;AAEnB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,2BAA2B,KAAK,CAAC,YAAY,MAAM,YAAA,EAAc,SAAS,OAAO,CAAC;AAAA,EAC3F;AAEA,QAAM,YAAY;AAClB,QAAM,OAAO,OAAO,UAAU,SAAS,WAAW,UAAU,OAAO;AACnE,QAAM,UAAU,OAAO,UAAU,YAAY,WAAW,UAAU,UAAU;AAC5E,QAAM,aAAa,GAAG,IAAI,IAAI,OAAO,GAAG,YAAA;AAExC,SAAO,2BAA2B,KAAK,CAAC,YAAY,WAAW,SAAS,OAAO,CAAC;AAClF;"}

package/dist/helpers/objectHelpers.d.ts

@@ -0,0 +1,13 @@
+export declare const ObjectHelpers: {
+    removeProperty: <T extends Record<string, unknown>, K extends keyof T>(obj: T, key: K) => Omit<T, K>;
+    removeProperties: <T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: Array<K>) => Omit<T, K>;
+    removePropertyMutating: <T extends Record<string, unknown>, K extends keyof T>(obj: T, key: K) => void;
+    removePropertiesMutating: <T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: Array<K>) => void;
+    cleanObject: <T extends Record<string, unknown>>(obj: T, predicate?: (key: keyof T, value: T[keyof T]) => boolean) => Partial<T>;
+    omitUndefined: <T extends Record<string, unknown>>(obj: T) => Partial<T>;
+};
+export declare const CacheUtils: {
+    clearCacheEntry: <T>(cache: Record<string, T>, key: string) => void;
+    clearCacheEntries: <T>(cache: Record<string, T>, keys: Array<string>) => void;
+    cleanCache: <T>(cache: Record<string, T>, predicate: (key: string, value: T) => boolean) => void;
+};

package/dist/helpers/objectHelpers.js

@@ -0,0 +1,59 @@
+const ObjectHelpers = {
+  removeProperty: (obj, key) => {
+    const { [key]: _, ...rest } = obj;
+    return rest;
+  },
+  removeProperties: (obj, keys) => {
+    const result = { ...obj };
+    keys.forEach((key) => {
+      delete result[key];
+    });
+    return result;
+  },
+  removePropertyMutating: (obj, key) => {
+    if (key in obj) {
+      delete obj[key];
+    }
+  },
+  removePropertiesMutating: (obj, keys) => {
+    keys.forEach((key) => {
+      if (key in obj) {
+        delete obj[key];
+      }
+    });
+  },
+  cleanObject: (obj, predicate = (_, value) => value !== void 0) => {
+    return Object.fromEntries(
+      Object.entries(obj).filter(([key, value]) => predicate(key, value))
+    );
+  },
+  omitUndefined: (obj) => {
+    return ObjectHelpers.cleanObject(obj, (_, value) => value !== void 0);
+  }
+};
+const CacheUtils = {
+  clearCacheEntry: (cache, key) => {
+    if (key in cache) {
+      delete cache[key];
+    }
+  },
+  clearCacheEntries: (cache, keys) => {
+    keys.forEach((key) => {
+      if (key in cache) {
+        delete cache[key];
+      }
+    });
+  },
+  cleanCache: (cache, predicate) => {
+    Object.keys(cache).forEach((key) => {
+      if (!predicate(key, cache[key])) {
+        delete cache[key];
+      }
+    });
+  }
+};
+export {
+  CacheUtils,
+  ObjectHelpers
+};
+//# sourceMappingURL=objectHelpers.js.map

package/dist/helpers/objectHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectHelpers.js","sources":["../../src/helpers/objectHelpers.ts"],"sourcesContent":["export const ObjectHelpers = {\n  removeProperty: <T extends Record<string, unknown>, K extends keyof T>(obj: T, key: K): Omit<T, K> => {\n    const { [key]: _, ...rest } = obj;\n    return rest;\n  },\n\n  removeProperties: <T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: Array<K>): Omit<T, K> => {\n    const result = { ...obj };\n    keys.forEach((key) => {\n      delete result[key];\n    });\n    return result;\n  },\n\n  removePropertyMutating: <T extends Record<string, unknown>, K extends keyof T>(obj: T, key: K): void => {\n    if (key in obj) {\n      delete obj[key];\n    }\n  },\n\n  removePropertiesMutating: <T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: Array<K>): void => {\n    keys.forEach((key) => {\n      if (key in obj) {\n        delete obj[key];\n      }\n    });\n  },\n\n  cleanObject: <T extends Record<string, unknown>>(\n    obj: T,\n    predicate: (key: keyof T, value: T[keyof T]) => boolean = (_, value) => value !== undefined,\n  ): Partial<T> => {\n    return Object.fromEntries(\n      Object.entries(obj).filter(([key, value]) => predicate(key, value as T[keyof T])),\n    ) as Partial<T>;\n  },\n\n  omitUndefined: <T extends Record<string, unknown>>(obj: T): Partial<T> => {\n    return ObjectHelpers.cleanObject(obj, (_, value) => value !== undefined);\n  },\n};\n\nexport const CacheUtils = {\n  clearCacheEntry: <T>(cache: Record<string, T>, key: string): void => {\n    if (key in cache) {\n      delete cache[key];\n    }\n  },\n\n  clearCacheEntries: <T>(cache: Record<string, T>, keys: Array<string>): void => {\n    keys.forEach((key) => {\n      if (key in cache) {\n        delete cache[key];\n      }\n    });\n  },\n\n  cleanCache: <T>(cache: Record<string, T>, predicate: (key: string, value: T) => boolean): void => {\n    Object.keys(cache).forEach((key) => {\n      if (!predicate(key, cache[key])) {\n        delete cache[key];\n      }\n    });\n  },\n};\n"],"names":[],"mappings":"AAAO,MAAM,gBAAgB;AAAA,EAC3B,gBAAgB,CAAuD,KAAQ,QAAuB;AACpG,UAAM,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,SAAS;AAC9B,WAAO;AAAA,EACT;AAAA,EAEA,kBAAkB,CAAuD,KAAQ,SAA+B;AAC9G,UAAM,SAAS,EAAE,GAAG,IAAA;AACpB,SAAK,QAAQ,CAAC,QAAQ;AACpB,aAAO,OAAO,GAAG;AAAA,IACnB,CAAC;AACD,WAAO;AAAA,EACT;AAAA,EAEA,wBAAwB,CAAuD,KAAQ,QAAiB;AACtG,QAAI,OAAO,KAAK;AACd,aAAO,IAAI,GAAG;AAAA,IAChB;AAAA,EACF;AAAA,EAEA,0BAA0B,CAAuD,KAAQ,SAAyB;AAChH,SAAK,QAAQ,CAAC,QAAQ;AACpB,UAAI,OAAO,KAAK;AACd,eAAO,IAAI,GAAG;AAAA,MAChB;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,aAAa,CACX,KACA,YAA0D,CAAC,GAAG,UAAU,UAAU,WACnE;AACf,WAAO,OAAO;AAAA,MACZ,OAAO,QAAQ,GAAG,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,MAAM,UAAU,KAAK,KAAmB,CAAC;AAAA,IAAA;AAAA,EAEpF;AAAA,EAEA,eAAe,CAAoC,QAAuB;AACxE,WAAO,cAAc,YAAY,KAAK,CAAC,GAAG,UAAU,UAAU,MAAS;AAAA,EACzE;AACF;AAEO,MAAM,aAAa;AAAA,EACxB,iBAAiB,CAAI,OAA0B,QAAsB;AACnE,QAAI,OAAO,OAAO;AAChB,aAAO,MAAM,GAAG;AAAA,IAClB;AAAA,EACF;AAAA,EAEA,mBAAmB,CAAI,OAA0B,SAA8B;AAC7E,SAAK,QAAQ,CAAC,QAAQ;AACpB,UAAI,OAAO,OAAO;AAChB,eAAO,MAAM,GAAG;AAAA,MAClB;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,YAAY,CAAI,OAA0B,cAAwD;AAChG,WAAO,KAAK,KAAK,EAAE,QAAQ,CAAC,QAAQ;AAClC,UAAI,CAAC,UAAU,KAAK,MAAM,GAAG,CAAC,GAAG;AAC/B,eAAO,MAAM,GAAG;AAAA,MAClB;AAAA,IACF,CAAC;AAAA,EACH;AACF;"}

package/dist/helpers/portalHost.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The host element every overlay portals into, or null where there is no DOM.
+ *
+ * `createPortal` runs during RENDER, so reading `document.body` inline throws
+ * `ReferenceError: document is not defined` on a server render (Next.js App
+ * Router renders every page on the server first). The overlays this affects are
+ * interactive by nature and have nothing to show before hydration, so the server
+ * render skips them and the client mounts them on the first paint.
+ */
+export declare function getPortalHost(): HTMLElement | null;

package/dist/helpers/portalHost.js

@@ -0,0 +1,7 @@
+function getPortalHost() {
+  return typeof document === "undefined" ? null : document.body;
+}
+export {
+  getPortalHost
+};
+//# sourceMappingURL=portalHost.js.map

package/dist/helpers/portalHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portalHost.js","sources":["../../src/helpers/portalHost.ts"],"sourcesContent":["/**\n * The host element every overlay portals into, or null where there is no DOM.\n *\n * `createPortal` runs during RENDER, so reading `document.body` inline throws\n * `ReferenceError: document is not defined` on a server render (Next.js App\n * Router renders every page on the server first). The overlays this affects are\n * interactive by nature and have nothing to show before hydration, so the server\n * render skips them and the client mounts them on the first paint.\n */\nexport function getPortalHost(): HTMLElement | null {\n  return typeof document === 'undefined' ? null : document.body;\n}\n"],"names":[],"mappings":"AASO,SAAS,gBAAoC;AAClD,SAAO,OAAO,aAAa,cAAc,OAAO,SAAS;AAC3D;"}

package/dist/helpers/richText.d.ts

@@ -0,0 +1,46 @@
+import { IFileAttachment } from '../interfaces/IFileAttachment';
+export type TRichTextColor = 'default' | 'brand' | 'secondary' | 'accent' | 'success' | 'warning' | 'danger' | 'info' | 'muted';
+export declare const RICH_TEXT_COLORS: Array<TRichTextColor>;
+export declare const RICH_TEXT_COLOR_CLASS: Record<Exclude<TRichTextColor, 'default'>, string>;
+/** The swatch shown in the palette: a token-driven background, never the stored value. */
+export declare const RICH_TEXT_COLOR_SWATCH_CLASS: Record<TRichTextColor, string>;
+export declare const RICH_TEXT_FILE_CLASS = "rt-file";
+/** An image written INTO the body, as opposed to a file referenced by name. */
+export declare const RICH_TEXT_IMAGE_CLASS = "rt-image";
+export declare const RICH_TEXT_IMAGE_LINK_CLASS = "rt-image-link";
+/**
+ * Text written before the rich editor existed is plain text with real line breaks. Rendered as
+ * HTML those breaks collapse, so the renderer needs to know which format it is looking at.
+ */
+export declare const isPlainTextBody: (html?: string) => boolean;
+export declare const sanitizeRichText: (html?: string) => string;
+/** Emptiness has to be measured on the text: an editor the user only clicked into holds `<br>`. */
+export declare const richTextToPlainText: (html?: string) => string;
+/**
+ * A body whose only content is an attachment has no text at all, so measuring emptiness on the
+ * text alone would throw away the picture the user just wrote into the field.
+ */
+export declare const isRichTextEmpty: (html?: string) => boolean;
+/**
+ * Seeds the editor from a value stored before the field became rich text. The line structure is
+ * preserved and the text is escaped, so nothing in it is read as markup.
+ */
+export declare const plainTextToRichHtml: (text?: string) => string;
+/** The value as the editor should receive it, whichever format it was stored in. */
+export declare const toEditableRichHtml: (value?: string) => string;
+/**
+ * Rewrites whatever `foreColor` just produced. Called again on every input because a colour
+ * chosen with no selection only materialises on the next typed character: without this pass
+ * that character would keep the literal sentinel colour, which the sanitizer drops.
+ */
+export declare const normalizeRichTextColorNodes: (editor: HTMLElement, color: TRichTextColor) => void;
+export declare const applyRichTextColor: (editor: HTMLElement, color: TRichTextColor) => void;
+/** The colour of the text under the caret, so the palette can show what is currently applied. */
+export declare const activeRichTextColor: (editor: HTMLElement) => TRichTextColor;
+/**
+ * An uploaded file referenced from inside the body. Hosts that have no attachment field of
+ * their own still keep the reference, because it travels in the same string the text does.
+ * An image is written as the picture itself, wrapped in the link that opens it at full size:
+ * a name-only chip hides what was attached, and the reader has no way to look at it.
+ */
+export declare const buildFileChipMarkup: (attachment: IFileAttachment) => string;