@stacksjs/stx 0.2.101 → 0.2.102

package/dist/builtins/icon.d.ts

@@ -1,4 +1,19 @@
 import type { BuiltinComponentDef } from '../component-registry';
+/**
+ * Resolve the on-disk path of an icon collection JSON.
+ *
+ * Two packaging conventions are accepted. `@iconify/json` ships every
+ * collection in one ~120MB dependency; `@iconify-json/<prefix>` ships a single
+ * collection in about a megabyte and is what most projects actually install.
+ * Supporting only the monolith meant an app with `@iconify-json/lucide`
+ * installed rendered nothing at all for every icon on every page, with no
+ * error to explain it.
+ *
+ * Each convention is checked through the package resolver first, then against
+ * `node_modules/` and Stacks-style `pantry/` (which sits parallel to
+ * node_modules in apps that vendor there).
+ */
+export declare function resolveCollectionPath(prefix: string): string | null;
 /**
  * Pre-load icon collections so they're available synchronously during render.
  * Call this before template processing starts.

package/dist/builtins/icon.js

@@ -1,25 +1,39 @@
 var {require}=import.meta;import { escapeAttr } from "./escape.js";
 import { existsSync, readFileSync } from "node:fs";
-const collectionCache = new Map;
-function resolveCollectionPath(prefix) {
-  try {
-    return require.resolve(`@iconify/json/json/${prefix}.json`);
-  } catch {}
+const collectionCache = new Map, warnedMissingCollections = new Set;
+function warnMissingCollection(prefix) {
+  if (warnedMissingCollections.has(prefix))
+    return;
+  warnedMissingCollections.add(prefix);
+  console.warn(`[stx] icon collection "${prefix}" is not installed, so its icons render as nothing. Install it with \`bun add -d @iconify-json/${prefix}\`.`);
+}
+export function resolveCollectionPath(prefix) {
   const cwd = process.cwd();
   for (const candidate of [
+    `${cwd}/node_modules/@iconify-json/${prefix}/icons.json`,
+    `${cwd}/pantry/@iconify-json/${prefix}/icons.json`,
     `${cwd}/node_modules/@iconify/json/json/${prefix}.json`,
     `${cwd}/pantry/@iconify/json/json/${prefix}.json`
   ])
     if (existsSync(candidate))
       return candidate;
+  for (const specifier of [
+    `@iconify-json/${prefix}/icons.json`,
+    `@iconify/json/json/${prefix}.json`
+  ])
+    try {
+      return require.resolve(specifier);
+    } catch {}
   return null;
 }
 function loadCollectionSync(prefix) {
   if (collectionCache.has(prefix))
     return collectionCache.get(prefix);
   const jsonPath = resolveCollectionPath(prefix);
-  if (!jsonPath)
+  if (!jsonPath) {
+    warnMissingCollection(prefix);
     return null;
+  }
   try {
     const data = JSON.parse(readFileSync(jsonPath, "utf8"));
     collectionCache.set(prefix, data.icons);
@@ -32,8 +46,10 @@ async function loadCollection(prefix) {
   if (collectionCache.has(prefix))
     return collectionCache.get(prefix);
   const jsonPath = resolveCollectionPath(prefix);
-  if (!jsonPath)
+  if (!jsonPath) {
+    warnMissingCollection(prefix);
     return null;
+  }
   try {
     const data = await Bun.file(jsonPath).json();
     collectionCache.set(prefix, data.icons);