mimeforge 0.0.0-stage → 0.1.1

package/assets/bodies/security.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32">
+<g id="page">
+<path d="M7.5 2.5H19.5L26.5 9.5V27.5A2 2 0 0 1 24.5 29.5H7.5A2 2 0 0 1 5.5 27.5V4.5A2 2 0 0 1 7.5 2.5Z" fill="#FFFFFF" stroke="#B8BFC7" stroke-linejoin="round"/>
+</g>
+<g id="emblem">
+<path d="M13 11V10A3 3 0 0 1 19 10V11" fill="none" stroke="#FF00FF" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+<rect x="9.5" y="11" width="13" height="7" rx="2" fill="#FF00FF"/>
+<circle cx="16" cy="14.5" r="1.5" fill="#FFFFFF"/>
+</g>
+<g id="fold">
+<path d="M19.5 2.5V7.5Q19.5 9.5 21.5 9.5H26.5Z" fill="#E3E7EB"/>
+<path d="M19.5 2.5V7.5Q19.5 9.5 21.5 9.5H26.5Z" fill="none" stroke="#B8BFC7" stroke-linejoin="round"/>
+</g>
+</svg>

package/assets/bodies/sheet.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32">
+<g id="page">
+<path d="M7.5 2.5H19.5L26.5 9.5V27.5A2 2 0 0 1 24.5 29.5H7.5A2 2 0 0 1 5.5 27.5V4.5A2 2 0 0 1 7.5 2.5Z" fill="#FFFFFF" stroke="#B8BFC7" stroke-linejoin="round"/>
+</g>
+<g id="emblem">
+<path d="M9 10h6v3H9z M17 10h6v3h-6z" fill="#FF00FF"/>
+<path d="M9 15h6v3H9z M17 15h6v3h-6z" fill="#FF99FF"/>
+</g>
+<g id="fold">
+<path d="M19.5 2.5V7.5Q19.5 9.5 21.5 9.5H26.5Z" fill="#E3E7EB"/>
+<path d="M19.5 2.5V7.5Q19.5 9.5 21.5 9.5H26.5Z" fill="none" stroke="#B8BFC7" stroke-linejoin="round"/>
+</g>
+</svg>

package/assets/bodies/slides.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32">
+<g id="page">
+<path d="M7.5 2.5H19.5L26.5 9.5V27.5A2 2 0 0 1 24.5 29.5H7.5A2 2 0 0 1 5.5 27.5V4.5A2 2 0 0 1 7.5 2.5Z" fill="#FFFFFF" stroke="#B8BFC7" stroke-linejoin="round"/>
+</g>
+<g id="emblem">
+<rect x="9" y="9" width="14" height="9" rx="2" fill="#FF99FF"/>
+<path d="M11 13h2v3h-2z M15 11.5h2v4.5h-2z M19 10h2v6h-2z" fill="#FF00FF"/>
+</g>
+<g id="fold">
+<path d="M19.5 2.5V7.5Q19.5 9.5 21.5 9.5H26.5Z" fill="#E3E7EB"/>
+<path d="M19.5 2.5V7.5Q19.5 9.5 21.5 9.5H26.5Z" fill="none" stroke="#B8BFC7" stroke-linejoin="round"/>
+</g>
+</svg>

package/assets/bodies/text.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32">
+<g id="page">
+<path d="M7.5 2.5H19.5L26.5 9.5V27.5A2 2 0 0 1 24.5 29.5H7.5A2 2 0 0 1 5.5 27.5V4.5A2 2 0 0 1 7.5 2.5Z" fill="#FFFFFF" stroke="#B8BFC7" stroke-linejoin="round"/>
+</g>
+<g id="emblem">
+<rect x="9" y="6" width="10" height="2" rx="1" fill="#FF00FF"/>
+<rect x="9" y="11" width="14" height="2" rx="1" fill="#FF00FF"/>
+<rect x="9" y="16" width="8" height="2" rx="1" fill="#FF00FF"/>
+</g>
+<g id="fold">
+<path d="M19.5 2.5V7.5Q19.5 9.5 21.5 9.5H26.5Z" fill="#E3E7EB"/>
+<path d="M19.5 2.5V7.5Q19.5 9.5 21.5 9.5H26.5Z" fill="none" stroke="#B8BFC7" stroke-linejoin="round"/>
+</g>
+</svg>

package/assets/bodies/video.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32">
+<g id="page">
+<path d="M7.5 2.5H19.5L26.5 9.5V27.5A2 2 0 0 1 24.5 29.5H7.5A2 2 0 0 1 5.5 27.5V4.5A2 2 0 0 1 7.5 2.5Z" fill="#FFFFFF" stroke="#B8BFC7" stroke-linejoin="round"/>
+</g>
+<g id="emblem">
+<rect x="9" y="9" width="14" height="9" rx="2.5" fill="#FF00FF"/>
+<polygon points="14,10.8 19.5,13.5 14,16.2" fill="#FFFFFF"/>
+</g>
+<g id="fold">
+<path d="M19.5 2.5V7.5Q19.5 9.5 21.5 9.5H26.5Z" fill="#E3E7EB"/>
+<path d="M19.5 2.5V7.5Q19.5 9.5 21.5 9.5H26.5Z" fill="none" stroke="#B8BFC7" stroke-linejoin="round"/>
+</g>
+</svg>

