@esportsplus/ui 0.56.4 → 0.57.0

package/build/components/editor/tree/icons.d.ts

@@ -0,0 +1,29 @@
+type Element = {
+    children?: unknown[];
+    name: string;
+    type?: 'file' | 'folder';
+};
+type Folder = typeof FOLDERS[number];
+type Interface = 'chevron' | 'file' | 'folder' | 'folder-open' | 'lock' | 'symlink';
+type Name = typeof NAMES[number];
+type Options = {
+    byFileExtension?: Rules<Name>;
+    byFileName?: Rules<Name>;
+    byFileNameContains?: Rules<Name>;
+    byFolderName?: Rules<Folder>;
+    colored?: boolean;
+    remap?: Partial<Record<Interface, string>>;
+    set?: Tier;
+};
+type Resolved = {
+    custom?: true;
+    name: string;
+};
+type Rules<T extends string> = Readonly<Record<string, T | (string & {})>>;
+type Tier = 'complete' | 'minimal' | 'standard';
+declare const FOLDERS: readonly ['assets', 'components', 'docs', 'git', 'output', 'packages', 'public', 'scripts', 'src', 'test'];
+declare const NAMES: readonly ['agents', 'astro', 'babel', 'bash', 'biome', 'bootstrap', 'browserslist', 'bun', 'c', 'claude', 'css', 'database', 'docker', 'eslint', 'file', 'font', 'git', 'go', 'graphql', 'html', 'image', 'javascript', 'json', 'markdown', 'mcp', 'nextjs', 'npm', 'oxc', 'package', 'pnpm', 'postcss', 'prettier', 'python', 'react', 'readme', 'ruby', 'rust', 'sass', 'stylelint', 'svelte', 'svg', 'svgo', 'swift', 'table', 'tailwind', 'terraform', 'text', 'tsconfig', 'typescript', 'vite', 'vscode', 'vue', 'wasm', 'webpack', 'yml', 'zig', 'zip'];
+declare function resolver(options?: Options): (element: Element) => Resolved;
+declare const resolve: (element: Element) => Resolved;
+export { FOLDERS, NAMES, resolve, resolver };
+export type { Folder, Interface, Name, Options, Resolved, Tier };

package/build/components/editor/tree/icons.js

