@veluai/velu 0.1.13 → 0.1.15

package/runtime/velu-ui/components/ApiSidebar.jsx

@@ -1,122 +1,122 @@
-import React from 'react';
-import Stack from '../primitives/Stack.jsx';
-import resolveIcon from '../lib/resolveIcon.jsx';
-import MethodBadge from './MethodBadge.jsx';
-
-/**
- * ApiSidebar — navigation for API reference pages. Like <Sidebar> but
- * flat (no nested folders): every entry is a single endpoint shown as
- * a method pill + name. Entries are organized into groups, each with
- * an optional icon.
- *
- *   <ApiSidebar
- *     activeHref="/api/trigger"
- *     linkComponent={RouterLink}
- *     sections={[
- *       {
- *         title: 'Admin',
- *         icon: 'rocket',
- *         endpoints: [
- *           { method: 'POST',   label: 'Trigger', href: '/api/trigger' },
- *           { method: 'GET',    label: 'Get deployment-status',
- *             href: '/api/status' },
- *           { method: 'DELETE', label: 'Trigger Preview deployment',
- *             href: '/api/preview' },
- *         ],
- *       },
- *     ]}
- *   />
- *
- * Vertical rhythm = the Stack primitive (DRY, same as <Sidebar>);
- * api.css holds only the rail / active state / row layout / icon size.
- * Selection is route-driven (`endpoint.href === activeHref`, or
- * `endpoint.active: true`). Router-agnostic via `linkComponent`.
- *
- * @typedef {Object} ApiEndpoint
- * @property {string} method   HTTP method — drives the MethodBadge color
- * @property {string} label    endpoint display name
- * @property {string} [href]
- * @property {boolean} [active]
- *
- * @param {{ sections: { title?: string, icon?: string|React.ReactNode,
- *           endpoints: ApiEndpoint[] }[], activeHref?: string,
- *           linkComponent?: React.ElementType, className?: string }} props
- */
-
-const Ctx = React.createContext({ activeHref: undefined, Link: 'a' });
-
-function Icon({ icon }) {
-  const node = resolveIcon(icon);
-  return node ? (
-    <span className="velu-api-sidebar__icon" aria-hidden="true">
-      {node}
-    </span>
-  ) : null;
-}
-
-function Endpoint({ endpoint }) {
-  const { activeHref, Link } = React.useContext(Ctx);
-  const { method = 'GET', label, href = '#', active } = endpoint;
-  const isActive = Boolean(
-    active || (href != null && href === activeHref),
-  );
-  const cls = `velu-api-sidebar__item${
-    isActive ? ' velu-api-sidebar__item--active' : ''
-  }`;
-  return (
-    <li>
-      <Link
-        className={cls}
-        href={href}
-        aria-current={isActive ? 'page' : undefined}
-      >
-        <MethodBadge method={method} />
-        <span className="velu-api-sidebar__label">{label}</span>
-      </Link>
-    </li>
-  );
-}
-
-export default function ApiSidebar({
-  sections = [],
-  activeHref,
-  linkComponent = 'a',
-  className = '',
-  ...rest
-}) {
-  const ctx = React.useMemo(
-    () => ({ activeHref, Link: linkComponent }),
-    [activeHref, linkComponent],
-  );
-  return (
-    <Ctx.Provider value={ctx}>
-      <Stack
-        as="nav"
-        space="var(--s1)"
-        className={`velu-api-sidebar ${className}`.trim()}
-        aria-label="API reference"
-        {...rest}
-      >
-        {sections.map((section, i) => (
-          <React.Fragment key={i}>
-            {section.title != null && (
-              <h5 className="velu-api-sidebar__section">
-                <Icon icon={section.icon} />
-                {section.title}
-              </h5>
-            )}
-            <Stack
-              as="ul"
-              space="var(--s0)"
-              className="velu-api-sidebar__list"
-            >
-              {(section.endpoints ?? []).map((ep, j) => (
-                <Endpoint key={j} endpoint={ep} />
-              ))}
-            </Stack>
-          </React.Fragment>
-        ))}
-      </Stack>
-    </Ctx.Provider>
-  );
-}
+import React from 'react';
+import Stack from '../primitives/Stack.jsx';
+import resolveIcon from '../lib/resolveIcon.jsx';
+import MethodBadge from './MethodBadge.jsx';
+
+/**
+ * ApiSidebar — navigation for API reference pages. Like <Sidebar> but
+ * flat (no nested folders): every entry is a single endpoint shown as
+ * a method pill + name. Entries are organized into groups, each with
+ * an optional icon.
+ *
+ *   <ApiSidebar
+ *     activeHref="/api/trigger"
+ *     linkComponent={RouterLink}
+ *     sections={[
+ *       {
+ *         title: 'Admin',
+ *         icon: 'rocket',
+ *         endpoints: [
+ *           { method: 'POST',   label: 'Trigger', href: '/api/trigger' },
+ *           { method: 'GET',    label: 'Get deployment-status',
+ *             href: '/api/status' },
+ *           { method: 'DELETE', label: 'Trigger Preview deployment',
+ *             href: '/api/preview' },
+ *         ],
+ *       },
+ *     ]}
+ *   />
+ *
+ * Vertical rhythm = the Stack primitive (DRY, same as <Sidebar>);
+ * api.css holds only the rail / active state / row layout / icon size.
+ * Selection is route-driven (`endpoint.href === activeHref`, or
+ * `endpoint.active: true`). Router-agnostic via `linkComponent`.
+ *
+ * @typedef {Object} ApiEndpoint
+ * @property {string} method   HTTP method — drives the MethodBadge color
+ * @property {string} label    endpoint display name
+ * @property {string} [href]
+ * @property {boolean} [active]
+ *
+ * @param {{ sections: { title?: string, icon?: string|React.ReactNode,
+ *           endpoints: ApiEndpoint[] }[], activeHref?: string,
+ *           linkComponent?: React.ElementType, className?: string }} props
+ */
+
+const Ctx = React.createContext({ activeHref: undefined, Link: 'a' });
+
+function Icon({ icon }) {
+  const node = resolveIcon(icon);
+  return node ? (
+    <span className="velu-api-sidebar__icon" aria-hidden="true">
+      {node}
+    </span>
+  ) : null;
+}
+
+function Endpoint({ endpoint }) {
+  const { activeHref, Link } = React.useContext(Ctx);
+  const { method = 'GET', label, href = '#', active } = endpoint;
+  const isActive = Boolean(
+    active || (href != null && href === activeHref),
+  );
+  const cls = `velu-api-sidebar__item${
+    isActive ? ' velu-api-sidebar__item--active' : ''
+  }`;
+  return (
+    <li>
+      <Link
+        className={cls}
+        href={href}
+        aria-current={isActive ? 'page' : undefined}
+      >
+        <MethodBadge method={method} />
+        <span className="velu-api-sidebar__label">{label}</span>
+      </Link>
+    </li>
+  );
+}
+
+export default function ApiSidebar({
+  sections = [],
+  activeHref,
+  linkComponent = 'a',
+  className = '',
+  ...rest
+}) {
+  const ctx = React.useMemo(
+    () => ({ activeHref, Link: linkComponent }),
+    [activeHref, linkComponent],
+  );
+  return (
+    <Ctx.Provider value={ctx}>
+      <Stack
+        as="nav"
+        space="var(--s1)"
+        className={`velu-api-sidebar ${className}`.trim()}
+        aria-label="API reference"
+        {...rest}
+      >
+        {sections.map((section, i) => (
+          <React.Fragment key={i}>
+            {section.title != null && (
+              <h5 className="velu-api-sidebar__section">
+                <Icon icon={section.icon} />
+                {section.title}
+              </h5>
+            )}
+            <Stack
+              as="ul"
+              space="var(--s0)"
+              className="velu-api-sidebar__list"
+            >
+              {(section.endpoints ?? []).map((ep, j) => (
+                <Endpoint key={j} endpoint={ep} />
+              ))}
+            </Stack>
+          </React.Fragment>
+        ))}
+      </Stack>
+    </Ctx.Provider>
+  );
+}

