@djangocfg/widget-data 0.1.1

package/src/FileIcon/index.ts

@@ -0,0 +1,19 @@
+'use client';
+
+export { FileIcon } from './FileIcon';
+export type { FileIconProps, FileIconSize } from './FileIcon';
+
+export { createFileIconSlot } from './treeAdapter';
+export type { CreateFileIconSlotOptions } from './treeAdapter';
+
+export { resolveFolderIcon } from './specialFolders';
+export type {
+  ResolveFolderIconOptions,
+  FolderIconOverrides,
+} from './specialFolders';
+
+export { getFileIcon, DEFAULT_FILE_ICON } from './get-file-icon';
+export type { FileIconDef } from './get-file-icon';
+
+/** @deprecated Use `getFileIcon` — resolution is now synchronous. */
+export { loadMaterialIcons, getMaterialIconsSync } from './loader';

package/src/FileIcon/loader.ts

@@ -0,0 +1,29 @@
+'use client';
+
+/**
+ * Back-compat shim for the former `material-file-icons` lazy loader.
+ *
+ * File icons are now resolved synchronously from a vendored static data
+ * module — see `./get-file-icon`. The async API is kept so existing callers
+ * of `loadMaterialIcons` / `getMaterialIconsSync` keep working; both resolve
+ * immediately to the local resolver.
+ *
+ * @deprecated Import {@link getFileIcon} from `./get-file-icon` instead.
+ */
+
+import { getFileIcon } from './get-file-icon';
+
+/** Returns an inline SVG string for a file name, or `undefined`. */
+type GetIconFn = (name: string) => { svg?: string } | undefined;
+
+const localGetIcon: GetIconFn = (name) => ({ svg: getFileIcon(name).svg });
+
+/** @deprecated Use {@link getFileIcon} — resolution is now synchronous. */
+export function loadMaterialIcons(): Promise<GetIconFn> {
+  return Promise.resolve(localGetIcon);
+}
+
+/** @deprecated Use {@link getFileIcon} — resolution is now synchronous. */
+export function getMaterialIconsSync(): GetIconFn {
+  return localGetIcon;
+}

package/src/FileIcon/specialFolders.ts

@@ -0,0 +1,110 @@
+'use client';
+
+import {
+  BookOpen,
+  Component,
+  Database,
+  FlaskConical,
+  Folder,
+  FolderCode,
+  FolderGit2,
+  FolderInput,
+  FolderOpen,
+  FolderOutput,
+  Image as ImageIcon,
+  Languages,
+  Package,
+  Settings,
+  Terminal,
+  Workflow,
+  type LucideIcon,
+} from 'lucide-react';
+
+/**
+ * Conventional folder names → Lucide icon. Lookup is case-insensitive and
+ * trimmed. Anything not in this map falls back to a generic folder icon.
+ *
+ * Designed to feel "right" across the common dev project layouts (Node,
+ * Python, Go, Rust, Django, Next, Vite). Not exhaustive on purpose —
+ * keeps the bundle light and the behaviour predictable.
+ */
+const SPECIAL_FOLDERS: Record<string, LucideIcon> = {
+  src: FolderCode,
+  source: FolderCode,
+  lib: FolderCode,
+  app: FolderCode,
+  packages: Package,
+  node_modules: Package,
+  vendor: Package,
+  public: FolderInput,
+  static: FolderInput,
+  assets: ImageIcon,
+  images: ImageIcon,
+  media: ImageIcon,
+  dist: FolderOutput,
+  build: FolderOutput,
+  out: FolderOutput,
+  '.next': FolderOutput,
+  '.nuxt': FolderOutput,
+  '.turbo': FolderOutput,
+  docs: BookOpen,
+  documentation: BookOpen,
+  tests: FlaskConical,
+  test: FlaskConical,
+  __tests__: FlaskConical,
+  __test__: FlaskConical,
+  spec: FlaskConical,
+  scripts: Terminal,
+  bin: Terminal,
+  config: Settings,
+  configs: Settings,
+  '.config': Settings,
+  '.vscode': Settings,
+  '.idea': Settings,
+  '.git': FolderGit2,
+  '.github': FolderGit2,
+  '.gitlab': FolderGit2,
+  '.husky': Workflow,
+  '.circleci': Workflow,
+  components: Component,
+  component: Component,
+  ui: Component,
+  i18n: Languages,
+  locale: Languages,
+  locales: Languages,
+  lang: Languages,
+  translations: Languages,
+  db: Database,
+  database: Database,
+  migrations: Database,
+};
+
+export interface ResolveFolderIconOptions {
+  /** Folder display name (no path). */
+  name: string;
+  /** Open / closed state — only used for the *generic* folder fallback. */
+  isExpanded?: boolean;
+  /**
+   * Optional override map. Wins over the built-in table. Keys are
+   * matched case-insensitively after `trim()`.
+   */
+  overrides?: Record<string, LucideIcon>;
+}
+
+/**
+ * Pick the right folder icon for `name`. Returns `Folder` / `FolderOpen`
+ * for unknown names so callers can render the generic open/closed pair.
+ */
+export function resolveFolderIcon({
+  name,
+  isExpanded = false,
+  overrides,
+}: ResolveFolderIconOptions): LucideIcon {
+  const key = name.trim().toLowerCase();
+  if (overrides?.[key]) return overrides[key];
+  const special = SPECIAL_FOLDERS[key];
+  if (special) return special;
+  return isExpanded ? FolderOpen : Folder;
+}
+
+export type FolderIconOverrides = Record<string, LucideIcon>;

package/src/FileIcon/treeAdapter.tsx

@@ -0,0 +1,49 @@
+'use client';
+
+import type { TreeNode, TreeRowSlot } from '../Tree/types';
+import { FileIcon, type FileIconSize } from './FileIcon';
+import type { FolderIconOverrides } from './specialFolders';
+
+export interface CreateFileIconSlotOptions<T> {
+  /**
+   * How to read the displayed name (with extension) for a node. Use the same
+   * accessor you pass to `<TreeRoot getItemName={...} />`.
+   */
+  getName: (node: TreeNode<T>) => string;
+  /** Pixel size for both file and folder icons. Default: 16. */
+  size?: FileIconSize;
+  /**
+   * Override or extend the built-in special-folder mapping (e.g. give
+   * `tests` a custom icon). Keys are matched case-insensitively.
+   */
+  folderOverrides?: FolderIconOverrides;
+}
+
+/**
+ * Build a `renderIcon` slot for `<TreeRoot>` that uses `<FileIcon>` for both
+ * leaves and folders.
+ *
+ * @example
+ * ```tsx
+ * <TreeRoot
+ *   data={data}
+ *   getItemName={(n) => n.data.name}
+ *   renderIcon={createFileIconSlot({ getName: (n) => n.data.name })}
+ * />
+ * ```
+ */
+export function createFileIconSlot<T>({
+  getName,
+  size = 16,
+  folderOverrides,
+}: CreateFileIconSlotOptions<T>): TreeRowSlot<T> {
+  return ({ node, isFolder, isExpanded }) => (
+    <FileIcon
+      name={getName(node)}
+      isFolder={isFolder}
+      isExpanded={isExpanded}
+      size={size}
+      folderOverrides={folderOverrides}
+    />
+  );
+}