@veluai/velu 0.2.25 → 0.2.28

package/runtime/velu-ui/components/update.css

@@ -1,111 +1,111 @@
-/* Update — changelog entries. Two-column rows: a sticky left rail with the
-   date/label pill, and the entry body on the right. All values are tokens;
-   light/dark via [data-theme]. */
-
-.velu-update {
-  display: grid;
-  grid-template-columns: minmax(8rem, 11rem) minmax(0, 1fr);
-  column-gap: var(--s1);
-  row-gap: var(--s-1);
-  align-items: start;
-  margin-block: var(--s1) var(--s3);
-  /* Clear the fixed header when an entry is jumped to via its anchor. */
-  scroll-margin-top: calc(var(--velu-header-height) + var(--s0));
-}
-
-.velu-update__meta {
-  position: sticky;
-  /* Stick just below the fixed header instead of sliding behind it. */
-  top: calc(var(--velu-header-height) + var(--s0));
-  align-self: start;
-  display: flex;
-  flex-direction: column;
-  gap: var(--s-2);
-  /* Leave room for the absolute anchor icon at left:0, plus a gap to the pill. */
-  padding-left: var(--s1);
-}
-
-.velu-update__anchor {
-  position: absolute;
-  left: 0;
-  top: 0.3rem;
-  display: inline-flex;
-  /* Hidden until the entry is hovered/focused (like heading anchors). */
-  color: var(--muted-color);
-  opacity: 0;
-  transition: opacity 0.15s ease, color 0.15s ease;
-}
-
-.velu-update:hover .velu-update__anchor,
-.velu-update:focus-within .velu-update__anchor {
-  opacity: 1;
-  color: var(--accent-color);
-}
-
-.velu-update__label {
-  width: fit-content;
-  border-radius: 999px;
-  padding: 0.2rem 0.6rem;
-  font-size: var(--f-h6);
-  font-weight: var(--weight-semibold);
-  line-height: 1.2;
-  color: var(--page-bg);
-  background: var(--accent-color);
-  text-decoration: none;
-}
-
-.velu-update__label:hover {
-  background: color-mix(in srgb, var(--accent-color) 85%, black);
-}
-
-.velu-update__description {
-  color: var(--muted-color);
-  font-size: var(--f-h6);
-  line-height: var(--lh-h6);
-}
-
-.velu-update__tags {
-  display: flex;
-  flex-wrap: wrap;
-  gap: var(--s-2);
-}
-
-.velu-update__tag {
-  font-size: var(--f-small, 0.72rem);
-  color: var(--muted-color);
-  border: var(--border-width) solid var(--border-color);
-  border-radius: 999px;
-  padding: 0.1rem 0.45rem;
-}
-
-.velu-update__content {
-  min-width: 0;
-}
-
-.velu-update__content > :first-child {
-  margin-top: 0;
-}
-
-.velu-update__content > :last-child {
-  margin-bottom: 0;
-}
-
-/* Hidden by a tag filter (DOM-driven). */
-.velu-update[hidden] {
-  display: none !important;
-}
-
-@media (max-width: 768px) {
-  .velu-update {
-    grid-template-columns: minmax(0, 1fr);
-  }
-
-  .velu-update__meta {
-    position: static;
-    padding-left: var(--s2);
-  }
-
-  .velu-update__anchor {
-    left: 0;
-  }
-}
+/* Update — changelog entries. Two-column rows: a sticky left rail with the
+   date/label pill, and the entry body on the right. All values are tokens;
+   light/dark via [data-theme]. */
+
+.velu-update {
+  display: grid;
+  grid-template-columns: minmax(8rem, 11rem) minmax(0, 1fr);
+  column-gap: var(--s1);
+  row-gap: var(--s-1);
+  align-items: start;
+  margin-block: var(--s1) var(--s3);
+  /* Clear the fixed header when an entry is jumped to via its anchor. */
+  scroll-margin-top: calc(var(--velu-header-height) + var(--s0));
+}
+
+.velu-update__meta {
+  position: sticky;
+  /* Stick just below the fixed header instead of sliding behind it. */
+  top: calc(var(--velu-header-height) + var(--s0));
+  align-self: start;
+  display: flex;
+  flex-direction: column;
+  gap: var(--s-2);
+  /* Leave room for the absolute anchor icon at left:0, plus a gap to the pill. */
+  padding-left: var(--s1);
+}
+
+.velu-update__anchor {
+  position: absolute;
+  left: 0;
+  top: 0.3rem;
+  display: inline-flex;
+  /* Hidden until the entry is hovered/focused (like heading anchors). */
+  color: var(--muted-color);
+  opacity: 0;
+  transition: opacity 0.15s ease, color 0.15s ease;
+}
+
+.velu-update:hover .velu-update__anchor,
+.velu-update:focus-within .velu-update__anchor {
+  opacity: 1;
+  color: var(--accent-color);
+}
+
+.velu-update__label {
+  width: fit-content;
+  border-radius: 999px;
+  padding: 0.2rem 0.6rem;
+  font-size: var(--f-h6);
+  font-weight: var(--weight-semibold);
+  line-height: 1.2;
+  color: var(--page-bg);
+  background: var(--accent-color);
+  text-decoration: none;
+}
+
+.velu-update__label:hover {
+  background: color-mix(in srgb, var(--accent-color) 85%, black);
+}
+
+.velu-update__description {
+  color: var(--muted-color);
+  font-size: var(--f-h6);
+  line-height: var(--lh-h6);
+}
+
+.velu-update__tags {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--s-2);
+}
+
+.velu-update__tag {
+  font-size: var(--f-small, 0.72rem);
+  color: var(--muted-color);
+  border: var(--border-width) solid var(--border-color);
+  border-radius: 999px;
+  padding: 0.1rem 0.45rem;
+}
+
+.velu-update__content {
+  min-width: 0;
+}
+
+.velu-update__content > :first-child {
+  margin-top: 0;
+}
+
+.velu-update__content > :last-child {
+  margin-bottom: 0;
+}
+
+/* Hidden by a tag filter (DOM-driven). */
+.velu-update[hidden] {
+  display: none !important;
+}
+
+@media (max-width: 768px) {
+  .velu-update {
+    grid-template-columns: minmax(0, 1fr);
+  }
+
+  .velu-update__meta {
+    position: static;
+    padding-left: var(--s2);
+  }
+
+  .velu-update__anchor {
+    left: 0;
+  }
+}