@@ -0,0 +1,417 @@
+const BASIC = {
+    jsx: 'javascript',
+    sass: 'css',
+    scss: 'css',
+    tsx: 'typescript'
+};
+const CONFIG = /^(?:\.([a-z\d]+)rc|([a-z\d]+)\.config)(?:\.(?:[cm]?[jt]s|json[5c]?|toml|ya?ml))?$/;
+const CONFIGS = {
+    astro: 'astro',
+    babel: 'babel',
+    bash: 'bash',
+    browserslist: 'browserslist',
+    eslint: 'eslint',
+    next: 'nextjs',
+    npm: 'npm',
+    nuxt: 'vue',
+    oxlint: 'oxc',
+    postcss: 'postcss',
+    prettier: 'prettier',
+    stylelint: 'stylelint',
+    svelte: 'svelte',
+    svgo: 'svgo',
+    tailwind: 'tailwind',
+    vite: 'vite',
+    vitest: 'vite',
+    webpack: 'webpack',
+    zsh: 'bash'
+};
+const EXTENSIONS = {
+    '7z': 'zip',
+    astro: 'astro',
+    avif: 'image',
+    bash: 'bash',
+    bat: 'bash',
+    bmp: 'image',
+    bz2: 'zip',
+    c: 'c',
+    'c++': 'c',
+    cc: 'c',
+    cfg: 'text',
+    cjs: 'javascript',
+    cmd: 'bash',
+    'code-workspace': 'vscode',
+    conf: 'text',
+    config: 'text',
+    cpp: 'c',
+    csh: 'bash',
+    css: 'css',
+    csv: 'table',
+    cts: 'typescript',
+    cxx: 'c',
+    db: 'database',
+    dtd: 'html',
+    eot: 'font',
+    erb: 'ruby',
+    es6: 'javascript',
+    fish: 'bash',
+    gemspec: 'ruby',
+    geojson: 'json',
+    gif: 'image',
+    go: 'go',
+    gql: 'graphql',
+    graphql: 'graphql',
+    gz: 'zip',
+    h: 'c',
+    hcl: 'terraform',
+    heic: 'image',
+    hh: 'c',
+    hpp: 'c',
+    htm: 'html',
+    html: 'html',
+    hxx: 'c',
+    icns: 'image',
+    ico: 'image',
+    ini: 'text',
+    inl: 'c',
+    ipynb: 'python',
+    jar: 'zip',
+    jpeg: 'image',
+    jpg: 'image',
+    js: 'javascript',
+    json: 'json',
+    json5: 'json',
+    jsonc: 'json',
+    jsonl: 'json',
+    jsx: 'react',
+    ksh: 'bash',
+    less: 'css',
+    log: 'text',
+    m: 'c',
+    markdown: 'markdown',
+    mcp: 'mcp',
+    md: 'markdown',
+    mdx: 'markdown',
+    'mdx.tsx': 'markdown',
+    mjs: 'javascript',
+    mm: 'c',
+    mts: 'typescript',
+    ndjson: 'json',
+    ods: 'table',
+    otf: 'font',
+    parquet: 'table',
+    pcss: 'css',
+    plist: 'html',
+    png: 'image',
+    postcss: 'css',
+    prefs: 'text',
+    properties: 'text',
+    ps1: 'bash',
+    psd: 'image',
+    psd1: 'bash',
+    psm1: 'bash',
+    pxd: 'python',
+    py: 'python',
+    pyi: 'python',
+    pyw: 'python',
+    pyx: 'python',
+    rake: 'ruby',
+    rar: 'zip',
+    rb: 'ruby',
+    rs: 'rust',
+    rst: 'text',
+    rtf: 'text',
+    sass: 'sass',
+    scss: 'sass',
+    sh: 'bash',
+    sql: 'database',
+    sqlite: 'database',
+    sqlite3: 'database',
+    styl: 'css',
+    stylus: 'css',
+    svelte: 'svelte',
+    svg: 'svg',
+    svgz: 'svg',
+    swift: 'swift',
+    tar: 'zip',
+    tbz2: 'zip',
+    text: 'text',
+    tf: 'terraform',
+    tfstate: 'terraform',
+    tfvars: 'terraform',
+    tgz: 'zip',
+    tif: 'image',
+    tiff: 'image',
+    ts: 'typescript',
+    tsv: 'table',
+    tsx: 'react',
+    ttf: 'font',
+    txt: 'text',
+    vue: 'vue',
+    war: 'zip',
+    wasm: 'wasm',
+    wast: 'wasm',
+    wat: 'wasm',
+    webmanifest: 'json',
+    webp: 'image',
+    woff: 'font',
+    woff2: 'font',
+    xhtml: 'html',
+    xls: 'table',
+    xlsx: 'table',
+    xml: 'html',
+    xsd: 'html',
+    xsl: 'html',
+    xslt: 'html',
+    xz: 'zip',
+    yaml: 'yml',
+    yml: 'yml',
+    zig: 'zig',
+    zip: 'zip',
+    zon: 'zig',
+    zsh: 'bash',
+    zst: 'zip'
+};
+const FILES = {
+    '.bash_aliases': 'bash',
+    '.bash_login': 'bash',
+    '.bash_logout': 'bash',
+    '.bash_profile': 'bash',
+    '.dockerignore': 'docker',
+    '.editorconfig': 'text',
+    '.eslintignore': 'eslint',
+    '.gitattributes': 'git',
+    '.gitconfig': 'git',
+    '.gitignore': 'git',
+    '.gitkeep': 'git',
+    '.gitmessage': 'git',
+    '.gitmodules': 'git',
+    '.mcp.json': 'mcp',
+    '.node-version': 'text',
+    '.npmignore': 'npm',
+    '.nvmrc': 'text',
+    '.pnpmfile.cjs': 'pnpm',
+    '.prettierignore': 'prettier',
+    '.profile': 'bash',
+    '.python-version': 'python',
+    '.ruby-version': 'ruby',
+    '.stylelintignore': 'stylelint',
+    '.terraform.lock.hcl': 'terraform',
+    '.tool-versions': 'text',
+    '.watchmanconfig': 'json',
+    '.zlogin': 'bash',
+    '.zlogout': 'bash',
+    '.zprofile': 'bash',
+    '.zshenv': 'bash',
+    'agents.md': 'agents',
+    authors: 'text',
+    'biome.json': 'biome',
+    'biome.jsonc': 'biome',
+    'bootstrap.bundle.js': 'bootstrap',
+    'bootstrap.bundle.min.js': 'bootstrap',
+    'bootstrap.css': 'bootstrap',
+    'bootstrap.js': 'bootstrap',
+    'bootstrap.min.css': 'bootstrap',
+    'bootstrap.min.js': 'bootstrap',
+    browserslist: 'browserslist',
+    'bun.lock': 'bun',
+    'bun.lockb': 'bun',
+    'bunfig.toml': 'bun',
+    'cargo.lock': 'rust',
+    'cargo.toml': 'rust',
+    changelog: 'text',
+    changes: 'text',
+    'claude.md': 'claude',
+    'compose.yaml': 'docker',
+    'compose.yml': 'docker',
+    'composer.lock': 'json',
+    containerfile: 'docker',
+    contributors: 'text',
+    'copilot-instructions.md': 'agents',
+    copying: 'text',
+    dockerfile: 'docker',
+    'gemini.md': 'agents',
+    gemfile: 'ruby',
+    'gemfile.lock': 'ruby',
+    'go.mod': 'go',
+    'go.sum': 'go',
+    'go.work': 'go',
+    'go.work.sum': 'go',
+    licence: 'text',
+    license: 'text',
+    'mcp.json': 'mcp',
+    notice: 'text',
+    'npm-shrinkwrap.json': 'npm',
+    'oxlint.json': 'oxc',
+    'package-lock.json': 'npm',
+    'package.json': 'package',
+    pipfile: 'python',
+    'pipfile.lock': 'python',
+    'pnpm-lock.yaml': 'pnpm',
+    'pnpm-workspace.yaml': 'pnpm',
+    'poetry.lock': 'python',
+    'pyproject.toml': 'python',
+    rakefile: 'ruby',
+    readme: 'readme',
+    'readme.markdown': 'readme',
+    'readme.md': 'readme',
+    'readme.mdx': 'readme',
+    'requirements.txt': 'python',
+    'setup.cfg': 'python',
+    'setup.py': 'python',
+    'uv.lock': 'python',
+    'webpack.config.babel.js': 'webpack'
+};
+const FOLDERS = [
+    'assets', 'components', 'docs', 'git', 'output', 'packages', 'public', 'scripts', 'src', 'test'
+];
+const NAMED = {
+    '.git': 'git',
+    '.githooks': 'git',
+    '.github': 'git',
+    '.gitlab': 'git',
+    '.next': 'output',
+    '.nuxt': 'output',
+    '.output': 'output',
+    __mocks__: 'test',
+    __snapshots__: 'test',
+    __tests__: 'test',
+    app: 'src',
+    apps: 'src',
+    assets: 'assets',
+    audio: 'assets',
+    bin: 'scripts',
+    build: 'output',
+    component: 'components',
+    components: 'components',
+    coverage: 'test',
+    cypress: 'test',
+    dependencies: 'packages',
+    deps: 'packages',
+    dist: 'output',
+    doc: 'docs',
+    docs: 'docs',
+    documentation: 'docs',
+    e2e: 'test',
+    fixtures: 'test',
+    font: 'assets',
+    fonts: 'assets',
+    icons: 'assets',
+    images: 'assets',
+    img: 'assets',
+    lib: 'src',
+    libs: 'src',
+    media: 'assets',
+    music: 'assets',
+    node_modules: 'packages',
+    out: 'output',
+    output: 'output',
+    packages: 'packages',
+    public: 'public',
+    resources: 'assets',
+    script: 'scripts',
+    scripts: 'scripts',
+    sounds: 'assets',
+    source: 'src',
+    sources: 'src',
+    spec: 'test',
+    specs: 'test',
+    src: 'src',
+    static: 'assets',
+    target: 'output',
+    test: 'test',
+    testing: 'test',
+    tests: 'test',
+    tooling: 'scripts',
+    tools: 'scripts',
+    vendor: 'packages',
+    video: 'assets',
+    videos: 'assets',
+    widgets: 'components',
+    wiki: 'docs',
+    www: 'public'
+};
+const NAMES = [
+    'agents', 'astro', 'babel', 'bash', 'biome', 'bootstrap', 'browserslist', 'bun', 'c', 'claude', 'css', 'database',
+    'docker', 'eslint', 'file', 'font', 'git', 'go', 'graphql', 'html', 'image', 'javascript', 'json', 'markdown',
+    'mcp', 'nextjs', 'npm', 'oxc', 'package', 'pnpm', 'postcss', 'prettier', 'python', 'react', 'readme', 'ruby',
+    'rust', 'sass', 'stylelint', 'svelte', 'svg', 'svgo', 'swift', 'table', 'tailwind', 'terraform', 'text',
+    'tsconfig', 'typescript', 'vite', 'vscode', 'vue', 'wasm', 'webpack', 'yml', 'zig', 'zip'
+];
+const PATTERNS = [
+    [/^tsconfig(?:\.[\w-]+)*\.json$/, 'tsconfig'],
+    [/^\.env(?:\..+)?$|\.env$/, 'text'],
+    [/^(?:containerfile|dockerfile)\.|^docker-compose(?:\..+)?\.ya?ml$/, 'docker']
+];
+const STANDARD = new Set([
+    'bash', 'c', 'css', 'database', 'font', 'git', 'go', 'html', 'image', 'javascript', 'json', 'markdown',
+    'mcp', 'python', 'ruby', 'rust', 'swift', 'table', 'text', 'typescript', 'zip'
+]);
+function basename(name) {
+    return name.replace(/\\/g, '/').replace(/\/+$/, '').split('/').pop().toLowerCase();
+}
+function compile(rules, extension = false) {
+    let map = new Map();
+    for (let [key, value] of Object.entries(rules ?? {})) {
+        key = key.trim().toLowerCase();
+        if (extension) {
+            key = key.replace(/^\./, '');
+        }
+        if (key && typeof value === 'string' && value) {
+            map.set(key, value);
+        }
+    }
+    return map;
+}
+function lookup(table, key) {
+    return Object.hasOwn(table, key) ? table[key] : undefined;
+}
+function resolver(options = {}) {
+    let contains = compile(options.byFileNameContains), extensions = compile(options.byFileExtension, true), files = compile(options.byFileName), folders = compile(options.byFolderName), set = options.set ?? 'complete';
+    function drawn(name) {
+        return name !== undefined && set !== 'minimal' && (set === 'complete' || STANDARD.has(name)) ? name : undefined;
+    }
+    function target(value, kinds, prefix = '') {
+        return kinds.includes(value) ? { name: prefix + value } : { custom: true, name: value };
+    }
+    return (element) => {
+        let name = basename(element.name);
+        if (element.type ? element.type === 'folder' : Array.isArray(element.children)) {
+            let custom = folders.get(name);
+            if (custom !== undefined) {
+                return target(custom, FOLDERS, 'folder-');
+            }
+            let named = set === 'minimal' ? undefined : lookup(NAMED, name);
+            return { name: named ? `folder-${named}` : 'folder' };
+        }
+        let candidates = [];
+        for (let at = name.indexOf('.', 1); at !== -1 && at < name.length - 1; at = name.indexOf('.', at + 1)) {
+            candidates.push(name.slice(at + 1));
+        }
+        let custom = files.get(name);
+        for (let [needle, value] of contains) {
+            if (custom === undefined && name.includes(needle)) {
+                custom = value;
+            }
+        }
+        for (let candidate of candidates) {
+            custom ??= extensions.get(candidate);
+        }
+        if (custom !== undefined) {
+            return target(custom, NAMES);
+        }
+        let config = CONFIG.exec(name), kind = drawn(lookup(FILES, name)) ?? drawn(config ? lookup(CONFIGS, config[1] ?? config[2]) : undefined);
+        for (let [pattern, value] of PATTERNS) {
+            if (kind === undefined && pattern.test(name)) {
+                kind = drawn(value);
+            }
+        }
+        for (let candidate of candidates) {
+            let basic = set === 'standard' ? lookup(BASIC, candidate) : undefined;
+            kind ??= drawn(basic ?? lookup(EXTENSIONS, candidate));
+        }
+        return { name: kind ?? 'file' };
+    };
+}
+const resolve = resolver();
+export { FOLDERS, NAMES, resolve, resolver };

