zard-cli 1.0.0-beta.99 → 1.0.1

package/utils/registry.d.ts

@@ -1,5 +1,23 @@
+import { type IconFamily } from '../core/icons/index.js';
 import type { Config } from '../utils/config.js';
 export declare const DEFAULT_REGISTRY_URL: string;
+/**
+ * The icons a component draws, as the registry publishes them.
+ *
+ * `family` is the family the files are written in — anyone installing with a
+ * different family in `components.json` learns from this field that they need
+ * rewriting. Absent from items published before this property existed.
+ */
+export interface RegistryIcons {
+    family: string;
+    symbols: string[];
+    tokens: string[];
+    /** The icons that only appear in the demos. Absent from the index, which does not carry them. */
+    demos?: {
+        symbols: string[];
+        tokens: string[];
+    };
+}
 export interface RegistryItem {
     name: string;
     type: 'registry:component';
@@ -11,9 +29,43 @@ export interface RegistryItem {
     dependencies?: string[];
     devDependencies?: string[];
     registryDependencies?: string[];
+    icons?: RegistryIcons;
+}
+/**
+ * A block, as the registry publishes it.
+ *
+ * Blocks live under `/blocks/` in their own index, and their file entries carry
+ * a `path` the components' do not — so they get their own type instead of being
+ * bent into `RegistryItem`.
+ */
+export interface BlockItem {
+    id: string;
+    title: string;
+    description: string;
+    category: string;
+    registryDependencies?: string[];
+    dependencies?: string[];
+    files: Array<{
+        name: string;
+        path: string;
+        content: string;
+        language: string;
+    }>;
+}
+export interface BlocksIndex {
+    blocks: Array<{
+        id: string;
+        title: string;
+        description: string;
+        category: string;
+        registryDependencies?: string[];
+        dependencies?: string[];
+    }>;
 }
 export interface RegistryIndex {
     $schema: string;
+    /** The file's shape. Absent from registries older than the field. */
+    schemaVersion?: number;
     name: string;
     homepage: string;
     version: string;
@@ -24,15 +76,67 @@ export interface RegistryIndex {
         dependencies?: string[];
         devDependencies?: string[];
         registryDependencies?: string[];
+        icons?: RegistryIcons;
         files: string[];
     }>;
 }
+/**
+ * The family the item's files are written in.
+ *
+ * An item with no `icons` — published before the property existed — is in
+ * lucide, which was the only possibility. So is an unknown value: better the
+ * right guess than refusing to install over an unfamiliar field.
+ */
+export declare function sourceFamilyOf(item: Pick<RegistryItem, 'icons'>): IconFamily;
 export declare function getRegistryUrl(config?: Config): string;
 export declare function validateRegistryUrl(url: string): void;
 export declare function fetchRegistryIndex(registryUrl?: string): Promise<RegistryIndex>;
 export declare function invalidateRegistryCache(): void;
 export declare function fetchComponentFromRegistry(componentName: string, registryUrl?: string): Promise<RegistryItem>;
+/**
+ * The block index, cached like the component one.
+ *
+ * A registry that predates blocks has no `blocks-registry.json`; that is not an
+ * error, it just means this registry publishes none.
+ */
+export declare function fetchBlocksIndex(registryUrl?: string): Promise<BlocksIndex>;
+export declare function fetchBlockFromRegistry(blockId: string, registryUrl?: string): Promise<BlockItem>;
+export declare function getAvailableBlocks(registryUrl?: string): Promise<string[]>;
 export declare function getAvailableComponents(registryUrl?: string): Promise<string[]>;
-export declare function transformContent(content: string, config: Config): string;
-export declare function fetchComponent(componentName: string, config: Config, registryUrl?: string): Promise<RegistryItem>;
+export interface TransformOptions {
+    /**
+     * The destination came from `--path`, outside the configured alias.
+     *
+     * In that case the batch's components become neighbours on disk, and the
+     * relative path is what resolves — the alias would point at the folder they are
+     * not in. `utils` and `core` stay on the alias, because `init` installed them.
+     */
+    readonly siblingComponents?: boolean;
+    /**
+     * Where the file sits inside its registry item (`i18n/locales/en-us.ts`).
+     *
+     * A `../` only points at another component when it climbs out of the item.
+     * From a nested file it can stay inside — `core/i18n/locales/en-us.ts`
+     * importing `../i18n.types` — and turning that into the components alias made
+     * every fresh `init` ship imports that do not resolve.
+     */
+    readonly fileName?: string;
+}
+export declare function transformContent(content: string, config: Config, options?: TransformOptions): string;
+/**
+ * Rewrites aliased imports as paths relative to the file that holds them.
+ *
+ * A library cannot ship `@/shared/...`: ng-packagr leaves non-relative imports
+ * external, so the published bundle kept importing a path that only the
+ * library's own workspace maps — and every app installing it from npm failed to
+ * resolve them. Relative imports get bundled, and keep working inside the
+ * workspace too.
+ *
+ * `targets` pairs each alias with the directory it stands for. The longest
+ * alias goes first, so `@/shared/components` is not taken for a shorter prefix.
+ */
+export declare function relativizeImports(content: string, filePath: string, targets: Record<string, string>): string;
+export declare function fetchComponent(componentName: string, config: Config, registryUrl?: string, options?: TransformOptions & {
+    isBlock?: boolean;
+}): Promise<RegistryItem>;
 //# sourceMappingURL=registry.d.ts.map

package/utils/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/utils/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAInD,eAAO,MAAM,oBAAoB,QAE0D,CAAC;AAE5F,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;QAChC,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC,CAAC;CACJ;AAED,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAarD;AAKD,wBAAsB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAYrF;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED,wBAAsB,0BAA0B,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAInH;AAED,wBAAsB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGpF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAyCxE;AAED,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC,CAgBvB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/utils/registry.ts"],"names":[],"mappings":"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"}

package/utils/registry.js

@@ -1,8 +1,24 @@
 import { DEFAULT_REGISTRY_URL as BUILD_REGISTRY_URL } from '../config/registry-config.js';
+import { isIconFamily, retargetIcons, SOURCE_ICON_FAMILY } from '../core/icons/index.js';
 import { ConfigError } from '../utils/errors.js';
 import { fetchJson } from '../utils/http-client.js';
+import { iconCatalog } from '../utils/icon-catalog.js';
+import { logger } from '../utils/logger.js';
+import { assertSupportedSchema } from '../utils/schema-version.js';
+import * as path from 'node:path';
 export const DEFAULT_REGISTRY_URL = process.env['ZARD_REGISTRY_URL'] ||
     (BUILD_REGISTRY_URL !== '__REGISTRY_URL__' ? BUILD_REGISTRY_URL : 'https://zardui.com/r');
+/**
+ * The family the item's files are written in.
+ *
+ * An item with no `icons` — published before the property existed — is in
+ * lucide, which was the only possibility. So is an unknown value: better the
+ * right guess than refusing to install over an unfamiliar field.
+ */
+export function sourceFamilyOf(item) {
+    const family = item.icons?.family;
+    return family !== undefined && isIconFamily(family, iconCatalog()) ? family : SOURCE_ICON_FAMILY;
+}
 export function getRegistryUrl(config) {
     return config?.registryUrl || DEFAULT_REGISTRY_URL;
 }
@@ -22,38 +38,95 @@ export function validateRegistryUrl(url) {
     }
 }
 const CACHE_TTL = 5 * 60 * 1000; // 5 minutes
