@stacksjs/stx 0.2.181 → 0.2.183

package/dist/builtins/icon.d.ts

@@ -33,5 +33,13 @@ export declare const IconBuiltin: BuiltinComponentDef;
 /**
  * Pre-load icon collections so they're available synchronously during render.
  * Call this before template processing starts.
+ *
+ * Silent when the collection is not installed. Callers preload on the chance a
+ * template wants it, so an absent collection here is a normal outcome and not
+ * a problem to report; the render path still says so if a template actually
+ * asks for one that is missing. Pass `speculative: false` when the caller knows
+ * the collection is required.
  */
-export declare function preloadIconCollection(prefix?: string): Promise<void>;
+export declare function preloadIconCollection(prefix?: string, options?: {
+    speculative?: boolean;
+}): Promise<void>;

package/dist/builtins/icon.js

@@ -42,12 +42,13 @@ function loadCollectionSync(prefix) {
     return null;
   }
 }
-async function loadCollection(prefix) {
+async function loadCollection(prefix, speculative = !1) {
   if (collectionCache.has(prefix))
     return collectionCache.get(prefix);
   const jsonPath = resolveCollectionPath(prefix);
   if (!jsonPath) {
-    warnMissingCollection(prefix);
+    if (!speculative)
+      warnMissingCollection(prefix);
     return null;
   }
   try {
@@ -94,6 +95,6 @@ export const IconBuiltin = {
     return `<svg xmlns="http://www.w3.org/2000/svg" width="${size}" height="${size}" viewBox="${viewBox}" fill="none"${classAttr}${styleAttr}>${body}</svg>`;
   }
 };
-export async function preloadIconCollection(prefix = "lucide") {
-  await loadCollection(prefix);
+export async function preloadIconCollection(prefix = "lucide", options = {}) {
+  await loadCollection(prefix, options.speculative ?? !0);
 }