@moewolf/moe-icons-cli 0.0.1 → 0.0.3

package/dist/commands/parser.d.ts

@@ -12,10 +12,20 @@ export type Command = {
     readonly name: "groups";
 } | {
     readonly name: "generate";
+} | {
+    readonly name: "recover";
 } | {
     readonly name: "init";
+    readonly dryRun?: boolean;
+} | {
+    readonly name: "doctor";
+    readonly check?: boolean;
+    readonly dryRun?: boolean;
 } | {
     readonly name: "mcp";
+} | {
+    readonly name: "update";
+    readonly metadata?: boolean;
 } | {
     readonly name: "help";
 } | {
@@ -34,8 +44,9 @@ export interface ParseResult {
 }
 export type Target = "react" | "vue" | "vanilla" | "assets";
 /**
- * Parse argv into a Command via Commander. Never calls `process.exit()`.
+ * Parse argv into a Command. Never calls `process.exit()`.
  * `moeicons --pro` / `--ent` legacy aliases map to install for the compatibility window.
+ * Unknown commands and unknown options map to a stable VALIDATION_ERROR.
  */
 export declare function parseArgs(argv: readonly string[]): ParseResult;
-export declare const HELP_TEXT = "moeicons \u2014 Moeicons icon library CLI\n\nUsage:\n  moeicons                      interactive guided flow (free / pro / login)\n  moeicons install [group]      install an icon group\n  moeicons login                browser login (PKCE)\n  moeicons logout               clear local session\n  moeicons account              show account/tier info\n  moeicons groups               list available icon groups\n  moeicons generate             generate React/Vue proxy components\n  moeicons init                 create moeicons.config.json\n  moeicons mcp                  start the MCP stdio server\n  moeicons --version            show version\n  moeicons --help               show help\n\nOptions:\n  --json         machine-readable JSON output\n  --yes          skip confirmations in noninteractive mode\n  --target       output target: react, vue, vanilla, or assets\n  --no-tailwind  skip Tailwind config auto-integration\n";
+export declare const HELP_TEXT = "moeicons \u2014 Moeicons icon library CLI\n\nUsage:\n  moeicons                      interactive guided flow (free / pro / login)\n  moeicons install [group]      install an icon group\n  moeicons login                browser login (PKCE)\n  moeicons logout               clear local session\n  moeicons account              show account/tier info\n  moeicons groups               list available icon groups\n  moeicons generate             generate React/Vue proxy components\n  moeicons init                 create moeicons.config.jsonc\n  moeicons init --dry-run       print the full config/entry/style plan without writing\n  moeicons doctor               diagnose project anchors (read-only)\n  moeicons recover              recover interrupted writes (run at project root)\n  moeicons doctor --check       exit non-zero when any required anchor is not OK\n  moeicons update metadata      sync MANUAL.md/catalog.json/manifest.json only\n  moeicons update               full code + metadata update\n  moeicons mcp                  start the MCP stdio server\n  moeicons --version            show version\n  moeicons --help               show help\n\nOptions:\n  --json         machine-readable JSON output\n  --yes          skip confirmations in noninteractive mode\n  --target       output target: react, vue, vanilla, or assets\n  --no-tailwind  skip Tailwind config auto-integration\n  --dry-run      (init/doctor) plan only, never write\n  --check        (doctor) exit 1 when required anchors are not OK\n";

package/dist/commands/parser.js

@@ -6,10 +6,59 @@ const SIMPLE_COMMANDS = [
     "account",
     "groups",
     "generate",
-    "init",
+    "recover",
     "mcp",
     "help",
 ];
+/**
+ * Options accepted on every command. `--dry-run`/`--check` are additionally
+ * accepted on `init` / `doctor` (validated in parseArgs). Unknown options never
+ * pass silently; they produce a stable VALIDATION_ERROR.
+ */
+const GLOBAL_OPTIONS = new Set([
+    "--json",
+    "--yes",
+    "--no-tailwind",
+    "--pro",
+    "--ent",
+    "--help",
+    "-h",
+    "--version",
+    "-v",
+    "--showVersion",
+]);
+function commandName(argv) {
+    for (const arg of argv) {
+        if (!arg.startsWith("-"))
+            return arg;
+    }
+    return undefined;
+}
+/** Validate that no option is unknown for the given command. */
+function rejectUnknownOptions(argv, command) {
+    const allowLocal = command === "init" || command === "doctor";
+    const local = new Set(["--dry-run", "--check"]);
+    for (const arg of argv) {
+        if (!arg.startsWith("-"))
+            continue;
+        const name = arg.split("=")[0] ?? arg;
+        if (arg.startsWith("--target"))
+            continue; // value validated separately
+        if (GLOBAL_OPTIONS.has(name))
+            continue;
+        if (allowLocal && local.has(name))
+            continue;
+        throw new CliError("VALIDATION_ERROR", `unknown option: ${name}`);
+    }
+}
+function parseTarget(argv) {
+    const targetIndex = argv.indexOf("--target");
+    const targetValue = targetIndex >= 0 ? argv[targetIndex + 1] : undefined;
+    if (targetIndex >= 0 && !["react", "vue", "vanilla", "assets"].includes(targetValue ?? "")) {
+        throw new CliError("VALIDATION_ERROR", `unknown target: ${targetValue ?? ""}`);
+    }
+    return targetValue;
+}
 function addSharedOptions(command) {
     return command
         .allowUnknownOption(true)
@@ -24,46 +73,11 @@ function addSharedOptions(command) {
         .option("--pro")
         .option("--ent");
 }
-function createProgram(onSelect) {
-    const program = addSharedOptions(new Commander());
-    program
-        .name("moeicons")
-        .exitOverride()
-        .addHelpCommand(false)
-        .showHelpAfterError(false)
-        .enablePositionalOptions()
-        .configureOutput({
-        writeOut: () => undefined,
-        writeErr: () => undefined,
-    })
-        .action(() => {
-        onSelect({ name: "wizard" });
-    });
-    addSharedOptions(program.command("install").argument("[group]")).action((group) => {
-        onSelect(group ? { name: "install", group } : { name: "install" });
-    });
-    for (const name of SIMPLE_COMMANDS) {
-        addSharedOptions(program.command(name)).action(() => {
-            onSelect({ name });
-        });
-    }
-    return program;
-}
-function toCliError(error) {
-    if (error instanceof CommanderError && error.code === "commander.unknownCommand") {
-        const match = /unknown command ['`]?([^'`\s]+)/.exec(error.message);
-        throw new CliError("VALIDATION_ERROR", `unknown command: ${match?.[1] ?? "unknown"}`);
-    }
-    if (error instanceof CommanderError &&
-        (error.code === "commander.help" || error.code === "commander.helpDisplayed")) {
-        throw new CliError("VALIDATION_ERROR", error.message);
-    }
-    throw error;
-}
-const KNOWN_COMMANDS = new Set(["install", ...SIMPLE_COMMANDS]);
+const KNOWN_COMMANDS = new Set(["install", "update", "init", "doctor", ...SIMPLE_COMMANDS]);
 /**
- * Parse argv into a Command via Commander. Never calls `process.exit()`.
+ * Parse argv into a Command. Never calls `process.exit()`.
  * `moeicons --pro` / `--ent` legacy aliases map to install for the compatibility window.
+ * Unknown commands and unknown options map to a stable VALIDATION_ERROR.
  */
 export function parseArgs(argv) {
     const json = argv.includes("--json");
@@ -73,12 +87,18 @@ export function parseArgs(argv) {
     const help = argv.includes("--help") || argv.includes("-h");
     const pro = argv.includes("--pro");
     const ent = argv.includes("--ent");
-    const targetIndex = argv.indexOf("--target");
-    const targetValue = targetIndex >= 0 ? argv[targetIndex + 1] : undefined;
-    if (targetIndex >= 0 && !["react", "vue", "vanilla", "assets"].includes(targetValue ?? "")) {
-        throw new CliError("VALIDATION_ERROR", `unknown target: ${targetValue ?? ""}`);
+    const target = parseTarget(argv);
+    const first = commandName(argv);
+    if (first !== undefined && !KNOWN_COMMANDS.has(first)) {
+        rejectUnknownOptions(argv, first);
+        throw new CliError("VALIDATION_ERROR", `unknown command: ${first}`);
+    }
+    if (first === "init" || first === "doctor") {
+        rejectUnknownOptions(argv, first);
+    }
+    else {
+        rejectUnknownOptions(argv);
     }
-    const target = targetValue;
     const withTarget = (command) => target ? { ...command, target } : command;
     // Preserve previous flag precedence: version/help/legacy aliases beat subcommands.
     if (version)
@@ -101,16 +121,33 @@ export function parseArgs(argv) {
             noTailwind,
             ...(target ? { target } : {}),
         };
-    const positional = argv.filter((arg) => !arg.startsWith("-"));
-    const first = positional[0];
-    if (first !== undefined && !KNOWN_COMMANDS.has(first)) {
-        throw new CliError("VALIDATION_ERROR", `unknown command: ${first}`);
+    if (first === "init") {
+        return {
+            command: withTarget({ name: "init", ...(argv.includes("--dry-run") ? { dryRun: true } : {}) }),
+            json,
+            yes,
+            noTailwind,
+            ...(target ? { target } : {}),
+        };
+    }
+    if (first === "doctor") {
+        return {
+            command: {
+                name: "doctor",
+                ...(argv.includes("--check") ? { check: true } : {}),
+                ...(argv.includes("--dry-run") ? { dryRun: true } : {}),
+            },
+            json,
+            yes,
+            noTailwind,
+            ...(target ? { target } : {}),
+        };
     }
     let selected;
     try {
         createProgram((command) => {
             selected = withTarget(command);
-        }).parse([...argv], { from: "user" });
+        }).parse(argv, { from: "user" });
     }
     catch (error) {
         toCliError(error);
@@ -123,6 +160,49 @@ export function parseArgs(argv) {
         ...(target ? { target } : {}),
     };
 }
+function createProgram(onSelect) {
+    const program = addSharedOptions(new Commander());
+    program
+        .name("moeicons")
+        .exitOverride()
+        .addHelpCommand(false)
+        .showHelpAfterError(false)
+        .enablePositionalOptions()
+        .configureOutput({
+        writeOut: () => undefined,
+        writeErr: () => undefined,
+    })
+        .action(() => {
+        onSelect({ name: "wizard" });
+    });
+    addSharedOptions(program.command("install").argument("[group]")).action((group) => {
+        onSelect(group ? { name: "install", group } : { name: "install" });
+    });
+    addSharedOptions(program.command("update").argument("[sub]")).action((sub) => {
+        onSelect({ name: "update", metadata: sub === "metadata" });
+    });
+    for (const name of SIMPLE_COMMANDS) {
+        addSharedOptions(program.command(name)).action(() => {
+            onSelect({ name });
+        });
+    }
+    return program;
+}
+function toCliError(error) {
+    if (error instanceof CommanderError && error.code === "commander.unknownCommand") {
+        const match = /unknown command ['`]?([^'`\s]+)/.exec(error.message);
+        throw new CliError("VALIDATION_ERROR", `unknown command: ${match?.[1] ?? "unknown"}`);
+    }
+    if (error instanceof CommanderError && error.code === "commander.unknownOption") {
+        const match = /unknown option ['`]?([^'`\s]+)/.exec(error.message);
+        throw new CliError("VALIDATION_ERROR", `unknown option: ${match?.[1] ?? "unknown"}`);
+    }
+    if (error instanceof CommanderError &&
+        (error.code === "commander.help" || error.code === "commander.helpDisplayed")) {
+        throw new CliError("VALIDATION_ERROR", error.message);
+    }
+    throw error;
+}
 export const HELP_TEXT = `moeicons — Moeicons icon library CLI
 
 Usage:
@@ -133,7 +213,13 @@ Usage:
   moeicons account              show account/tier info
   moeicons groups               list available icon groups
   moeicons generate             generate React/Vue proxy components
-  moeicons init                 create moeicons.config.json
+  moeicons init                 create moeicons.config.jsonc
+  moeicons init --dry-run       print the full config/entry/style plan without writing
+  moeicons doctor               diagnose project anchors (read-only)
+  moeicons recover              recover interrupted writes (run at project root)
+  moeicons doctor --check       exit non-zero when any required anchor is not OK
+  moeicons update metadata      sync MANUAL.md/catalog.json/manifest.json only
+  moeicons update               full code + metadata update
   moeicons mcp                  start the MCP stdio server
   moeicons --version            show version
   moeicons --help               show help
@@ -143,4 +229,6 @@ Options:
   --yes          skip confirmations in noninteractive mode
   --target       output target: react, vue, vanilla, or assets
   --no-tailwind  skip Tailwind config auto-integration
+  --dry-run      (init/doctor) plan only, never write
+  --check        (doctor) exit 1 when required anchors are not OK
 `;

package/dist/config-package/generated/SOURCE.json

@@ -0,0 +1,25 @@
+{
+  "schemaVersion": 1,
+  "sourceRepo": "moewolf-dev/moe-icons-code-library",
+  "sourceDir": "config-package",
+  "sourceCommit": "76d9924b2114afc317d0a630cde536fb035a908c",
+  "sourceCommitExact": true,
+  "files": {
+    "render-config.cjs": {
+      "size": 6002,
+      "sha256": "690418924769912a2e5b572ceed96b30cfe77e19ca3eb40189dc183bc32056c3"
+    },
+    "validate-config.cjs": {
+      "size": 11112,
+      "sha256": "36c35b686335eab4e7db002afb631aa631c80f66656f137b1e2437317b126b0f"
+    },
+    "moeicons-config.schema.json": {
+      "size": 4769,
+      "sha256": "0e15c0cf7c282abad7d7399e4a52b7804dc8211b427490fca5efc6c53d9319df"
+    },
+    "moeicons.config.jsonc": {
+      "size": 1207,
+      "sha256": "260496b4dee0796e03b37dffd442dafeb406b3fdf15eb43c2927e75b497cb6ef"
+    }
+  }
+}

package/dist/config-package/generated/moeicons-config.schema.json

@@ -0,0 +1,191 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://moeicons.dev/schema/moeicons-config-v3.json",
+  "title": "Moeicons user-project configuration (schema v3)",
+  "description": "Canonical user-project configuration. Version 3 adds the optional `integration` object (application/style anchors confirmed by the CLI) on top of the schema v2 fields. The pixel-ladder field remains `imageSize` and is never called `size`.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "tier",
+    "target",
+    "outputDir",
+    "defaultTheme",
+    "themes",
+    "icons"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 3
+    },
+    "tier": {
+      "enum": [
+        "free",
+        "pro"
+      ]
+    },
+    "target": {
+      "enum": [
+        "react",
+        "vue",
+        "vanilla",
+        "assets"
+      ]
+    },
+    "outputDir": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?!/)(?![A-Za-z]:)(?!.*(?:/|^)\\.{1,2}(?:/|$))(?!(?:\\.git|\\.moeicons|node_modules)(?:/|$))[A-Za-z0-9_-]+(?:/[A-Za-z0-9_.-]+)*$"
+    },
+    "defaultTheme": {
+      "type": "string",
+      "minLength": 1
+    },
+    "missingIconPolicy": {
+      "enum": [
+        "fallback",
+        "error"
+      ]
+    },
+    "themes": {
+      "type": "object",
+      "propertyNames": {
+        "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+      },
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "styleGroup"
+        ],
+        "properties": {
+          "icons": {
+            "description": "Optional subset of project icons selected for this theme. Omit to select all registered icons; an empty array selects none. Missing variants follow missingIconPolicy.",
+            "type": "array",
+            "uniqueItems": true,
+            "items": {
+              "type": "string"
+            }
+          },
+          "styleGroup": {
+            "type": "string",
+            "pattern": "^moe-[a-z0-9]+(?:-[a-z0-9]+)*$"
+          },
+          "styles": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "format": {
+            "enum": [
+              "svg",
+              "webp",
+              "png"
+            ]
+          },
+          "imageSize": {
+            "enum": [
+              64,
+              128,
+              256,
+              512
+            ]
+          },
+          "defaultSize": {
+            "type": "number",
+            "exclusiveMinimum": 0
+          },
+          "strokeWidth": {
+            "type": "number",
+            "minimum": 0
+          },
+          "className": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "icons": {
+      "description": "Either a flat string array or a prefix-grouped object. Grouped form is canonical; each key is a prefix and each value an array of icon IDs.",
+      "oneOf": [
+        {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      ]
+    },
+    "integration": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "adapter"
+      ],
+      "properties": {
+        "adapter": {
+          "enum": [
+            "vite-react",
+            "next-app",
+            "next-pages",
+            "vite-vue",
+            "nuxt",
+            "vanilla",
+            "assets-only"
+          ]
+        },
+        "entry": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^(?!/)(?![A-Za-z]:)(?!.*\\\\)(?!.*\\u0000)(?!.*(?:^|/)\\.{1,2}(?:/|$))[^/]+(?:/[^/]+)*$"
+        },
+        "style": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^(?!/)(?![A-Za-z]:)(?!.*\\\\)(?!.*\\u0000)(?!.*(?:^|/)\\.{1,2}(?:/|$))[^/]+(?:/[^/]+)*$"
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "not": {
+              "properties": {
+                "adapter": {
+                  "const": "assets-only"
+                }
+              },
+              "required": [
+                "adapter"
+              ]
+            }
+          },
+          "then": {
+            "required": [
+              "entry"
+            ]
+          }
+        }
+      ]
+    },
+    "downloadMode": {
+      "type": "string",
+      "enum": [
+        "auto",
+        "icons",
+        "full"
+      ],
+      "default": "auto",
+      "description": "Prefer configuration-selected resources (auto), require them (icons), or download the full archive (full)."
+    }
+  }
+}

package/dist/config-package/generated/moeicons.config.jsonc

@@ -0,0 +1,42 @@
+{
+  "schemaVersion": 3,
+  "tier": "free",
+  "target": "react",
+  "outputDir": "src/moeicons",
+  // auto: indexed resources when available; icons: require them; full: whole archive.
+  "downloadMode": "auto",
+  // Global icons registers IDs; per-theme icons selects a subset (empty means none).
+  "defaultTheme": "outline",
+  "themes": {
+    "outline": {
+      "styleGroup": "moe-outline"
+    },
+    // "solid": { "styleGroup": "moe-solid" },
+    // Bitmap style groups are commented out and selected with format/imageSize:
+    // cute — bitmap style (moe-cute-3d)
+    // format options: webp, png
+    // imageSize options: 64, 128, 256, 512
+    // "cute": {
+    //   "styleGroup": "moe-cute-3d",
+    //   "format": "webp",
+    //   "imageSize": 256
+    // },
+    // Set defaultTheme above to any enabled theme key.
+  },
+  // Add icon ids from .moeicons/catalog.json as needed.
+  "icons": {
+    "arrow": [
+      "arrow-bold-right"
+    ],
+    "ui": [
+      "ui-search"
+    ]
+  },
+  "missingIconPolicy": "fallback",
+  // integration is written only after the user confirms anchors:
+  // "integration": {
+  //   "adapter": "vite-react",
+  //   "entry": "src/main.tsx",
+  //   "style": "src/index.css"
+  // }
+}

package/dist/config-package/generated/render-config.cjs

@@ -0,0 +1,145 @@
+'use strict';
+
+// Canonical renderer for the user-project `moeicons.config.jsonc`.
+//
+// Ownership: this module (moe-icons-code-library/config-package) is the single
+// source of truth for the editable config skeleton. The CLI bundles a generated
+// copy of this module plus a source digest and must never maintain a second
+// full renderer.
+//
+// Behaviour contract:
+// - `fullCatalog: true` retains the historical exhaustive renderer for users
+//   who explicitly request it. The default is a small, valid first-run config.
+// - When `integration` is supplied (adapter/entry/style confirmed by the user),
+//   the renderer emits schemaVersion 3 and adds the `integration` block. It
+//   never invents integration paths on its own.
+// - Deterministic output for identical inputs.
+
+/**
+ * @param {object} options
+ * @param {"react"|"vue"|"vanilla"|"assets"} options.target
+ * @param {"react"|"vue"} [options.framework] legacy alias; resolves to target
+ * @param {"free"|"pro"} [options.tier]
+ * @param {object} [options.integration] optional {adapter, entry, style}
+ * @returns {string} JSONC skeleton text
+ */
+function renderMoeiconsConfigJsonc(options) {
+  const ALLOWED = new Set(['target', 'framework', 'tier', 'catalog', 'integration', 'fullCatalog']);
+  for (const key of Object.keys(options)) {
+    if (!ALLOWED.has(key)) {
+      throw new Error(`unknown render option "${key}"`);
+    }
+  }
+  const tier = options.tier ?? 'free';
+  if (!options.catalog) {
+    throw new Error('catalog is required');
+  }
+  const target = options.target ?? options.framework ?? 'react';
+
+  const availableGroups = (options.catalog ? options.catalog.styleGroups : [])
+    .filter((g) => Array.isArray(g.tiers) && g.tiers.includes(tier))
+    .sort((a, b) => a.id.localeCompare(b.id));
+
+  const fullCatalog = options.fullCatalog === true;
+  const defaultGroup = availableGroups.find((group) => group.id === 'moe-outline') ?? availableGroups.find((group) => group.type !== 'bitmap');
+  if (!defaultGroup) throw new Error(`no SVG style group is available in ${tier} tier`);
+  const defaultThemeName = fullCatalog ? 'outline' : defaultGroup.id.replace(/^moe-/, '');
+
+  const themeLines = [];
+  for (const group of availableGroups) {
+    const themeName = group.id.replace(/^moe-/, '');
+    if (group.type === 'bitmap') {
+      const formatsComment = `// format options: ${group.formats.join(', ')}`;
+      const sizesComment = `// imageSize options: ${group.imageSizes.join(', ')}`;
+      themeLines.push(
+        `    // ${themeName} — bitmap style (${group.id})`,
+        `    // ${formatsComment}`,
+        `    // ${sizesComment}`,
+        `    // ${JSON.stringify(themeName)}: {`,
+        `    //   "styleGroup": ${JSON.stringify(group.id)},`,
+        `    //   "format": "webp",`,
+        `    //   "imageSize": 256`,
+        `    // },`,
+      );
+    } else if (fullCatalog || group.id === defaultGroup.id) {
+      themeLines.push(
+        `    ${JSON.stringify(themeName)}: {`,
+        `      "styleGroup": ${JSON.stringify(group.id)}`,
+        `    },`,
+      );
+    } else {
+      themeLines.push(`    // ${JSON.stringify(themeName)}: { "styleGroup": ${JSON.stringify(group.id)} },`);
+    }
+  }
+
+  const tierGroupIds = new Set((fullCatalog ? availableGroups : [defaultGroup]).map((g) => g.id));
+  const groups = new Map();
+  const eligible = (options.catalog ? options.catalog.icons : [])
+    .filter((icon) => icon.availableIn.some((sg) => tierGroupIds.has(sg)));
+  const examples = fullCatalog ? eligible : [
+    ...['arrow-bold-right', 'ui-search'].map((id) => eligible.find((icon) => icon.id === id)).filter(Boolean),
+    ...eligible,
+  ].filter((icon, index, values) => values.findIndex((item) => item.id === icon.id) === index).slice(0, 2);
+  for (const icon of examples) {
+    const ids = groups.get(icon.prefix) ?? [];
+    ids.push(icon.id);
+    groups.set(icon.prefix, ids);
+  }
+  const iconLines = [...groups.entries()]
+    .sort(([a], [b]) => a.localeCompare(b))
+    .flatMap(([prefix, ids]) => [
+      `    // ${prefix} icons`,
+      `    ${JSON.stringify(prefix)}: [`,
+      ...ids.map((id) => `      ${JSON.stringify(id)},`),
+      '    ],',
+    ]);
+
+  const schemaVersion = options.integration || !fullCatalog ? 3 : 2;
+  const integrationBlock = options.integration
+    ? [
+        '',
+        '  // User-confirmed application/style anchors (written only after',
+        '  // confirmation; never auto-guessed).',
+        `  "integration": {`,
+        `    "adapter": ${JSON.stringify(options.integration.adapter)},`,
+        ...(options.integration.entry !== undefined
+          ? [`    "entry": ${JSON.stringify(options.integration.entry)},`]
+          : []),
+        ...(options.integration.style !== undefined
+          ? [`    "style": ${JSON.stringify(options.integration.style)},`]
+          : []),
+        '  }',
+      ]
+    : [];
+
+  return [
+    '{',
+    `  "schemaVersion": ${schemaVersion},`,
+    `  "tier": ${JSON.stringify(tier)},`,
+    `  "target": ${JSON.stringify(target)},`,
+    `  "outputDir": "src/moeicons",`,
+    ...(!fullCatalog ? [
+      '  // auto: indexed resources when available; icons: require them; full: whole archive.',
+      '  "downloadMode": "auto",',
+      '  // Global icons registers IDs; per-theme icons selects a subset (empty means none).',
+    ] : []),
+    `  "defaultTheme": ${JSON.stringify(defaultThemeName)},`,
+    '  "themes": {',
+    ...themeLines,
+    `    // Set defaultTheme above to one of: ${availableGroups
+      .filter((g) => g.type !== 'bitmap')
+      .map((g) => JSON.stringify(g.id.replace(/^moe-/, '')))
+      .join(', ')}`,
+    '  },',
+    fullCatalog ? '  // Comment out individual IDs or a complete prefix group to exclude it.' : '  // Add more icon ids from .moeicons/catalog.json when needed.',
+    '  "icons": {',
+    ...iconLines,
+    '  },',
+    `  "missingIconPolicy": "fallback"${options.integration ? ',' : ''}`,
+    ...integrationBlock,
+    '}',
+    '',
+  ].join('\n');
+}
+
+module.exports = { renderMoeiconsConfigJsonc };