-let registryIndexCache = null;
+/**
+ * Keyed by registry URL, not global.
+ *
+ * `registryUrl` is a `components.json` field, so two registries can be read in one
+ * run — and a single cache entry handed the second call the first registry's index.
+ */
+const registryIndexCache = new Map();
 export async function fetchRegistryIndex(registryUrl) {
     const baseUrl = registryUrl || DEFAULT_REGISTRY_URL;
-    if (registryIndexCache && Date.now() - registryIndexCache.timestamp < CACHE_TTL) {
-        return registryIndexCache.data;
+    const cached = registryIndexCache.get(baseUrl);
+    if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
+        return cached.data;
     }
     const url = `${baseUrl}/registry.json`;
     const data = await fetchJson(url);
-    registryIndexCache = { data, timestamp: Date.now() };
+    assertSupportedSchema(data.schemaVersion, 'registry.json');
+    registryIndexCache.set(baseUrl, { data, timestamp: Date.now() });
     return data;
 }
 export function invalidateRegistryCache() {
-    registryIndexCache = null;
+    registryIndexCache.clear();
+    blocksIndexCache.clear();
 }
 export async function fetchComponentFromRegistry(componentName, registryUrl) {
     const baseUrl = registryUrl || DEFAULT_REGISTRY_URL;
     const url = `${baseUrl}/${componentName}.json`;
     return fetchJson(url);
 }
