npm - @zenginui/registry - Versions diffs - 0.1.0 - Mend

@zenginui/registry 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (32) hide show

package/dist/html.js ADDED Viewed

@@ -0,0 +1,63 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+const MARK = "data-zengin";
+/**
+ * Edits index.html in place: the title, the theme-color meta, the icon, and one fonts link the CLI owns
+ * (marked with data-zengin so a later theme replaces it, never duplicates it). Returns false when there
+ * is no index.html to patch.
+ */
+export function patchIndexHtml(projectDir, patch) {
+    // A Vite project has index.html; a Next project has the root layout, whose <head> holds the same tags.
+    const p = existsSync(join(projectDir, "index.html")) ? join(projectDir, "index.html") : join(projectDir, "src", "app", "layout.tsx");
+    if (!existsSync(p))
+        return false;
+    const layout = p.endsWith("layout.tsx");
+    let html = readFileSync(p, "utf8");
+    if (patch.title !== undefined) {
+        if (layout) {
+            html = html.replace(/(export const metadata[^=]*=\s*\{[^}]*title:\s*)"[^"]*"/, `$1${JSON.stringify(patch.title)}`);
+        }
+        else {
+            const title = `<title>${escapeHtml(patch.title)}</title>`;
+            html = /<title>[\s\S]*?<\/title>/.test(html) ? html.replace(/<title>[\s\S]*?<\/title>/, title) : insertInHead(html, title);
+        }
+    }
+    if (patch.themeColor !== undefined) {
+        const meta = `<meta name="theme-color" content="${patch.themeColor}" />`;
+        html = /<meta\s+name="theme-color"[^>]*>/.test(html) ? html.replace(/<meta\s+name="theme-color"[^>]*>/, meta) : insertInHead(html, meta);
+    }
+    if (patch.icon !== undefined) {
+        const link = `<link rel="icon" href="${patch.icon}" />`;
+        html = /<link\s+rel="icon"[^>]*>/.test(html) ? html.replace(/<link\s+rel="icon"[^>]*>/, link) : insertInHead(html, link);
+    }
+    if (patch.fonts !== undefined) {
+        const owned = new RegExp(`\\s*<link[^>]*${MARK}="fonts"[^>]*>`, "g");
+        html = html.replace(owned, "");
+        if (patch.fonts) {
+            // In a React 19 layout a stylesheet link needs `precedence`, or Next's prerender fails on the hoisting.
+            const link = `<link rel="stylesheet" href="${patch.fonts}" ${MARK}="fonts"${layout ? ' precedence="default"' : ""} />`;
+            html = insertInHead(html, link);
+        }
+    }
+    writeFileSync(p, html);
+    return true;
+}
+/** The Google Fonts css2 href for the families, at the four weights components use unless `Family:400;700` pins them. */
+export function fontsHref(families) {
+    const unique = [...new Set(families.map((f) => f.trim()).filter(Boolean))];
+    const params = unique
+        .map((f) => {
+        const [family, weights] = f.split(":");
+        return `family=${encodeURIComponent(family.trim()).replace(/%20/g, "+")}:wght@${(weights ?? "400;500;600;700").trim()}`;
+    })
+        .join("&");
+    return `https://fonts.googleapis.com/css2?${params}&display=swap`;
+}
+function insertInHead(html, tag) {
+    if (/<\/head>/.test(html))
+        return html.replace(/(\s*)<\/head>/, `\n    ${tag}$1</head>`);
+    return `${tag}\n${html}`;
+}
+function escapeHtml(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}

package/dist/icons.d.ts ADDED Viewed

@@ -0,0 +1,43 @@
+import type { RegistrySource } from "./load.js";
+/**
+ * Icon sets. The vocabulary is Zengin UI's: sixty-odd names every component and template draws by.
+ * A set maps each name to an export of one react-icons module, and `zengin icons <set>` rewrites
+ * src/lib/icons.tsx so the names come from that set. App code never imports react-icons directly; the
+ * Icon manifest shadows it, and the engine says so.
+ */
+export declare const ICON_NAMES: readonly ["Search", "Close", "Check", "ChevronDown", "ChevronUp", "ChevronLeft", "ChevronRight", "ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Plus", "Minus", "Trash", "Edit", "Settings", "Menu", "More", "Home", "User", "Users", "Bell", "Info", "Warning", "Error", "Success", "Help", "Copy", "ExternalLink", "Download", "Upload", "Filter", "Sun", "Moon", "Loader", "Grid", "CreditCard", "Mail", "Calendar", "Clock", "Eye", "EyeOff", "Lock", "LogOut", "Star", "Send", "Paperclip", "Sparkles", "Link", "Refresh", "Globe", "File", "Folder", "Tag", "Inbox", "Message", "Code", "Terminal", "Chart", "Layers", "Database", "Shield", "Drag"];
+export type IconName = (typeof ICON_NAMES)[number];
+export interface IconSetSpec {
+    title: string;
+    description: string;
+    /** The react-icons module, e.g. `react-icons/lu`. */
+    module: string;
+    /** Vocabulary name -> export name in the module. */
+    names: Record<IconName, string>;
+}
+export declare const ICON_SETS: Record<string, IconSetSpec>;
+export declare const REACT_ICONS_VERSION = "^5.5.0";
+/** src/lib/icons.tsx for a set: the same `Icon` object and types the default file exports, drawn by react-icons. */
+export declare function renderIconsModule(name: string, set: IconSetSpec): string;
+export interface IconsSummary {
+    name: string;
+    title: string;
+    description: string;
+    module: string;
+}
+export declare function listIconSets(source: RegistrySource): Promise<IconsSummary[]>;
+export interface ApplyIconsResult {
+    name: string;
+    module: string;
+    files: string[];
+    /** npm packages the project now needs; the caller says how to install them. */
+    dependencies: Record<string, string>;
+    /** The file that was replaced, when the project already had one. */
+    replaced: boolean;
+}
+/** Points the project's icon vocabulary at a set: rewrites src/lib/icons.tsx and records the react-icons dependency. */
+export declare function applyIcons(opts: {
+    projectDir: string;
+    name: string;
+    source: RegistrySource;
+}): Promise<ApplyIconsResult>;