package/assets/bodies/word.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32">
+<g id="page">
+<path d="M7.5 2.5H19.5L26.5 9.5V27.5A2 2 0 0 1 24.5 29.5H7.5A2 2 0 0 1 5.5 27.5V4.5A2 2 0 0 1 7.5 2.5Z" fill="#FFFFFF" stroke="#B8BFC7" stroke-linejoin="round"/>
+</g>
+<g id="emblem">
+<path d="M10 7L12.7 17L16 10L19.3 17L22 7" fill="none" stroke="#FF00FF" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</g>
+<g id="fold">
+<path d="M19.5 2.5V7.5Q19.5 9.5 21.5 9.5H26.5Z" fill="#E3E7EB"/>
+<path d="M19.5 2.5V7.5Q19.5 9.5 21.5 9.5H26.5Z" fill="none" stroke="#B8BFC7" stroke-linejoin="round"/>
+</g>
+</svg>

package/assets/fonts/monogram.json

@@ -0,0 +1,106 @@
+{
+ "name": "Monogram",
+ "author": "Vinícius Menézio (datagoblin)",
+ "license": "CC0-1.0",
+ "source": "https://datagoblin.itch.io/monogram",
+ "cols": 5,
+ "rows": 7,
+ "descender": 1,
+ "advance": 6,
+ "glyphs": {
+  "0": [ ".###.", "#...#", "#..##", "#.#.#", "##..#", "#...#", ".###.", "....." ],
+  "1": [ "..#..", ".##..", "..#..", "..#..", "..#..", "..#..", "#####", "....." ],
+  "2": [ ".###.", "#...#", "....#", "...#.", "..#..", ".#...", "#####", "....." ],
+  "3": [ ".###.", "#...#", "....#", "..##.", "....#", "#...#", ".###.", "....." ],
+  "4": [ ".#..#", ".#..#", "#...#", "#####", "....#", "....#", "....#", "....." ],
+  "5": [ "#####", "#....", "####.", "....#", "....#", "#...#", ".###.", "....." ],
+  "6": [ ".###.", "#....", "#....", "####.", "#...#", "#...#", ".###.", "....." ],
+  "7": [ "#####", "....#", "....#", "...#.", "..#..", "..#..", "..#..", "....." ],
+  "8": [ ".###.", "#...#", "#...#", ".###.", "#...#", "#...#", ".###.", "....." ],
+  "9": [ ".###.", "#...#", "#...#", ".####", "....#", "#...#", ".###.", "....." ],
+  "!": [ "..#..", "..#..", "..#..", "..#..", "..#..", ".....", "..#..", "....." ],
+  "\"": [ ".#.#.", ".#.#.", ".#.#.", ".....", ".....", ".....", ".....", "....." ],
+  "#": [ ".....", ".#.#.", "#####", ".#.#.", ".#.#.", "#####", ".#.#.", "....." ],
+  "$": [ "..#..", ".####", "#.#..", ".###.", "..#.#", "####.", "..#..", "....." ],
+  "%": [ "#...#", "#...#", "...#.", "..#..", ".#...", "#...#", "#...#", "....." ],
+  "&": [ ".##..", "#..#.", "#..#.", ".####", "#..#.", "#..#.", ".##.#", "....." ],
+  "'": [ "..#..", "..#..", "..#..", ".....", ".....", ".....", ".....", "....." ],
+  "(": [ "...#.", "..#..", "..#..", "..#..", "..#..", "..#..", "...#.", "....." ],
+  ")": [ ".#...", "..#..", "..#..", "..#..", "..#..", "..#..", ".#...", "....." ],
+  "*": [ ".....", "..#..", "#.#.#", ".###.", "#.#.#", "..#..", ".....", "....." ],
+  "+": [ ".....", "..#..", "..#..", "#####", "..#..", "..#..", ".....", "....." ],
+  ",": [ ".....", ".....", ".....", ".....", ".....", "..#..", "..#..", ".#..." ],
+  "-": [ ".....", ".....", ".....", "#####", ".....", ".....", ".....", "....." ],
+  ".": [ ".....", ".....", ".....", ".....", ".....", "..#..", "..#..", "....." ],
+  "/": [ "....#", "....#", "...#.", "..#..", ".#...", "#....", "#....", "....." ],
+  ":": [ ".....", "..#..", "..#..", ".....", ".....", "..#..", "..#..", "....." ],
+  ";": [ ".....", "..#..", "..#..", ".....", ".....", "..#..", "..#..", ".#..." ],
+  "<": [ ".....", "...##", ".##..", "#....", ".##..", "...##", ".....", "....." ],
+  "=": [ ".....", ".....", "#####", ".....", "#####", ".....", ".....", "....." ],
+  ">": [ ".....", "##...", "..##.", "....#", "..##.", "##...", ".....", "....." ],
+  "?": [ ".###.", "#...#", "....#", "...#.", "..#..", ".....", "..#..", "....." ],
+  "@": [ ".###.", "#..##", "#.#.#", "#.#.#", "#..##", "#....", ".###.", "....." ],
+  "A": [ ".###.", "#...#", "#...#", "#...#", "#####", "#...#", "#...#", "....." ],
+  "B": [ "####.", "#...#", "#...#", "####.", "#...#", "#...#", "####.", "....." ],
+  "C": [ ".###.", "#...#", "#....", "#....", "#....", "#...#", ".###.", "....." ],
+  "D": [ "####.", "#...#", "#...#", "#...#", "#...#", "#...#", "####.", "....." ],
+  "E": [ "#####", "#....", "#....", "####.", "#....", "#....", "#####", "....." ],
+  "F": [ "#####", "#....", "#....", "####.", "#....", "#....", "#....", "....." ],
+  "G": [ ".###.", "#...#", "#....", "#.###", "#...#", "#...#", ".###.", "....." ],
+  "H": [ "#...#", "#...#", "#...#", "#####", "#...#", "#...#", "#...#", "....." ],
+  "I": [ "#####", "..#..", "..#..", "..#..", "..#..", "..#..", "#####", "....." ],
+  "J": [ "....#", "....#", "....#", "....#", "#...#", "#...#", ".###.", "....." ],
+  "K": [ "#...#", "#..#.", "#.#..", "##...", "#.#..", "#..#.", "#...#", "....." ],
+  "L": [ "#....", "#....", "#....", "#....", "#....", "#....", "#####", "....." ],
+  "M": [ "#...#", "##.##", "#.#.#", "#...#", "#...#", "#...#", "#...#", "....." ],
+  "N": [ "#...#", "#...#", "##..#", "#.#.#", "#..##", "#...#", "#...#", "....." ],
+  "O": [ ".###.", "#...#", "#...#", "#...#", "#...#", "#...#", ".###.", "....." ],
+  "P": [ "####.", "#...#", "#...#", "####.", "#....", "#....", "#....", "....." ],
+  "Q": [ ".###.", "#...#", "#...#", "#...#", "#...#", "#...#", ".###.", "...##" ],
+  "R": [ "####.", "#...#", "#...#", "####.", "#...#", "#...#", "#...#", "....." ],
+  "S": [ ".###.", "#...#", "#....", ".###.", "....#", "#...#", ".###.", "....." ],
+  "T": [ "#####", "..#..", "..#..", "..#..", "..#..", "..#..", "..#..", "....." ],
+  "U": [ "#...#", "#...#", "#...#", "#...#", "#...#", "#...#", ".###.", "....." ],
+  "V": [ "#...#", "#...#", "#...#", "#...#", ".#.#.", ".#.#.", "..#..", "....." ],
+  "W": [ "#...#", "#...#", "#...#", "#...#", "#.#.#", "##.##", "#...#", "....." ],
+  "X": [ "#...#", "#...#", ".#.#.", "..#..", ".#.#.", "#...#", "#...#", "....." ],
+  "Y": [ "#...#", "#...#", ".#.#.", "..#..", "..#..", "..#..", "..#..", "....." ],
+  "Z": [ "#####", "....#", "...#.", "..#..", ".#...", "#....", "#####", "....." ],
+  "[": [ "..##.", "..#..", "..#..", "..#..", "..#..", "..#..", "..##.", "....." ],
+  "\\": [ "#....", "#....", ".#...", "..#..", "...#.", "....#", "....#", "....." ],
+  "]": [ ".##..", "..#..", "..#..", "..#..", "..#..", "..#..", ".##..", "....." ],
+  "^": [ "..#..", ".#.#.", "#...#", ".....", ".....", ".....", ".....", "....." ],
+  "_": [ ".....", ".....", ".....", ".....", ".....", ".....", "#####", "....." ],
+  "`": [ ".#...", "..#..", ".....", ".....", ".....", ".....", ".....", "....." ],
+  "a": [ ".....", ".....", ".####", "#...#", "#...#", "#...#", ".####", "....." ],
+  "b": [ "#....", "#....", "####.", "#...#", "#...#", "#...#", "####.", "....." ],
+  "c": [ ".....", ".....", ".###.", "#...#", "#....", "#...#", ".###.", "....." ],
+  "d": [ "....#", "....#", ".####", "#...#", "#...#", "#...#", ".####", "....." ],
+  "e": [ ".....", ".....", ".###.", "#...#", "#####", "#....", ".###.", "....." ],
+  "f": [ "..##.", ".#..#", ".#...", "####.", ".#...", ".#...", ".#...", "....." ],
+  "g": [ ".....", ".....", ".####", "#...#", "#...#", "#...#", ".####", "....#" ],
+  "h": [ "#....", "#....", "####.", "#...#", "#...#", "#...#", "#...#", "....." ],
+  "i": [ "..#..", ".....", ".##..", "..#..", "..#..", "..#..", "#####", "....." ],
+  "j": [ "....#", ".....", "...##", "....#", "....#", "....#", "....#", "#...#" ],
+  "k": [ "#....", "#....", "#...#", "#..#.", "###..", "#..#.", "#...#", "....." ],
+  "l": [ "##...", ".#...", ".#...", ".#...", ".#...", ".#...", "..###", "....." ],
+  "m": [ ".....", ".....", "####.", "#.#.#", "#.#.#", "#.#.#", "#.#.#", "....." ],
+  "n": [ ".....", ".....", "####.", "#...#", "#...#", "#...#", "#...#", "....." ],
+  "o": [ ".....", ".....", ".###.", "#...#", "#...#", "#...#", ".###.", "....." ],
+  "p": [ ".....", ".....", "####.", "#...#", "#...#", "#...#", "####.", "#...." ],
+  "q": [ ".....", ".....", ".####", "#...#", "#...#", "#...#", ".####", "....#" ],
+  "r": [ ".....", ".....", "#.##.", "##..#", "#....", "#....", "#....", "....." ],
+  "s": [ ".....", ".....", ".####", "#....", ".###.", "....#", "####.", "....." ],
+  "t": [ ".#...", ".#...", "####.", ".#...", ".#...", ".#...", "..###", "....." ],
+  "u": [ ".....", ".....", "#...#", "#...#", "#...#", "#...#", ".####", "....." ],
+  "v": [ ".....", ".....", "#...#", "#...#", "#...#", ".#.#.", "..#..", "....." ],
+  "w": [ ".....", ".....", "#...#", "#...#", "#.#.#", "#.#.#", ".#.#.", "....." ],
+  "x": [ ".....", ".....", "#...#", ".#.#.", "..#..", ".#.#.", "#...#", "....." ],
+  "y": [ ".....", ".....", "#...#", "#...#", "#...#", "#...#", ".####", "....#" ],
+  "z": [ ".....", ".....", "#####", "...#.", "..#..", ".#...", "#####", "....." ],
+  "{": [ "...#.", "..#..", "..#..", ".#...", "..#..", "..#..", "...#.", "....." ],
+  "|": [ "..#..", "..#..", "..#..", "..#..", "..#..", "..#..", "..#..", "....." ],
+  "}": [ ".#...", "..#..", "..#..", "...#.", "..#..", "..#..", ".#...", "....." ],
+  "~": [ ".....", ".....", ".#..#", "#.##.", ".....", ".....", ".....", "....." ]
+ }
+}

