@proveanything/smartlinks 2.0.13 → 2.0.14

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.0.13  |  Generated: 2026-09-22T11:06:35.662Z
+Version: 2.0.14  |  Generated: 2026-09-22T11:19:25.044Z
 
 This is a concise summary of all available API functions and types.
 

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.0.13  |  Generated: 2026-09-22T11:06:35.662Z
+Version: 2.0.14  |  Generated: 2026-09-22T11:19:25.044Z
 
 This is a concise summary of all available API functions and types.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "2.0.13",
+  "version": "2.0.14",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "type": "module",
   "main": "dist/index.js",
@@ -36,6 +36,7 @@
     "scripts/register-release.mjs",
     "scripts/publish.mjs",
     "scripts/doctor.mjs",
+    "scripts/lib/",
     "openapi.yaml",
     "README.md"
   ],

package/scripts/doctor.mjs

@@ -143,6 +143,47 @@ if (!checkEsm && problems.length === 0) {
   console.log(`${DIM}moduleFormat "${format}" — ESM path not in use; UMD bundles resolve shared deps from window globals.${RESET}`);
 }
 
+// ---- CSS baseline (sl-baseline) --------------------------------------------
+// If the app declares meta.cssBaseline, warn on any `sl-*` class it uses that isn't in
+// the declared baseline version — those render nothing once the host's baseline is the
+// only source. Heuristic (scans built bundle text for the distinctive `sl-` namespace)
+// and WARN-only: it never fails the build.
+if (meta.cssBaseline) {
+  let baseline = null;
+  try {
+    baseline = JSON.parse(readFileSync(resolve(here, '../dist/baseline.classes.json'), 'utf8'));
+  } catch {
+    warnings.push(`meta.cssBaseline is "${meta.cssBaseline}" but this SDK build has no baseline class list to check against.`);
+  }
+  if (baseline) {
+    if (baseline.version !== meta.cssBaseline) {
+      warnings.push(`meta.cssBaseline is "${meta.cssBaseline}" but this SDK ships baseline "${baseline.version}" — the host may serve a different set.`);
+    }
+    const baseSet = new Set(baseline.classes || []);
+    // Class usage lives in compiled markup strings — present in every bundle regardless
+    // of module format, so scan both umd + esm across all surfaces.
+    const used = new Set();
+    for (const [, block] of surfaces) {
+      for (const p of [block?.files?.js?.umd, block?.files?.js?.esm]) {
+        if (!p) continue;
+        const bp = resolveBundle(p);
+        if (!bp) continue;
+        for (const m of readFileSync(bp, 'utf8').matchAll(/\bsl-[a-z0-9-]+/g)) used.add(m[0]);
+      }
+    }
+    const unknown = [...used].filter((c) => !baseSet.has(c)).sort();
+    if (used.size === 0) {
+      console.log(`${DIM}cssBaseline (${baseline.version}) — declared; no sl-* classes found in the bundles.${RESET}`);
+    } else if (unknown.length === 0) {
+      console.log(`${GREEN}✓${RESET} cssBaseline ${DIM}(${baseline.version})${RESET} — all ${used.size} sl-* classes used are in the baseline`);
+    } else {
+      console.log(`${YELLOW}⚠${RESET} cssBaseline ${DIM}(${baseline.version})${RESET} — ${unknown.length} sl-* class${unknown.length === 1 ? '' : 'es'} used but not in the baseline (they will not render):`);
+      for (const c of unknown) console.log(`    ${YELLOW}${c}${RESET}`);
+      warnings.push(`sl-* classes used but not in cssBaseline "${baseline.version}": ${unknown.join(', ')} — define them in your own CSS, fix the typo, or drop them.`);
+    }
+  }
+}
+
 console.log('');
 for (const w of warnings) console.log(`${YELLOW}⚠ ${w}${RESET}`);
 

package/scripts/lib/bare-imports.mjs

@@ -0,0 +1,57 @@
+// Extract the *real* bare import specifiers from a (usually minified) ESM bundle.
+//
+// We LEX the module with es-module-lexer rather than text-scanning, so specifiers only
+// come from genuine `import`/`export … from`/`import()` statements. Data that merely
+// contains the word `from` — e.g. tailwind-merge's class map `{"gradient-from":[{from:…}]}`
+// — can no longer masquerade as an import (the historical false-positive class).
+//
+// Relative, absolute-path, and http(s) specifiers are dropped (never contract entries);
+// `node:` specifiers are kept so the caller can flag them (they must never appear in a
+// browser bundle).
+
+import { init, parse } from 'es-module-lexer';
+
+await init;
+
+// Legacy conservative regex — only used if the lexer throws (unexpected for valid ESM).
+// Kept so the doctor degrades to "runs, approximately" rather than crashing.
+function regexFallback(code) {
+  const specs = new Set();
+  const patterns = [
+    /\bfrom\s*["']([^"']+)["']/g,
+    /\bimport\s*["']([^"']+)["']/g,
+    /\bimport\(\s*["']([^"']+)["']\s*\)/g,
+  ];
+  for (const re of patterns) {
+    let m;
+    while ((m = re.exec(code))) specs.add(m[1]);
+  }
+  return [...specs].filter(keep);
+}
+
+function keep(spec) {
+  if (!spec) return false;
+  if (spec.startsWith('.') || spec.startsWith('/')) return false; // internal/relative
+  if (/^https?:/.test(spec)) return false; // absolute URL import
+  return true;
+}
+
+/**
+ * @param {string} code  ESM bundle source
+ * @returns {string[]}   deduped bare import specifiers (may include `node:` ones)
+ */
+export function bareImportsOf(code) {
+  let imports;
+  try {
+    [imports] = parse(code);
+  } catch {
+    return regexFallback(code);
+  }
+  const specs = new Set();
+  for (const imp of imports) {
+    // `imp.n` is the resolved specifier for static imports, re-exports, and
+    // string-literal dynamic imports; undefined for `import(expr)` we can't resolve.
+    if (imp.n && keep(imp.n)) specs.add(imp.n);
+  }
+  return [...specs];
+}