package/runtime/velu-ui/components/AskBar.jsx

@@ -1,71 +1,71 @@
-import React, { useState } from 'react';
-import resolveIcon from '../lib/resolveIcon.jsx';
-
-/**
- * AskBar — an "ask a question" input card.
- *
- *   <AskBar onSubmit={(q) => …} />
- *
- * The component owns only the card visuals (border, glow-on-focus,
- * multi-line input, circular send button). PLACEMENT is the consumer's
- * job — the docs page pins it `position: absolute` to the bottom of
- * the article column so content scrolls behind its opaque surface.
- *
- *  - `placeholder` input placeholder (default "Ask a question…")
- *  - `onSubmit(value)` fired on the send button or Enter (Shift+Enter
- *    inserts a newline). Dummy-friendly — omit it and the bar is inert.
- *
- * The send affordance is a circular accent button with an up-arrow;
- * the card border glows in the accent color while the input is focused.
- */
-
-export default function AskBar({
-  placeholder = 'Ask a question…',
-  onSubmit,
-  className = '',
-  ...rest
-}) {
-  const [value, setValue] = useState('');
-
-  function submit() {
-    const q = value.trim();
-    if (!q) return;
-    onSubmit?.(q);
-    setValue('');
-  }
-
-  function onKeyDown(e) {
-    // Enter sends; Shift+Enter inserts a newline.
-    if (e.key === 'Enter' && !e.shiftKey) {
-      e.preventDefault();
-      submit();
-    }
-  }
-
-  // Disable the send button until there's non-whitespace input. The
-  // CSS reads :disabled to render it muted + un-hoverable; React reads
-  // the attribute to short-circuit clicks too.
-  const isEmpty = value.trim().length === 0;
-
-  return (
-    <div className={`velu-ask-bar ${className}`.trim()} {...rest}>
-      <textarea
-        className="velu-ask-bar__input"
-        placeholder={placeholder}
-        value={value}
-        onChange={(e) => setValue(e.target.value)}
-        onKeyDown={onKeyDown}
-        rows={2}
-      />
-      <button
-        type="button"
-        className="velu-ask-bar__send"
-        onClick={submit}
-        disabled={isEmpty}
-        aria-label="Ask"
-      >
-        {resolveIcon('arrow-up', { size: '1em' })}
-      </button>
-    </div>
-  );
-}
+import React, { useState } from 'react';
+import resolveIcon from '../lib/resolveIcon.jsx';
+
+/**
+ * AskBar — an "ask a question" input card.
+ *
+ *   <AskBar onSubmit={(q) => …} />
+ *
+ * The component owns only the card visuals (border, glow-on-focus,
+ * multi-line input, circular send button). PLACEMENT is the consumer's
+ * job — the docs page pins it `position: absolute` to the bottom of
+ * the article column so content scrolls behind its opaque surface.
+ *
+ *  - `placeholder` input placeholder (default "Ask a question…")
+ *  - `onSubmit(value)` fired on the send button or Enter (Shift+Enter
+ *    inserts a newline). Dummy-friendly — omit it and the bar is inert.
+ *
+ * The send affordance is a circular accent button with an up-arrow;
+ * the card border glows in the accent color while the input is focused.
+ */
+
+export default function AskBar({
+  placeholder = 'Ask a question…',
+  onSubmit,
+  className = '',
+  ...rest
+}) {
+  const [value, setValue] = useState('');
+
+  function submit() {
+    const q = value.trim();
+    if (!q) return;
+    onSubmit?.(q);
+    setValue('');
+  }
+
+  function onKeyDown(e) {
+    // Enter sends; Shift+Enter inserts a newline.
+    if (e.key === 'Enter' && !e.shiftKey) {
+      e.preventDefault();
+      submit();
+    }
+  }
+
+  // Disable the send button until there's non-whitespace input. The
+  // CSS reads :disabled to render it muted + un-hoverable; React reads
+  // the attribute to short-circuit clicks too.
+  const isEmpty = value.trim().length === 0;
+
+  return (
+    <div className={`velu-ask-bar ${className}`.trim()} {...rest}>
+      <textarea
+        className="velu-ask-bar__input"
+        placeholder={placeholder}
+        value={value}
+        onChange={(e) => setValue(e.target.value)}
+        onKeyDown={onKeyDown}
+        rows={2}
+      />
+      <button
+        type="button"
+        className="velu-ask-bar__send"
+        onClick={submit}
+        disabled={isEmpty}
+        aria-label="Ask"
+      >
+        {resolveIcon('arrow-up', { size: '1em' })}
+      </button>
+    </div>
+  );
+}

