@illuma-ai/icons 2.3.0 → 2.4.0

package/dist/files/FileIcon.d.ts

@@ -23,12 +23,19 @@ export interface ArtifactIconProps extends Omit<SVGProps<SVGSVGElement>, 'childr
     type?: string;
     /** Artifact language (e.g. `react`, `html`, `python`) — fallback when no type. */
     language?: string;
+    /**
+     * The artifact's real filename. Takes precedence over `type`/`language` so a
+     * `.docx` shows the Word icon even though its preview is rendered to PDF.
+     */
+    filename?: string;
     /** Pixel size for width and height. Defaults to 24. */
     size?: number;
 }
 /**
- * Icon for a side-panel code/document artifact, resolved from its type/language
- * rather than a filename (a React artifact → react icon, HTML → html, etc.).
+ * Icon for a side-panel code/document artifact. Resolved from the real filename
+ * first (source of truth), then artifact type/language — so a React artifact →
+ * react icon, an HTML artifact → html, and a `.docx` → Word (not PDF, even
+ * though its preview is rendered to PDF).
  */
 export declare const ArtifactIcon: import('react').ForwardRefExoticComponent<Omit<ArtifactIconProps, "ref"> & import('react').RefAttributes<SVGSVGElement>>;
 export interface AnimatedFileIconProps {

package/dist/files/resolve.d.ts

@@ -1,14 +1,22 @@
 import { FILE_ICONS, FileIconName, FileIconData } from './icons.generated';
 /** Generic fallback for unknown/other file types (Office 365 mark). */
 export declare const DEFAULT_FILE_ICON: FileIconName;
-/**
- * Resolve an artifact's icon from its `type` and/or `language`. Resolution
- * order: artifact type → language → {@link DEFAULT_FILE_ICON}.
- */
-export declare function resolveArtifactIcon(type?: string, language?: string): ResolvedFileIcon;
 export interface ResolvedFileIcon extends FileIconData {
     readonly name: FileIconName;
 }
+/**
+ * Resolve an artifact's icon. The real file is the source of truth, so a
+ * `filename` (when present) wins — a `.docx` shows the Word icon even though its
+ * side-panel PREVIEW is rendered to PDF. Resolution order:
+ * filename extension → artifact type → language → {@link DEFAULT_FILE_ICON}.
+ *
+ * @param type artifact type identifier (e.g. `application/vnd.react`); note that
+ *   office docs carry a `*-pdf-preview`/`*-preview` type reflecting how they're
+ *   rendered, NOT the source format — which is why `filename` is checked first.
+ * @param language artifact language (e.g. `react`, `python`)
+ * @param filename the artifact's real filename, when known
+ */
+export declare function resolveArtifactIcon(type?: string, language?: string, filename?: string): ResolvedFileIcon;
 /**
  * Resolve a file's icon from its filename and/or MIME type. Resolution order:
  * exact extension → exact MIME → {@link DEFAULT_FILE_ICON}.