@djangocfg/ui-tools 2.1.404 → 2.1.408

package/dist/file-icon/index.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { LucideIcon } from 'lucide-react';
-import { b as TreeNode, g as TreeRowSlot } from '../types-B_zhyAqR.cjs';
+import { b as TreeNode, g as TreeRowSlot } from '../types-eEu8SeiQ.cjs';
 import 'react';
 
 interface ResolveFolderIconOptions {
@@ -36,19 +36,25 @@ interface FileIconProps {
      * matched case-insensitively. Only used when `isFolder` is true.
      */
     folderOverrides?: FolderIconOverrides;
+    /**
+     * Accessible label. When omitted the icon is decorative (`aria-hidden`) —
+     * correct when it sits next to a visible file name. Pass a string to
+     * expose the icon to assistive technology.
+     */
+    label?: string;
     className?: string;
 }
 /**
  * VSCode-style file icon.
  *
- * - Folders render Lucide `Folder` / `FolderOpen` (amber tint).
- * - Files use `material-file-icons` if it's installed in the consumer; otherwise
- *   fall back to a neutral Lucide `File` icon.
+ * - Folders render Lucide `Folder` / `FolderOpen` (warning-token tint).
+ * - Files render rich, colourful SVGs vendored from `material-file-icons`
+ *   (MIT). Resolution is synchronous — no runtime dependency, no async load.
  *
- * The optional dependency is loaded lazily on first render — there is zero
- * bundle cost for consumers who never mount this component.
+ * The icon SVG data is a static module, so it bundles into the `FileIcon`
+ * chunk and is only fetched by consumers that actually mount this component.
  */
-declare function FileIcon({ name, isFolder, isExpanded, size, folderOverrides, className, }: FileIconProps): react_jsx_runtime.JSX.Element;
+declare function FileIcon({ name, isFolder, isExpanded, size, folderOverrides, label, className, }: FileIconProps): react_jsx_runtime.JSX.Element;
 
 interface CreateFileIconSlotOptions<T> {
     /**
@@ -80,19 +86,51 @@ interface CreateFileIconSlotOptions<T> {
 declare function createFileIconSlot<T>({ getName, size, folderOverrides, }: CreateFileIconSlotOptions<T>): TreeRowSlot<T>;
 
 /**
- * Lazy loader for `material-file-icons`. The package is an optional dependency:
- * if it's installed in the consumer's tree, we render its rich VSCode-style
- * SVGs; if not, the loader resolves to `null` and `<FileIcon>` falls back to a
- * Lucide icon. Either way, ui-tools never throws or warns about a missing
- * package.
+ * Icon SVGs vendored from material-file-icons (MIT) —
+ * https://github.com/simonnilsson/material-file-icons
  *
- * Resolution is cached per-process so we don't re-import on every render.
+ * Auto-generated static data module. Do not edit by hand.
+ * Re-extract with getAllIcons() if upgrading the upstream package.
  */
-type GetIconFn = (name: string) => {
+interface FileIconDef {
+    /** Stable icon name (e.g. "html", "typescript"). */
+    name: string;
+    /** Raw inline SVG markup. Static vendored asset — safe to render. */
     svg: string;
+    /** Lowercase extensions (no dot) this icon matches. */
+    extensions?: string[];
+    /** Full lowercase filenames this icon matches exactly. */
+    files?: string[];
+}
+declare const DEFAULT_FILE_ICON: FileIconDef;
+
+/**
+ * Resolver for VSCode-style file icons. Replaces the former optional
+ * `material-file-icons` runtime dependency — the icon SVGs are now vendored
+ * as a static data module (`./icons/icon-data`), so the bundler resolves them
+ * deterministically with no dynamic `import()` and no `@vite-ignore`.
+ *
+ * Lookup matches the original `material-file-icons` algorithm:
+ *   1. exact full-name match (`files[]`, lowercased)
+ *   2. longest matching extension (`name.endsWith('.' + ext)`)
+ *   3. fall back to the default file icon
+ *
+ * The `files` / `extensions` lookup maps are built lazily on first call.
+ */
+
+/**
+ * Resolve the icon definition for a file name. Always returns a definition —
+ * unknown types yield {@link DEFAULT_FILE_ICON}.
+ */
+declare function getFileIcon(filename: string): FileIconDef;
+
+/** Returns an inline SVG string for a file name, or `undefined`. */
+type GetIconFn = (name: string) => {
+    svg?: string;
 } | undefined;
-declare function loadMaterialIcons(): Promise<GetIconFn | null>;
-/** Synchronous accessor — returns null until `loadMaterialIcons` resolves. */
-declare function getMaterialIconsSync(): GetIconFn | null;
+/** @deprecated Use {@link getFileIcon} — resolution is now synchronous. */
+declare function loadMaterialIcons(): Promise<GetIconFn>;
+/** @deprecated Use {@link getFileIcon} — resolution is now synchronous. */
+declare function getMaterialIconsSync(): GetIconFn;
 
-export { type CreateFileIconSlotOptions, FileIcon, type FileIconProps, type FileIconSize, type FolderIconOverrides, type ResolveFolderIconOptions, createFileIconSlot, getMaterialIconsSync, loadMaterialIcons, resolveFolderIcon };
+export { type CreateFileIconSlotOptions, DEFAULT_FILE_ICON, FileIcon, type FileIconDef, type FileIconProps, type FileIconSize, type FolderIconOverrides, type ResolveFolderIconOptions, createFileIconSlot, getFileIcon, getMaterialIconsSync, loadMaterialIcons, resolveFolderIcon };

package/dist/file-icon/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { LucideIcon } from 'lucide-react';
-import { b as TreeNode, g as TreeRowSlot } from '../types-B_zhyAqR.js';
+import { b as TreeNode, g as TreeRowSlot } from '../types-eEu8SeiQ.js';
 import 'react';
 
 interface ResolveFolderIconOptions {
@@ -36,19 +36,25 @@ interface FileIconProps {
      * matched case-insensitively. Only used when `isFolder` is true.
      */
     folderOverrides?: FolderIconOverrides;
+    /**
+     * Accessible label. When omitted the icon is decorative (`aria-hidden`) —
+     * correct when it sits next to a visible file name. Pass a string to
+     * expose the icon to assistive technology.
+     */
+    label?: string;
     className?: string;
 }
 /**
  * VSCode-style file icon.
  *
- * - Folders render Lucide `Folder` / `FolderOpen` (amber tint).
- * - Files use `material-file-icons` if it's installed in the consumer; otherwise
- *   fall back to a neutral Lucide `File` icon.
+ * - Folders render Lucide `Folder` / `FolderOpen` (warning-token tint).
+ * - Files render rich, colourful SVGs vendored from `material-file-icons`
+ *   (MIT). Resolution is synchronous — no runtime dependency, no async load.
  *
- * The optional dependency is loaded lazily on first render — there is zero
- * bundle cost for consumers who never mount this component.
+ * The icon SVG data is a static module, so it bundles into the `FileIcon`
+ * chunk and is only fetched by consumers that actually mount this component.
  */
-declare function FileIcon({ name, isFolder, isExpanded, size, folderOverrides, className, }: FileIconProps): react_jsx_runtime.JSX.Element;
+declare function FileIcon({ name, isFolder, isExpanded, size, folderOverrides, label, className, }: FileIconProps): react_jsx_runtime.JSX.Element;
 
 interface CreateFileIconSlotOptions<T> {
     /**
@@ -80,19 +86,51 @@ interface CreateFileIconSlotOptions<T> {
 declare function createFileIconSlot<T>({ getName, size, folderOverrides, }: CreateFileIconSlotOptions<T>): TreeRowSlot<T>;
 
 /**
- * Lazy loader for `material-file-icons`. The package is an optional dependency:
- * if it's installed in the consumer's tree, we render its rich VSCode-style
- * SVGs; if not, the loader resolves to `null` and `<FileIcon>` falls back to a
- * Lucide icon. Either way, ui-tools never throws or warns about a missing
- * package.
+ * Icon SVGs vendored from material-file-icons (MIT) —
+ * https://github.com/simonnilsson/material-file-icons
  *
- * Resolution is cached per-process so we don't re-import on every render.
+ * Auto-generated static data module. Do not edit by hand.
+ * Re-extract with getAllIcons() if upgrading the upstream package.
  */
-type GetIconFn = (name: string) => {
+interface FileIconDef {
+    /** Stable icon name (e.g. "html", "typescript"). */
+    name: string;
+    /** Raw inline SVG markup. Static vendored asset — safe to render. */
     svg: string;
+    /** Lowercase extensions (no dot) this icon matches. */
+    extensions?: string[];
+    /** Full lowercase filenames this icon matches exactly. */
+    files?: string[];
+}
+declare const DEFAULT_FILE_ICON: FileIconDef;
+
+/**
+ * Resolver for VSCode-style file icons. Replaces the former optional
+ * `material-file-icons` runtime dependency — the icon SVGs are now vendored
+ * as a static data module (`./icons/icon-data`), so the bundler resolves them
+ * deterministically with no dynamic `import()` and no `@vite-ignore`.
+ *
+ * Lookup matches the original `material-file-icons` algorithm:
+ *   1. exact full-name match (`files[]`, lowercased)
+ *   2. longest matching extension (`name.endsWith('.' + ext)`)
+ *   3. fall back to the default file icon
+ *
+ * The `files` / `extensions` lookup maps are built lazily on first call.
+ */
+
+/**
+ * Resolve the icon definition for a file name. Always returns a definition —
+ * unknown types yield {@link DEFAULT_FILE_ICON}.
+ */
+declare function getFileIcon(filename: string): FileIconDef;
+
+/** Returns an inline SVG string for a file name, or `undefined`. */
+type GetIconFn = (name: string) => {
+    svg?: string;
 } | undefined;
-declare function loadMaterialIcons(): Promise<GetIconFn | null>;
-/** Synchronous accessor — returns null until `loadMaterialIcons` resolves. */
-declare function getMaterialIconsSync(): GetIconFn | null;
+/** @deprecated Use {@link getFileIcon} — resolution is now synchronous. */
+declare function loadMaterialIcons(): Promise<GetIconFn>;
+/** @deprecated Use {@link getFileIcon} — resolution is now synchronous. */
+declare function getMaterialIconsSync(): GetIconFn;
 
-export { type CreateFileIconSlotOptions, FileIcon, type FileIconProps, type FileIconSize, type FolderIconOverrides, type ResolveFolderIconOptions, createFileIconSlot, getMaterialIconsSync, loadMaterialIcons, resolveFolderIcon };
+export { type CreateFileIconSlotOptions, DEFAULT_FILE_ICON, FileIcon, type FileIconDef, type FileIconProps, type FileIconSize, type FolderIconOverrides, type ResolveFolderIconOptions, createFileIconSlot, getFileIcon, getMaterialIconsSync, loadMaterialIcons, resolveFolderIcon };