package/dist/icons.js ADDED Viewed

@@ -0,0 +1,197 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { installItems } from "./install.js";
+import { resolveItems } from "./resolve.js";
+import { LAYOUT } from "./schema.js";
+/**
+ * Icon sets. The vocabulary is Zengin UI's: sixty-odd names every component and template draws by.
+ * A set maps each name to an export of one react-icons module, and `zengin icons <set>` rewrites
+ * src/lib/icons.tsx so the names come from that set. App code never imports react-icons directly; the
+ * Icon manifest shadows it, and the engine says so.
+ */
+export const ICON_NAMES = [
+    "Search", "Close", "Check", "ChevronDown", "ChevronUp", "ChevronLeft", "ChevronRight", "ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight",
+    "Plus", "Minus", "Trash", "Edit", "Settings", "Menu", "More", "Home", "User", "Users", "Bell", "Info", "Warning", "Error", "Success", "Help",
+    "Copy", "ExternalLink", "Download", "Upload", "Filter", "Sun", "Moon", "Loader", "Grid", "CreditCard", "Mail", "Calendar", "Clock", "Eye", "EyeOff",
+    "Lock", "LogOut", "Star", "Send", "Paperclip", "Sparkles", "Link", "Refresh", "Globe", "File", "Folder", "Tag", "Inbox", "Message", "Code", "Terminal",
+    "Chart", "Layers", "Database", "Shield", "Drag",
+];
+const names = (prefix, map) => Object.fromEntries(Object.entries(map).map(([k, v]) => [k, prefix + v]));
+export const ICON_SETS = {
+    lucide: {
+        title: "Lucide",
+        description: "The set most React apps already use: even 2px strokes, round joins, one voice across a thousand glyphs.",
+        module: "react-icons/lu",
+        names: names("Lu", {
+            Search: "Search", Close: "X", Check: "Check", ChevronDown: "ChevronDown", ChevronUp: "ChevronUp", ChevronLeft: "ChevronLeft", ChevronRight: "ChevronRight",
+            ArrowUp: "ArrowUp", ArrowDown: "ArrowDown", ArrowLeft: "ArrowLeft", ArrowRight: "ArrowRight", Plus: "Plus", Minus: "Minus", Trash: "Trash2", Edit: "Pencil",
+            Settings: "Settings", Menu: "Menu", More: "Ellipsis", Home: "House", User: "User", Users: "Users", Bell: "Bell", Info: "Info", Warning: "TriangleAlert",
+            Error: "CircleX", Success: "CircleCheck", Help: "CircleHelp", Copy: "Copy", ExternalLink: "ExternalLink", Download: "Download", Upload: "Upload", Filter: "Filter",
+            Sun: "Sun", Moon: "Moon", Loader: "Loader", Grid: "LayoutGrid", CreditCard: "CreditCard", Mail: "Mail", Calendar: "Calendar", Clock: "Clock", Eye: "Eye",
+            EyeOff: "EyeOff", Lock: "Lock", LogOut: "LogOut", Star: "Star", Send: "Send", Paperclip: "Paperclip", Sparkles: "Sparkles", Link: "Link", Refresh: "RefreshCw",
+            Globe: "Globe", File: "File", Folder: "Folder", Tag: "Tag", Inbox: "Inbox", Message: "MessageSquare", Code: "Code", Terminal: "Terminal", Chart: "ChartBar",
+            Layers: "Layers", Database: "Database", Shield: "Shield", Drag: "GripVertical",
+        }),
+    },
+    tabler: {
+        title: "Tabler",
+        description: "Thin, wide, a little technical. Four thousand glyphs on a 24 grid; suits dashboards and dense tables.",
+        module: "react-icons/tb",
+        names: names("Tb", {
+            Search: "Search", Close: "X", Check: "Check", ChevronDown: "ChevronDown", ChevronUp: "ChevronUp", ChevronLeft: "ChevronLeft", ChevronRight: "ChevronRight",
+            ArrowUp: "ArrowUp", ArrowDown: "ArrowDown", ArrowLeft: "ArrowLeft", ArrowRight: "ArrowRight", Plus: "Plus", Minus: "Minus", Trash: "Trash", Edit: "Pencil",
+            Settings: "Settings", Menu: "Menu2", More: "Dots", Home: "Home", User: "User", Users: "Users", Bell: "Bell", Info: "InfoCircle", Warning: "AlertTriangle",
+            Error: "AlertCircle", Success: "CircleCheck", Help: "HelpCircle", Copy: "Copy", ExternalLink: "ExternalLink", Download: "Download", Upload: "Upload", Filter: "Filter",
+            Sun: "Sun", Moon: "Moon", Loader: "Loader2", Grid: "LayoutGrid", CreditCard: "CreditCard", Mail: "Mail", Calendar: "Calendar", Clock: "Clock", Eye: "Eye",
+            EyeOff: "EyeOff", Lock: "Lock", LogOut: "Logout", Star: "Star", Send: "Send", Paperclip: "Paperclip", Sparkles: "Sparkles", Link: "Link", Refresh: "Refresh",
+            Globe: "World", File: "File", Folder: "Folder", Tag: "Tag", Inbox: "Inbox", Message: "Message", Code: "Code", Terminal: "Terminal2", Chart: "ChartBar",
+            Layers: "Stack2", Database: "Database", Shield: "Shield", Drag: "GripVertical",
+        }),
+    },
+    phosphor: {
+        title: "Phosphor",
+        description: "Friendly and geometric, with a bit more curve than Lucide. Regular weight here; the family has five more.",
+        module: "react-icons/pi",
+        names: names("Pi", {
+            Search: "MagnifyingGlass", Close: "X", Check: "Check", ChevronDown: "CaretDown", ChevronUp: "CaretUp", ChevronLeft: "CaretLeft", ChevronRight: "CaretRight",
+            ArrowUp: "ArrowUp", ArrowDown: "ArrowDown", ArrowLeft: "ArrowLeft", ArrowRight: "ArrowRight", Plus: "Plus", Minus: "Minus", Trash: "Trash", Edit: "PencilSimple",
+            Settings: "Gear", Menu: "List", More: "DotsThree", Home: "House", User: "User", Users: "Users", Bell: "Bell", Info: "Info", Warning: "Warning",
+            Error: "WarningCircle", Success: "CheckCircle", Help: "Question", Copy: "Copy", ExternalLink: "ArrowSquareOut", Download: "DownloadSimple", Upload: "UploadSimple",
+            Filter: "Funnel", Sun: "Sun", Moon: "Moon", Loader: "Spinner", Grid: "SquaresFour", CreditCard: "CreditCard", Mail: "Envelope", Calendar: "Calendar", Clock: "Clock",
+            Eye: "Eye", EyeOff: "EyeSlash", Lock: "Lock", LogOut: "SignOut", Star: "Star", Send: "PaperPlaneRight", Paperclip: "Paperclip", Sparkles: "Sparkle", Link: "Link",
+            Refresh: "ArrowsClockwise", Globe: "Globe", File: "File", Folder: "Folder", Tag: "Tag", Inbox: "Tray", Message: "ChatCircle", Code: "Code", Terminal: "Terminal",
+            Chart: "ChartBar", Layers: "Stack", Database: "Database", Shield: "Shield", Drag: "DotsSixVertical",
+        }),
+    },
+    heroicons: {
+        title: "Heroicons",
+        description: "Tailwind's set, outline weight. Slightly heavier strokes and rounder forms; reads well at 20 and 24.",
+        module: "react-icons/hi2",
+        names: names("HiOutline", {
+            Search: "MagnifyingGlass", Close: "XMark", Check: "Check", ChevronDown: "ChevronDown", ChevronUp: "ChevronUp", ChevronLeft: "ChevronLeft", ChevronRight: "ChevronRight",
+            ArrowUp: "ArrowUp", ArrowDown: "ArrowDown", ArrowLeft: "ArrowLeft", ArrowRight: "ArrowRight", Plus: "Plus", Minus: "Minus", Trash: "Trash", Edit: "Pencil",
+            Settings: "Cog6Tooth", Menu: "Bars3", More: "EllipsisHorizontal", Home: "Home", User: "User", Users: "Users", Bell: "Bell", Info: "InformationCircle",
+            Warning: "ExclamationTriangle", Error: "ExclamationCircle", Success: "CheckCircle", Help: "QuestionMarkCircle", Copy: "DocumentDuplicate", ExternalLink: "ArrowTopRightOnSquare",
+            Download: "ArrowDownTray", Upload: "ArrowUpTray", Filter: "Funnel", Sun: "Sun", Moon: "Moon", Loader: "ArrowPath", Grid: "Squares2X2", CreditCard: "CreditCard",
+            Mail: "Envelope", Calendar: "Calendar", Clock: "Clock", Eye: "Eye", EyeOff: "EyeSlash", Lock: "LockClosed", LogOut: "ArrowRightOnRectangle", Star: "Star",
+            Send: "PaperAirplane", Paperclip: "PaperClip", Sparkles: "Sparkles", Link: "Link", Refresh: "ArrowPath", Globe: "GlobeAlt", File: "Document", Folder: "Folder",
+            Tag: "Tag", Inbox: "Inbox", Message: "ChatBubbleLeft", Code: "CodeBracket", Terminal: "CommandLine", Chart: "ChartBar", Layers: "Square3Stack3D",
+            Database: "CircleStack", Shield: "ShieldCheck", Drag: "EllipsisVertical",
+        }),
+    },
+    feather: {
+        title: "Feather",
+        description: "The original minimal line set: 2px, 24 grid, nothing extra. Fewer glyphs, every one of them calm.",
+        module: "react-icons/fi",
+        names: names("Fi", {
+            Search: "Search", Close: "X", Check: "Check", ChevronDown: "ChevronDown", ChevronUp: "ChevronUp", ChevronLeft: "ChevronLeft", ChevronRight: "ChevronRight",
+            ArrowUp: "ArrowUp", ArrowDown: "ArrowDown", ArrowLeft: "ArrowLeft", ArrowRight: "ArrowRight", Plus: "Plus", Minus: "Minus", Trash: "Trash2", Edit: "Edit2",
+            Settings: "Settings", Menu: "Menu", More: "MoreHorizontal", Home: "Home", User: "User", Users: "Users", Bell: "Bell", Info: "Info", Warning: "AlertTriangle",
+            Error: "AlertCircle", Success: "CheckCircle", Help: "HelpCircle", Copy: "Copy", ExternalLink: "ExternalLink", Download: "Download", Upload: "Upload", Filter: "Filter",
+            Sun: "Sun", Moon: "Moon", Loader: "Loader", Grid: "Grid", CreditCard: "CreditCard", Mail: "Mail", Calendar: "Calendar", Clock: "Clock", Eye: "Eye", EyeOff: "EyeOff",
+            Lock: "Lock", LogOut: "LogOut", Star: "Star", Send: "Send", Paperclip: "Paperclip", Sparkles: "Zap", Link: "Link", Refresh: "RefreshCw", Globe: "Globe", File: "File",
+            Folder: "Folder", Tag: "Tag", Inbox: "Inbox", Message: "MessageSquare", Code: "Code", Terminal: "Terminal", Chart: "BarChart2", Layers: "Layers", Database: "Database",
+            Shield: "Shield", Drag: "MoreVertical",
+        }),
+    },
+    radix: {
+        title: "Radix",
+        description: "15-pixel glyphs drawn for dense interfaces: crisp at small sizes, the set Radix Themes ships.",
+        module: "react-icons/rx",
+        names: names("Rx", {
+            Search: "MagnifyingGlass", Close: "Cross2", Check: "Check", ChevronDown: "ChevronDown", ChevronUp: "ChevronUp", ChevronLeft: "ChevronLeft", ChevronRight: "ChevronRight",
+            ArrowUp: "ArrowUp", ArrowDown: "ArrowDown", ArrowLeft: "ArrowLeft", ArrowRight: "ArrowRight", Plus: "Plus", Minus: "Minus", Trash: "Trash", Edit: "Pencil1",
+            Settings: "Gear", Menu: "HamburgerMenu", More: "DotsHorizontal", Home: "Home", User: "Person", Users: "Person", Bell: "Bell", Info: "InfoCircled",
+            Warning: "ExclamationTriangle", Error: "CrossCircled", Success: "CheckCircled", Help: "QuestionMarkCircled", Copy: "Copy", ExternalLink: "ExternalLink",
+            Download: "Download", Upload: "Upload", Filter: "MixerHorizontal", Sun: "Sun", Moon: "Moon", Loader: "Update", Grid: "Grid", CreditCard: "IdCard", Mail: "EnvelopeClosed",
+            Calendar: "Calendar", Clock: "Clock", Eye: "EyeOpen", EyeOff: "EyeClosed", Lock: "LockClosed", LogOut: "Exit", Star: "Star", Send: "PaperPlane", Paperclip: "Link2",
+            Sparkles: "MagicWand", Link: "Link1", Refresh: "Reload", Globe: "Globe", File: "FileText", Folder: "Archive", Tag: "Bookmark", Inbox: "EnvelopeOpen",
+            Message: "ChatBubble", Code: "Code", Terminal: "Code", Chart: "BarChart", Layers: "Layers", Database: "Archive", Shield: "LockClosed", Drag: "DragHandleDots2",
+        }),
+    },
+    material: {
+        title: "Material",
+        description: "Google's filled set, outlined where a hollow reads better. Heavier than the line sets; matches Material apps.",
+        module: "react-icons/md",
+        names: names("Md", {
+            Search: "Search", Close: "Close", Check: "Check", ChevronDown: "ExpandMore", ChevronUp: "ExpandLess", ChevronLeft: "ChevronLeft", ChevronRight: "ChevronRight",
+            ArrowUp: "ArrowUpward", ArrowDown: "ArrowDownward", ArrowLeft: "ArrowBack", ArrowRight: "ArrowForward", Plus: "Add", Minus: "Remove", Trash: "DeleteOutline", Edit: "Edit",
+            Settings: "Settings", Menu: "Menu", More: "MoreHoriz", Home: "Home", User: "Person", Users: "People", Bell: "Notifications", Info: "InfoOutline", Warning: "WarningAmber",
+            Error: "ErrorOutline", Success: "CheckCircleOutline", Help: "HelpOutline", Copy: "ContentCopy", ExternalLink: "OpenInNew", Download: "Download", Upload: "Upload",
+            Filter: "FilterList", Sun: "LightMode", Moon: "DarkMode", Loader: "Refresh", Grid: "GridView", CreditCard: "CreditCard", Mail: "MailOutline", Calendar: "CalendarToday",
+            Clock: "AccessTime", Eye: "Visibility", EyeOff: "VisibilityOff", Lock: "LockOutline", LogOut: "Logout", Star: "StarBorder", Send: "Send", Paperclip: "AttachFile",
+            Sparkles: "AutoAwesome", Link: "Link", Refresh: "Refresh", Globe: "Public", File: "InsertDriveFile", Folder: "Folder", Tag: "LabelOutline", Inbox: "Inbox",
+            Message: "ChatBubbleOutline", Code: "Code", Terminal: "Terminal", Chart: "BarChart", Layers: "Layers", Database: "Storage", Shield: "Shield", Drag: "DragIndicator",
+        }),
+    },
+    bootstrap: {
+        title: "Bootstrap",
+        description: "Bootstrap's own set: fine 1px-ish strokes on a 16 grid, drawn small first. Quiet next to text.",
+        module: "react-icons/bs",
+        names: names("Bs", {
+            Search: "Search", Close: "X", Check: "Check", ChevronDown: "ChevronDown", ChevronUp: "ChevronUp", ChevronLeft: "ChevronLeft", ChevronRight: "ChevronRight",
+            ArrowUp: "ArrowUp", ArrowDown: "ArrowDown", ArrowLeft: "ArrowLeft", ArrowRight: "ArrowRight", Plus: "Plus", Minus: "Dash", Trash: "Trash", Edit: "Pencil",
+            Settings: "Gear", Menu: "List", More: "ThreeDots", Home: "House", User: "Person", Users: "People", Bell: "Bell", Info: "InfoCircle", Warning: "ExclamationTriangle",
+            Error: "ExclamationCircle", Success: "CheckCircle", Help: "QuestionCircle", Copy: "Copy", ExternalLink: "BoxArrowUpRight", Download: "Download", Upload: "Upload",
+            Filter: "Funnel", Sun: "Sun", Moon: "Moon", Loader: "ArrowRepeat", Grid: "Grid", CreditCard: "CreditCard", Mail: "Envelope", Calendar: "Calendar", Clock: "Clock",
+            Eye: "Eye", EyeOff: "EyeSlash", Lock: "Lock", LogOut: "BoxArrowRight", Star: "Star", Send: "Send", Paperclip: "Paperclip", Sparkles: "Stars", Link: "Link45Deg",
+            Refresh: "ArrowClockwise", Globe: "Globe", File: "FileEarmark", Folder: "Folder", Tag: "Tag", Inbox: "Inbox", Message: "Chat", Code: "Code", Terminal: "Terminal",
+            Chart: "BarChart", Layers: "Layers", Database: "Database", Shield: "Shield", Drag: "GripVertical",
+        }),
+    },
+};
+export const REACT_ICONS_VERSION = "^5.5.0";
+/** src/lib/icons.tsx for a set: the same `Icon` object and types the default file exports, drawn by react-icons. */
+export function renderIconsModule(name, set) {
+    const imports = [...new Set(Object.values(set.names))].sort();
+    const entries = ICON_NAMES.map((n) => `  ${n}: ${set.names[n]},`);
+    return `import type { IconBaseProps } from "react-icons";
+import { ${imports.join(", ")} } from "${set.module}";
+/**
+ * The icon vocabulary, drawn by ${set.title} (${set.module}) since \`zengin icons ${name}\`. Components and app code
+ * draw by name: <Icon.Search />. Run \`zengin icons <set>\` again to change every icon at once, or edit a line
+ * here to swap one glyph. Sized by font-size (1em) unless \`size\` says otherwise, like every react-icons glyph.
+ */
+export const Icon = {
+${entries.join("\n")}
+} as const;
+export type IconName = keyof typeof Icon;
+export const iconNames = Object.keys(Icon) as IconName[];
+export type IconProps = IconBaseProps;
+export type IconComponent = (typeof Icon)[IconName];
+export type IconSet = Partial<Record<IconName, IconComponent>>;
+/** Kept for API parity with the default module; a project on a fixed set has nothing to swap at runtime. */
+export function setIconSet(_set: IconSet): void {}
+`;
+}
+export async function listIconSets(source) {
+    const index = await source.index();
+    return index.items.filter((i) => i.type === "icons" && i.iconSet).map((i) => ({ name: i.name.replace(/^icons-/, ""), title: i.title, description: i.description, module: i.iconSet.module }));
+}
+/** Points the project's icon vocabulary at a set: rewrites src/lib/icons.tsx and records the react-icons dependency. */
+export async function applyIcons(opts) {
+    const dir = resolve(opts.projectDir);
+    if (!existsSync(join(dir, "zengin.config.yaml")))
+        throw new Error(`${dir} has no zengin.config.yaml. Run zengin icons inside a project made by zengin create, or pass --dir.`);
+    const index = await opts.source.index();
+    const itemName = `icons-${opts.name.replace(/^icons-/, "")}`;
+    const summary = index.items.find((i) => i.name === itemName && i.type === "icons");
+    if (!summary) {
+        const sets = index.items.filter((i) => i.type === "icons").map((i) => i.name.replace(/^icons-/, ""));
+        throw new Error(`No icon set "${opts.name}". Sets: ${sets.join(", ")}.`);
+    }
+    const target = join(dir, LAYOUT.libDir, "icons.tsx");
+    const replaced = existsSync(target);
+    const items = await resolveItems(opts.source, [itemName]);
+    const r = installItems({ projectDir: dir, items, version: index.version, force: true });
+    const pkgPath = join(dir, "package.json");
+    if (existsSync(pkgPath)) {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+        pkg.dependencies = { ...pkg.dependencies, ...r.dependencies };
+        writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+    }
+    return { name: opts.name.replace(/^icons-/, ""), module: summary.iconSet.module, files: r.written, dependencies: r.dependencies, replaced };
+}

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,14 @@
+export { buildRegistry, writeRegistry, kebab, pascal } from "./build.js";
+export { openRegistry, registryFromMemory, DEFAULT_REGISTRY, type RegistrySource } from "./load.js";
+export { resolveItems } from "./resolve.js";
+export { installItems, withPragma, stripPragma, contentHash, type InstallResult } from "./install.js";
+export { planUpgrade, applyUpgrade, diffLines, type UpgradePlan, type UpgradeEntry, type UpgradeState, type ApplyResult } from "./upgrade.js";
+export { createProject, VERSIONS, type CreateOptions, type CreateResult } from "./create.js";
+export { buildTokensCss, writeTokensCss } from "./tokens.js";
+export { applyTheme, listThemes, type ApplyThemeResult, type ThemeSummary } from "./theme.js";
+export { applyIcons, listIconSets, renderIconsModule, ICON_NAMES, ICON_SETS, type ApplyIconsResult, type IconsSummary, type IconSetSpec } from "./icons.js";
+export { applyFonts, listFonts, applyPairingToCss, pairingCss, pairingFamilies, type ApplyFontsResult, type FontsSummary } from "./fonts.js";
+export { brandProject, derivePalette, paletteContrast, renderBrandCss, primaryFromSvg, faviconSvg, type BrandOptions, type BrandResult, type BrandRadius, type Palette } from "./brand.js";
+export { contrast, hexToOklch, oklchToHex, pushForContrast, type Oklch } from "./color.js";
+export { patchIndexHtml, fontsHref, type HtmlPatch } from "./html.js";
+export { LAYOUT, REGISTRY_SCHEMA, isRegistryIndex, type Registry, type RegistryIndex, type RegistryItem, type RegistryFile, type ItemType, type FileKind, type FontPairing, type FontRole } from "./schema.js";

