@wildo-ai/saas-frontend-lib 1.0.1

package/dist/esm/core/icons/icon-registry.frontend.definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-registry.frontend.definitions.d.ts","sourceRoot":"","sources":["../../../../src/core/icons/icon-registry.frontend.definitions.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,UAAU,EAEV,KAAK,aAAa,EAElB,KAAK,mBAAmB,EACzB,MAAM,kCAAkC,CAAC;AA0B1C;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAkB5D;AAcD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAEzF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAAC,GAAG,IAAI,CAI7F;AAiBD,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,qBAAqB,EAChC,MAAM,EAAE,mBAAmB,GAC1B,IAAI,CAEN;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,qBAAqB,GAC/B,mBAAmB,GAAG,SAAS,CAEjC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAK/E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EACrD,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,EACvB,OAAO,EAAE,KAAK,CAAC,CAAC,qBAAqB,EAAE,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,GAC9F,IAAI,CAaN;AAMD,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,EAAE,UAGjC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAO9B,CAAC"}

package/dist/esm/core/icons/icon-registry.frontend.definitions.js

@@ -0,0 +1,142 @@
+import React from 'react';
+import { IconSize, } from './icon-registry.frontend.schemas.js';
+/**
+ * Framework-owned inline SVG fallback — rendered when no icon is registered for a reference.
+ * Visually: circle with exclamation mark (alert indicator). No external dependency.
+ */
+const FallbackIcon = function FallbackIcon({ size = 20, className, color }) {
+    return React.createElement('svg', {
+        xmlns: 'http://www.w3.org/2000/svg',
+        width: size,
+        height: size,
+        viewBox: '0 0 24 24',
+        fill: 'none',
+        stroke: color || 'currentColor',
+        strokeWidth: 2,
+        strokeLinecap: 'round',
+        strokeLinejoin: 'round',
+        className,
+        'aria-hidden': true,
+    }, React.createElement('circle', { cx: 12, cy: 12, r: 10 }), React.createElement('line', { x1: 12, y1: 8, x2: 12, y2: 12 }), React.createElement('line', { x1: 12, y1: 16, x2: 12.01, y2: 16 }));
+};
+/**
+ * Factory for emoji-based IconComponents.
+ * Enables flags, symbols, and other Unicode characters as first-class icons
+ * through the same IconComponent contract as SVG icons.
+ *
+ * `color` is applied as CSS `color` — works for text-based unicode characters
+ * (dingbats, symbols) but most platform emoji renderers ignore it.
+ * `strokeWidth` is not applicable to emoji and is silently ignored.
+ */
+export function createEmojiIcon(emoji) {
+    return function EmojiIcon({ size = 20, className, color }) {
+        return React.createElement('span', {
+            className,
+            role: 'img',
+            'aria-hidden': true,
+            style: {
+                fontSize: size,
+                lineHeight: 1,
+                display: 'inline-flex',
+                alignItems: 'center',
+                justifyContent: 'center',
+                width: size,
+                height: size,
+                color,
+            },
+        }, emoji);
+    };
+}
+// ---------------------------------------------------------------------------
+// Standard icon registration — populated by presets at startup, before mount
+// ---------------------------------------------------------------------------
+/**
+ * Module-level map for standard icon implementations.
+ * Populated by `registerStandardIcons()` (called from presets during componentLoader).
+ * `CoreIconRegistry.standard` references this map directly — the provider's `useMemo`
+ * copies entries at mount time, by which point presets have already populated it.
+ */
+const IconStandardDataMap = new Map();
+export function registerStandardIcon(ref, config) {
+    IconStandardDataMap.set(ref, config);
+}
+export function registerStandardIcons(icons) {
+    for (const [ref, config] of icons) {
+        IconStandardDataMap.set(ref, config);
+    }
+}
+// ---------------------------------------------------------------------------
+// Animation data registration — separate map, read per-call in renderIcon
+// ---------------------------------------------------------------------------
+/**
+ * Module-level map for animation overlays on standard icons.
+ * Read per-call by `getIconAnimation()` in the rendering path — not captured in
+ * the provider's `useMemo`, so always fresh regardless of React lifecycle.
+ *
+ * This asymmetry with `IconStandardDataMap` is intentional: standard icons participate
+ * in the provider's merge pipeline (customRegistry can override them), so they flow
+ * through `useMemo`. Animations are an independent overlay with no merge semantics.
+ */
+const IconAnimationDataMap = new Map();
+export function registerIconAnimation(reference, config) {
+    IconAnimationDataMap.set(reference, config);
+}
+export function getIconAnimation(reference) {
+    return IconAnimationDataMap.get(reference);
+}
+/**
+ * Checks whether an animation config has a valid source that can be rendered.
+ * Valid = dotLottieUrl present OR (animationData with non-empty layers array).
+ */
+export function hasValidAnimationSource(animation) {
+    if (animation.dotLottieUrl)
+        return true;
+    if (!animation.animationData)
+        return false;
+    const data = animation.animationData;
+    return Array.isArray(data.layers) && data.layers.length > 0;
+}
+/**
+ * Bulk registration of animation overlays from a data record.
+ * Each entry maps a StandardIconReference to a key in the data record (the dotLottie URL)
+ * plus optional animation config overrides.
+ *
+ * The generic `K` constrains mapping keys to actual keys in `data`, catching typos at compile time.
+ */
+export function registerIconAnimations(data, mapping) {
+    for (const [ref, key, opts] of mapping) {
+        const url = data[key];
+        if (url) {
+            registerIconAnimation(ref, {
+                dotLottieUrl: url,
+                loop: opts?.loop ?? true,
+                autoplay: opts?.autoplay ?? true,
+                speed: opts?.speed,
+                minSize: opts?.minSize,
+            });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Core registry + default config
+// ---------------------------------------------------------------------------
+/** Default fallback for unregistered icon references */
+export const DEFAULT_ICON_CONFIG = {
+    icon: FallbackIcon,
+    defaultSize: IconSize.MD,
+};
+/**
+ * Core icon registry.
+ * `standard` points to `IconStandardDataMap` — populated by presets before the
+ * provider mounts. Other categories start empty and are filled via `customRegistry`
+ * prop on `IconRegistryProvider`.
+ */
+export const CoreIconRegistry = {
+    resources: new Map(),
+    operationResources: new Map(),
+    enumValues: new Map(),
+    standard: IconStandardDataMap,
+    compositeView: new Map(),
+    custom: new Map(),
+};
+//# sourceMappingURL=icon-registry.frontend.definitions.js.map

package/dist/esm/core/icons/icon-registry.frontend.definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-registry.frontend.definitions.js","sourceRoot":"","sources":["../../../../src/core/icons/icon-registry.frontend.definitions.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/icons/icon-registry.frontend.schemas.d.ts

@@ -0,0 +1,294 @@
+import type { ComponentType } from 'react';
+import { z } from 'zod';
+import { ResourceType } from '@wildo-ai/saas-models';
+/**
+ * Standard Icon References
+ * These are the standard icons used across the application
+ */
+export declare enum StandardIconReference {
+    HOME = "home",
+    MENU = "menu",
+    CLOSE = "close",
+    BACK = "back",
+    FORWARD = "forward",
+    ADD = "add",
+    EDIT = "edit",
+    DELETE = "delete",
+    SAVE = "save",
+    CANCEL = "cancel",
+    SEARCH = "search",
+    FILTER = "filter",
+    REFRESH = "refresh",
+    DOWNLOAD = "download",
+    UPLOAD = "upload",
+    COPY = "copy",
+    SHARE = "share",
+    SUCCESS = "success",
+    ERROR = "error",
+    WARNING = "warning",
+    INFO = "info",
+    LOADING = "loading",
+    ERROR_NOT_FOUND = "error_not_found",
+    ERROR_ACCESS_DENIED = "error_access_denied",
+    ERROR_SERVER = "error_server",
+    ERROR_APPLICATION = "error_application",
+    ERROR_UNKNOWN = "error_unknown",
+    RELOAD = "reload",
+    TRY_AGAIN = "try_again",
+    USER = "user",
+    USERS = "users",
+    PROFILE = "profile",
+    SETTINGS = "settings",
+    LOGOUT = "logout",
+    LOGIN = "login",
+    ORGANIZATION = "organization",
+    TEAM = "team",
+    FILE = "file",
+    FILE_IMAGE = "file_image",
+    FILE_VIDEO = "file_video",
+    FILE_AUDIO = "file_audio",
+    FILE_TEXT = "file_text",
+    FILE_SPREADSHEET = "file_spreadsheet",
+    FILE_PRESENTATION = "file_presentation",
+    FILE_ARCHIVE = "file_archive",
+    FOLDER = "folder",
+    MAIL = "mail",
+    NOTIFICATION = "notification",
+    CHAT = "chat",
+    CALENDAR = "calendar",
+    CLOCK = "clock",
+    LOCK = "lock",
+    UNLOCK = "unlock",
+    HELP = "help",
+    EXTERNAL_LINK = "external_link",
+    MORE = "more",
+    CHEVRON_DOWN = "chevron_down",
+    CHEVRON_UP = "chevron_up",
+    CHEVRON_LEFT = "chevron_left",
+    CHEVRON_RIGHT = "chevron_right",
+    CHECK = "check",
+    CHECK_CIRCLE = "check_circle",
+    X_CIRCLE = "x_circle",
+    CIRCLE = "circle",
+    MINUS = "minus",
+    DOT = "dot",
+    CHEVRONS_UP_DOWN = "chevrons_up_down",
+    ARROW_LEFT = "arrow_left",
+    ARROW_RIGHT = "arrow_right",
+    ARROW_DOWN = "arrow_down",
+    CORNER_DOWN_LEFT = "corner_down_left",
+    GRIP_VERTICAL = "grip_vertical",
+    MORE_HORIZONTAL = "more_horizontal",
+    PANEL_LEFT = "panel_left",
+    PAPERCLIP = "paperclip",
+    PLUS = "plus",
+    SQUARE = "square",
+    IMAGE = "image",
+    MIC = "mic",
+    LOADER_2 = "loader_2",
+    WRENCH = "wrench",
+    BOOK = "book",
+    BOOKMARK = "bookmark",
+    BRAIN = "brain",
+    MESSAGE_CIRCLE = "message_circle",
+    DOCUMENT = "document",
+    X_MARK = "x_mark",
+    EYE = "eye",
+    EYE_OFF = "eye_off",
+    CREDIT_CARD = "credit_card",
+    INVOICE = "invoice",
+    SUBSCRIPTION = "subscription",
+    CREDIT_POOL = "credit_pool",
+    PROMOTION = "promotion",
+    METER = "meter",
+    RECEIPT = "receipt",
+    CHART = "chart",
+    LOADING_LIGHT = "loading_light",
+    LOADING_DARK = "loading_dark",
+    NETWORK_ERROR = "network_error",
+    TADA = "tada"
+}
+export declare const StandardIconReferenceSchema: z.ZodEnum<typeof StandardIconReference>;
+/**
+ * Icon Categories
+ */
+export declare enum IconCategory {
+    RESOURCES = "resources",
+    OPERATION_RESOURCES = "operation_resources",
+    ENUM_VALUES = "enum_values",
+    STANDARD = "standard",
+    COMPOSITE_VIEW = "composite_view",
+    CUSTOM = "custom"
+}
+export declare const IconCategorySchema: z.ZodEnum<typeof IconCategory>;
+/**
+ * Icon size variants
+ */
+export declare enum IconSize {
+    XS = "xs",
+    SM = "sm",
+    MD = "md",
+    LG = "lg",
+    XL = "xl"
+}
+export declare const IconSizeSchema: z.ZodEnum<typeof IconSize>;
+declare const IconRequest_ResourcesSchema: z.ZodObject<{
+    category: z.ZodLiteral<IconCategory.RESOURCES>;
+    resourceType: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>;
+declare const IconRequest_OperationResourcesSchema: z.ZodObject<{
+    category: z.ZodLiteral<IconCategory.OPERATION_RESOURCES>;
+    resourceType: z.ZodString;
+    operationReference: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>;
+declare const IconRequest_EnumValuesSchema: z.ZodObject<{
+    category: z.ZodLiteral<IconCategory.ENUM_VALUES>;
+    enumReference: z.ZodString;
+    enumValue: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>;
+declare const IconRequest_StandardSchema: z.ZodObject<{
+    category: z.ZodLiteral<IconCategory.STANDARD>;
+    iconReference: z.ZodEnum<typeof StandardIconReference>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+declare const IconRequest_CompositeViewSchema: z.ZodObject<{
+    category: z.ZodLiteral<IconCategory.COMPOSITE_VIEW>;
+    viewReference: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>;
+declare const IconRequest_CustomSchema: z.ZodObject<{
+    category: z.ZodLiteral<IconCategory.CUSTOM>;
+    customReference: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export declare const IconRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    category: z.ZodLiteral<IconCategory.RESOURCES>;
+    resourceType: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    category: z.ZodLiteral<IconCategory.OPERATION_RESOURCES>;
+    resourceType: z.ZodString;
+    operationReference: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    category: z.ZodLiteral<IconCategory.ENUM_VALUES>;
+    enumReference: z.ZodString;
+    enumValue: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    category: z.ZodLiteral<IconCategory.STANDARD>;
+    iconReference: z.ZodEnum<typeof StandardIconReference>;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    category: z.ZodLiteral<IconCategory.COMPOSITE_VIEW>;
+    viewReference: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    category: z.ZodLiteral<IconCategory.CUSTOM>;
+    customReference: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>], "category">;
+export declare const IconPropsSchema: z.ZodObject<{
+    request: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        category: z.ZodLiteral<IconCategory.RESOURCES>;
+        resourceType: z.ZodString;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        category: z.ZodLiteral<IconCategory.OPERATION_RESOURCES>;
+        resourceType: z.ZodString;
+        operationReference: z.ZodString;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        category: z.ZodLiteral<IconCategory.ENUM_VALUES>;
+        enumReference: z.ZodString;
+        enumValue: z.ZodString;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        category: z.ZodLiteral<IconCategory.STANDARD>;
+        iconReference: z.ZodEnum<typeof StandardIconReference>;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        category: z.ZodLiteral<IconCategory.COMPOSITE_VIEW>;
+        viewReference: z.ZodString;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        category: z.ZodLiteral<IconCategory.CUSTOM>;
+        customReference: z.ZodString;
+    }, z.core.$strip, core.$ZodObjectExtra>], "category">;
+    size: z.ZodOptional<z.ZodEnum<typeof IconSize>>;
+    className: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    color: z.ZodOptional<z.ZodString>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type IconRequest_Resources = z.infer<typeof IconRequest_ResourcesSchema>;
+export type IconRequest_OperationResources = z.infer<typeof IconRequest_OperationResourcesSchema>;
+export type IconRequest_EnumValues = z.infer<typeof IconRequest_EnumValuesSchema>;
+export type IconRequest_Standard = z.infer<typeof IconRequest_StandardSchema>;
+export type IconRequest_CompositeView = z.infer<typeof IconRequest_CompositeViewSchema>;
+export type IconRequest_Custom = z.infer<typeof IconRequest_CustomSchema>;
+export type IconRequest = z.infer<typeof IconRequestSchema>;
+export type IconProps = z.infer<typeof IconPropsSchema>;
+/**
+ * Icon size to pixel mapping
+ */
+export declare const ICON_SIZE_MAP: Record<IconSize, number>;
+/**
+ * Icon render options (used by both simple and registry APIs)
+ */
+export interface IconRenderOptions {
+    size?: IconSize;
+    className?: string;
+    strokeWidth?: number;
+    color?: string;
+}
+/**
+ * Framework-owned abstract icon component props.
+ * Any icon library whose components accept these props (Lucide, custom SVGs, emoji wrappers)
+ * can be registered as an IconComponent without adapters.
+ */
+export interface IconComponentProps {
+    size?: number;
+    className?: string;
+    strokeWidth?: number;
+    color?: string;
+}
+/**
+ * Any React component that accepts IconComponentProps.
+ * Concrete implementations include Lucide icons, emoji wrappers (via createEmojiIcon),
+ * custom SVG components, or any future icon source.
+ */
+export type IconComponent = ComponentType<IconComponentProps>;
+/**
+ * Animation configuration for animated icons (Lottie JSON / DotLottie).
+ * All fields are config-time concerns — set at registration, not at render callsites.
+ */
+export interface IconAnimationConfig {
+    /** Lottie JSON animation data */
+    animationData?: object;
+    /** DotLottie URL (base64 data URL or HTTP URL) */
+    dotLottieUrl?: string;
+    /** Whether the animation loops (intrinsic to the asset, not the consumer) */
+    loop: boolean;
+    /** Whether to autoplay on mount */
+    autoplay: boolean;
+    /** Playback speed multiplier (1 = normal). Currently applies to dotLottie sources only — lottie-react controls speed via its imperative API, not props. */
+    speed?: number;
+    /** Below this size threshold, the static icon fallback is used instead of the animation */
+    minSize?: IconSize;
+}
+/**
+ * Icon configuration for themable icons.
+ * The static `icon` component is always present and serves as the fallback.
+ *
+ * For standard icons, animations are registered via the separate `IconAnimationDataMap`
+ * (through `registerIconAnimation()`), not through this `animation` field.
+ *
+ * The `animation` field exists for non-standard categories (resource, custom, enum)
+ * where icons are registered inline via `customRegistry` on the provider — these
+ * don't go through the standard registration path and can embed animation config directly.
+ */
+export interface IconConfig {
+    icon: IconComponent;
+    defaultSize?: IconSize;
+    className?: string;
+    animation?: IconAnimationConfig;
+}
+/**
+ * Icon registry structure
+ */
+export interface IconRegistry {
+    resources?: Map<ResourceType, IconConfig>;
+    operationResources?: Map<string, IconConfig>;
+    enumValues?: Map<string, IconConfig>;
+    standard: Map<StandardIconReference, IconConfig>;
+    compositeView?: Map<string, IconConfig>;
+    custom?: Map<string, IconConfig>;
+}
+export {};
+//# sourceMappingURL=icon-registry.frontend.schemas.d.ts.map

package/dist/esm/core/icons/icon-registry.frontend.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-registry.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/icons/icon-registry.frontend.schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/icons/icon-registry.frontend.schemas.js

@@ -0,0 +1,205 @@
+import { z } from 'zod';
+/**
+ * Standard Icon References
+ * These are the standard icons used across the application
+ */
+export var StandardIconReference;
+(function (StandardIconReference) {
+    // Navigation
+    StandardIconReference["HOME"] = "home";
+    StandardIconReference["MENU"] = "menu";
+    StandardIconReference["CLOSE"] = "close";
+    StandardIconReference["BACK"] = "back";
+    StandardIconReference["FORWARD"] = "forward";
+    // Actions
+    StandardIconReference["ADD"] = "add";
+    StandardIconReference["EDIT"] = "edit";
+    StandardIconReference["DELETE"] = "delete";
+    StandardIconReference["SAVE"] = "save";
+    StandardIconReference["CANCEL"] = "cancel";
+    StandardIconReference["SEARCH"] = "search";
+    StandardIconReference["FILTER"] = "filter";
+    StandardIconReference["REFRESH"] = "refresh";
+    StandardIconReference["DOWNLOAD"] = "download";
+    StandardIconReference["UPLOAD"] = "upload";
+    StandardIconReference["COPY"] = "copy";
+    StandardIconReference["SHARE"] = "share";
+    // Status
+    StandardIconReference["SUCCESS"] = "success";
+    StandardIconReference["ERROR"] = "error";
+    StandardIconReference["WARNING"] = "warning";
+    StandardIconReference["INFO"] = "info";
+    StandardIconReference["LOADING"] = "loading";
+    // Error Display
+    StandardIconReference["ERROR_NOT_FOUND"] = "error_not_found";
+    StandardIconReference["ERROR_ACCESS_DENIED"] = "error_access_denied";
+    StandardIconReference["ERROR_SERVER"] = "error_server";
+    StandardIconReference["ERROR_APPLICATION"] = "error_application";
+    StandardIconReference["ERROR_UNKNOWN"] = "error_unknown";
+    StandardIconReference["RELOAD"] = "reload";
+    StandardIconReference["TRY_AGAIN"] = "try_again";
+    // User
+    StandardIconReference["USER"] = "user";
+    StandardIconReference["USERS"] = "users";
+    StandardIconReference["PROFILE"] = "profile";
+    StandardIconReference["SETTINGS"] = "settings";
+    StandardIconReference["LOGOUT"] = "logout";
+    StandardIconReference["LOGIN"] = "login";
+    // Organization
+    StandardIconReference["ORGANIZATION"] = "organization";
+    StandardIconReference["TEAM"] = "team";
+    // Files
+    StandardIconReference["FILE"] = "file";
+    StandardIconReference["FILE_IMAGE"] = "file_image";
+    StandardIconReference["FILE_VIDEO"] = "file_video";
+    StandardIconReference["FILE_AUDIO"] = "file_audio";
+    StandardIconReference["FILE_TEXT"] = "file_text";
+    StandardIconReference["FILE_SPREADSHEET"] = "file_spreadsheet";
+    StandardIconReference["FILE_PRESENTATION"] = "file_presentation";
+    StandardIconReference["FILE_ARCHIVE"] = "file_archive";
+    StandardIconReference["FOLDER"] = "folder";
+    // Communication
+    StandardIconReference["MAIL"] = "mail";
+    StandardIconReference["NOTIFICATION"] = "notification";
+    StandardIconReference["CHAT"] = "chat";
+    // Misc
+    StandardIconReference["CALENDAR"] = "calendar";
+    StandardIconReference["CLOCK"] = "clock";
+    StandardIconReference["LOCK"] = "lock";
+    StandardIconReference["UNLOCK"] = "unlock";
+    StandardIconReference["HELP"] = "help";
+    StandardIconReference["EXTERNAL_LINK"] = "external_link";
+    StandardIconReference["MORE"] = "more";
+    StandardIconReference["CHEVRON_DOWN"] = "chevron_down";
+    StandardIconReference["CHEVRON_UP"] = "chevron_up";
+    StandardIconReference["CHEVRON_LEFT"] = "chevron_left";
+    StandardIconReference["CHEVRON_RIGHT"] = "chevron_right";
+    // UI Pattern Icons - Checks & Indicators
+    StandardIconReference["CHECK"] = "check";
+    StandardIconReference["CHECK_CIRCLE"] = "check_circle";
+    StandardIconReference["X_CIRCLE"] = "x_circle";
+    StandardIconReference["CIRCLE"] = "circle";
+    StandardIconReference["MINUS"] = "minus";
+    StandardIconReference["DOT"] = "dot";
+    // UI Pattern Icons - Chevrons & Arrows
+    StandardIconReference["CHEVRONS_UP_DOWN"] = "chevrons_up_down";
+    StandardIconReference["ARROW_LEFT"] = "arrow_left";
+    StandardIconReference["ARROW_RIGHT"] = "arrow_right";
+    StandardIconReference["ARROW_DOWN"] = "arrow_down";
+    StandardIconReference["CORNER_DOWN_LEFT"] = "corner_down_left";
+    // UI Pattern Icons - Actions & Controls
+    StandardIconReference["GRIP_VERTICAL"] = "grip_vertical";
+    StandardIconReference["MORE_HORIZONTAL"] = "more_horizontal";
+    StandardIconReference["PANEL_LEFT"] = "panel_left";
+    StandardIconReference["PAPERCLIP"] = "paperclip";
+    StandardIconReference["PLUS"] = "plus";
+    StandardIconReference["SQUARE"] = "square";
+    StandardIconReference["IMAGE"] = "image";
+    StandardIconReference["MIC"] = "mic";
+    StandardIconReference["LOADER_2"] = "loader_2";
+    StandardIconReference["WRENCH"] = "wrench";
+    // Content Icons
+    StandardIconReference["BOOK"] = "book";
+    StandardIconReference["BOOKMARK"] = "bookmark";
+    StandardIconReference["BRAIN"] = "brain";
+    StandardIconReference["MESSAGE_CIRCLE"] = "message_circle";
+    // Document & File Icons
+    StandardIconReference["DOCUMENT"] = "document";
+    StandardIconReference["X_MARK"] = "x_mark";
+    // Visibility Icons
+    StandardIconReference["EYE"] = "eye";
+    StandardIconReference["EYE_OFF"] = "eye_off";
+    // Billing Icons
+    StandardIconReference["CREDIT_CARD"] = "credit_card";
+    StandardIconReference["INVOICE"] = "invoice";
+    StandardIconReference["SUBSCRIPTION"] = "subscription";
+    StandardIconReference["CREDIT_POOL"] = "credit_pool";
+    StandardIconReference["PROMOTION"] = "promotion";
+    StandardIconReference["METER"] = "meter";
+    StandardIconReference["RECEIPT"] = "receipt";
+    // Data Visualization
+    StandardIconReference["CHART"] = "chart";
+    // Animation-capable icons (have animated overlays when registered)
+    StandardIconReference["LOADING_LIGHT"] = "loading_light";
+    StandardIconReference["LOADING_DARK"] = "loading_dark";
+    StandardIconReference["NETWORK_ERROR"] = "network_error";
+    StandardIconReference["TADA"] = "tada";
+})(StandardIconReference || (StandardIconReference = {}));
+export const StandardIconReferenceSchema = z.enum(StandardIconReference);
+/**
+ * Icon Categories
+ */
+export var IconCategory;
+(function (IconCategory) {
+    IconCategory["RESOURCES"] = "resources";
+    IconCategory["OPERATION_RESOURCES"] = "operation_resources";
+    IconCategory["ENUM_VALUES"] = "enum_values";
+    IconCategory["STANDARD"] = "standard";
+    IconCategory["COMPOSITE_VIEW"] = "composite_view";
+    IconCategory["CUSTOM"] = "custom";
+})(IconCategory || (IconCategory = {}));
+export const IconCategorySchema = z.enum(IconCategory);
+/**
+ * Icon size variants
+ */
+export var IconSize;
+(function (IconSize) {
+    IconSize["XS"] = "xs";
+    IconSize["SM"] = "sm";
+    IconSize["MD"] = "md";
+    IconSize["LG"] = "lg";
+    IconSize["XL"] = "xl";
+})(IconSize || (IconSize = {}));
+export const IconSizeSchema = z.enum(IconSize);
+const IconRequest_ResourcesSchema = z.object({
+    category: z.literal(IconCategory.RESOURCES),
+    resourceType: z.string(),
+});
+const IconRequest_OperationResourcesSchema = z.object({
+    category: z.literal(IconCategory.OPERATION_RESOURCES),
+    resourceType: z.string(),
+    operationReference: z.string(),
+});
+const IconRequest_EnumValuesSchema = z.object({
+    category: z.literal(IconCategory.ENUM_VALUES),
+    enumReference: z.string(),
+    enumValue: z.string(),
+});
+const IconRequest_StandardSchema = z.object({
+    category: z.literal(IconCategory.STANDARD),
+    iconReference: StandardIconReferenceSchema,
+});
+const IconRequest_CompositeViewSchema = z.object({
+    category: z.literal(IconCategory.COMPOSITE_VIEW),
+    viewReference: z.string(),
+});
+const IconRequest_CustomSchema = z.object({
+    category: z.literal(IconCategory.CUSTOM),
+    customReference: z.string(),
+});
+export const IconRequestSchema = z.discriminatedUnion('category', [
+    IconRequest_ResourcesSchema,
+    IconRequest_OperationResourcesSchema,
+    IconRequest_EnumValuesSchema,
+    IconRequest_StandardSchema,
+    IconRequest_CompositeViewSchema,
+    IconRequest_CustomSchema,
+]);
+export const IconPropsSchema = z.object({
+    request: IconRequestSchema,
+    size: IconSizeSchema.optional(),
+    className: z.string().optional(),
+    strokeWidth: z.number().optional(),
+    color: z.string().optional(),
+});
+/**
+ * Icon size to pixel mapping
+ */
+export const ICON_SIZE_MAP = {
+    [IconSize.XS]: 12,
+    [IconSize.SM]: 16,
+    [IconSize.MD]: 20,
+    [IconSize.LG]: 24,
+    [IconSize.XL]: 32,
+};
+//# sourceMappingURL=icon-registry.frontend.schemas.js.map