+const blocksIndexCache = new Map();
+/**
+ * The block index, cached like the component one.
+ *
+ * A registry that predates blocks has no `blocks-registry.json`; that is not an
+ * error, it just means this registry publishes none.
+ */
+export async function fetchBlocksIndex(registryUrl) {
+    const baseUrl = registryUrl || DEFAULT_REGISTRY_URL;
+    const cached = blocksIndexCache.get(baseUrl);
+    if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
+        return cached.data;
+    }
+    let data;
+    try {
+        data = await fetchJson(`${baseUrl}/blocks-registry.json`);
+    }
+    catch {
+        data = { blocks: [] };
+    }
+    blocksIndexCache.set(baseUrl, { data, timestamp: Date.now() });
+    return data;
+}
+export async function fetchBlockFromRegistry(blockId, registryUrl) {
+    const baseUrl = registryUrl || DEFAULT_REGISTRY_URL;
+    return fetchJson(`${baseUrl}/blocks/${blockId}.json`);
+}
+export async function getAvailableBlocks(registryUrl) {
+    const index = await fetchBlocksIndex(registryUrl);
+    return index.blocks.map(block => block.id);
+}
 export async function getAvailableComponents(registryUrl) {
     const index = await fetchRegistryIndex(registryUrl);
     return index.items.map(item => item.name);
 }