package/dist/index.js ADDED Viewed

@@ -0,0 +1,14 @@
+export { buildRegistry, writeRegistry, kebab, pascal } from "./build.js";
+export { openRegistry, registryFromMemory, DEFAULT_REGISTRY } from "./load.js";
+export { resolveItems } from "./resolve.js";
+export { installItems, withPragma, stripPragma, contentHash } from "./install.js";
+export { planUpgrade, applyUpgrade, diffLines } from "./upgrade.js";
+export { createProject, VERSIONS } from "./create.js";
+export { buildTokensCss, writeTokensCss } from "./tokens.js";
+export { applyTheme, listThemes } from "./theme.js";
+export { applyIcons, listIconSets, renderIconsModule, ICON_NAMES, ICON_SETS } from "./icons.js";
+export { applyFonts, listFonts, applyPairingToCss, pairingCss, pairingFamilies } from "./fonts.js";
+export { brandProject, derivePalette, paletteContrast, renderBrandCss, primaryFromSvg, faviconSvg } from "./brand.js";
+export { contrast, hexToOklch, oklchToHex, pushForContrast } from "./color.js";
+export { patchIndexHtml, fontsHref } from "./html.js";
+export { LAYOUT, REGISTRY_SCHEMA, isRegistryIndex } from "./schema.js";