package/dist/body.d.ts

@@ -0,0 +1,24 @@
+import { type Category } from './categories.js';
+export interface BodyTokens {
+    /** Literal color in body SVGs that is replaced by the accent. */
+    accent: string;
+    /** Literal color replaced by the lighter tint of the accent. */
+    tint: string;
+}
+export declare const DEFAULT_TOKENS: BodyTokens;
+export interface BodySet {
+    source: string;
+    svg(category: Category): string;
+    warnings: string[];
+    /** Categories that have no own body and are drawn with the generic one. */
+    missing: Category[];
+}
+/** Check the body contract (see docs/BODY-SPEC.md). Returns human readable problems. */
+export declare function validateBody(svg: string, name: string, tokens?: BodyTokens): string[];
+/**
+ * `spec`: undefined → bundled bodies. A directory → `<category>.svg` files, missing ones fall back to the
+ * directory's `generic.svg`, then to the bundled body. A single `.svg` file → used for every category.
+ */
+export declare function loadBodies(spec?: string, tokens?: BodyTokens): BodySet;
+/** Replace the color tokens in a body SVG. */
+export declare function recolor(svg: string, accent: string, tokens?: BodyTokens, tintAmount?: number): string;

package/dist/body.js

@@ -0,0 +1,70 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { CATEGORIES, isCategory } from './categories.js';
+import { tint } from './color.js';
+import { assetPath } from './paths.js';
+export const DEFAULT_TOKENS = { accent: '#FF00FF', tint: '#FF99FF' };
+/** Check the body contract (see docs/BODY-SPEC.md). Returns human readable problems. */
+export function validateBody(svg, name, tokens = DEFAULT_TOKENS) {
+    const problems = [];
+    if (!/<svg[^>]*viewBox="0 0 32 32"/.test(svg))
+        problems.push(`${name}: root <svg> must have viewBox="0 0 32 32"`);
+    if (!svg.toLowerCase().includes(tokens.accent.toLowerCase()))
+        problems.push(`${name}: no accent token ${tokens.accent} found (icon cannot be recolored)`);
+    if (!/<\/svg>\s*$/.test(svg))
+        problems.push(`${name}: must end with </svg>`);
+    return problems;
+}
+function readDirBodies(dir) {
+    const map = new Map();
+    for (const f of readdirSync(dir)) {
+        if (!f.endsWith('.svg'))
+            continue;
+        const cat = basename(f, '.svg');
+        if (isCategory(cat))
+            map.set(cat, readFileSync(join(dir, f), 'utf8').trim());
+    }
+    return map;
+}
+/**
+ * `spec`: undefined → bundled bodies. A directory → `<category>.svg` files, missing ones fall back to the
+ * directory's `generic.svg`, then to the bundled body. A single `.svg` file → used for every category.
+ */
+export function loadBodies(spec, tokens = DEFAULT_TOKENS) {
+    const bundled = readDirBodies(assetPath('bodies'));
+    const warnings = [];
+    let custom;
+    let single;
+    if (spec) {
+        if (!existsSync(spec))
+            throw new Error(`Body path not found: ${spec}`);
+        if (statSync(spec).isDirectory())
+            custom = readDirBodies(spec);
+        else
+            single = readFileSync(spec, 'utf8').trim();
+    }
+    if (single)
+        warnings.push(...validateBody(single, spec, tokens));
+    if (custom)
+        for (const [c, s] of custom)
+            warnings.push(...validateBody(s, `${spec}/${c}.svg`, tokens));
+    const has = (c) => !!(single ?? custom?.get(c) ?? bundled.get(c));
+    return {
+        source: spec ?? 'bundled',
+        warnings,
+        missing: CATEGORIES.filter((c) => !has(c)),
+        svg(category) {
+            const s = single ?? custom?.get(category) ?? custom?.get('generic') ?? bundled.get(category) ?? bundled.get('generic');
+            if (!s)
+                throw new Error(`No body for category "${category}"`);
+            return s;
+        },
+    };
+}
+/** Replace the color tokens in a body SVG. */
+export function recolor(svg, accent, tokens = DEFAULT_TOKENS, tintAmount = 0.55) {
+    const esc = (s) => s.replace(/[.*+?^${}()|[\]\\#]/g, '\\$&');
+    return svg
+        .replace(new RegExp(esc(tokens.accent), 'gi'), accent)
+        .replace(new RegExp(esc(tokens.tint), 'gi'), tint(accent, tintAmount));
+}

package/dist/categories.d.ts

@@ -0,0 +1,10 @@
+export declare const CATEGORIES: readonly ['generic', 'text', 'code', 'data', 'pdf', 'word', 'sheet', 'slides', 'image', 'audio', 'video', 'archive', 'font', 'ebook', 'database', 'executable', 'security', 'model3d', 'geo', 'mail', 'science', 'disk', 'design', 'game'];
+export type Category = (typeof CATEGORIES)[number];
+export declare const isCategory: (v: string) => v is Category;
+export declare const EXT_OVERRIDES: ReadonlyMap<string, Category>;
+export declare function classifyMime(mime: string): Category;
+/**
+ * Category for an extension (without dot, any case). `mimes` are all mime types registered for it; an extension can
+ * have several (`mp4` is both application/mp4 and video/mp4), the first one that is not "generic" wins.
+ */
+export declare function classify(ext: string, mimes?: string | readonly string[]): Category;

package/dist/categories.js

@@ -0,0 +1,122 @@
+export const CATEGORIES = [
+    'generic', 'text', 'code', 'data', 'pdf', 'word', 'sheet', 'slides', 'image', 'audio', 'video',
+    'archive', 'font', 'ebook', 'database', 'executable', 'security', 'model3d', 'geo', 'mail', 'science',
+    'disk', 'design', 'game',
+];
+export const isCategory = (v) => CATEGORIES.includes(v);
+/** Extension → category for popular formats that mime types alone get wrong or do not know. Checked first. */
+const EXT_GROUPS = {
+    text: 'txt text md markdown mdx log ini conf cfg rst adoc org tex lock gitignore editorconfig',
+    code: 'js mjs cjs jsx ts tsx mts cts vue svelte astro py pyw rb go rs java kt kts swift c h cc cpp cxx hpp hh cs fs php sh bash zsh fish ps1 bat cmd lua pl pm r scala dart ex exs erl hs clj groovy gradle makefile dockerfile html htm xhtml css scss sass less ipynb vb vbs asm wasm coffee elm nim zig',
+    data: 'json jsonc json5 jsonl ndjson yaml yml toml xml xsd xsl xslt rss atom plist env properties proto graphql gql ndjson csv-schema',
+    image: 'jpg jpeg png gif webp avif heic heif bmp tif tiff ico icns svg raw cr2 nef dng jxl apng',
+    archive: 'zip rar 7z tar gz tgz bz2 xz zst lz lz4 lzma cab jar war ear pkg deb rpm apk arc gtar ustar cfs msix msixbundle appx appxbundle sis sisx crx xpi oxt',
+    font: 'ttf otf woff woff2 eot',
+    ebook: 'epub mobi azw azw3 fb2 cbz cbr djvu lrf',
+    database: 'db sqlite sqlite3 mdb accdb sql dbf',
+    executable: 'exe msi app dll so dylib elf out com run class luac application xbap',
+    security: 'pem key crt cer der pub gpg pgp asc pfx p12 jks csr kdbx scq scs spq spp roa mft dssc',
+    model3d: 'glb gltf obj stl fbx dae 3ds blend step stp ply usdz',
+    geo: 'kml kmz gpx geojson shp dwg dxf gml mvt mgp',
+    mail: 'eml msg mbox ics vcf emlx',
+    science: 'hdf hdf5 h5 nc mat fits cif pdb sdf mol seed mseed dataless',
+    disk: 'iso dmg img toast vhd vhdx vmdk vdi qcow qcow2 ova ovf vbox vbox-extpack hdd nrg mdf wim',
+    design: 'psd psb ai sketch fig xd indd indt idml cdr afdesign afphoto afpub xcf kra ora vsd vsdx vss vst vsw vtx vdx qwd qwt qxb qxd qxl qxt fm frame maker book',
+    game: 'z1 z2 z3 z4 z5 z6 z7 z8 wad gam t3 sm smzip n-gage ngdat blb blorb c4d c4f c4g c4p c4u dir dcr dxr cst cct cxt w3d fgd swa aam aas swf rom nes smc sfc gba gbc gb nds n64 z64 v64 sav srm sms gg pce nsp xci pak vpk unity3d uasset umap',
+};
+/** Office-like and other formats mapped by function (no brand-specific bodies). */
+const FUNCTION_MAP = {
+    // Google Workspace shortcut files
+    gdoc: 'word', gsheet: 'sheet', gslides: 'slides', gdraw: 'image', gscript: 'code', gmap: 'geo',
+    // StarOffice / StarDivision
+    sdw: 'word', sgl: 'word', vor: 'word', sdc: 'sheet', smf: 'sheet', sdd: 'slides', sda: 'image',
+    // MS Works, Project, Office theme, OneNote, XPS, HTML help
+    wps: 'word', wcm: 'word', wks: 'sheet', wdb: 'database', mpt: 'sheet', thmx: 'slides',
+    one: 'text', onea: 'text', onepkg: 'text', onetmp: 'text', onetoc: 'text', onetoc2: 'text', xps: 'pdf', chm: 'ebook',
+    // KDE Calligra / KOffice
+    kwd: 'word', kwt: 'word', ksp: 'sheet', kpr: 'slides', kpt: 'slides',
+    // misc
+    procreate: 'image', dra: 'image', dsf: 'image', xfdf: 'data', siv: 'code', sieve: 'code', texi: 'text', texinfo: 'text',
+    icc: 'data', icm: 'data', pcap: 'data', cap: 'data', dmp: 'data',
+    // formats found while triaging the generic list
+    wpd: 'word', abw: 'word', fdf: 'pdf', oxps: 'pdf',
+    saf: 'audio', spf: 'audio', mmf: 'audio', mlp: 'audio', rm: 'video', rmvb: 'video', mxf: 'video',
+    // Lotus, Gnumeric and other office-like formats
+    lwp: 'word', '123': 'sheet', gnumeric: 'sheet', pre: 'slides', apr: 'database', nsf: 'mail', see: 'mail',
+    // archives / packages
+    mar: 'archive', ipk: 'archive', joda: 'archive', portpkg: 'archive', ez3: 'archive',
+    // audio (Yamaha HV, karaoke, music notation), video, compiled code, DRM / crypto, dynamic geometry & math
+    hvp: 'audio', hvs: 'audio', mmd: 'audio', mus: 'audio', qam: 'video', mvb: 'video', elc: 'code', wmlsc: 'code',
+    irm: 'security', nns: 'security', cryptonote: 'security',
+    geo: 'science', i2g: 'science', cdy: 'science', dpg: 'science', kfo: 'science', nbp: 'science',
+    // old archive formats, Android App Bundle (zip), Windows Installer parts, WML, RDF/SPARQL/MARC, KDE/Micrografx drawing, math, misc
+    arj: 'archive', bcpio: 'archive', cpt: 'archive', dgc: 'archive', gca: 'archive', hqx: 'archive', sea: 'archive',
+    shar: 'archive', sv4cpio: 'archive', sv4crc: 'archive', udeb: 'archive', aab: 'archive',
+    osf: 'audio', hvd: 'audio', m13: 'video', m14: 'video', msm: 'executable', msp: 'executable', wmlc: 'code',
+    nq: 'data', nt: 'data', rq: 'data', trig: 'data', mrc: 'data',
+    flw: 'design', karbon: 'design', kon: 'design', flo: 'design', igx: 'design',
+    gqf: 'science', gqs: 'science', mc1: 'science', fzs: 'sheet', chrt: 'sheet', atx: 'game',
+};
+const DOC_GROUPS = {
+    pdf: 'pdf', ps: 'pdf', eps: 'pdf', dvi: 'pdf',
+    doc: 'word', docx: 'word', docm: 'word', dot: 'word', dotx: 'word', rtf: 'word', odt: 'word', pages: 'word',
+    xls: 'sheet', xlsx: 'sheet', xlsm: 'sheet', xlsb: 'sheet', csv: 'sheet', tsv: 'sheet', ods: 'sheet', numbers: 'sheet',
+    ppt: 'slides', pptx: 'slides', pptm: 'slides', pps: 'slides', ppsx: 'slides', odp: 'slides', key: 'slides',
+};
+export const EXT_OVERRIDES = (() => {
+    const m = new Map();
+    for (const [cat, list] of Object.entries(EXT_GROUPS))
+        for (const ext of list.split(/\s+/))
+            m.set(ext, cat);
+    for (const [ext, cat] of Object.entries(DOC_GROUPS))
+        m.set(ext, cat);
+    for (const [ext, cat] of Object.entries(FUNCTION_MAP))
+        m.set(ext, cat);
+    m.set('key', 'slides'); // Keynote wins over the generic "private key" meaning
+    return m;
+})();
+/** Mime rules, first match wins (order matters: specific formats before broad ones). */
+const MIME_RULES = [
+    ['pdf', /^application\/(pdf|postscript|x-dvi)$/],
+    ['word', /msword|wordprocessingml|vnd\.ms-word|\/rtf$|opendocument\.text|vnd\.sun\.xml\.writer/],
+    ['sheet', /ms-excel|spreadsheetml|opendocument\.(spreadsheet|chart|formula)|vnd\.sun\.xml\.calc|^text\/(csv|tab-separated)/],
+    ['slides', /powerpoint|presentationml|opendocument\.presentation|vnd\.sun\.xml\.impress/],
+    ['database', /sqlite|ms-access|x-msaccess|opendocument\.database|x-dbf|^application\/sql/],
+    ['ebook', /epub|mobipocket|x-fictionbook|x-cbr|x-cbz|ebook/],
+    ['font', /^font\/|font-|-font|ms-fontobject/],
+    ['image', /^image\/|opendocument\.(graphics|image)|x-msmetafile|x-emf|x-wmf/],
+    ['video', /^video\/|^application\/(mp4|mp21)$/],
+    ['audio', /^audio\/|mpegurl|x-scpls/],
+    ['model3d', /^model\/|x-shader/],
+    ['security', /pkcs|x509|pgp|pkix|x-pem|ms-pki|x-pkcs|cert|keys?$|pkixcmp/],
+    ['geo', /google-earth|gpx|vnd\.geo|dwg|dxf|shapefile|^application\/gml/],
+    ['mail', /^message\/|mbox|ms-outlook|^text\/(calendar|vcard|x-vcard)|^application\/(ics|vcard)/],
+    ['science', /^chemical\/|x-hdf|netcdf|^application\/fits|mathematica|matlab|x-cdf/],
+    ['archive', /zip|x-tar|gzip|x-7z|x-rar|rar-compressed|x-bzip|x-xz|x-compress|java-archive|x-rpm|vnd\.debian|x-iso9660|diskimage|android\.package|x-lzh|x-cpio|x-stuffit|x-ace|vnd\.ms-cab|installer/],
+    ['executable', /x-msdownload|x-msdos-program|portable-executable|x-executable|x-msi|x-dosexec|x-mach-binary/],
+    ['code', /javascript|ecmascript|^text\/(html|css|x-|javascript|typescript|jsx|tsx)|^application\/(x-sh(?![a-z])|x-csh|x-python|x-httpd|x-perl|x-ruby|x-php|wasm|typescript|x-tcl|sieve)/],
+    ['data', /json|xml|yaml|cbor|protobuf|toml|graphql|rdf|iccprofile|^application\/(x-ndjson|x-plist)/],
+    ['text', /^text\/|x-texinfo/],
+];
+export function classifyMime(mime) {
+    for (const [cat, re] of MIME_RULES)
+        if (re.test(mime))
+            return cat;
+    return 'generic';
+}
+/**
+ * Category for an extension (without dot, any case). `mimes` are all mime types registered for it; an extension can
+ * have several (`mp4` is both application/mp4 and video/mp4), the first one that is not "generic" wins.
+ */
+export function classify(ext, mimes = []) {
+    const e = ext.toLowerCase().replace(/^\./, '');
+    const override = EXT_OVERRIDES.get(e);
+    if (override)
+        return override;
+    for (const m of typeof mimes === 'string' ? [mimes] : mimes) {
+        const c = classifyMime(m);
+        if (c !== 'generic')
+            return c;
+    }
+    return 'generic';
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { loadBodies } from './body.js';
+import { loadConfig } from './config.js';
+import { renderPng } from './png.js';
+import { loadFont } from './font.js';
+import { allExtensions, categoryFor } from './mime.js';
+import { createPalette } from './palette.js';
+import { renderIcon } from './render.js';
+import { testRun } from './testrun.js';
+import { ROOT } from './paths.js';
+const HELP = `MimeForge – generate file-type icons (SVG) from file extensions
+
+Usage
+  mimeforge <ext...> [options]           write <out>/<ext>.svg for the given extensions
+  mimeforge --all [options]              every known extension (mime-db + extras) + manifest.json
+  mimeforge --test-run [options]         write an HTML page with all body types at 16/48/128 px
+
+Options
+  -o, --out <dir>          output directory (default: ./out, test run: ./out/test-run)
+      --font <spec>        "monogram" (default), a .ttf/.otf/.woff file, or a bitmap-font .json
+      --body <path>        a directory of <category>.svg bodies, or one .svg used for every type
+      --color <k=#hex>     override an accent; k = category (pdf) or extension (.docx); repeatable
+      --colors <file>      JSON file {"pdf": "#d00", ".docx": "#06c"}
+      --accent <#hex>      force one accent for all icons
+      --label-case <c>     upper (default) | lower | none
+      --no-label           bodies only
+      --png <sizes>        also write PNGs, e.g. --png 16,32,48 → <out>/<size>/<ext>.png (needs @resvg/resvg-js)
+      --config <file>      JSON config (default: ./mimeforge.config.json if present); flags override it
+      --list               print "ext category" for every known extension
+  -h, --help               this help
+  -v, --version
+`;
+function fail(msg) {
+    console.error(`error: ${msg}`);
+    process.exit(1);
+}
+async function main() {
+    const { values, positionals } = parseArgs({
+        allowPositionals: true,
+        options: {
+            'test-run': { type: 'boolean' }, all: { type: 'boolean' }, list: { type: 'boolean' },
+            out: { type: 'string', short: 'o' }, font: { type: 'string' }, body: { type: 'string' },
+            color: { type: 'string', multiple: true }, colors: { type: 'string' }, accent: { type: 'string' },
+            'label-case': { type: 'string' }, 'no-label': { type: 'boolean' }, png: { type: 'string' }, config: { type: 'string' },
+            help: { type: 'boolean', short: 'h' }, version: { type: 'boolean', short: 'v' },
+        },
+    });
+    if (values.version) {
+        console.log(JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf8')).version);
+        return;
+    }
+    if (values.help || (!positionals.length && !values.all && !values['test-run'] && !values.list)) {
+        console.log(HELP);
+        return;
+    }
+    if (values.list) {
+        for (const e of allExtensions())
+            console.log(`${e} ${categoryFor(e)}`);
+        return;
+    }
+    let cfg = {};
+    try {
+        cfg = loadConfig(values.config)?.config ?? {};
+    }
+    catch (e) {
+        fail(e.message);
+    }
+    const fontSpec = values.font ?? cfg.font;
+    const bodySpec = values.body ?? cfg.body;
+    const accent = values.accent ?? cfg.accent;
+    const overrides = { ...(cfg.colors ?? {}) };
+    if (values.colors)
+        Object.assign(overrides, JSON.parse(readFileSync(values.colors, 'utf8')));
+    for (const kv of values.color ?? []) {
+        const i = kv.indexOf('=');
+        if (i < 1)
+            fail(`--color expects key=#hex, got "${kv}"`);
+        overrides[kv.slice(0, i)] = kv.slice(i + 1);
+    }
+    const labelCase = values['label-case'] ?? cfg.labelCase ?? 'upper';
+    if (!['upper', 'lower', 'none'].includes(labelCase))
+        fail('--label-case must be upper, lower or none');
+    let opts;
+    let bodyInfo;
+    try {
+        const bodies = loadBodies(bodySpec);
+        bodyInfo = bodies;
+        opts = {
+            font: loadFont(fontSpec), bodies, palette: createPalette(overrides), accent,
+            label: values['no-label'] || cfg.label === false ? false : undefined, labelCase: labelCase,
+        };
+    }
+    catch (e) {
+        fail(e.message);
+    }
+    for (const w of bodyInfo.warnings)
+        console.error(`warning: ${w}`);
+    if (values['test-run']) {
+        const out = resolve(values.out ?? 'out/test-run');
+        const file = testRun(out, opts, { font: fontSpec ?? 'monogram', body: bodyInfo.source, warnings: bodyInfo.warnings, missing: bodyInfo.missing });
+        console.log(`test run written: ${file}`);
+        return;
+    }
+    const out = resolve(values.out ?? cfg.out ?? 'out');
+    mkdirSync(out, { recursive: true });
+    const pngSizes = (values.png ? values.png.split(',').map(Number) : cfg.png ?? []).filter((n) => Number.isFinite(n) && n > 0);
+    const exts = values.all ? allExtensions() : positionals.map((e) => e.toLowerCase().replace(/^\./, ''));
+    const manifest = {};
+    let bytes = 0;
+    for (const ext of exts) {
+        const r = renderIcon(ext, opts);
+        writeFileSync(join(out, `${ext}.svg`), r.svg);
+        for (const size of pngSizes) {
+            mkdirSync(join(out, String(size)), { recursive: true });
+            writeFileSync(join(out, String(size), `${ext}.png`), await renderPng(r.svg, size));
+        }
+        manifest[ext] = r.category;
+        bytes += r.svg.length;
+    }
+    if (values.all)
+        writeFileSync(join(out, 'manifest.json'), JSON.stringify(manifest, null, 1));
+    console.log(`${exts.length} icon(s) → ${out}  (${(bytes / 1024).toFixed(0)} KB total, ${(bytes / exts.length / 1024).toFixed(1)} KB avg)`);
+}
+main().catch((e) => fail(e.message));

package/dist/color.d.ts

@@ -0,0 +1,12 @@
+export type RGB = [number, number, number];
+export declare function parseHex(input: string): RGB;
+export declare function toHex([r, g, b]: RGB): string;
+/** Normalize any accepted hex notation to `#RRGGBB`. */
+export declare const normalizeHex: (input: string) => string;
+/** Mix a color towards white by `t` (0 = unchanged, 1 = white). */
+export declare function tint(hex: string, t: number): string;
+/** WCAG relative luminance. */
+export declare function luminance(hex: string): number;
+export declare function contrast(a: string, b: string): number;
+/** White label text unless the accent is too light for it; then a dark ink. */
+export declare function labelTextColor(accent: string, light?: string, dark?: string, minContrast?: number): string;

package/dist/color.js

@@ -0,0 +1,34 @@
+export function parseHex(input) {
+    let h = input.trim().replace(/^#/, '');
+    if (h.length === 3)
+        h = h.split('').map((c) => c + c).join('');
+    if (!/^[0-9a-fA-F]{6}$/.test(h))
+        throw new Error(`Invalid hex color: "${input}"`);
+    return [parseInt(h.slice(0, 2), 16), parseInt(h.slice(2, 4), 16), parseInt(h.slice(4, 6), 16)];
+}
+export function toHex([r, g, b]) {
+    return '#' + [r, g, b].map((v) => Math.round(Math.max(0, Math.min(255, v))).toString(16).padStart(2, '0')).join('').toUpperCase();
+}
+/** Normalize any accepted hex notation to `#RRGGBB`. */
+export const normalizeHex = (input) => toHex(parseHex(input));
+/** Mix a color towards white by `t` (0 = unchanged, 1 = white). */
+export function tint(hex, t) {
+    const [r, g, b] = parseHex(hex);
+    return toHex([r + (255 - r) * t, g + (255 - g) * t, b + (255 - b) * t]);
+}
+/** WCAG relative luminance. */
+export function luminance(hex) {
+    const lin = parseHex(hex).map((v) => {
+        const s = v / 255;
+        return s <= 0.03928 ? s / 12.92 : Math.pow((s + 0.055) / 1.055, 2.4);
+    });
+    return 0.2126 * lin[0] + 0.7152 * lin[1] + 0.0722 * lin[2];
+}
+export function contrast(a, b) {
+    const [hi, lo] = [luminance(a), luminance(b)].sort((x, y) => y - x);
+    return (hi + 0.05) / (lo + 0.05);
+}
+/** White label text unless the accent is too light for it; then a dark ink. */
+export function labelTextColor(accent, light = '#FFFFFF', dark = '#1B1F24', minContrast = 3) {
+    return contrast(accent, light) >= minContrast ? light : dark;
+}