package/runtime/velu-ui/index.js

@@ -1,58 +1,58 @@
-export { default as Stack } from './primitives/Stack.jsx';
-export { default as Switcher } from './primitives/Switcher.jsx';
-export { default as Cluster } from './primitives/Cluster.jsx';
-export { default as ThemeToggle } from './components/ThemeToggle.jsx';
-export { default as Sidebar } from './components/Sidebar.jsx';
-export { default as NavSelect } from './components/NavSelect.jsx';
-export { default as ContextMenu } from './components/ContextMenu.jsx';
-export { default as Toc } from './components/Toc.jsx';
-export { default as TocBar } from './components/TocBar.jsx';
-export { default as Callout } from './components/Callout.jsx';
-export { default as ErrorCard } from './components/ErrorCard.jsx';
-export { default as Logo } from './components/Logo.jsx';
-export { default as SocialLinks } from './components/SocialLinks.jsx';
-export {
-  default as Accordion,
-  AccordionGroup,
-} from './components/Accordion.jsx';
-export { default as Card, CardGroup } from './components/Card.jsx';
-export { default as Columns } from './components/Columns.jsx';
-export { default as Field } from './components/Field.jsx';
-export { default as Prompt } from './components/Prompt.jsx';
-export { default as Steps, Step } from './components/Steps.jsx';
-export { default as Tree, Folder, File } from './components/Tree.jsx';
-export { default as Update } from './components/Update.jsx';
-export { default as ChangelogFilters } from './components/ChangelogFilters.jsx';
-export { default as MethodBadge } from './components/MethodBadge.jsx';
-export { default as ApiPath } from './components/ApiPath.jsx';
-export { default as TryItBar } from './components/TryItBar.jsx';
-export { default as ApiField } from './components/ApiField.jsx';
-export { default as ApiClient } from './components/ApiClient.jsx';
-export { default as ApiSidebar } from './components/ApiSidebar.jsx';
-export { default as ApiReferencePage } from './components/ApiReferencePage.jsx';
-export { default as ApiSamples } from './components/ApiSamples.jsx';
-export { setApiProxyTransport } from './lib/api-send.js';
-export { default as NotFound } from './components/NotFound.jsx';
-export { default as AskBar } from './components/AskBar.jsx';
-export { default as Chatbot } from './components/Chatbot.jsx';
-export { default as PageFeedback } from './components/PageFeedback.jsx';
-export { default as PageNav } from './components/PageNav.jsx';
-export { default as PageFooter } from './components/PageFooter.jsx';
-export { default as PoweredBy } from './components/PoweredBy.jsx';
-export { default as resolveIcon } from './lib/resolveIcon.jsx';
-export {
-  default as PageHeader,
-  VeluMark,
-} from './components/PageHeader.jsx';
-export { default as Search } from './components/Search.jsx';
-export { default as pagefindSearch } from './lib/pagefind.js';
-export { createDocsAssistant } from './lib/docs-assistant.js';
-export { createPageFeedback } from './lib/page-feedback.js';
-export { default as Image } from './components/Image.jsx';
-export {
-  default as CodeBlock,
-  CodeGroup,
-} from './components/CodeBlock.jsx';
-export {
-  default as defaultMdxComponents,
-} from './mdx-components.jsx';
+export { default as Stack } from './primitives/Stack.jsx';
+export { default as Switcher } from './primitives/Switcher.jsx';
+export { default as Cluster } from './primitives/Cluster.jsx';
+export { default as ThemeToggle } from './components/ThemeToggle.jsx';
+export { default as Sidebar } from './components/Sidebar.jsx';
+export { default as NavSelect } from './components/NavSelect.jsx';
+export { default as ContextMenu } from './components/ContextMenu.jsx';
+export { default as Toc } from './components/Toc.jsx';
+export { default as TocBar } from './components/TocBar.jsx';
+export { default as Callout } from './components/Callout.jsx';
+export { default as ErrorCard } from './components/ErrorCard.jsx';
+export { default as Logo } from './components/Logo.jsx';
+export { default as SocialLinks } from './components/SocialLinks.jsx';
+export {
+  default as Accordion,
+  AccordionGroup,
+} from './components/Accordion.jsx';
+export { default as Card, CardGroup } from './components/Card.jsx';
+export { default as Columns } from './components/Columns.jsx';
+export { default as Field } from './components/Field.jsx';
+export { default as Prompt } from './components/Prompt.jsx';
+export { default as Steps, Step } from './components/Steps.jsx';
+export { default as Tree, Folder, File } from './components/Tree.jsx';
+export { default as Update } from './components/Update.jsx';
+export { default as ChangelogFilters } from './components/ChangelogFilters.jsx';
+export { default as MethodBadge } from './components/MethodBadge.jsx';
+export { default as ApiPath } from './components/ApiPath.jsx';
+export { default as TryItBar } from './components/TryItBar.jsx';
+export { default as ApiField } from './components/ApiField.jsx';
+export { default as ApiClient } from './components/ApiClient.jsx';
+export { default as ApiSidebar } from './components/ApiSidebar.jsx';
+export { default as ApiReferencePage } from './components/ApiReferencePage.jsx';
+export { default as ApiSamples } from './components/ApiSamples.jsx';
+export { setApiProxyTransport } from './lib/api-send.js';
+export { default as NotFound } from './components/NotFound.jsx';
+export { default as AskBar } from './components/AskBar.jsx';
+export { default as Chatbot } from './components/Chatbot.jsx';
+export { default as PageFeedback } from './components/PageFeedback.jsx';
+export { default as PageNav } from './components/PageNav.jsx';
+export { default as PageFooter } from './components/PageFooter.jsx';
+export { default as PoweredBy } from './components/PoweredBy.jsx';
+export { default as resolveIcon } from './lib/resolveIcon.jsx';
+export {
+  default as PageHeader,
+  VeluMark,
+} from './components/PageHeader.jsx';
+export { default as Search } from './components/Search.jsx';
+export { default as pagefindSearch } from './lib/pagefind.js';
+export { createDocsAssistant } from './lib/docs-assistant.js';
+export { createPageFeedback } from './lib/page-feedback.js';
+export { default as Image } from './components/Image.jsx';
+export {
+  default as CodeBlock,
+  CodeGroup,
+} from './components/CodeBlock.jsx';
+export {
+  default as defaultMdxComponents,
+} from './mdx-components.jsx';