package/dist/install.d.ts ADDED Viewed

@@ -0,0 +1,34 @@
+import type { ComponentManifest } from "@zenginui/engine";
+import { type RegistryItem } from "./schema.js";
+export interface InstallResult {
+    /** Project-relative paths written, in order. */
+    written: string[];
+    /** Project-relative paths that existed and were left alone (pass `force` to overwrite). */
+    skipped: string[];
+    dependencies: Record<string, string>;
+    devDependencies: Record<string, string>;
+    /** Component names now in the manifest. */
+    components: string[];
+}
+/**
+ * Writes resolved items into a project: component files with the owned pragma, the manifest entry merged
+ * into zengin/components.json with `export.from` pointing at the alias, the stylesheet import, the barrel
+ * export, and the story. Templates write their files as-is. Existing files are kept unless `force`.
+ */
+export declare function installItems(opts: {
+    projectDir: string;
+    items: RegistryItem[];
+    version: string;
+    force?: boolean;
+}): InstallResult;
+/**
+ * The pragma the engine reads: the file is owned by the project, forked from this system version, and this
+ * is the hash of what was copied, so `zengin upgrade` can tell a local edit from an upstream change.
+ */
+export declare function withPragma(content: string, component: string, version: string): string;
+/** The file without its pragma line, line endings normalized, so hashes compare across platforms. */
+export declare function stripPragma(content: string): string;
+export declare function contentHash(body: string): string;
+export declare function mergeManifest(projectDir: string, entry: ComponentManifest): void;
+export declare const STYLES_INDEX_HEAD = "/* Order matters: tokens, then foundation, then components. `zengin add` appends component stylesheets here. */\n@import \"generated/tokens.css\";\n@import \"base.css\";\n@import \"chart.css\";\n@import \"motion.css\";\n";
+export declare const BARREL_HEAD: string;

