@featherk/icons 0.14.1 → 0.15.0

package/dist/fontawesome/catalog.mjs

@@ -0,0 +1,224 @@
+const entries = [
+  {
+    key: "rocket",
+    name: "rocket",
+    version: "7.0.0",
+    family: "classic",
+    style: "solid",
+    package: "@fortawesome/free-solid-svg-icons",
+    registryPackage: "@fortawesome/free-solid-svg-icons",
+    exportName: "faRocket",
+    tier: "free"
+  },
+  {
+    key: "feather",
+    name: "feather",
+    version: "7.0.0",
+    family: "classic",
+    style: "solid",
+    package: "@fortawesome/free-solid-svg-icons",
+    registryPackage: "@fortawesome/free-solid-svg-icons",
+    exportName: "faFeather",
+    tier: "free"
+  },
+  {
+    key: "heart",
+    name: "heart",
+    version: "7.0.0",
+    family: "classic",
+    style: "solid",
+    package: "@fortawesome/free-solid-svg-icons",
+    registryPackage: "@fortawesome/free-solid-svg-icons",
+    exportName: "faHeart",
+    tier: "free"
+  },
+  {
+    key: "star",
+    name: "star",
+    version: "7.0.0",
+    family: "classic",
+    style: "solid",
+    package: "@fortawesome/free-solid-svg-icons",
+    registryPackage: "@fortawesome/free-solid-svg-icons",
+    exportName: "faStar",
+    tier: "free"
+  },
+  {
+    key: "user",
+    name: "user",
+    version: "7.0.0",
+    family: "classic",
+    style: "solid",
+    package: "@fortawesome/free-solid-svg-icons",
+    registryPackage: "@fortawesome/free-solid-svg-icons",
+    exportName: "faUser",
+    tier: "free"
+  },
+  {
+    key: "rocket-v5",
+    name: "rocket",
+    version: "5.15.4",
+    family: "classic",
+    style: "solid",
+    package: "fa-solid-v5",
+    registryPackage: "@fortawesome/free-solid-svg-icons",
+    exportName: "faRocket",
+    tier: "free"
+  },
+  {
+    key: "rocket-v6",
+    name: "rocket",
+    version: "6.7.2",
+    family: "classic",
+    style: "solid",
+    package: "fa-solid-v6",
+    registryPackage: "@fortawesome/free-solid-svg-icons",
+    exportName: "faRocket",
+    tier: "free"
+  },
+  {
+    key: "heart-regular",
+    name: "heart",
+    version: "7.0.0",
+    family: "classic",
+    style: "regular",
+    package: "@fortawesome/free-regular-svg-icons",
+    registryPackage: "@fortawesome/free-regular-svg-icons",
+    exportName: "faHeart",
+    tier: "free"
+  },
+  {
+    key: "star-regular",
+    name: "star",
+    version: "7.0.0",
+    family: "classic",
+    style: "regular",
+    package: "@fortawesome/free-regular-svg-icons",
+    registryPackage: "@fortawesome/free-regular-svg-icons",
+    exportName: "faStar",
+    tier: "free"
+  },
+  {
+    key: "user-regular",
+    name: "user",
+    version: "7.0.0",
+    family: "classic",
+    style: "regular",
+    package: "@fortawesome/free-regular-svg-icons",
+    registryPackage: "@fortawesome/free-regular-svg-icons",
+    exportName: "faUser",
+    tier: "free"
+  },
+  {
+    key: "pro-rocket-regular",
+    name: "rocket",
+    version: "7.0.0",
+    family: "classic",
+    style: "regular",
+    package: "@fortawesome/pro-regular-svg-icons",
+    registryPackage: "@fortawesome/pro-regular-svg-icons",
+    exportName: "faRocket",
+    tier: "pro"
+  },
+  {
+    key: "pro-feather-light",
+    name: "feather",
+    version: "7.0.0",
+    family: "classic",
+    style: "light",
+    package: "@fortawesome/pro-light-svg-icons",
+    registryPackage: "@fortawesome/pro-light-svg-icons",
+    exportName: "faFeather",
+    tier: "pro"
+  },
+  {
+    key: "pro-heart-light",
+    name: "heart",
+    version: "7.0.0",
+    family: "classic",
+    style: "light",
+    package: "@fortawesome/pro-light-svg-icons",
+    registryPackage: "@fortawesome/pro-light-svg-icons",
+    exportName: "faHeart",
+    tier: "pro"
+  },
+  {
+    key: "pro-house-light",
+    name: "house",
+    version: "7.0.0",
+    family: "classic",
+    style: "light",
+    package: "@fortawesome/pro-light-svg-icons",
+    registryPackage: "@fortawesome/pro-light-svg-icons",
+    exportName: "faHouse",
+    tier: "pro"
+  }
+];
+function createCatalogIndex(catalog) {
+  const index = /* @__PURE__ */ new Map();
+  for (const entry of catalog) {
+    if (!entry.key.trim()) {
+      throw new Error("Font Awesome catalog keys must not be empty");
+    }
+    if (index.has(entry.key)) {
+      throw new Error(`Duplicate Font Awesome catalog key "${entry.key}"`);
+    }
+    index.set(entry.key, entry);
+  }
+  return index;
+}
+const fontAwesomeCatalog = Object.freeze(
+  entries.map((entry) => Object.freeze(entry))
+);
+const catalogByKey = createCatalogIndex(fontAwesomeCatalog);
+function resolveFontAwesomeKeys(keys, options = {}) {
+  if (!Array.isArray(keys)) {
+    throw new Error("Font Awesome keys must be an array");
+  }
+  const seen = /* @__PURE__ */ new Set();
+  return keys.map((key) => {
+    if (typeof key !== "string" || !key.trim()) {
+      throw new Error("Font Awesome keys must be non-empty strings");
+    }
+    if (seen.has(key)) {
+      throw new Error(`Duplicate Font Awesome key "${key}"`);
+    }
+    seen.add(key);
+    const entry = catalogByKey.get(key);
+    if (!entry) {
+      throw new Error(`Unknown Font Awesome catalog key "${key}"`);
+    }
+    if (entry.tier === "pro" && !options.allowPro) {
+      throw new Error(
+        `Font Awesome key "${key}" is Pro; enable the Pro profile to use it`
+      );
+    }
+    return {
+      key: entry.key,
+      name: entry.name,
+      version: entry.version,
+      family: entry.family,
+      style: entry.style,
+      package: entry.package,
+      exportName: entry.exportName,
+      registryPackage: entry.registryPackage
+    };
+  });
+}
+function getFontAwesomeInstallCommand(keys, options = {}) {
+  resolveFontAwesomeKeys(keys, options);
+  const packages = /* @__PURE__ */ new Set();
+  for (const key of keys) {
+    const entry = catalogByKey.get(key);
+    packages.add(
+      entry.package === entry.registryPackage ? `${entry.registryPackage}@${entry.version}` : `${entry.package}@npm:${entry.registryPackage}@${entry.version}`
+    );
+  }
+  if (packages.size === 0) return void 0;
+  return `npm install --save-dev --save-exact ${[...packages].join(" ")}`;
+}
+export {
+  fontAwesomeCatalog,
+  getFontAwesomeInstallCommand,
+  resolveFontAwesomeKeys
+};