package/runtime/velu-ui/lib/api-send.js

@@ -1,118 +1,118 @@
-// Build and send a "Try It" request from the playground field values.
-//
-// By default the request goes through the dev server's proxy
-// (/@velu-api-proxy) so it isn't blocked by CORS — the proxy forwards it
-// server-side and returns { status, statusText, headers, body }. Set the
-// project's api.playground.proxy to false to send straight from the browser.
-
-const PROXY_URL = '/@velu-api-proxy';
-const BODY_METHODS = new Set(['POST', 'PUT', 'PATCH', 'DELETE']);
-
-// Pluggable proxy transport. The dev server and the built site both proxy via
-// the same-origin HTTP endpoint (PROXY_URL). The instant preview, however,
-// runs in a sandboxed iframe with no server behind that URL, so it registers a
-// transport here that forwards the request to the editor host over postMessage
-// (which proxies it server-side and replies). The real site never registers
-// one, so it keeps using PROXY_URL. A transport receives the built request
-// ({ method, url, headers, body }) and resolves the SAME shape the HTTP proxy
-// returns: { status, statusText, headers, body } | { error }.
-let proxyTransport = null;
-export function setApiProxyTransport(fn) {
-  proxyTransport = typeof fn === 'function' ? fn : null;
-}
-
-// Compose the concrete request (url + headers + body) from the operation and
-// the user-entered values: { auth, path, query, header } maps + bodyText.
-function buildRequest({ operation, server, values, bodyText }) {
-  const v = values || {};
-  let path = operation.path.replace(/\{([^}]+)\}/g, (m, name) => {
-    const val = v.path?.[name];
-    return val ? encodeURIComponent(val) : m; // leave {name} if unfilled
-  });
-
-  const query = Object.entries(v.query || {}).filter(([, val]) => val !== '' && val != null);
-  const qs = query.map(([k, val]) => `${encodeURIComponent(k)}=${encodeURIComponent(val)}`).join('&');
-  const base = (server || '').replace(/\/+$/, '');
-  const url = `${base}${path}${qs ? `?${qs}` : ''}`;
-
-  const headers = {};
-  for (const a of operation.auth || []) {
-    const val = v.auth?.[a.name];
-    if (val) headers[a.name] = a.prefix ? `${a.prefix} ${val}` : val;
-  }
-  for (const [k, val] of Object.entries(v.header || {})) {
-    if (val !== '' && val != null) headers[k] = val;
-  }
-
-  let body = null;
-  if (operation.body && BODY_METHODS.has(operation.method)) {
-    body = bodyText || '';
-    if (body && !headers['Content-Type']) headers['Content-Type'] = operation.body.contentType || 'application/json';
-  }
-
-  return { method: operation.method, url, headers, body };
-}
-
-async function readBody(res) {
-  const text = await res.text();
-  const ct = res.headers.get('content-type') || '';
-  if (/json/i.test(ct)) {
-    try {
-      return JSON.parse(text);
-    } catch {
-      /* fall through to raw text */
-    }
-  }
-  return text;
-}
-
-export async function sendApiRequest({ operation, server, proxy = true, values, bodyText }) {
-  const req = buildRequest({ operation, server, values, bodyText });
-
-  // Proxied send. A registered transport (the instant preview's host bridge)
-  // takes precedence over the same-origin HTTP proxy — same return shape.
-  if (proxy && proxyTransport) {
-    const payload = await proxyTransport(req);
-    if (payload && payload.error) return { error: payload.error };
-    return {
-      status: payload?.status,
-      statusText: payload?.statusText || '',
-      headers: payload?.headers || {},
-      body: payload?.body,
-    };
-  }
-
-  if (proxy) {
-    const res = await fetch(PROXY_URL, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(req),
-    });
-    // The proxy returns the upstream result as JSON.
-    const payload = await res.json().catch(() => ({}));
-    if (payload && payload.error) return { error: payload.error };
-    return {
-      status: payload.status,
-      statusText: payload.statusText || '',
-      headers: payload.headers || {},
-      body: payload.body,
-    };
-  }
-
-  // Direct browser fetch (subject to CORS).
-  const res = await fetch(req.url, {
-    method: req.method,
-    headers: req.headers,
-    body: req.body || undefined,
-  });
-  const headers = {};
-  res.headers.forEach((val, key) => {
-    headers[key] = val;
-  });
-  return {
-    status: res.status,
-    statusText: res.statusText,
-    headers,
-    body: await readBody(res),
-  };
-}
+// Build and send a "Try It" request from the playground field values.
+//
+// By default the request goes through the dev server's proxy
+// (/@velu-api-proxy) so it isn't blocked by CORS — the proxy forwards it
+// server-side and returns { status, statusText, headers, body }. Set the
+// project's api.playground.proxy to false to send straight from the browser.
+
+const PROXY_URL = '/@velu-api-proxy';
+const BODY_METHODS = new Set(['POST', 'PUT', 'PATCH', 'DELETE']);
+
+// Pluggable proxy transport. The dev server and the built site both proxy via
+// the same-origin HTTP endpoint (PROXY_URL). The instant preview, however,
+// runs in a sandboxed iframe with no server behind that URL, so it registers a
+// transport here that forwards the request to the editor host over postMessage
+// (which proxies it server-side and replies). The real site never registers
+// one, so it keeps using PROXY_URL. A transport receives the built request
+// ({ method, url, headers, body }) and resolves the SAME shape the HTTP proxy
+// returns: { status, statusText, headers, body } | { error }.
+let proxyTransport = null;
+export function setApiProxyTransport(fn) {
+  proxyTransport = typeof fn === 'function' ? fn : null;
+}
+
+// Compose the concrete request (url + headers + body) from the operation and
+// the user-entered values: { auth, path, query, header } maps + bodyText.
+function buildRequest({ operation, server, values, bodyText }) {
+  const v = values || {};
+  let path = operation.path.replace(/\{([^}]+)\}/g, (m, name) => {
+    const val = v.path?.[name];
+    return val ? encodeURIComponent(val) : m; // leave {name} if unfilled
+  });
+
+  const query = Object.entries(v.query || {}).filter(([, val]) => val !== '' && val != null);
+  const qs = query.map(([k, val]) => `${encodeURIComponent(k)}=${encodeURIComponent(val)}`).join('&');
+  const base = (server || '').replace(/\/+$/, '');
+  const url = `${base}${path}${qs ? `?${qs}` : ''}`;
+
+  const headers = {};
+  for (const a of operation.auth || []) {
+    const val = v.auth?.[a.name];
+    if (val) headers[a.name] = a.prefix ? `${a.prefix} ${val}` : val;
+  }
+  for (const [k, val] of Object.entries(v.header || {})) {
+    if (val !== '' && val != null) headers[k] = val;
+  }
+
+  let body = null;
+  if (operation.body && BODY_METHODS.has(operation.method)) {
+    body = bodyText || '';
+    if (body && !headers['Content-Type']) headers['Content-Type'] = operation.body.contentType || 'application/json';
+  }
+
+  return { method: operation.method, url, headers, body };
+}
+
+async function readBody(res) {
+  const text = await res.text();
+  const ct = res.headers.get('content-type') || '';
+  if (/json/i.test(ct)) {
+    try {
+      return JSON.parse(text);
+    } catch {
+      /* fall through to raw text */
+    }
+  }
+  return text;
+}
+
+export async function sendApiRequest({ operation, server, proxy = true, values, bodyText }) {
+  const req = buildRequest({ operation, server, values, bodyText });
+
+  // Proxied send. A registered transport (the instant preview's host bridge)
+  // takes precedence over the same-origin HTTP proxy — same return shape.
+  if (proxy && proxyTransport) {
+    const payload = await proxyTransport(req);
+    if (payload && payload.error) return { error: payload.error };
+    return {
+      status: payload?.status,
+      statusText: payload?.statusText || '',
+      headers: payload?.headers || {},
+      body: payload?.body,
+    };
+  }
+
+  if (proxy) {
+    const res = await fetch(PROXY_URL, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(req),
+    });
+    // The proxy returns the upstream result as JSON.
+    const payload = await res.json().catch(() => ({}));
+    if (payload && payload.error) return { error: payload.error };
+    return {
+      status: payload.status,
+      statusText: payload.statusText || '',
+      headers: payload.headers || {},
+      body: payload.body,
+    };
+  }
+
+  // Direct browser fetch (subject to CORS).
+  const res = await fetch(req.url, {
+    method: req.method,
+    headers: req.headers,
+    body: req.body || undefined,
+  });
+  const headers = {};
+  res.headers.forEach((val, key) => {
+    headers[key] = val;
+  });
+  return {
+    status: res.status,
+    statusText: res.statusText,
+    headers,
+    body: await readBody(res),
+  };
+}