-export function transformContent(content, config) {
+/** Sem isto, um alias digitado como `@/ui/components/` produz `@/ui/components//button`. */
+function trimSlashes(alias) {
+    return alias.replace(/\/+$/, '');
+}
+export function transformContent(content, config, options = {}) {
     let transformed = content;
-    const { aliases } = config;
-    // Replace utils imports
-    transformed = transformed.replace(/from ['"]\.\.\/\.\.\/shared\/utils\/utils['"]/g, `from '${aliases.utils}/merge-classes'`);
-    transformed = transformed.replace(/from ['"]\.\.\/\.\.\/shared\/utils\/number['"]/g, `from '${aliases.utils}/number'`);
-    // Replace relative component imports with aliased imports
-    const componentImportRegex = /from ['"]\.\.\/([\w-/.]+)['"]/g;
-    transformed = transformed.replace(componentImportRegex, `from '${aliases.components}/$1'`);
+    const aliases = {
+        components: options.siblingComponents ? '..' : trimSlashes(config.aliases.components),
+        utils: trimSlashes(config.aliases.utils),
+        core: trimSlashes(config.aliases.core),
+        services: trimSlashes(config.aliases.services),
+    };
+    /*
+     * Blocks are authored inside the monorepo, so their sources import the library
+     * by its workspace alias (`@zard/components/card/card.imports`). Nothing maps
+     * that name in the installing project — left alone, every block would arrive
+     * with imports that do not resolve.
+     */
+    transformed = transformed.replace(/(['"])@zard\/components\/([\w\-/.]+)\1/g, (_match, quote, subpath) => `${quote}${aliases.components}/${subpath}${quote}`);
+    // Replace relative imports that leave the item (`../button/button.component`)
+    // with the components alias; the ones that stay inside it are left relative.
+    const fileDir = path.posix.dirname(options.fileName ?? '');
+    transformed = transformed.replace(/from ['"](\.\.\/[\w\-/.]+)['"]/g, (match, specifier) => {
+        const resolved = path.posix.normalize(path.posix.join(fileDir, specifier));
+        return resolved.startsWith('../') ? `from '${aliases.components}/${resolved.slice(3)}'` : match;
+    });
     // Replace ClassValue imports
     transformed = transformed.replace(/import \{ ClassValue \} from ['"]class-variance-authority\/dist\/types['"]/g, `import { ClassValue } from 'clsx'`);
     transformed = transformed.replace(/import \{ ClassValue \} from ['"]class-variance-authority['"]/g, `import { ClassValue } from 'clsx'`);
@@ -62,20 +135,81 @@ export function transformContent(content, config) {
         if (!value) {
             continue;
         }
-        const regex = new RegExp(`(['"])@\\/shared\\/${key}\\/([\\w\\-\\/.]+)\\1`, 'g');
-        transformed = transformed.replace(regex, `$1${value}/$2$1`);
+        // The subpath is optional: `card.component.ts` imports the barrel directly
+        // (`from '@/shared/core'`). Requiring `/something` after the key let that
+        // import escape the substitution, and the installed component kept pointing
+        // at `@/shared/core` — a folder that does not exist under a custom alias.
+        const regex = new RegExp(`(['"])@\\/shared\\/${key}(\\/[\\w\\-\\/.]+)?\\1`, 'g');
+        transformed = transformed.replace(regex, (_match, quote, subpath) => {
+            return `${quote}${value}${subpath ?? ''}${quote}`;
+        });
+    }
+    return transformed;
+}
+/**
+ * Rewrites aliased imports as paths relative to the file that holds them.
+ *
+ * A library cannot ship `@/shared/...`: ng-packagr leaves non-relative imports
+ * external, so the published bundle kept importing a path that only the
+ * library's own workspace maps — and every app installing it from npm failed to
+ * resolve them. Relative imports get bundled, and keep working inside the
+ * workspace too.
+ *
+ * `targets` pairs each alias with the directory it stands for. The longest
+ * alias goes first, so `@/shared/components` is not taken for a shorter prefix.
+ */
+export function relativizeImports(content, filePath, targets) {
+    const fileDir = path.dirname(filePath);
+    let transformed = content;
+    for (const [alias, dir] of Object.entries(targets).sort(([a], [b]) => b.length - a.length)) {
+        const escaped = trimSlashes(alias).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const regex = new RegExp(`(['"])${escaped}(\\/[\\w\\-\\/.]+)?\\1`, 'g');
+        transformed = transformed.replace(regex, (_match, quote, subpath) => {
+            const target = path.join(dir, ...(subpath ?? '').split('/').filter(Boolean));
+            const relative = path.relative(fileDir, target).split(path.sep).join('/') || '.';
+            return `${quote}${relative.startsWith('.') ? relative : `./${relative}`}${quote}`;
+        });
     }
     return transformed;
 }
-export async function fetchComponent(componentName, config, registryUrl) {
-    const item = await fetchComponentFromRegistry(componentName, registryUrl);
+/**
+ * A block in the shape the installer already understands.
+ *
+ * The two differ only in what the registry carries: a block entry adds `path`
+ * and `language` per file, neither of which affects how the files are written.
+ */
+function blockAsRegistryItem(block) {
+    return {
+        name: block.id,
+        type: 'registry:component',
+        basePath: 'blocks',
+        dependencies: block.dependencies,
+        registryDependencies: block.registryDependencies,
+        files: block.files.map(file => ({ name: file.name, content: file.content })),
+    };
+}
+export async function fetchComponent(componentName, config, registryUrl, options = {}) {
+    const item = options.isBlock
+        ? blockAsRegistryItem(await fetchBlockFromRegistry(componentName, registryUrl))
+        : await fetchComponentFromRegistry(componentName, registryUrl);
     if (!item.files || !Array.isArray(item.files)) {
         throw new ConfigError(`Component "${componentName}" has no files in the registry`);
     }
-    const transformedFiles = item.files.map(file => ({
-        name: file.name,
-        content: transformContent(file.content, config),
-    }));
+    const sourceFamily = sourceFamilyOf(item);
+    const missing = new Set();
+    const transformedFiles = item.files.map(file => {
+        const retargeted = retargetIcons(transformContent(file.content, config, { ...options, fileName: file.name }), sourceFamily, config.icons, iconCatalog());
+        for (const symbol of retargeted.missing)
+            missing.add(symbol);
+        return { name: file.name, content: retargeted.content };
+    });
+    // An icon with no equivalent in the chosen family keeps its original symbol,
+    // and its import no longer resolves. Failing the whole install over that would
+    // be worse: the rest of the component is correct and the fix is one line.
+    if (missing.size > 0) {
+        logger.warn(`"${componentName}" uses icons that ${config.icons} does not provide: ${[...missing].sort().join(', ')}. ` +
+            'They were left untouched — replace them by hand.');
+    }
     return {
         ...item,
         files: transformedFiles,

package/utils/registry.js.map

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

package/utils/schema-version.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The registry FORMAT version this CLI understands.
+ *
+ * Not to be confused with the package version, which the index also publishes:
+ * that one says which release the content came from, this one says what shape it
+ * has. Without separating them there was no way for the registry to change shape
+ * without silently breaking whoever was already installed — the CLI would read
+ * `files` from an item with a different shape and get it wrong without a word.
+ *
+ * It goes up when the change breaks a reader: a field removed, a meaning
+ * altered, an item reorganized. A new optional field raises nothing.
+ */
+export declare const SUPPORTED_SCHEMA_VERSION = 1;
+/**
+ * Rejects a document newer than this CLI knows how to read.
+ *
+ * A missing field means a registry older than the field itself, which is version
+ * 1 by definition.
+ */
+export declare function assertSupportedSchema(schemaVersion: number | undefined, source: string): void;
+//# sourceMappingURL=schema-version.d.ts.map

package/utils/schema-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.d.ts","sourceRoot":"","sources":["../../src/utils/schema-version.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAS7F"}

package/utils/schema-version.js

@@ -0,0 +1,28 @@
+import { SchemaVersionError } from '../utils/errors.js';
+/**
+ * The registry FORMAT version this CLI understands.
+ *
+ * Not to be confused with the package version, which the index also publishes:
+ * that one says which release the content came from, this one says what shape it
+ * has. Without separating them there was no way for the registry to change shape
+ * without silently breaking whoever was already installed — the CLI would read
+ * `files` from an item with a different shape and get it wrong without a word.
+ *
+ * It goes up when the change breaks a reader: a field removed, a meaning
+ * altered, an item reorganized. A new optional field raises nothing.
+ */
+export const SUPPORTED_SCHEMA_VERSION = 1;
+/**
+ * Rejects a document newer than this CLI knows how to read.
+ *
+ * A missing field means a registry older than the field itself, which is version
+ * 1 by definition.
+ */
+export function assertSupportedSchema(schemaVersion, source) {
+    const version = schemaVersion ?? 1;
+    if (version > SUPPORTED_SCHEMA_VERSION) {
+        throw new SchemaVersionError(`This registry publishes ${source} in format v${version}, and this CLI reads up to v${SUPPORTED_SCHEMA_VERSION}. ` +
+            'Update it with `npm i -g zard-cli@latest`, or run it through npx, which always fetches the latest.');
+    }
+}
+//# sourceMappingURL=schema-version.js.map

package/utils/schema-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.js","sourceRoot":"","sources":["../../src/utils/schema-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,aAAiC,EAAE,MAAc;IACrF,MAAM,OAAO,GAAG,aAAa,IAAI,CAAC,CAAC;IAEnC,IAAI,OAAO,GAAG,wBAAwB,EAAE,CAAC;QACvC,MAAM,IAAI,kBAAkB,CAC1B,2BAA2B,MAAM,eAAe,OAAO,+BAA+B,wBAAwB,IAAI;YAChH,oGAAoG,CACvG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/utils/source-file.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Source edits that more than one init step needs to make.
+ *
+ * Inserting an import looks trivial until the file is in CRLF: a raw `\n`
+ * produces mixed endings, makes git mark the whole file as changed, and — when
+ * the expression that finds the imports forgets the `\r` — welds the new line
+ * onto the end of the previous one.
+ */
+/** The line ending the file already uses. */
+export declare function lineEndingOf(content: string): string;
+/**
+ * Inserts an import line just after the file's last import.
+ *
+ * Returns the content untouched when the import is already there, so calling it
+ * twice is the same as calling it once.
+ */
+export declare function withImport(content: string, importLine: string): string;
+/** Where an array literal starts and ends, as indices into the content. */
+export interface ArrayRange {
+    /** Index of the opening `[`. */
+    readonly open: number;
+    /** Index of the closing `]`. */
+    readonly close: number;
+    /** What sits between the two, without the brackets. */
+    readonly body: string;
+}
+/**
+ * The range of the array assigned to `key`, found by counting brackets.
+ *
+ * A regular expression stops at the first `]` it sees, and in real code that `]`
+ * is usually a nested array's — `withInterceptors([...])` inside `providers`, a
+ * plugin with options inside `plugins`. Anything inserted there landed in the
+ * wrong array, and the build broke with a type error that mentions ZardUI
+ * nowhere.
+ *
+ * Strings and comments are skipped, so a `]` written inside one does not count
+ * as a closing bracket.
+ */
+export declare function arrayRange(content: string, key: string): ArrayRange | null;
+//# sourceMappingURL=source-file.d.ts.map

package/utils/source-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-file.d.ts","sourceRoot":"","sources":["../../src/utils/source-file.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6CAA6C;AAC7C,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAgBD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAYtE;AAED,2EAA2E;AAC3E,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAyB1E"}

package/utils/source-file.js

@@ -0,0 +1,104 @@
+/**
+ * Source edits that more than one init step needs to make.
+ *
+ * Inserting an import looks trivial until the file is in CRLF: a raw `\n`
+ * produces mixed endings, makes git mark the whole file as changed, and — when
+ * the expression that finds the imports forgets the `\r` — welds the new line
+ * onto the end of the previous one.
+ */
+/** The line ending the file already uses. */
+export function lineEndingOf(content) {
+    return content.includes('\r\n') ? '\r\n' : '\n';
+}
+/** The file's last `import ... from '...'`, or null when there is none. */
+function lastImport(content) {
+    // `[\s\S]*?` rather than `.*`: the list of imported symbols often wraps across
+    // several lines, and a pattern anchored to a single line did not reach it — in
+    // such a file the new import was thrown in before all the others.
+    const importRegex = /^import\s[\s\S]*?from\s+'[^']*';\r?\n?/gm;
+    let last = null;
+    let match;
+    while ((match = importRegex.exec(content)) !== null)
+        last = match;
+    return last;
+}
+/**
+ * Inserts an import line just after the file's last import.
+ *
+ * Returns the content untouched when the import is already there, so calling it
+ * twice is the same as calling it once.
+ */
+export function withImport(content, importLine) {
+    if (content.includes(importLine))
+        return content;
+    const eol = lineEndingOf(content);
+    const last = lastImport(content);
+    if (!last)
+        return importLine + eol + content;
+    const end = last.index + last[0].length;
+    const alreadyBroken = /\r?\n$/.test(last[0]);
+    return content.slice(0, end) + (alreadyBroken ? '' : eol) + importLine + eol + content.slice(end);
+}
+/**
+ * The range of the array assigned to `key`, found by counting brackets.
+ *
+ * A regular expression stops at the first `]` it sees, and in real code that `]`
+ * is usually a nested array's — `withInterceptors([...])` inside `providers`, a
+ * plugin with options inside `plugins`. Anything inserted there landed in the
+ * wrong array, and the build broke with a type error that mentions ZardUI
+ * nowhere.
+ *
+ * Strings and comments are skipped, so a `]` written inside one does not count
+ * as a closing bracket.
+ */
+export function arrayRange(content, key) {
+    const opening = new RegExp(`\\b${key}\\s*:\\s*\\[`).exec(content);
+    if (!opening)
+        return null;
+    const open = opening.index + opening[0].length - 1;
+    let depth = 0;
+    for (let index = open; index < content.length; index++) {
+        const skipped = skipStringOrComment(content, index);
+        if (skipped !== index) {
+            index = skipped - 1;
+            continue;
+        }
+        const char = content[index];
+        if (char === '[')
+            depth++;
+        else if (char === ']' && --depth === 0) {
+            return { open, close: index, body: content.slice(open + 1, index) };
+        }
+    }
+    return null;
+}
+/**
+ * The index just past the string or comment starting at `index`.
+ *
+ * Returns `index` itself when there is neither — the caller uses that to know
+ * the character is code and should be taken into account.
+ */
+function skipStringOrComment(content, index) {
+    const char = content[index];
+    const next = content[index + 1];
+    if (char === '/' && next === '/') {
+        const end = content.indexOf('\n', index);
+        return end === -1 ? content.length : end;
+    }
+    if (char === '/' && next === '*') {
+        const end = content.indexOf('*/', index + 2);
+        return end === -1 ? content.length : end + 2;
+    }
+    if (char !== '"' && char !== "'" && char !== '`')
+        return index;
+    for (let cursor = index + 1; cursor < content.length; cursor++) {
+        if (content[cursor] === '\\') {
+            cursor++;
+            continue;
+        }
+        if (content[cursor] === char)
+            return cursor + 1;
+    }
+    return content.length;
+}
+//# sourceMappingURL=source-file.js.map

package/utils/source-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-file.js","sourceRoot":"","sources":["../../src/utils/source-file.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6CAA6C;AAC7C,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,2EAA2E;AAC3E,SAAS,UAAU,CAAC,OAAe;IACjC,+EAA+E;IAC/E,+EAA+E;IAC/E,kEAAkE;IAClE,MAAM,WAAW,GAAG,0CAA0C,CAAC;IAE/D,IAAI,IAAI,GAA2B,IAAI,CAAC;IACxC,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI;QAAE,IAAI,GAAG,KAAK,CAAC;IAElE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,UAAkB;IAC5D,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,OAAO,CAAC;IAEjD,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAEjC,IAAI,CAAC,IAAI;QAAE,OAAO,UAAU,GAAG,GAAG,GAAG,OAAO,CAAC;IAE7C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACxC,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7C,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,UAAU,GAAG,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACpG,CAAC;AAYD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,GAAW;IACrD,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAElE,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACnD,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACvD,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAEpD,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;YACtB,KAAK,GAAG,OAAO,GAAG,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAE5B,IAAI,IAAI,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;aACrB,IAAI,IAAI,KAAK,GAAG,IAAI,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;QACtE,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,OAAe,EAAE,KAAa;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAEhC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACzC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3C,CAAC;IAED,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7C,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IAE/D,KAAK,IAAI,MAAM,GAAG,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;QAC/D,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;YAC7B,MAAM,EAAE,CAAC;YACT,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI;YAAE,OAAO,MAAM,GAAG,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC"}