package/dist/fontawesome/catalog.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/fontawesome/chunks/{generate-Bobf_ghm.cjs → generate-BBurrhLv.cjs}

@@ -3,6 +3,7 @@ const node_module = require("node:module");
 const promises = require("node:fs/promises");
 const node_path = require("node:path");
 const node_crypto = require("node:crypto");
+const fontawesome_catalog = require("../catalog.cjs");
 const prefixes = {
   "classic:solid": "fas",
   "classic:regular": "far",
@@ -173,23 +174,30 @@ async function writeAtomically(file, content) {
   }
 }
 async function generateFaIcons(options) {
-  const root = await promises.realpath(node_path.resolve(options.root ?? process.cwd()));
-  if (!Array.isArray(options.icons))
-    throw new Error("Font Awesome icons must be an array of selections");
-  const selections = options.icons.map((selection) => {
-    if (!selection || typeof selection !== "object") {
-      throw new Error("Font Awesome selections must be objects");
-    }
-    return {
-      key: selection.key,
-      name: selection.name,
-      version: selection.version,
-      family: selection.family,
-      style: selection.style,
-      package: selection.package,
-      ...selection.exportName === void 0 ? {} : { exportName: selection.exportName }
-    };
+  const selections = fontawesome_catalog.resolveFontAwesomeKeys(options.keys, {
+    allowPro: options.allowPro
+  });
+  return generateFaIconsFromSelections({
+    root: options.root,
+    sourceRoot: options.sourceRoot,
+    allowPro: options.allowPro,
+    outFile: options.outFile,
+    virtualTypesFile: options.virtualTypesFile,
+    selections
   });
+}
+async function generateFaIconsFromSelections(options) {
+  const root = await promises.realpath(node_path.resolve(options.root ?? process.cwd()));
+  const selections = options.selections.map((selection) => ({
+    key: selection.key,
+    name: selection.name,
+    version: selection.version,
+    family: selection.family,
+    style: selection.style,
+    package: selection.package,
+    registryPackage: selection.registryPackage,
+    ...selection.exportName === void 0 ? {} : { exportName: selection.exportName }
+  }));
   const keys = /* @__PURE__ */ new Set();
   const exports$1 = selections.map((selection) => {
     const exportName = validateSelection(selection);
@@ -227,13 +235,23 @@ async function generateFaIcons(options) {
       );
     }
     const metadata = JSON.parse(await promises.readFile(metadataFile, "utf8"));
+    if (typeof metadata.name !== "string" || !metadata.name) {
+      throw new Error(`Missing source package name for "${selection.key}"`);
+    }
+    if (selection.registryPackage !== void 0 && metadata.name !== selection.registryPackage) {
+      throw new Error(
+        `Font Awesome package mismatch for "${selection.key}": expected ${selection.registryPackage}, installed ${metadata.name}`
+      );
+    }
     if (metadata.version !== selection.version) {
       throw new Error(
         `Font Awesome version mismatch for "${selection.key}": requested ${selection.version}, installed ${metadata.version}`
       );
     }
-    if (typeof metadata.name !== "string" || !metadata.name) {
-      throw new Error(`Missing source package name for "${selection.key}"`);
+    if (!options.allowPro && (selection.package.startsWith("@fortawesome/pro-") || metadata.name.startsWith("@fortawesome/pro-"))) {
+      throw new Error(
+        `Font Awesome source for "${selection.key}" is Pro; enable the Pro profile to use it`
+      );
     }
     const licenseFile = node_path.join(node_path.dirname(metadataFile), "LICENSE.txt");
     if (!notices.has(metadataFile)) {
@@ -258,7 +276,16 @@ ${text.trim()}
       );
     }
     icons[selection.key] = normalizeIcon(selection, source[exportName]);
-    provenance.push({ ...selection, exportName, sourcePackage: metadata.name });
+    provenance.push({
+      key: selection.key,
+      name: selection.name,
+      version: selection.version,
+      family: selection.family,
+      style: selection.style,
+      package: selection.package,
+      exportName,
+      sourcePackage: metadata.name
+    });
   }
   const result = {
     moduleCode: `import { createFontAwesomeService } from "@featherk/icons/fontawesome";

package/dist/fontawesome/chunks/{generate-Bp92GTVi.mjs → generate-Zq9q2YZD.mjs}

@@ -2,6 +2,7 @@ import { createRequire } from "node:module";
 import { realpath, readFile, mkdir, writeFile, rename, unlink } from "node:fs/promises";
 import { resolve, join, dirname, relative, isAbsolute, sep, extname, basename } from "node:path";
 import { randomUUID } from "node:crypto";
+import { resolveFontAwesomeKeys } from "../catalog.mjs";
 const prefixes = {
   "classic:solid": "fas",
   "classic:regular": "far",
@@ -172,23 +173,30 @@ async function writeAtomically(file, content) {
   }
 }
 async function generateFaIcons(options) {
-  const root = await realpath(resolve(options.root ?? process.cwd()));
-  if (!Array.isArray(options.icons))
-    throw new Error("Font Awesome icons must be an array of selections");
-  const selections = options.icons.map((selection) => {
-    if (!selection || typeof selection !== "object") {
-      throw new Error("Font Awesome selections must be objects");
-    }
-    return {
-      key: selection.key,
-      name: selection.name,
-      version: selection.version,
-      family: selection.family,
-      style: selection.style,
-      package: selection.package,
-      ...selection.exportName === void 0 ? {} : { exportName: selection.exportName }
-    };
+  const selections = resolveFontAwesomeKeys(options.keys, {
+    allowPro: options.allowPro
+  });
+  return generateFaIconsFromSelections({
+    root: options.root,
+    sourceRoot: options.sourceRoot,
+    allowPro: options.allowPro,
+    outFile: options.outFile,
+    virtualTypesFile: options.virtualTypesFile,
+    selections
   });
+}
+async function generateFaIconsFromSelections(options) {
+  const root = await realpath(resolve(options.root ?? process.cwd()));
+  const selections = options.selections.map((selection) => ({
+    key: selection.key,
+    name: selection.name,
+    version: selection.version,
+    family: selection.family,
+    style: selection.style,
+    package: selection.package,
+    registryPackage: selection.registryPackage,
+    ...selection.exportName === void 0 ? {} : { exportName: selection.exportName }
+  }));
   const keys = /* @__PURE__ */ new Set();
   const exports$1 = selections.map((selection) => {
     const exportName = validateSelection(selection);
@@ -226,13 +234,23 @@ async function generateFaIcons(options) {
       );
     }
     const metadata = JSON.parse(await readFile(metadataFile, "utf8"));
+    if (typeof metadata.name !== "string" || !metadata.name) {
+      throw new Error(`Missing source package name for "${selection.key}"`);
+    }
+    if (selection.registryPackage !== void 0 && metadata.name !== selection.registryPackage) {
+      throw new Error(
+        `Font Awesome package mismatch for "${selection.key}": expected ${selection.registryPackage}, installed ${metadata.name}`
+      );
+    }
     if (metadata.version !== selection.version) {
       throw new Error(
         `Font Awesome version mismatch for "${selection.key}": requested ${selection.version}, installed ${metadata.version}`
       );
     }
-    if (typeof metadata.name !== "string" || !metadata.name) {
-      throw new Error(`Missing source package name for "${selection.key}"`);
+    if (!options.allowPro && (selection.package.startsWith("@fortawesome/pro-") || metadata.name.startsWith("@fortawesome/pro-"))) {
+      throw new Error(
+        `Font Awesome source for "${selection.key}" is Pro; enable the Pro profile to use it`
+      );
     }
     const licenseFile = join(dirname(metadataFile), "LICENSE.txt");
     if (!notices.has(metadataFile)) {
@@ -257,7 +275,16 @@ ${text.trim()}
       );
     }
     icons[selection.key] = normalizeIcon(selection, source[exportName]);
-    provenance.push({ ...selection, exportName, sourcePackage: metadata.name });
+    provenance.push({
+      key: selection.key,
+      name: selection.name,
+      version: selection.version,
+      family: selection.family,
+      style: selection.style,
+      package: selection.package,
+      exportName,
+      sourcePackage: metadata.name
+    });
   }
   const result = {
     moduleCode: `import { createFontAwesomeService } from "@featherk/icons/fontawesome";

package/dist/fontawesome/cli.cjs

@@ -3,10 +3,12 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const promises = require("node:fs/promises");
 const node_path = require("node:path");
 const node_util = require("node:util");
-const generate = require("./chunks/generate-Bobf_ghm.cjs");
-const usage = `Usage: featherk-fontawesome --manifest <icons.json> [--root <project>] [--source-root <installed-sources>] [--out <icons.mjs>] [--virtual-types <types.d.ts>]
+const fontawesome_catalog = require("./catalog.cjs");
+const generate = require("./chunks/generate-BBurrhLv.cjs");
+const usage = `Usage: featherk-fontawesome --manifest <icons.json> [--root <project>] [--source-root <installed-sources>] [--allow-pro] [--out <icons.mjs>] [--virtual-types <types.d.ts>]
 
-The JSON manifest must contain { "icons": [...] } with exact installed selections.
+The JSON manifest contains { "free": [keys], "pro": [keys] }.
+Use --allow-pro to include Pro keys.
 Provide --out, --virtual-types, or both. Paths are relative to the project root.
 This command does not download assets or authenticate; install licensed packages first.
 Generated assets belong to the consuming project, never the @featherk/icons package.`;
@@ -20,6 +22,7 @@ async function runFontAwesomeCli(args, io = {}) {
         manifest: { type: "string" },
         root: { type: "string" },
         "source-root": { type: "string" },
+        "allow-pro": { type: "boolean" },
         out: { type: "string" },
         "virtual-types": { type: "string" },
         help: { type: "boolean", short: "h" }
@@ -40,18 +43,39 @@ async function runFontAwesomeCli(args, io = {}) {
     const manifest = JSON.parse(
       await promises.readFile(node_path.resolve(root, values.manifest), "utf8")
     );
-    if (!manifest || typeof manifest !== "object" || Array.isArray(manifest) || !Array.isArray(manifest.icons)) {
-      throw new Error(
-        'Font Awesome manifest must be a JSON object with an "icons" array'
-      );
+    if (!manifest || typeof manifest !== "object" || Array.isArray(manifest)) {
+      throw new Error("Font Awesome manifest must be a JSON object");
     }
-    const result = await generate.generateFaIcons({
+    const record = manifest;
+    const common = {
       root,
       sourceRoot: values["source-root"],
-      icons: manifest.icons,
+      allowPro: values["allow-pro"],
       outFile: values.out,
       virtualTypesFile: values["virtual-types"]
+    };
+    const isKeyList = (value) => Array.isArray(value) && value.every((key) => typeof key === "string");
+    const freeKeys = record.free;
+    const proKeys = record.pro;
+    if (!isKeyList(freeKeys) || proKeys !== void 0 && !isKeyList(proKeys)) {
+      throw new Error(
+        'Font Awesome manifest must contain "free" and optional "pro" key arrays'
+      );
+    }
+    const keys = [
+      ...freeKeys,
+      ...values["allow-pro"] ? proKeys ?? [] : []
+    ];
+    const installCommand = fontawesome_catalog.getFontAwesomeInstallCommand(keys, {
+      allowPro: values["allow-pro"]
     });
+    if (installCommand) {
+      stdout(
+        `Install selected Font Awesome source packages with:
+${installCommand}`
+      );
+    }
+    const result = await generate.generateFaIcons({ ...common, keys });
     stdout(
       `Prepared ${result.provenance.length} selected Font Awesome icon(s). Preserve generated license notices in application distribution.`
     );

package/dist/fontawesome/cli.d.ts

@@ -1,6 +1,13 @@
+/** Injectable process I/O used by the CLI entry point and its tests. */
 export interface FontAwesomeCliIO {
     cwd?: string;
     stdout?: (message: string) => void;
     stderr?: (message: string) => void;
 }
+/**
+ * Parses CLI arguments and generates the requested consumer output.
+ *
+ * @returns `0` on success and `1` when argument, manifest, source, or output
+ * validation fails.
+ */
 export declare function runFontAwesomeCli(args: readonly string[], io?: FontAwesomeCliIO): Promise<number>;

package/dist/fontawesome/cli.mjs

@@ -1,10 +1,12 @@
 import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
 import { parseArgs } from "node:util";
-import { g as generateFaIcons } from "./chunks/generate-Bp92GTVi.mjs";
-const usage = `Usage: featherk-fontawesome --manifest <icons.json> [--root <project>] [--source-root <installed-sources>] [--out <icons.mjs>] [--virtual-types <types.d.ts>]
+import { getFontAwesomeInstallCommand } from "./catalog.mjs";
+import { g as generateFaIcons } from "./chunks/generate-Zq9q2YZD.mjs";
+const usage = `Usage: featherk-fontawesome --manifest <icons.json> [--root <project>] [--source-root <installed-sources>] [--allow-pro] [--out <icons.mjs>] [--virtual-types <types.d.ts>]
 
-The JSON manifest must contain { "icons": [...] } with exact installed selections.
+The JSON manifest contains { "free": [keys], "pro": [keys] }.
+Use --allow-pro to include Pro keys.
 Provide --out, --virtual-types, or both. Paths are relative to the project root.
 This command does not download assets or authenticate; install licensed packages first.
 Generated assets belong to the consuming project, never the @featherk/icons package.`;
@@ -18,6 +20,7 @@ async function runFontAwesomeCli(args, io = {}) {
         manifest: { type: "string" },
         root: { type: "string" },
         "source-root": { type: "string" },
+        "allow-pro": { type: "boolean" },
         out: { type: "string" },
         "virtual-types": { type: "string" },
         help: { type: "boolean", short: "h" }
@@ -38,18 +41,39 @@ async function runFontAwesomeCli(args, io = {}) {
     const manifest = JSON.parse(
       await readFile(resolve(root, values.manifest), "utf8")
     );
-    if (!manifest || typeof manifest !== "object" || Array.isArray(manifest) || !Array.isArray(manifest.icons)) {
-      throw new Error(
-        'Font Awesome manifest must be a JSON object with an "icons" array'
-      );
+    if (!manifest || typeof manifest !== "object" || Array.isArray(manifest)) {
+      throw new Error("Font Awesome manifest must be a JSON object");
     }
-    const result = await generateFaIcons({
+    const record = manifest;
+    const common = {
       root,
       sourceRoot: values["source-root"],
-      icons: manifest.icons,
+      allowPro: values["allow-pro"],
       outFile: values.out,
       virtualTypesFile: values["virtual-types"]
+    };
+    const isKeyList = (value) => Array.isArray(value) && value.every((key) => typeof key === "string");
+    const freeKeys = record.free;
+    const proKeys = record.pro;
+    if (!isKeyList(freeKeys) || proKeys !== void 0 && !isKeyList(proKeys)) {
+      throw new Error(
+        'Font Awesome manifest must contain "free" and optional "pro" key arrays'
+      );
+    }
+    const keys = [
+      ...freeKeys,
+      ...values["allow-pro"] ? proKeys ?? [] : []
+    ];
+    const installCommand = getFontAwesomeInstallCommand(keys, {
+      allowPro: values["allow-pro"]
     });
+    if (installCommand) {
+      stdout(
+        `Install selected Font Awesome source packages with:
+${installCommand}`
+      );
+    }
+    const result = await generateFaIcons({ ...common, keys });
     stdout(
       `Prepared ${result.provenance.length} selected Font Awesome icon(s). Preserve generated license notices in application distribution.`
     );

package/dist/fontawesome/generate.d.ts

@@ -1,12 +1,22 @@
-import type { FontAwesomeOptions, FontAwesomeSelection } from "./types";
+import type { FontAwesomeOptions, FontAwesomeSelection, FontAwesomeSourceSelection } from "./types";
+/** Options for resolving selected Font Awesome icons into consumer output. */
 export interface GenerateFaIconsOptions extends FontAwesomeOptions {
     outFile?: string;
     virtualTypesFile?: string;
 }
+/**
+ * Resolved source selections for the internal generation core.
+ * @internal
+ */
+export interface GenerateFaIconsFromSelectionsOptions extends Omit<GenerateFaIconsOptions, "keys"> {
+    selections: readonly FontAwesomeSourceSelection[];
+}
+/** Source identity used to generate one selected icon. */
 export interface FontAwesomeProvenance extends FontAwesomeSelection {
     sourcePackage: string;
     exportName: string;
 }
+/** Files and metadata produced while generating a consumer icon module. */
 export interface GeneratedFaIcons {
     moduleCode: string;
     declarationCode: string;
@@ -15,4 +25,18 @@ export interface GeneratedFaIcons {
     provenance: readonly FontAwesomeProvenance[];
     dependencies: readonly string[];
 }
+/**
+ * Generates descriptors for the requested catalog keys.
+ *
+ * Catalog-key selections verify the installed package name and exact version
+ * before loading its icon export. Pro keys require `allowPro: true`.
+ *
+ * @throws If a key is unknown or duplicated, a Pro key is not opted into, an
+ * installed source does not match the requested identity, or output is unsafe.
+ */
 export declare function generateFaIcons(options: GenerateFaIconsOptions): Promise<GeneratedFaIcons>;
+/**
+ * Generates descriptors from already-resolved source selections.
+ * @internal
+ */
+export declare function generateFaIconsFromSelections(options: GenerateFaIconsFromSelectionsOptions): Promise<GeneratedFaIcons>;

package/dist/fontawesome/normalize.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Validates installed Font Awesome definitions and converts safe path geometry
+ * into the Kendo-compatible SVG icon descriptor used by the runtime service.
+ */
 import type { FontAwesomeIcon, FontAwesomeSelection } from "./types";
+/** Returns the required Font Awesome prefix for a catalog family/style pair. */
 export declare function expectedPrefix(selection: FontAwesomeSelection): string;
+/**
+ * Validates a selected icon definition and normalizes its paths and viewBox.
+ *
+ * @throws If the identity, geometry, layer count, or path data is invalid.
+ */
 export declare function normalizeIcon(selection: FontAwesomeSelection, definition: unknown): FontAwesomeIcon;

package/dist/fontawesome/types.d.ts

@@ -5,6 +5,7 @@ export interface FontAwesomeIcon {
 }
 export type FontAwesomeFamily = "classic" | "sharp" | "duotone" | "sharp-duotone";
 export type FontAwesomeStyle = "solid" | "regular" | "light" | "thin" | "brands";
+export type FontAwesomeTier = "free" | "pro";
 export interface FontAwesomeSelection {
     key: string;
     name: string;
@@ -14,8 +15,17 @@ export interface FontAwesomeSelection {
     package: string;
     exportName?: string;
 }
+export interface FontAwesomeSourceSelection extends FontAwesomeSelection {
+    registryPackage: string;
+}
+export interface FontAwesomeCatalogEntry extends FontAwesomeSelection {
+    exportName: string;
+    registryPackage: string;
+    tier: FontAwesomeTier;
+}
 export interface FontAwesomeOptions {
-    icons: readonly FontAwesomeSelection[];
+    keys: readonly string[];
     root?: string;
     sourceRoot?: string;
+    allowPro?: boolean;
 }