package/dist/install.js ADDED Viewed

@@ -0,0 +1,106 @@
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { LAYOUT } from "./schema.js";
+/**
+ * Writes resolved items into a project: component files with the owned pragma, the manifest entry merged
+ * into zengin/components.json with `export.from` pointing at the alias, the stylesheet import, the barrel
+ * export, and the story. Templates write their files as-is. Existing files are kept unless `force`.
+ */
+export function installItems(opts) {
+    const { projectDir, items, version } = opts;
+    const result = { written: [], skipped: [], dependencies: {}, devDependencies: {}, components: [] };
+    const write = (rel, content, always = false) => {
+        const abs = join(projectDir, rel);
+        if (existsSync(abs) && !opts.force && !always) {
+            result.skipped.push(rel);
+            return;
+        }
+        mkdirSync(dirname(abs), { recursive: true });
+        writeFileSync(abs, content);
+        result.written.push(rel);
+    };
+    for (const item of items) {
+        Object.assign(result.dependencies, item.dependencies);
+        Object.assign(result.devDependencies, item.devDependencies);
+        for (const f of item.files) {
+            // A component's own files, the .tsx and its stylesheet, carry the pragma; a story is the project's from the start.
+            const owned = item.manifest && (f.kind === "component" || (f.kind === "style" && f.path.startsWith(LAYOUT.componentsDir)));
+            const content = owned ? withPragma(f.content, item.manifest.name, version) : f.content;
+            write(f.path, content);
+        }
+        if (item.manifest) {
+            mergeManifest(projectDir, { ...item.manifest, export: item.type === "component" ? { ...item.manifest.export, from: LAYOUT.alias } : item.manifest.export });
+            const css = item.files.find((f) => f.kind === "style" && f.path.startsWith(LAYOUT.componentsDir));
+            if (css)
+                addStyleImport(projectDir, css.path);
+            // Templates import Icon from the package alias, as they did from @zenginui/ui: the barrel re-exports the vocabulary.
+            if (item.name === "lib-icons")
+                addBarrelLine(projectDir, `export * from "../../lib/icons";`);
+            else
+                addBarrelExport(projectDir, item.name);
+        }
+    }
+    const manifestPath = join(projectDir, LAYOUT.definitionsDir, "components.json");
+    if (existsSync(manifestPath)) {
+        result.components = JSON.parse(readFileSync(manifestPath, "utf8")).map((m) => m.name);
+    }
+    return result;
+}
+/**
+ * The pragma the engine reads: the file is owned by the project, forked from this system version, and this
+ * is the hash of what was copied, so `zengin upgrade` can tell a local edit from an upstream change.
+ */
+export function withPragma(content, component, version) {
+    const body = stripPragma(content);
+    return `/* zengin-owned ${component}, forked from @zenginui/ui@${version}, sha ${contentHash(body)} */\n${body}`;
+}
+/** The file without its pragma line, line endings normalized, so hashes compare across platforms. */
+export function stripPragma(content) {
+    return content.replace(/^\/\* zengin-owned[^\n]*\*\/\r?\n/, "").replace(/\r\n/g, "\n");
+}
+export function contentHash(body) {
+    return createHash("sha256").update(body.replace(/\r\n/g, "\n")).digest("hex").slice(0, 12);
+}
+export function mergeManifest(projectDir, entry) {
+    const p = join(projectDir, LAYOUT.definitionsDir, "components.json");
+    const current = existsSync(p) ? JSON.parse(readFileSync(p, "utf8")) : [];
+    const i = current.findIndex((m) => m.name === entry.name);
+    if (i === -1)
+        current.push(entry);
+    else
+        current[i] = entry;
+    mkdirSync(dirname(p), { recursive: true });
+    writeFileSync(p, JSON.stringify(current, null, 2) + "\n");
+}
+/** Appends `@import "../components/ui/<x>/<x>.css";` to src/styles/index.css once. */
+function addStyleImport(projectDir, cssPath) {
+    const p = join(projectDir, LAYOUT.stylesIndex);
+    const rel = "../" + cssPath.replace(/^src\//, "");
+    const line = `@import "${rel}";`;
+    const current = existsSync(p) ? readFileSync(p, "utf8") : STYLES_INDEX_HEAD;
+    if (current.includes(line))
+        return;
+    mkdirSync(dirname(p), { recursive: true });
+    writeFileSync(p, current.trimEnd() + "\n" + line + "\n");
+}
+/** Appends `export * from "./<x>/<x>";` to src/components/ui/index.ts once. */
+function addBarrelExport(projectDir, name) {
+    addBarrelLine(projectDir, `export * from "./${name}/${name}";`);
+}
+function addBarrelLine(projectDir, line) {
+    const p = join(projectDir, LAYOUT.componentsDir, "index.ts");
+    const current = existsSync(p) ? readFileSync(p, "utf8") : BARREL_HEAD;
+    if (current.includes(line))
+        return;
+    mkdirSync(dirname(p), { recursive: true });
+    writeFileSync(p, current.trimEnd() + "\n" + line + "\n");
+}
+export const STYLES_INDEX_HEAD = `/* Order matters: tokens, then foundation, then components. \`zengin add\` appends component stylesheets here. */
+@import "generated/tokens.css";
+@import "base.css";
+@import "chart.css";
+@import "motion.css";
+`;
+export const BARREL_HEAD = `/* Every component the project owns. \`zengin add\` appends to this file; the engine treats "${LAYOUT.alias}" as the system. */
+`;

package/dist/load.d.ts ADDED Viewed

@@ -0,0 +1,11 @@
+import { type Registry, type RegistryIndex, type RegistryItem } from "./schema.js";
+/** A registry the client can list and fetch items from, whether it is a directory, a URL, or in memory. */
+export interface RegistrySource {
+    readonly location: string;
+    index(): Promise<RegistryIndex>;
+    item(name: string): Promise<RegistryItem>;
+}
+export declare const DEFAULT_REGISTRY = "https://zengin-marketing-site.vercel.app/r";
+/** `source` is a directory written by writeRegistry, or the base URL such a directory is served from. */
+export declare function openRegistry(source?: string): RegistrySource;
+export declare function registryFromMemory(registry: Registry): RegistrySource;

package/dist/load.js ADDED Viewed

@@ -0,0 +1,70 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { isRegistryIndex } from "./schema.js";
+export const DEFAULT_REGISTRY = "https://zengin-marketing-site.vercel.app/r";
+/** `source` is a directory written by writeRegistry, or the base URL such a directory is served from. */
+export function openRegistry(source = process.env["ZENGIN_REGISTRY"] ?? DEFAULT_REGISTRY) {
+    if (/^https?:\/\//.test(source))
+        return remote(source.replace(/\/$/, ""));
+    if (!existsSync(join(source, "index.json")))
+        throw new Error(`No registry at ${source}: index.json not found. Build one with \`zengin registry build --out <dir>\`.`);
+    return local(source);
+}
+export function registryFromMemory(registry) {
+    const byName = new Map(registry.items.map((i) => [i.name, i]));
+    return {
+        location: "memory",
+        async index() {
+            return { ...registry, items: registry.items.map(({ files: _f, manifest: _m, ...rest }) => rest) };
+        },
+        async item(name) {
+            const it = byName.get(name);
+            if (!it)
+                throw new Error(`Registry has no item "${name}".`);
+            return it;
+        },
+    };
+}
+function local(dir) {
+    return {
+        location: dir,
+        async index() {
+            const parsed = JSON.parse(readFileSync(join(dir, "index.json"), "utf8"));
+            if (!isRegistryIndex(parsed))
+                throw new Error(`${dir}/index.json is not a Zengin registry index.`);
+            return parsed;
+        },
+        async item(name) {
+            const p = join(dir, "items", `${name}.json`);
+            if (!existsSync(p))
+                throw new Error(`Registry at ${dir} has no item "${name}".`);
+            return JSON.parse(readFileSync(p, "utf8"));
+        },
+    };
+}
+function remote(base) {
+    const get = async (path) => {
+        let res;
+        try {
+            res = await fetch(`${base}/${path}`);
+        }
+        catch (e) {
+            throw new Error(`Could not reach the registry at ${base}: ${e.message}. Pass --registry <dir|url> or set ZENGIN_REGISTRY.`);
+        }
+        if (!res.ok)
+            throw new Error(`Registry ${base}/${path} answered ${res.status}.`);
+        return res.json();
+    };
+    return {
+        location: base,
+        async index() {
+            const parsed = await get("index.json");
+            if (!isRegistryIndex(parsed))
+                throw new Error(`${base}/index.json is not a Zengin registry index.`);
+            return parsed;
+        },
+        async item(name) {
+            return (await get(`items/${name}.json`));
+        },
+    };
+}

package/dist/resolve.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+import type { RegistrySource } from "./load.js";
+import type { RegistryItem } from "./schema.js";
+/**
+ * The items named plus everything they depend on, dependencies first, each once. Unknown names fail with
+ * the list of what the registry does have, so a typo is a one-line fix.
+ */
+export declare function resolveItems(source: RegistrySource, names: string[]): Promise<RegistryItem[]>;

package/dist/resolve.js ADDED Viewed

@@ -0,0 +1,31 @@
+/**
+ * The items named plus everything they depend on, dependencies first, each once. Unknown names fail with
+ * the list of what the registry does have, so a typo is a one-line fix.
+ */
+export async function resolveItems(source, names) {
+    const index = await source.index();
+    const known = new Set(index.items.map((i) => i.name));
+    const unknown = names.filter((n) => !known.has(n));
+    if (unknown.length) {
+        throw new Error(`Registry at ${source.location} has no item${unknown.length > 1 ? "s" : ""} ${unknown.map((n) => `"${n}"`).join(", ")}. Available: ${[...known].sort().join(", ")}.`);
+    }
+    const ordered = [];
+    const seen = new Set();
+    const visiting = new Set();
+    async function visit(name, trail) {
+        if (seen.has(name))
+            return;
+        if (visiting.has(name))
+            throw new Error(`Registry dependency cycle: ${[...trail, name].join(" -> ")}`);
+        visiting.add(name);
+        const item = await source.item(name);
+        for (const dep of item.registryDependencies)
+            await visit(dep, [...trail, name]);
+        visiting.delete(name);
+        seen.add(name);
+        ordered.push(item);
+    }
+    for (const n of names)
+        await visit(n, []);
+    return ordered;
+}