zard-cli 1.0.0-beta.13 → 1.0.0-beta.130

package/constants/app.constants.js

@@ -1,24 +1,47 @@
 import { readFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
+// Not `__dirname`: transpiled to CJS (as Jest does) that name is already bound
+// by the module wrapper, and redeclaring it is a syntax error.
+const moduleDir = dirname(fileURLToPath(import.meta.url));
+const VERSION_FALLBACK = '0.0.0';
 /**
- * Get the CLI version from package.json
- * This is automatically synced with the package version during builds
+ * Reads the CLI version from the package.json that ships with the binary.
+ *
+ * The build copies package.json next to the compiled entrypoint, so from
+ * `constants/` it is always one level up — both in `dist/` and in the published
+ * package, whose root *is* `dist/`. Going up two levels instead used to land on
+ * `packages/cli/package.json` inside the monorepo, which hid the bug during
+ * development, and on `node_modules/package.json` once installed, which is why
+ * `zard-cli --version` printed `0.0.0` for users.
+ *
+ * The second candidate covers running straight from `src/`, and the name check
+ * keeps an unrelated package.json further up the tree from being picked up.
+ *
+ * Exported for testing: the directory is a parameter so both layouts can be
+ * exercised without depending on where the test file itself lives.
  */
-function getAppVersion() {
-    try {
-        // In production, package.json is at the root of the published package
-        // From dist/constants/ we need to go up 2 levels to reach package.json
-        const packageJsonPath = join(__dirname, '../../package.json');
-        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
-        return packageJson.version;
-    }
-    catch (error) {
-        console.warn('Failed to read version from package.json');
-        return '0.0.0';
+export function resolveAppVersion(fromDir) {
+    const candidates = [join(fromDir, '../package.json'), join(fromDir, '../../package.json')];
+    for (const candidate of candidates) {
+        try {
+            const packageJson = JSON.parse(readFileSync(candidate, 'utf8'));
+            if (typeof packageJson === 'object' &&
+                packageJson !== null &&
+                'version' in packageJson &&
+                'name' in packageJson &&
+                typeof packageJson.version === 'string' &&
+                typeof packageJson.name === 'string' &&
+                packageJson.name.startsWith('zard-cli')) {
+                return packageJson.version;
+            }
+        }
+        catch {
+            // Not there, or not readable — try the next candidate.
+        }
     }
+    console.warn('Failed to read version from package.json');
+    return VERSION_FALLBACK;
 }
-export const APP_VERSION = getAppVersion();
+export const APP_VERSION = resolveAppVersion(moduleDir);
 //# sourceMappingURL=app.constants.js.map

package/constants/app.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.constants.js","sourceRoot":"","sources":["../../src/constants/app.constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC;;;GAGG;AACH,SAAS,aAAa;IACpB,IAAI,CAAC;QACH,sEAAsE;QACtE,uEAAuE;QACvE,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;QAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;QACtE,OAAO,WAAW,CAAC,OAAO,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACzD,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,EAAE,CAAC"}
+{"version":3,"file":"app.constants.js","sourceRoot":"","sources":["../../src/constants/app.constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,+EAA+E;AAC/E,+DAA+D;AAC/D,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEjC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAE3F,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,WAAW,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;YACzE,IACE,OAAO,WAAW,KAAK,QAAQ;gBAC/B,WAAW,KAAK,IAAI;gBACpB,SAAS,IAAI,WAAW;gBACxB,MAAM,IAAI,WAAW;gBACrB,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ;gBACvC,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ;gBACpC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EACvC,CAAC;gBACD,OAAO,WAAW,CAAC,OAAO,CAAC;YAC7B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;QACzD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IACzD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC"}

package/core/icons/families.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The icon families `components.json` accepts under `icons`.
+ *
+ * Every component in the library draws through ng-icons' `<ng-icon>`, which is
+ * family-agnostic: what ties the drawing to one family is the package the
+ * symbols are imported from (`@ng-icons/lucide`) and the prefix they carry
+ * (`lucideCheck`). Both are declared here, and that is all that separates one
+ * family from another on the install path.
+ *
+ * This table is the local copy — the one used when the registry does not
+ * answer. The authoritative list comes from `<registry>/icons.json`, which is
+ * what lets a new family arrive without anyone updating the CLI.
+ */
+export interface IconFamilyInfo {
+    /** How it appears in `components.json`. */
+    readonly value: string;
+    /** Display name, for prompts and reports. */
+    readonly label: string;
+    /** The npm package the project needs installed. */
+    readonly package: string;
+    /** The prefix of the symbols that package exports (`lucide` → `lucideCheck`). */
+    readonly prefix: string;
+}
+/**
+ * A string, not the union of the known families.
+ *
+ * The literal type would be more precise and more wrong: families now come from
+ * the registry, so the valid set is whatever is published at run time, not
+ * whatever existed when the CLI was compiled. `assertIconFamily` validates the
+ * value against the catalog in hand.
+ */
+export type IconFamily = string;
+export declare const ICON_FAMILIES: Record<string, IconFamilyInfo>;
+/** The family `libs/zard` uses — the one the registry files are written in. */
+export declare const SOURCE_ICON_FAMILY: IconFamily;
+/** The package that registers `<ng-icon>`, shared by every family. */
+export declare const ICON_CORE_PACKAGE = "@ng-icons/core";
+//# sourceMappingURL=families.d.ts.map

package/core/icons/families.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"families.d.ts","sourceRoot":"","sources":["../../../src/core/icons/families.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAOxD,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,EAAE,UAAqB,CAAC;AAEvD,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,mBAAmB,CAAC"}

package/core/icons/families.js

@@ -0,0 +1,26 @@
+/**
+ * The icon families `components.json` accepts under `icons`.
+ *
+ * Every component in the library draws through ng-icons' `<ng-icon>`, which is
+ * family-agnostic: what ties the drawing to one family is the package the
+ * symbols are imported from (`@ng-icons/lucide`) and the prefix they carry
+ * (`lucideCheck`). Both are declared here, and that is all that separates one
+ * family from another on the install path.
+ *
+ * This table is the local copy — the one used when the registry does not
+ * answer. The authoritative list comes from `<registry>/icons.json`, which is
+ * what lets a new family arrive without anyone updating the CLI.
+ */
+export const ICON_FAMILIES = {
+    lucide: {
+        value: 'lucide',
+        label: 'Lucide',
+        package: '@ng-icons/lucide',
+        prefix: 'lucide',
+    },
+};
+/** The family `libs/zard` uses — the one the registry files are written in. */
+export const SOURCE_ICON_FAMILY = 'lucide';
+/** The package that registers `<ng-icon>`, shared by every family. */
+export const ICON_CORE_PACKAGE = '@ng-icons/core';
+//# sourceMappingURL=families.js.map

package/core/icons/families.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"families.js","sourceRoot":"","sources":["../../../src/core/icons/families.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAuBH,MAAM,CAAC,MAAM,aAAa,GAAmC;IAC3D,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,kBAAkB;QAC3B,MAAM,EAAE,QAAQ;KACjB;CACF,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kBAAkB,GAAe,QAAQ,CAAC;AAEvD,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC"}

package/core/icons/icon-map.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The translation table between icon sets.
+ *
+ * Each row is an icon by what it MEANS — `check`, `chevron-down` — and the
+ * value is the symbol each set exports for it. Only the `lucide` column exists
+ * today, the one set the library supports; supporting another one means filling
+ * in its column, and nothing else along the install path changes.
+ *
+ * This is the copy bundled with the CLI. It is published at
+ * `<registry>/icons.json`, and that is where the CLI reads it from at run time
+ * — the file here is what holds when the registry does not answer, and the
+ * floor the published table is generated from.
+ *
+ * The list covers every icon the components and demos use today. A new icon in
+ * the code with no row here is an error: `icons.spec.ts` compares this table
+ * against what `libs/zard` actually imports.
+ *
+ * The tokens come from the lucide name in kebab-case because that already is
+ * the icon's semantic name (`lucideChevronDown` → `chevron-down`) — the key
+ * belongs to the table, not to the set, and stays valid once lucide is no
+ * longer the only column.
+ */
+export declare const ICON_MAP: Record<string, Record<string, string>>;
+//# sourceMappingURL=icon-map.d.ts.map

package/core/icons/icon-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-map.d.ts","sourceRoot":"","sources":["../../../src/core/icons/icon-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqH3D,CAAC"}

package/core/icons/icon-map.js

@@ -0,0 +1,141 @@
+/**
+ * The translation table between icon sets.
+ *
+ * Each row is an icon by what it MEANS — `check`, `chevron-down` — and the
+ * value is the symbol each set exports for it. Only the `lucide` column exists
+ * today, the one set the library supports; supporting another one means filling
+ * in its column, and nothing else along the install path changes.
+ *
+ * This is the copy bundled with the CLI. It is published at
+ * `<registry>/icons.json`, and that is where the CLI reads it from at run time
+ * — the file here is what holds when the registry does not answer, and the
+ * floor the published table is generated from.
+ *
+ * The list covers every icon the components and demos use today. A new icon in
+ * the code with no row here is an error: `icons.spec.ts` compares this table
+ * against what `libs/zard` actually imports.
+ *
+ * The tokens come from the lucide name in kebab-case because that already is
+ * the icon's semantic name (`lucideChevronDown` → `chevron-down`) — the key
+ * belongs to the table, not to the set, and stays valid once lucide is no
+ * longer the only column.
+ */
+export const ICON_MAP = {
+    'alert-triangle': { lucide: 'lucideAlertTriangle' },
+    'app-window': { lucide: 'lucideAppWindow' },
+    archive: { lucide: 'lucideArchive' },
+    'arrow-left': { lucide: 'lucideArrowLeft' },
+    'arrow-right': { lucide: 'lucideArrowRight' },
+    'arrow-up': { lucide: 'lucideArrowUp' },
+    'arrow-up-right': { lucide: 'lucideArrowUpRight' },
+    'audio-lines': { lucide: 'lucideAudioLines' },
+    'badge-check': { lucide: 'lucideBadgeCheck' },
+    bell: { lucide: 'lucideBell' },
+    bluetooth: { lucide: 'lucideBluetooth' },
+    bold: { lucide: 'lucideBold' },
+    'book-open-check': { lucide: 'lucideBookOpenCheck' },
+    bookmark: { lucide: 'lucideBookmark' },
+    bot: { lucide: 'lucideBot' },
+    'building-2': { lucide: 'lucideBuilding2' },
+    calculator: { lucide: 'lucideCalculator' },
+    calendar: { lucide: 'lucideCalendar' },
+    'calendar-plus': { lucide: 'lucideCalendarPlus' },
+    check: { lucide: 'lucideCheck' },
+    'chevron-down': { lucide: 'lucideChevronDown' },
+    'chevron-left': { lucide: 'lucideChevronLeft' },
+    'chevron-right': { lucide: 'lucideChevronRight' },
+    'chevron-up': { lucide: 'lucideChevronUp' },
+    'chevrons-left': { lucide: 'lucideChevronsLeft' },
+    'chevrons-right': { lucide: 'lucideChevronsRight' },
+    'chevrons-up-down': { lucide: 'lucideChevronsUpDown' },
+    'circle-alert': { lucide: 'lucideCircleAlert' },
+    'circle-check': { lucide: 'lucideCircleCheck' },
+    'circle-dashed': { lucide: 'lucideCircleDashed' },
+    'circle-fading-arrow-up': { lucide: 'lucideCircleFadingArrowUp' },
+    'circle-fading-plus': { lucide: 'lucideCircleFadingPlus' },
+    'circle-help': { lucide: 'lucideCircleHelp' },
+    'circle-small': { lucide: 'lucideCircleSmall' },
+    'clipboard-paste': { lucide: 'lucideClipboardPaste' },
+    clock: { lucide: 'lucideClock' },
+    'clock-2': { lucide: 'lucideClock2' },
+    cloud: { lucide: 'lucideCloud' },
+    code: { lucide: 'lucideCode' },
+    copy: { lucide: 'lucideCopy' },
+    'corner-down-left': { lucide: 'lucideCornerDownLeft' },
+    'credit-card': { lucide: 'lucideCreditCard' },
+    dot: { lucide: 'lucideDot' },
+    download: { lucide: 'lucideDownload' },
+    ellipsis: { lucide: 'lucideEllipsis' },
+    'external-link': { lucide: 'lucideExternalLink' },
+    'eye-off': { lucide: 'lucideEyeOff' },
+    file: { lucide: 'lucideFile' },
+    'file-code': { lucide: 'lucideFileCode' },
+    'file-code-2': { lucide: 'lucideFileCode2' },
+    'file-text': { lucide: 'lucideFileText' },
+    folder: { lucide: 'lucideFolder' },
+    'folder-code': { lucide: 'lucideFolderCode' },
+    'folder-plus': { lucide: 'lucideFolderPlus' },
+    footprints: { lucide: 'lucideFootprints' },
+    'gallery-vertical-end': { lucide: 'lucideGalleryVerticalEnd' },
+    'git-branch': { lucide: 'lucideGitBranch' },
+    globe: { lucide: 'lucideGlobe' },
+    house: { lucide: 'lucideHouse' },
+    image: { lucide: 'lucideImage' },
+    inbox: { lucide: 'lucideInbox' },
+    info: { lucide: 'lucideInfo' },
+    italic: { lucide: 'lucideItalic' },
+    keyboard: { lucide: 'lucideKeyboard' },
+    'layout-grid': { lucide: 'lucideLayoutGrid' },
+    lightbulb: { lucide: 'lucideLightbulb' },
+    'lightbulb-off': { lucide: 'lucideLightbulbOff' },
+    list: { lucide: 'lucideList' },
+    'list-filter': { lucide: 'lucideListFilter' },
+    'list-filter-plus': { lucide: 'lucideListFilterPlus' },
+    loader: { lucide: 'lucideLoader' },
+    'loader-2': { lucide: 'lucideLoader2' },
+    'loader-circle': { lucide: 'lucideLoaderCircle' },
+    'log-out': { lucide: 'lucideLogOut' },
+    mail: { lucide: 'lucideMail' },
+    'mail-check': { lucide: 'lucideMailCheck' },
+    maximize: { lucide: 'lucideMaximize' },
+    'message-square': { lucide: 'lucideMessageSquare' },
+    minimize: { lucide: 'lucideMinimize' },
+    minus: { lucide: 'lucideMinus' },
+    monitor: { lucide: 'lucideMonitor' },
+    'more-horizontal': { lucide: 'lucideMoreHorizontal' },
+    'octagon-x': { lucide: 'lucideOctagonX' },
+    'panel-left': { lucide: 'lucidePanelLeft' },
+    pencil: { lucide: 'lucidePencil' },
+    plus: { lucide: 'lucidePlus' },
+    'refresh-ccw': { lucide: 'lucideRefreshCcw' },
+    'refresh-cw': { lucide: 'lucideRefreshCw' },
+    'rotate-ccw': { lucide: 'lucideRotateCcw' },
+    save: { lucide: 'lucideSave' },
+    scissors: { lucide: 'lucideScissors' },
+    search: { lucide: 'lucideSearch' },
+    settings: { lucide: 'lucideSettings' },
+    share: { lucide: 'lucideShare' },
+    'shield-alert': { lucide: 'lucideShieldAlert' },
+    smartphone: { lucide: 'lucideSmartphone' },
+    smile: { lucide: 'lucideSmile' },
+    star: { lucide: 'lucideStar' },
+    sun: { lucide: 'lucideSun' },
+    tag: { lucide: 'lucideTag' },
+    terminal: { lucide: 'lucideTerminal' },
+    'thumbs-down': { lucide: 'lucideThumbsDown' },
+    'thumbs-up': { lucide: 'lucideThumbsUp' },
+    trash: { lucide: 'lucideTrash' },
+    'trash-2': { lucide: 'lucideTrash2' },
+    'trending-up': { lucide: 'lucideTrendingUp' },
+    'triangle-alert': { lucide: 'lucideTriangleAlert' },
+    underline: { lucide: 'lucideUnderline' },
+    user: { lucide: 'lucideUser' },
+    'user-round-x': { lucide: 'lucideUserRoundX' },
+    'volume-off': { lucide: 'lucideVolumeOff' },
+    wallet: { lucide: 'lucideWallet' },
+    waves: { lucide: 'lucideWaves' },
+    x: { lucide: 'lucideX' },
+    'zoom-in': { lucide: 'lucideZoomIn' },
+    'zoom-out': { lucide: 'lucideZoomOut' },
+};
+//# sourceMappingURL=icon-map.js.map

package/core/icons/icon-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-map.js","sourceRoot":"","sources":["../../../src/core/icons/icon-map.ts"],"names":[],"mappings":"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"}

package/core/icons/index.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Icons — what the components draw, and how that changes with the family.
+ *
+ * Everything here works off a catalog: the pair (declared families, translation
+ * table). The local catalog is the bundled copy; the one that counts at runtime
+ * comes from `<registry>/icons.json`. That indirection is what makes "support
+ * material" a matter of publishing one more column in the registry, with no CLI
+ * release and no hunting for `lucide` through the code.
+ *
+ *   `extractIcons`    reads which icons a source uses (the registry publishes this)
+ *   `retargetIcons`   rewrites a source from one family to another (install uses it)
+ *   `iconPackagesFor` says which packages the project needs (init uses it)
+ */
+import { type IconFamily, type IconFamilyInfo } from './families.js';
+export { ICON_CORE_PACKAGE, ICON_FAMILIES, SOURCE_ICON_FAMILY, type IconFamily, type IconFamilyInfo, } from './families.js';
+export { ICON_MAP } from './icon-map.js';
+/** An icon by what it means: `check`, `chevron-down`. */
+export type IconToken = string;
+/**
+ * The declared families and the table that translates between them.
+ *
+ * `icons` is keyed by token and then by family — the same shape as
+ * `icon-map.ts`, which is the local copy of this same data.
+ */
+export interface IconCatalog {
+    readonly families: Readonly<Record<string, IconFamilyInfo>>;
+    readonly icons: Readonly<Record<string, Readonly<Record<string, string>>>>;
+}
+/** The catalog bundled with the CLI — used when the registry does not answer. */
+export declare const LOCAL_ICON_CATALOG: IconCatalog;
+/** A list of icons in both forms: as the code writes them, and as the table names them. */
+export interface IconList {
+    /** The symbols as they appear in the code (`lucideCheck`). */
+    readonly symbols: string[];
+    /** The same icons under the table's neutral key (`check`). */
+    readonly tokens: IconToken[];
+}
+/**
+ * A component's icons, in the shape the registry publishes them.
+ *
+ * The two lists are separate because they serve different things: `symbols` and
+ * `tokens` are what `add` writes into the project — the ng-icons dependency
+ * comes from them — while `demos` are the icons that only appear in the
+ * documentation examples. A component can draw no icon at all and still have
+ * demos full of them, and switching family has to reach both.
+ */
+export interface ComponentIcons extends IconList {
+    /** The family the published files are written in. */
+    readonly family: IconFamily;
+    readonly demos: IconList;
+}
+export declare function iconFamilies(catalog?: IconCatalog): string[];
+export declare function isIconFamily(value: string, catalog?: IconCatalog): boolean;
+export declare function iconFamily(family: IconFamily, catalog?: IconCatalog): IconFamilyInfo | undefined;
+/** The npm packages a project configured with this family needs. */
+export declare function iconPackagesFor(family: IconFamily, catalog?: IconCatalog): string[];
+export declare function tokenFor(symbol: string, family?: IconFamily, catalog?: IconCatalog): IconToken | undefined;
+export declare function symbolFor(token: IconToken, family: IconFamily, catalog?: IconCatalog): string | undefined;
+/** Tokens that have no symbol declared in this family yet. */
+export declare function missingTokensFor(family: IconFamily, catalog?: IconCatalog): IconToken[];
+/**
+ * The icon symbols a source imports.
+ *
+ * Only the import counts. A stray `name="lucideCheck"` in a template draws
+ * nothing without the matching `provideIcons`, so the import is at once the
+ * complete list and the list without false positives — `@ng-icons/core`
+ * (NgIcon, provideIcons, IconName) is left out because it is not a family.
+ */
+export declare function extractIcons(source: string, family?: IconFamily, catalog?: IconCatalog): string[];
+/** The icons of a set of files, in both forms. */
+export declare function listIcons(sources: readonly string[], family?: IconFamily, catalog?: IconCatalog): IconList;
+/**
+ * A component's icon mapping, ready for the registry.
+ *
+ * It comes back filled in even when there is no icon at all: the field always
+ * being present is what tells "this component draws no icons" apart from "this
+ * registry was published before the mapping existed", so a reader never has to
+ * guess which of the two it is.
+ */
+export declare function collectIcons(files: readonly string[], demos?: readonly string[], family?: IconFamily, catalog?: IconCatalog): ComponentIcons;
+export interface RetargetResult {
+    readonly content: string;
+    /** Symbols the target family does not declare — left untouched. */
+    readonly missing: string[];
+}
+/**
+ * Rewrites a source from one icon family to another.
+ *
+ * Two swaps: the package the symbols come from, and each symbol itself. A symbol
+ * is replaced wherever it appears — the import, the `provideIcons({ lucideCheck })`
+ * and the template's `name="lucideCheck"` are the same word, and the object
+ * shorthand stays valid after the swap.
+ *
+ * A symbol with no equivalent in the target family is not invented: it stays as
+ * it is and comes back in `missing`, so the caller can warn instead of writing
+ * an import that does not resolve.
+ */
+export declare function retargetIcons(source: string, from: IconFamily, to: IconFamily, catalog?: IconCatalog): RetargetResult;
+/**
+ * The mechanical half of the swap, separated from whatever decides what to swap.
+ *
+ * It is exported because this is where rewriting bugs live — whole-word
+ * replacement and the order of the alternation — and because testing it does
+ * not require more than one declared family.
+ */
+export declare function rewriteIcons(source: string, fromPackage: string, toPackage: string, replacements: ReadonlyMap<string, string>): string;
+//# sourceMappingURL=index.d.ts.map

package/core/icons/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/icons/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,yDAAyD;AACzD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5E;AAED,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,EAAE,WAA0D,CAAC;AAE5F,2FAA2F;AAC3F,MAAM,WAAW,QAAQ;IACvB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC9C,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;CAC1B;AA8BD,wBAAgB,YAAY,CAAC,OAAO,GAAE,WAAgC,GAAG,MAAM,EAAE,CAEhF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgC,GAAG,OAAO,CAE9F;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,WAAgC,GAAG,cAAc,GAAG,SAAS,CAEpH;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,WAAgC,GAAG,MAAM,EAAE,CAGvG;AAED,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,UAA+B,EACvC,OAAO,GAAE,WAAgC,GACxC,SAAS,GAAG,SAAS,CAEvB;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,WAAgC,GACxC,MAAM,GAAG,SAAS,CAEpB;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,WAAgC,GAAG,SAAS,EAAE,CAE3G;AAaD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,UAA+B,EACvC,OAAO,GAAE,WAAgC,GACxC,MAAM,EAAE,CAkBV;AAED,kDAAkD;AAClD,wBAAgB,SAAS,CACvB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,MAAM,GAAE,UAA+B,EACvC,OAAO,GAAE,WAAgC,GACxC,QAAQ,CAeV;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,GAAE,SAAS,MAAM,EAAO,EAC7B,MAAM,GAAE,UAA+B,EACvC,OAAO,GAAE,WAAgC,GACxC,cAAc,CAMhB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,UAAU,EACd,OAAO,GAAE,WAAgC,GACxC,cAAc,CAoBhB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,MAAM,CAcR"}

package/core/icons/index.js

@@ -0,0 +1,183 @@
+/**
+ * Icons — what the components draw, and how that changes with the family.
+ *
+ * Everything here works off a catalog: the pair (declared families, translation
+ * table). The local catalog is the bundled copy; the one that counts at runtime
+ * comes from `<registry>/icons.json`. That indirection is what makes "support
+ * material" a matter of publishing one more column in the registry, with no CLI
+ * release and no hunting for `lucide` through the code.
+ *
+ *   `extractIcons`    reads which icons a source uses (the registry publishes this)
+ *   `retargetIcons`   rewrites a source from one family to another (install uses it)
+ *   `iconPackagesFor` says which packages the project needs (init uses it)
+ */
+import { ICON_CORE_PACKAGE, ICON_FAMILIES, SOURCE_ICON_FAMILY, } from './families.js';
+import { ICON_MAP } from './icon-map.js';
+export { ICON_CORE_PACKAGE, ICON_FAMILIES, SOURCE_ICON_FAMILY, } from './families.js';
+export { ICON_MAP } from './icon-map.js';
+/** The catalog bundled with the CLI — used when the registry does not answer. */
+export const LOCAL_ICON_CATALOG = { families: ICON_FAMILIES, icons: ICON_MAP };
+/**
+ * Reverse symbol → token index, built per catalog and memoized.
+ *
+ * The remote catalog is a single object, fetched once per run, so a weak key is
+ * enough and the index is not rebuilt for every installed file.
+ */
+const reverseIndexes = new WeakMap();
+function reverseIndex(catalog, family) {
+    let byFamily = reverseIndexes.get(catalog);
+    if (!byFamily) {
+        byFamily = new Map();
+        for (const [token, symbols] of Object.entries(catalog.icons)) {
+            for (const [name, symbol] of Object.entries(symbols)) {
+                const index = byFamily.get(name) ?? new Map();
+                index.set(symbol, token);
+                byFamily.set(name, index);
+            }
+        }
+        reverseIndexes.set(catalog, byFamily);
+    }
+    return byFamily.get(family) ?? new Map();
+}
+export function iconFamilies(catalog = LOCAL_ICON_CATALOG) {
+    return Object.keys(catalog.families).sort();
+}
+export function isIconFamily(value, catalog = LOCAL_ICON_CATALOG) {
+    return Object.prototype.hasOwnProperty.call(catalog.families, value);
+}
+export function iconFamily(family, catalog = LOCAL_ICON_CATALOG) {
+    return catalog.families[family];
+}
+/** The npm packages a project configured with this family needs. */
+export function iconPackagesFor(family, catalog = LOCAL_ICON_CATALOG) {
+    const info = iconFamily(family, catalog);
+    return info ? [ICON_CORE_PACKAGE, info.package] : [ICON_CORE_PACKAGE];
+}
+export function tokenFor(symbol, family = SOURCE_ICON_FAMILY, catalog = LOCAL_ICON_CATALOG) {
+    return reverseIndex(catalog, family).get(symbol);
+}
+export function symbolFor(token, family, catalog = LOCAL_ICON_CATALOG) {
+    return catalog.icons[token]?.[family];
+}
+/** Tokens that have no symbol declared in this family yet. */
+export function missingTokensFor(family, catalog = LOCAL_ICON_CATALOG) {
+    return Object.keys(catalog.icons).filter(token => symbolFor(token, family, catalog) === undefined);
+}
+/**
+ * `import { lucideCheck, lucideX } from '@ng-icons/lucide'` — on one line or
+ * several, with a leading `type` or aliased. What matters is the package (which
+ * gives the family) and the names imported from it.
+ */
+const ICON_IMPORT = /import\s*(?:type\s+)?\{([^}]*)\}\s*from\s*['"]@ng-icons\/([a-z0-9-]+)['"]/g;
+function familyByPackageSuffix(suffix, catalog) {
+    return Object.keys(catalog.families).find(name => catalog.families[name]?.package === `@ng-icons/${suffix}`);
+}
+/**
+ * The icon symbols a source imports.
+ *
+ * Only the import counts. A stray `name="lucideCheck"` in a template draws
+ * nothing without the matching `provideIcons`, so the import is at once the
+ * complete list and the list without false positives — `@ng-icons/core`
+ * (NgIcon, provideIcons, IconName) is left out because it is not a family.
+ */
+export function extractIcons(source, family = SOURCE_ICON_FAMILY, catalog = LOCAL_ICON_CATALOG) {
+    const found = new Set();
+    for (const match of source.matchAll(ICON_IMPORT)) {
+        if (familyByPackageSuffix(match[2] ?? '', catalog) !== family)
+            continue;
+        for (const specifier of (match[1] ?? '').split(',')) {
+            // `type Foo`, `Foo as Bar` — the package's symbol is always the first name.
+            const name = specifier
+                .trim()
+                .replace(/^type\s+/, '')
+                .split(/\s+as\s+/)[0]
+                ?.trim();
+            if (name)
+                found.add(name);
+        }
+    }
+    return [...found].sort();
+}
+/** The icons of a set of files, in both forms. */
+export function listIcons(sources, family = SOURCE_ICON_FAMILY, catalog = LOCAL_ICON_CATALOG) {
+    const symbols = new Set();
+    for (const source of sources) {
+        for (const symbol of extractIcons(source, family, catalog))
+            symbols.add(symbol);
+    }
+    const sorted = [...symbols].sort();
+    return {
+        symbols: sorted,
+        tokens: sorted
+            .map(symbol => tokenFor(symbol, family, catalog))
+            .filter((token) => token !== undefined),
+    };
+}
+/**
+ * A component's icon mapping, ready for the registry.
+ *
+ * It comes back filled in even when there is no icon at all: the field always
+ * being present is what tells "this component draws no icons" apart from "this
+ * registry was published before the mapping existed", so a reader never has to
+ * guess which of the two it is.
+ */
+export function collectIcons(files, demos = [], family = SOURCE_ICON_FAMILY, catalog = LOCAL_ICON_CATALOG) {
+    return {
+        family,
+        ...listIcons(files, family, catalog),
+        demos: listIcons(demos, family, catalog),
+    };
+}
+/**
+ * Rewrites a source from one icon family to another.
+ *
+ * Two swaps: the package the symbols come from, and each symbol itself. A symbol
+ * is replaced wherever it appears — the import, the `provideIcons({ lucideCheck })`
+ * and the template's `name="lucideCheck"` are the same word, and the object
+ * shorthand stays valid after the swap.
+ *
+ * A symbol with no equivalent in the target family is not invented: it stays as
+ * it is and comes back in `missing`, so the caller can warn instead of writing
+ * an import that does not resolve.
+ */
+export function retargetIcons(source, from, to, catalog = LOCAL_ICON_CATALOG) {
+    const origin = iconFamily(from, catalog);
+    const target = iconFamily(to, catalog);
+    if (from === to || !origin || !target)
+        return { content: source, missing: [] };
+    const missing = [];
+    const replacements = new Map();
+    for (const symbol of extractIcons(source, from, catalog)) {
+        const token = tokenFor(symbol, from, catalog);
+        const replacement = token !== undefined ? symbolFor(token, to, catalog) : undefined;
+        if (replacement === undefined)
+            missing.push(symbol);
+        else
+            replacements.set(symbol, replacement);
+    }
+    if (replacements.size === 0)
+        return { content: source, missing };
+    return { content: rewriteIcons(source, origin.package, target.package, replacements), missing };
+}
+/**
+ * The mechanical half of the swap, separated from whatever decides what to swap.
+ *
+ * It is exported because this is where rewriting bugs live — whole-word
+ * replacement and the order of the alternation — and because testing it does
+ * not require more than one declared family.
+ */
+export function rewriteIcons(source, fromPackage, toPackage, replacements) {
+    if (replacements.size === 0)
+        return source;
+    // The alternation is tried in written order, so the long names come first:
+    // with `lucideClock` in front, `lucideClock2` would be matched from its prefix
+    // and only the trailing `\b` would save it — cheaper not to rely on that.
+    const pattern = new RegExp(`\\b(${[...replacements.keys()].sort((a, b) => b.length - a.length).join('|')})\\b`, 'g');
+    return source
+        .replace(new RegExp(`(['"])${escapeRegExp(fromPackage)}\\1`, 'g'), (_match, quote) => `${quote}${toPackage}${quote}`)
+        .replace(pattern, symbol => replacements.get(symbol) ?? symbol);
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=index.js.map

package/core/icons/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/icons/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GAGnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GAGnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAgBzC,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAgB,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAyB5F;;;;;GAKG;AACH,MAAM,cAAc,GAAG,IAAI,OAAO,EAAoD,CAAC;AAEvF,SAAS,YAAY,CAAC,OAAoB,EAAE,MAAkB;IAC5D,IAAI,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE3C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAErB,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAqB,CAAC;gBACjE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBACzB,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,UAAuB,kBAAkB;IACpE,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,UAAuB,kBAAkB;IACnF,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAkB,EAAE,UAAuB,kBAAkB;IACtF,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,MAAkB,EAAE,UAAuB,kBAAkB;IAC3F,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,MAAc,EACd,SAAqB,kBAAkB,EACvC,UAAuB,kBAAkB;IAEzC,OAAO,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,KAAgB,EAChB,MAAkB,EAClB,UAAuB,kBAAkB;IAEzC,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB,CAAC,MAAkB,EAAE,UAAuB,kBAAkB;IAC5F,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC;AACrG,CAAC;AAED;;;;GAIG;AACH,MAAM,WAAW,GAAG,4EAA4E,CAAC;AAEjG,SAAS,qBAAqB,CAAC,MAAc,EAAE,OAAoB;IACjE,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,aAAa,MAAM,EAAE,CAAC,CAAC;AAC/G,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,SAAqB,kBAAkB,EACvC,UAAuB,kBAAkB;IAEzC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACjD,IAAI,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,KAAK,MAAM;YAAE,SAAS;QAExE,KAAK,MAAM,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACpD,4EAA4E;YAC5E,MAAM,IAAI,GAAG,SAAS;iBACnB,IAAI,EAAE;iBACN,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;iBACvB,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;gBACrB,EAAE,IAAI,EAAE,CAAC;YACX,IAAI,IAAI;gBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,SAAS,CACvB,OAA0B,EAC1B,SAAqB,kBAAkB,EACvC,UAAuB,kBAAkB;IAEzC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,MAAM,IAAI,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAEnC,OAAO;QACL,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,MAAM;aACX,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;aAChD,MAAM,CAAC,CAAC,KAAK,EAAsB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAwB,EACxB,QAA2B,EAAE,EAC7B,SAAqB,kBAAkB,EACvC,UAAuB,kBAAkB;IAEzC,OAAO;QACL,MAAM;QACN,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC;QACpC,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC;KACzC,CAAC;AACJ,CAAC;AAQD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,IAAgB,EAChB,EAAc,EACd,UAAuB,kBAAkB;IAEzC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAEvC,IAAI,IAAI,KAAK,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAE/E,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE/C,KAAK,MAAM,MAAM,IAAI,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;QACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9C,MAAM,WAAW,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEpF,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;;YAC/C,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAEjE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;AAClG,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,WAAmB,EACnB,SAAiB,EACjB,YAAyC;IAEzC,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAE3C,2EAA2E;IAC3E,+EAA+E;IAC/E,0EAA0E;IAC1E,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAErH,OAAO,MAAM;SACV,OAAO,CACN,IAAI,MAAM,CAAC,SAAS,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,EACxD,CAAC,MAAM,EAAE,KAAa,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,EAAE,CAC1D;SACA,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC"}