@sxl-studio/storybook-addon 1.0.14 → 1.0.15

package/dist/index.d.ts

@@ -69,6 +69,10 @@ type SxlRegistry = {
     figmaFileKey: string;
     figmaFileName?: string;
     updatedAt?: string;
+    repository?: {
+        url?: string;
+        documentationUrl?: string;
+    };
     entries: SxlRegistryEntry[];
 };
 /**

package/dist/index.js

@@ -11,12 +11,17 @@ function fromDiffCodeConnect(data) {
   const d = data;
   const fileKey = typeof d.$figmaFileKey === "string" ? d.$figmaFileKey : "";
   const fileName = typeof d.$figmaFileName === "string" ? d.$figmaFileName : void 0;
+  const repository = d.repository && typeof d.repository === "object" ? d.repository : void 0;
   const isV2 = Array.isArray(d.components);
   const entries = isV2 ? convertV2Components(d.components, fileKey) : convertV1Entries(Array.isArray(d.entries) ? d.entries : [], fileKey);
   return {
     version: 1,
     figmaFileKey: fileKey,
     figmaFileName: fileName,
+    repository: repository ? {
+      ...typeof repository.url === "string" ? { url: repository.url } : {},
+      ...typeof repository.documentationUrl === "string" ? { documentationUrl: repository.documentationUrl } : {}
+    } : void 0,
     entries
   };
 }
@@ -133,6 +138,54 @@ function joinFetchUrl(base, path) {
   const segments = normalizeCompositionPath(path).split("/").filter(Boolean);
   return b + segments.map(encodeURIComponent).join("/");
 }
+function candidateRelativePaths(path) {
+  const n = normalizeCompositionPath(path);
+  const out = [n];
+  if (n.startsWith("components/")) {
+    out.push(n.slice("components/".length));
+  }
+  return Array.from(new Set(out));
+}
+function buildGitlabRawCandidates(repositoryUrl, path) {
+  let parsed;
+  try {
+    parsed = new URL(repositoryUrl);
+  } catch {
+    return [];
+  }
+  const cleanPath = parsed.pathname.replace(/\/+$/, "");
+  const marker = "/-/tree/";
+  const idx = cleanPath.indexOf(marker);
+  if (idx < 0) return [];
+  const prefix = cleanPath.slice(0, idx);
+  const tail = cleanPath.slice(idx + marker.length);
+  const slash = tail.indexOf("/");
+  const ref = slash >= 0 ? tail.slice(0, slash) : tail;
+  const baseDir = slash >= 0 ? tail.slice(slash + 1) : "";
+  const baseRaw = `${parsed.origin}${prefix}/-/raw/${encodeURIComponent(ref)}` + (baseDir ? `/${baseDir.split("/").map(encodeURIComponent).join("/")}` : "");
+  return candidateRelativePaths(path).map((rel) => joinFetchUrl(baseRaw, rel));
+}
+function extractRepositoryUrl(params) {
+  const raw = params?.registry;
+  if (!raw || typeof raw !== "object") return void 0;
+  const repo = raw.repository;
+  if (!repo || typeof repo !== "object") return void 0;
+  const url = repo.url;
+  return typeof url === "string" && url.trim() ? url.trim() : void 0;
+}
+async function fetchFirstOk(urls) {
+  for (const url of urls) {
+    try {
+      const res = await fetch(url, { credentials: "include" });
+      if (!res.ok) continue;
+      const text = await res.text();
+      if (!text.trim()) continue;
+      return { text, url };
+    } catch {
+    }
+  }
+  return null;
+}
 async function loadCompositionJsonText(path, legacyInline, params) {
   const inline = legacyInline?.trim();
   if (inline) {
@@ -176,8 +229,21 @@ async function loadCompositionJsonText(path, legacyInline, params) {
       return { error: `Fetch failed: ${msg}` };
     }
   }
+  const repoUrl = extractRepositoryUrl(params);
+  if (repoUrl) {
+    const gitlabCandidates = buildGitlabRawCandidates(repoUrl, p);
+    const hit = await fetchFirstOk(gitlabCandidates);
+    if (hit) {
+      return { text: hit.text, source: "fetch" };
+    }
+  }
+  const localCandidates = candidateRelativePaths(p).map((rel) => `/${rel}`);
+  const localHit = await fetchFirstOk(localCandidates);
+  if (localHit) {
+    return { text: localHit.text, source: "fetch" };
+  }
   return {
-    error: "Composition file is not inlined. Pass parameters.sxl.compositionSources, compositionFetchBaseUrl + staticDirs, or resolveComposition() in preview \u2014 see @sxl-studio/storybook-addon README."
+    error: "Composition file is not inlined and auto-fetch failed. Pass parameters.sxl.compositionSources, compositionFetchBaseUrl + staticDirs, or resolveComposition() in preview \u2014 see @sxl-studio/storybook-addon README."
   };
 }
 export {

package/dist/manager.js

@@ -19,12 +19,17 @@ function fromDiffCodeConnect(data) {
   const d = data;
   const fileKey = typeof d.$figmaFileKey === "string" ? d.$figmaFileKey : "";
   const fileName = typeof d.$figmaFileName === "string" ? d.$figmaFileName : void 0;
+  const repository = d.repository && typeof d.repository === "object" ? d.repository : void 0;
   const isV2 = Array.isArray(d.components);
   const entries = isV2 ? convertV2Components(d.components, fileKey) : convertV1Entries(Array.isArray(d.entries) ? d.entries : [], fileKey);
   return {
     version: 1,
     figmaFileKey: fileKey,
     figmaFileName: fileName,
+    repository: repository ? {
+      ...typeof repository.url === "string" ? { url: repository.url } : {},
+      ...typeof repository.documentationUrl === "string" ? { documentationUrl: repository.documentationUrl } : {}
+    } : void 0,
     entries
   };
 }
@@ -141,6 +146,54 @@ function joinFetchUrl(base, path) {
   const segments = normalizeCompositionPath(path).split("/").filter(Boolean);
   return b + segments.map(encodeURIComponent).join("/");
 }
+function candidateRelativePaths(path) {
+  const n = normalizeCompositionPath(path);
+  const out = [n];
+  if (n.startsWith("components/")) {
+    out.push(n.slice("components/".length));
+  }
+  return Array.from(new Set(out));
+}
+function buildGitlabRawCandidates(repositoryUrl, path) {
+  let parsed;
+  try {
+    parsed = new URL(repositoryUrl);
+  } catch {
+    return [];
+  }
+  const cleanPath = parsed.pathname.replace(/\/+$/, "");
+  const marker = "/-/tree/";
+  const idx = cleanPath.indexOf(marker);
+  if (idx < 0) return [];
+  const prefix = cleanPath.slice(0, idx);
+  const tail = cleanPath.slice(idx + marker.length);
+  const slash = tail.indexOf("/");
+  const ref = slash >= 0 ? tail.slice(0, slash) : tail;
+  const baseDir = slash >= 0 ? tail.slice(slash + 1) : "";
+  const baseRaw = `${parsed.origin}${prefix}/-/raw/${encodeURIComponent(ref)}` + (baseDir ? `/${baseDir.split("/").map(encodeURIComponent).join("/")}` : "");
+  return candidateRelativePaths(path).map((rel) => joinFetchUrl(baseRaw, rel));
+}
+function extractRepositoryUrl(params) {
+  const raw = params?.registry;
+  if (!raw || typeof raw !== "object") return void 0;
+  const repo = raw.repository;
+  if (!repo || typeof repo !== "object") return void 0;
+  const url = repo.url;
+  return typeof url === "string" && url.trim() ? url.trim() : void 0;
+}
+async function fetchFirstOk(urls) {
+  for (const url of urls) {
+    try {
+      const res = await fetch(url, { credentials: "include" });
+      if (!res.ok) continue;
+      const text = await res.text();
+      if (!text.trim()) continue;
+      return { text, url };
+    } catch {
+    }
+  }
+  return null;
+}
 async function loadCompositionJsonText(path, legacyInline, params) {
   const inline = legacyInline?.trim();
   if (inline) {
@@ -184,8 +237,21 @@ async function loadCompositionJsonText(path, legacyInline, params) {
       return { error: `Fetch failed: ${msg}` };
     }
   }
+  const repoUrl = extractRepositoryUrl(params);
+  if (repoUrl) {
+    const gitlabCandidates = buildGitlabRawCandidates(repoUrl, p);
+    const hit = await fetchFirstOk(gitlabCandidates);
+    if (hit) {
+      return { text: hit.text, source: "fetch" };
+    }
+  }
+  const localCandidates = candidateRelativePaths(p).map((rel) => `/${rel}`);
+  const localHit = await fetchFirstOk(localCandidates);
+  if (localHit) {
+    return { text: localHit.text, source: "fetch" };
+  }
   return {
-    error: "Composition file is not inlined. Pass parameters.sxl.compositionSources, compositionFetchBaseUrl + staticDirs, or resolveComposition() in preview \u2014 see @sxl-studio/storybook-addon README."
+    error: "Composition file is not inlined and auto-fetch failed. Pass parameters.sxl.compositionSources, compositionFetchBaseUrl + staticDirs, or resolveComposition() in preview \u2014 see @sxl-studio/storybook-addon README."
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sxl-studio/storybook-addon",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "description": "Storybook addon for SXL Studio — displays Figma Embed, component info and design token status for linked components",
   "type": "module",
   "main": "dist/index.js",