package/build/components/editor/tree/index.d.ts

@@ -0,0 +1,118 @@
+import { type Attributes, type Renderable } from '@esportsplus/template';
+import Decorations, { type Badge, type Decoration, type Status } from './decorations.js';
+import { type Drag, type Drop } from './drag.js';
+import Editor, { type Kind, type Result } from './edit.js';
+import { type Mode } from './find.js';
+import glyph from './glyph.js';
+import History, { type Entry as HistoryEntry, type Operation, type Options as HistoryOptions, type Place, type Step } from './history.js';
+import { resolver as createFileTreeIconResolver, resolve as resolveFileTreeIcon, type Name as IconName, type Options as IconOptions, type Resolved as ResolvedIcon } from './icons.js';
+import { type Jump } from './jump.js';
+import { type Load } from './lazy.js';
+import Elements, { type Change } from './model.js';
+import { type Case, type Options, type Order, type Sort } from './sort.js';
+import type { Export, ImportEntry } from './transfer.js';
+import '../../button/scss/index.scss';
+import './scss/index.scss';
+type A = Attributes & {
+    compact?: boolean;
+    controller?: (controller: Controller) => void;
+    create?: (parent: Element | null, parts: string[], kind: Kind) => Result;
+    decorations?: Decorations | Decorations[];
+    display?: Display;
+    drag?: Drag<Element>;
+    editor?: Editor;
+    elements: Element[] | Elements;
+    empty?: () => Renderable<unknown>;
+    exclude?: string[];
+    expand?: 'click' | 'dblclick';
+    expanded?: string[];
+    export?: (element: Element) => Export | null;
+    find?: Mode | 'off';
+    highlight?: string | (() => string);
+    history?: History;
+    icon?: (element: Element, open: boolean) => Renderable<unknown>;
+    icons?: IconOptions | false;
+    indicator?: Indicator;
+    label?: string;
+    load?: Load;
+    menu?: (elements: Element[], position: {
+        x: number;
+        y: number;
+    }, root: boolean) => void;
+    open?: (element: Element, open: Open) => void;
+    operations?: Operations;
+    path?: (element: Element, relative: boolean) => string;
+    preview?: boolean | 'immediate';
+    rename?: (element: Element, name: string) => Result;
+    reveal?: 'off' | 'on' | 'select';
+    roots?: boolean;
+    scopes?: Scope[];
+    searched?: (query: string) => void;
+    select?: (element: Element) => void;
+    selected?: string;
+    shortcuts?: boolean;
+    snapshot?: Snapshot;
+    sort?: Sort;
+    state?: State;
+    sticky?: boolean | number;
+    toggle?: boolean;
+    tooltip?: boolean;
+    typing?: 'find' | 'typeahead';
+    validate?: (name: string, parent: Element | null, element: Element | null) => string | void;
+};
+type Controller = {
+    collapseAll: () => void;
+    expandAll: () => void;
+    find: (query?: string) => void;
+    next: (kind: Jump) => Promise<Element | null>;
+    previous: (kind: Jump) => Promise<Element | null>;
+    search: (query: string) => void;
+};
+type Display = {
+    deleted?: boolean;
+    dotfiles?: boolean;
+    ignored?: boolean;
+    stats?: boolean;
+};
+type Element = {
+    children?: Element[];
+    id: string;
+    modified?: Date | number;
+    name: string;
+    readonly?: boolean;
+    selectable?: boolean;
+    size?: number;
+    symlink?: boolean;
+    type?: 'file' | 'folder';
+};
+type Indicator = 'always' | 'hover' | 'never';
+type Open = {
+    mode: 'pinned' | 'preview';
+    side: boolean;
+};
+type Operations = {
+    confirm?: (elements: Element[], permanent: boolean) => boolean | Promise<boolean>;
+    copy?: (elements: Element[]) => void;
+    cut?: (elements: Element[]) => void;
+    delete?: (elements: Element[], permanent: boolean) => void;
+    duplicate?: (elements: Element[]) => void;
+    import?: (target: Element | null, entries: readonly ImportEntry[]) => void | Promise<void>;
+    paste?: (elements: Element[], target: Element | null, cut: boolean) => void | Promise<void>;
+};
+type Scope = {
+    color: string;
+    match: RegExp | ((element: Element) => boolean);
+};
+type Snapshot = {
+    expanded?: string[];
+    scroll?: number;
+};
+type State = {
+    selected: string;
+    selection?: ReadonlySet<string>;
+};
+export default _default;
+declare function _default({ compact, controller, create, decorations: providers, display, drag, editor, elements, empty, exclude, expand: unfold, expanded, export: exporter, find, highlight: phrase, history, icon: draw, icons, indicator, label, load, menu, open: view, operations, path: address, preview, rename, reveal: autoreveal, roots, scopes, searched, select, selected, shortcuts, snapshot, sort, state, sticky, toggle, tooltip: hint, typing, validate, ...attributes }: A): DocumentFragment | Text;
+export { Decorations as FileTreeDecorations, Editor as FileTreeEditor, Elements as FileTreeElements, History as FileTreeHistory };
+export { createFileTreeIconResolver, glyph as fileTreeIcon, resolveFileTreeIcon };
+export type { Badge as FileTreeBadge, Change as FileTreeChange, Controller as FileTreeController, Decoration as FileTreeDecoration, Drag as FileTreeDrag, Drop as FileTreeDrop, Element as FileTreeElement, Export as FileTreeExport, HistoryEntry as FileTreeHistoryEntry, Operation as FileTreeHistoryOperation, HistoryOptions as FileTreeHistoryOptions, Place as FileTreeHistoryPlace, Step as FileTreeHistoryStep, IconName as FileTreeIconName, IconOptions as FileTreeIconOptions, ImportEntry as FileTreeImportEntry, Indicator as FileTreeIndicator, Jump as FileTreeJump, Kind as FileTreeKind, Load as FileTreeLoad, Open as FileTreeOpen, Operations as FileTreeOperations, ResolvedIcon as FileTreeResolvedIcon, Result as FileTreeResult, Scope as FileTreeScope, Snapshot as FileTreeSnapshot, Sort as FileTreeSort, Case as FileTreeSortCase, Options as FileTreeSortOptions, Order as FileTreeSortOrder, State as FileTreeState, Status as FileTreeStatus };