package/runtime/velu-ui/components/Callout.jsx

@@ -1,114 +1,114 @@
-import React from 'react';
-import resolveIcon from '../lib/resolveIcon.jsx';
-
-/**
- * Callout — admonition box (note/warning/info/tip/check/danger/callout).
- *
- * Fully tokenized: each `type` maps to its Figma bg + stroke token pair
- * (base.css, light + dark), so theming is automatic via [data-theme]. Border
- * + icon use the stroke; surface uses the bg; body uses --text-color.
- * Spacing/radius from the modular scale.
- *
- * Layout: the icon is FLOATED into the text flow (not a fixed column) — it
- * sits on the first line and the text wraps beside it, then subsequent/wrapped
- * lines flow back UNDER the icon (no hanging indent). `display: flow-root`
- * contains the float cleanly (no clipping, no clearfix hack).
- *
- * Content-driven & extensible: `icon` is a **lucide icon id string**
- * (kebab-case), resolved by the shared resolveIcon util (also accepts a
- * node). `stroke` / `bg` override the variant colors for custom callouts.
- *
- * SSR-safe & presentational (no effects/refs).
- *
- * @param {{ type?: 'note'|'warning'|'info'|'tip'|'check'|'danger'|'callout',
- *   icon?: string|React.ReactNode, stroke?: string, bg?: string,
- *   children: React.ReactNode, className?: string }} props
- */
-
-// Variant icon defaults are lucide IDS (not components) → one resolution path.
-const VARIANTS = {
-  note: { bg: '--note-bg-color', stroke: '--note-stroke-color', icon: 'pencil' },
-  warning: {
-    bg: '--warning-bg-color',
-    stroke: '--warning-stroke-color',
-    icon: 'triangle-alert',
-  },
-  info: { bg: '--info-bg-color', stroke: '--info-stroke-color', icon: 'info' },
-  tip: {
-    bg: '--tip-bg-color',
-    stroke: '--tip-stroke-color',
-    icon: 'lightbulb',
-  },
-  check: {
-    bg: '--check-bg-color',
-    stroke: '--check-stroke-color',
-    icon: 'circle-check',
-  },
-  danger: {
-    bg: '--danger-bg-color',
-    stroke: '--danger-stroke-color',
-    icon: 'shield-alert',
-  },
-  callout: {
-    bg: '--callout-bg-color',
-    stroke: '--callout-stroke-color',
-    icon: 'message-circle',
-  },
-};
-
-export default function Callout({
-  type = 'note',
-  icon,
-  stroke,
-  bg,
-  children,
-  className = '',
-  style,
-  ...rest
-}) {
-  const v = VARIANTS[type] || VARIANTS.note;
-  const strokeColor = stroke ?? `var(${v.stroke})`;
-  const bgColor = bg ?? `var(${v.bg})`;
-  // size only; stroke weight comes from the global --icon-stroke token
-  // (.lucide rule in base.css), not set per-icon.
-  const iconNode = resolveIcon(icon ?? v.icon, { size: '1em' });
-
-  return (
-    <div
-      className={className}
-      style={{
-        display: 'flow-root', // contains the floated icon, no clipping
-        padding: 'var(--s0) var(--s3)',
-        background: bgColor,
-        border: `var(--border-width) solid ${strokeColor}`,
-        borderRadius: 'var(--radius-sm)',
-        color: 'var(--text-color)',
-        fontSize: 'var(--f-body)',
-        lineHeight: 'var(--lh-body)',
-        ...style,
-      }}
-      {...rest}
-    >
-      {iconNode && (
-        <span
-          aria-hidden="true"
-          style={{
-            float: 'left',
-            display: 'inline-flex',
-            alignItems: 'center',
-            // one line-box tall (body font-size × body line-height token) so
-            // the icon is centered on the FIRST line; text wraps beside it
-            // then flows back under it (no hanging indent).
-            blockSize: 'calc(var(--f-body) * var(--lh-body))',
-            marginInlineEnd: 'var(--s-1)',
-            color: strokeColor,
-            fontSize: 'var(--f-body)',
-          }}
-        >
-          {iconNode}
-        </span>
-      )}
-      {children}
-    </div>
-  );
-}
+import React from 'react';
+import resolveIcon from '../lib/resolveIcon.jsx';
+
+/**
+ * Callout — admonition box (note/warning/info/tip/check/danger/callout).
+ *
+ * Fully tokenized: each `type` maps to its Figma bg + stroke token pair
+ * (base.css, light + dark), so theming is automatic via [data-theme]. Border
+ * + icon use the stroke; surface uses the bg; body uses --text-color.
+ * Spacing/radius from the modular scale.
+ *
+ * Layout: the icon is FLOATED into the text flow (not a fixed column) — it
+ * sits on the first line and the text wraps beside it, then subsequent/wrapped
+ * lines flow back UNDER the icon (no hanging indent). `display: flow-root`
+ * contains the float cleanly (no clipping, no clearfix hack).
+ *
+ * Content-driven & extensible: `icon` is a **lucide icon id string**
+ * (kebab-case), resolved by the shared resolveIcon util (also accepts a
+ * node). `stroke` / `bg` override the variant colors for custom callouts.
+ *
+ * SSR-safe & presentational (no effects/refs).
+ *
+ * @param {{ type?: 'note'|'warning'|'info'|'tip'|'check'|'danger'|'callout',
+ *   icon?: string|React.ReactNode, stroke?: string, bg?: string,
+ *   children: React.ReactNode, className?: string }} props
+ */
+
+// Variant icon defaults are lucide IDS (not components) → one resolution path.
+const VARIANTS = {
+  note: { bg: '--note-bg-color', stroke: '--note-stroke-color', icon: 'pencil' },
+  warning: {
+    bg: '--warning-bg-color',
+    stroke: '--warning-stroke-color',
+    icon: 'triangle-alert',
+  },
+  info: { bg: '--info-bg-color', stroke: '--info-stroke-color', icon: 'info' },
+  tip: {
+    bg: '--tip-bg-color',
+    stroke: '--tip-stroke-color',
+    icon: 'lightbulb',
+  },
+  check: {
+    bg: '--check-bg-color',
+    stroke: '--check-stroke-color',
+    icon: 'circle-check',
+  },
+  danger: {
+    bg: '--danger-bg-color',
+    stroke: '--danger-stroke-color',
+    icon: 'shield-alert',
+  },
+  callout: {
+    bg: '--callout-bg-color',
+    stroke: '--callout-stroke-color',
+    icon: 'message-circle',
+  },
+};
+
+export default function Callout({
+  type = 'note',
+  icon,
+  stroke,
+  bg,
+  children,
+  className = '',
+  style,
+  ...rest
+}) {
+  const v = VARIANTS[type] || VARIANTS.note;
+  const strokeColor = stroke ?? `var(${v.stroke})`;
+  const bgColor = bg ?? `var(${v.bg})`;
+  // size only; stroke weight comes from the global --icon-stroke token
+  // (.lucide rule in base.css), not set per-icon.
+  const iconNode = resolveIcon(icon ?? v.icon, { size: '1em' });
+
+  return (
+    <div
+      className={className}
+      style={{
+        display: 'flow-root', // contains the floated icon, no clipping
+        padding: 'var(--s0) var(--s3)',
+        background: bgColor,
+        border: `var(--border-width) solid ${strokeColor}`,
+        borderRadius: 'var(--radius-sm)',
+        color: 'var(--text-color)',
+        fontSize: 'var(--f-body)',
+        lineHeight: 'var(--lh-body)',
+        ...style,
+      }}
+      {...rest}
+    >
+      {iconNode && (
+        <span
+          aria-hidden="true"
+          style={{
+            float: 'left',
+            display: 'inline-flex',
+            alignItems: 'center',
+            // one line-box tall (body font-size × body line-height token) so
+            // the icon is centered on the FIRST line; text wraps beside it
+            // then flows back under it (no hanging indent).
+            blockSize: 'calc(var(--f-body) * var(--lh-body))',
+            marginInlineEnd: 'var(--s-1)',
+            color: strokeColor,
+            fontSize: 'var(--f-body)',
+          }}
+        >
+          {iconNode}
+        </span>
+      )}
+      {children}
+    </div>
+  );
+}