veryfront 0.1.1237 → 0.1.1239

package/esm/src/react/components/ui/tabs.d.ts

@@ -1,9 +1,16 @@
 /**
- * Tabs — ported from Veryfront Studio `components/Tabs/Tabs.tsx`, with the
+ * Tabs - ported from Veryfront Studio `components/Tabs/Tabs.tsx`, with the
  * `motion/react` spring-slide forked out: the active pill is a static
  * background (no dependency, no layout animation), only the `transition-colors`
  * CSS that Studio already ships. Semantic classes remapped to veryfront's
- * `[var(--token)]` vocabulary. Private to the chat module.
+ * `[var(--token)]` vocabulary.
+ *
+ * The selection MECHANICS (`role="tablist"` / `role="tab"`, `aria-selected`,
+ * select-on-click) come from the active adapter's `tabs` slot
+ * (`useAdapter().tabs`) - with no provider that is the zero-dependency builtin,
+ * so behaviour and markup are unchanged. This skin owns only the API shape, the
+ * `size` variant, and the visual look (including the active pill), which it
+ * drives from the controlled `value` prop.
  *
  * Flat, prefixed exports (`Tabs` + `TabsItem`) to match the other `ui/`
  * primitives (`SelectItem`, `DialogTrigger`, …). Note: `cn` is clsx-only (no
@@ -11,8 +18,23 @@
  * suffix (e.g. `px-8!`).
  *
  * Two sizes:
- * - `default` — filled track (`--input-bg`), 34/38px, accent pill.
- * - `sm` — flat, outlined, 32px, for panel headers.
+ * - `default` - filled track (`--input-bg`), 34/38px, accent pill.
+ * - `sm` - flat, outlined, 32px, for panel headers.
+ *
+ * @example
+ * ```tsx
+ * import { Tabs, TabsItem } from "veryfront/ui";
+ *
+ * function Example() {
+ *   const [tab, setTab] = React.useState("overview");
+ *   return (
+ *     <Tabs value={tab} onValueChange={setTab}>
+ *       <TabsItem value="overview">Overview</TabsItem>
+ *       <TabsItem value="activity">Activity</TabsItem>
+ *     </Tabs>
+ *   );
+ * }
+ * ```
  *
  * @module react/components/ui/tabs
  */
@@ -25,7 +47,7 @@ export interface TabsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "o
     size?: TabsSize;
     children: React.ReactNode;
 }
-/** Tablist container — manages active state and passes context to items. */
+/** Tablist container - delegates selection to the adapter, owns the size + look. */
 export declare const Tabs: any;
 /** Props accepted by `<TabsItem>`. */
 export interface TabsItemProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "value"> {
@@ -34,10 +56,11 @@ export interface TabsItemProps extends Omit<React.ButtonHTMLAttributes<HTMLButto
     children: React.ReactNode;
 }
 /**
- * Individual tab — renders as a button, or an anchor when `href` is set.
- * Forwards native props/ref and composes the caller's `onClick` with the
- * internal selection (caller's runs first, then the tab activates), so a
- * consumer-supplied handler adds to — never overrides — selection.
+ * Individual tab - renders as a button, or an anchor when `href` is set. The
+ * adapter's `tabs.Tab` supplies the `role="tab"` / `aria-selected` / `data-state`
+ * mechanics and composes selection onto the caller's `onClick` (caller's runs
+ * first, then the tab activates); this skin renders the visual pill and forwards
+ * native props/ref.
  */
 export declare const TabsItem: any;
 export {};

package/esm/src/react/components/ui/tabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../../../../src/src/react/components/ui/tabs.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,KAAK,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC;AAUjC,0DAA0D;AAC1D,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IACvF,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,4EAA4E;AAC5E,eAAO,MAAM,IAAI,KAsBf,CAAC;AAGH,sCAAsC;AACtC,MAAM,WAAW,aACf,SAAQ,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,KA6CpB,CAAC"}
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../../../../src/src/react/components/ui/tabs.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,KAAK,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC;AAWjC,0DAA0D;AAC1D,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IACvF,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,oFAAoF;AACpF,eAAO,MAAM,IAAI,KAwBf,CAAC;AAGH,sCAAsC;AACtC,MAAM,WAAW,aACf,SAAQ,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,KAyCpB,CAAC"}

package/esm/src/react/components/ui/tabs.js

@@ -1,9 +1,16 @@
 /**
- * Tabs — ported from Veryfront Studio `components/Tabs/Tabs.tsx`, with the
+ * Tabs - ported from Veryfront Studio `components/Tabs/Tabs.tsx`, with the
  * `motion/react` spring-slide forked out: the active pill is a static
  * background (no dependency, no layout animation), only the `transition-colors`
  * CSS that Studio already ships. Semantic classes remapped to veryfront's
- * `[var(--token)]` vocabulary. Private to the chat module.
+ * `[var(--token)]` vocabulary.
+ *
+ * The selection MECHANICS (`role="tablist"` / `role="tab"`, `aria-selected`,
+ * select-on-click) come from the active adapter's `tabs` slot
+ * (`useAdapter().tabs`) - with no provider that is the zero-dependency builtin,
+ * so behaviour and markup are unchanged. This skin owns only the API shape, the
+ * `size` variant, and the visual look (including the active pill), which it
+ * drives from the controlled `value` prop.
  *
  * Flat, prefixed exports (`Tabs` + `TabsItem`) to match the other `ui/`
  * primitives (`SelectItem`, `DialogTrigger`, …). Note: `cn` is clsx-only (no
@@ -11,40 +18,57 @@
  * suffix (e.g. `px-8!`).
  *
  * Two sizes:
- * - `default` — filled track (`--input-bg`), 34/38px, accent pill.
- * - `sm` — flat, outlined, 32px, for panel headers.
+ * - `default` - filled track (`--input-bg`), 34/38px, accent pill.
+ * - `sm` - flat, outlined, 32px, for panel headers.
+ *
+ * @example
+ * ```tsx
+ * import { Tabs, TabsItem } from "veryfront/ui";
+ *
+ * function Example() {
+ *   const [tab, setTab] = React.useState("overview");
+ *   return (
+ *     <Tabs value={tab} onValueChange={setTab}>
+ *       <TabsItem value="overview">Overview</TabsItem>
+ *       <TabsItem value="activity">Activity</TabsItem>
+ *     </Tabs>
+ *   );
+ * }
+ * ```
  *
  * @module react/components/ui/tabs
  */
 import * as React from "react";
 import { createStrictContext } from "../create-strict-context.js";
 import { cx as cn } from "./cva.js";
-const [TabsContext, useTabs] = createStrictContext("TabsItem", "Tabs");
-/** Tablist container — manages active state and passes context to items. */
+import { useAdapter } from "./adapter/context.js";
+const [TabsSkinContext, useTabsSkin] = createStrictContext("TabsItem", "Tabs");
+/** Tablist container - delegates selection to the adapter, owns the size + look. */
 export const Tabs = React.forwardRef(function Tabs({ value, onValueChange, size = "default", className, children, ...props }, ref) {
-    return (React.createElement(TabsContext.Provider, { value: { value, onValueChange, size } },
-        React.createElement("div", { ref: ref, ...props, role: "tablist", className: cn("inline-flex w-fit items-center rounded-full", size === "sm"
+    const { tabs } = useAdapter();
+    return (React.createElement(TabsSkinContext.Provider, { value: { value, size } },
+        React.createElement(tabs.Root, { ref: ref, value: value, onValueChange: onValueChange, ...props, className: cn("inline-flex w-fit items-center rounded-full", size === "sm"
                 ? "h-[32px] gap-0 border border-[var(--edge)] bg-transparent p-0.5"
                 : "h-[34px] gap-2 bg-[var(--input-bg)] p-1 md:h-[38px]", className) }, children)));
 });
 Tabs.displayName = "Tabs";
 /**
- * Individual tab — renders as a button, or an anchor when `href` is set.
- * Forwards native props/ref and composes the caller's `onClick` with the
- * internal selection (caller's runs first, then the tab activates), so a
- * consumer-supplied handler adds to — never overrides — selection.
+ * Individual tab - renders as a button, or an anchor when `href` is set. The
+ * adapter's `tabs.Tab` supplies the `role="tab"` / `aria-selected` / `data-state`
+ * mechanics and composes selection onto the caller's `onClick` (caller's runs
+ * first, then the tab activates); this skin renders the visual pill and forwards
+ * native props/ref.
  */
 export const TabsItem = React.forwardRef(function TabsItem({ value, href, children, className, onClick, ...props }, ref) {
-    const ctx = useTabs();
-    const isActive = ctx.value === value;
+    const { tabs } = useAdapter();
+    const { value: selected, size } = useTabsSkin();
+    const isActive = selected === value;
     const Comp = (href ? "a" : "button");
-    return (React.createElement(Comp, { ref: ref, ...(href ? { href } : { type: "button" }), ...props, role: "tab", "aria-selected": isActive, onClick: (e) => {
-            onClick?.(e);
-            ctx.onValueChange(value);
-        }, className: cn("relative inline-flex items-center h-full rounded-full font-normal transition-colors cursor-pointer focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--edge-medium)]", ctx.size === "sm" ? "px-3 text-sm" : "px-5 md:px-6 text-sm md:text-base", isActive
-            ? cn("text-[var(--foreground)]", ctx.size === "default" && "dark:text-[var(--background)]")
-            : "text-[var(--foreground)] opacity-50 hover:opacity-100", className) },
-        isActive && (React.createElement("div", { className: cn("absolute inset-0 rounded-full bg-[var(--accent)]", ctx.size === "default" && "dark:bg-[var(--foreground)]") })),
-        React.createElement("span", { className: "relative z-10" }, children)));
+    return (React.createElement(tabs.Tab, { value: value, asChild: true, ref: ref, onClick: onClick },
+        React.createElement(Comp, { ...(href ? { href } : { type: "button" }), ...props, className: cn("relative inline-flex items-center h-full rounded-full font-normal transition-colors cursor-pointer focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--edge-medium)]", size === "sm" ? "px-3 text-sm" : "px-5 md:px-6 text-sm md:text-base", isActive
+                ? cn("text-[var(--foreground)]", size === "default" && "dark:text-[var(--background)]")
+                : "text-[var(--foreground)] opacity-50 hover:opacity-100", className) },
+            isActive && (React.createElement("div", { className: cn("absolute inset-0 rounded-full bg-[var(--accent)]", size === "default" && "dark:bg-[var(--foreground)]") })),
+            React.createElement("span", { className: "relative z-10" }, children))));
 });
 TabsItem.displayName = "TabsItem";

package/esm/src/react/components/ui/toggle.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Toggle - a two-state pressed button (on / off). Behavioural but self-contained
+ * (a single `aria-pressed` button, no floating engine needed): controlled via
+ * `pressed`/`onPressedChange` or uncontrolled via `defaultPressed`. State is
+ * exposed as `data-state="on" | "off"` for styling; `asChild` grafts the toggle
+ * behaviour onto your own element. Skinned entirely with veryfront theme tokens.
+ *
+ * @module react/components/ui/toggle
+ */
+import * as React from "react";
+/** Props accepted by `<Toggle>`. */
+export interface ToggleProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onChange"> {
+    /** Controlled pressed state. Pair with `onPressedChange`. */
+    pressed?: boolean;
+    /** Initial pressed state when uncontrolled. @default false */
+    defaultPressed?: boolean;
+    /** Fires with the next pressed state on user activation. */
+    onPressedChange?: (pressed: boolean) => void;
+    /** Render as a Slot, merging the toggle behaviour onto the child element. */
+    asChild?: boolean;
+    /** React 19: ref is a regular prop. */
+    ref?: React.Ref<HTMLButtonElement>;
+}
+/** Render a pressed toggle button. */
+export declare function Toggle({ pressed, defaultPressed, onPressedChange, asChild, disabled, className, onClick, ref, ...props }: ToggleProps): React.ReactElement;
+//# sourceMappingURL=toggle.d.ts.map

package/esm/src/react/components/ui/toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.d.ts","sourceRoot":"","sources":["../../../../../src/src/react/components/ui/toggle.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,oCAAoC;AACpC,MAAM,WAAW,WACf,SAAQ,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,UAAU,CAAC;IACvE,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;CACpC;AAED,sCAAsC;AACtC,wBAAgB,MAAM,CAAC,EACrB,OAAO,EACP,cAAsB,EACtB,eAAe,EACf,OAAe,EACf,QAAQ,EACR,SAAS,EACT,OAAO,EACP,GAAG,EACH,GAAG,KAAK,EACT,EAAE,WAAW,GAAG,KAAK,CAAC,YAAY,CAsClC"}

package/esm/src/react/components/ui/toggle.js

@@ -0,0 +1,29 @@
+/**
+ * Toggle - a two-state pressed button (on / off). Behavioural but self-contained
+ * (a single `aria-pressed` button, no floating engine needed): controlled via
+ * `pressed`/`onPressedChange` or uncontrolled via `defaultPressed`. State is
+ * exposed as `data-state="on" | "off"` for styling; `asChild` grafts the toggle
+ * behaviour onto your own element. Skinned entirely with veryfront theme tokens.
+ *
+ * @module react/components/ui/toggle
+ */
+import * as React from "react";
+import { cx as cn } from "./cva.js";
+import { Slot } from "./slot.js";
+/** Render a pressed toggle button. */
+export function Toggle({ pressed, defaultPressed = false, onPressedChange, asChild = false, disabled, className, onClick, ref, ...props }) {
+    const isControlled = pressed !== undefined;
+    const [internal, setInternal] = React.useState(defaultPressed);
+    const isOn = isControlled ? pressed : internal;
+    const handleClick = (event) => {
+        onClick?.(event);
+        if (event.defaultPrevented)
+            return;
+        const next = !isOn;
+        if (!isControlled)
+            setInternal(next);
+        onPressedChange?.(next);
+    };
+    const Comp = asChild ? Slot : "button";
+    return (React.createElement(Comp, { ref: ref, type: asChild ? undefined : "button", "aria-pressed": isOn, "data-state": isOn ? "on" : "off", "data-disabled": disabled ? "" : undefined, disabled: disabled, onClick: handleClick, className: cn("inline-flex items-center justify-center gap-1.5 whitespace-nowrap rounded-md", "h-[38px] min-w-[38px] px-3 text-base font-normal", "transition-[background-color,color] duration-150 ease-in", "text-[var(--foreground)] hover:bg-[var(--accent)]", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--edge-medium)] focus-visible:ring-offset-2 focus-visible:ring-offset-[var(--background)]", "data-[state=on]:bg-[var(--secondary)] data-[state=on]:text-[var(--foreground)]", "disabled:pointer-events-none disabled:opacity-50", "[&_svg]:size-4 [&_svg]:shrink-0", className), ...props }));
+}

package/esm/src/react/components/ui/use-isomorphic-layout-effect.d.ts

@@ -1,6 +1,7 @@
+import * as React from "react";
 /**
  * Use a layout effect in browsers without emitting React's server-rendering
  * warning when a primitive is rendered on the server.
  */
-export declare const useIsomorphicLayoutEffect: any;
+export declare const useIsomorphicLayoutEffect: typeof React.useLayoutEffect;
 //# sourceMappingURL=use-isomorphic-layout-effect.d.ts.map

package/esm/src/react/components/ui/use-isomorphic-layout-effect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-isomorphic-layout-effect.d.ts","sourceRoot":"","sources":["../../../../../src/src/react/components/ui/use-isomorphic-layout-effect.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,yBAAyB,KAEb,CAAC"}
+{"version":3,"file":"use-isomorphic-layout-effect.d.ts","sourceRoot":"","sources":["../../../../../src/src/react/components/ui/use-isomorphic-layout-effect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,OAAO,KAAK,CAAC,eAKpD,CAAC"}

package/esm/src/react/components/ui/use-isomorphic-layout-effect.js

@@ -3,6 +3,9 @@ import * as React from "react";
  * Use a layout effect in browsers without emitting React's server-rendering
  * warning when a primitive is rendered on the server.
  */
-export const useIsomorphicLayoutEffect = typeof globalThis.document === "undefined"
-    ? React.useEffect
-    : React.useLayoutEffect;
+export const useIsomorphicLayoutEffect = (effect, deps) => {
+    const useEffectHook = typeof globalThis.document === "undefined"
+        ? React.useEffect
+        : React.useLayoutEffect;
+    return useEffectHook(effect, deps);
+};

package/esm/src/rendering/chunk-optimizer/source-imports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-imports.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/chunk-optimizer/source-imports.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAKjE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAqXD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAwBhE;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"source-imports.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/chunk-optimizer/source-imports.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAKjE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AA8PD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAwBhE;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/esm/src/rendering/chunk-optimizer/source-imports.js

@@ -179,123 +179,13 @@ function maskMarkdownRegions(source) {
     }
     return maskHtmlComments(parts.join(""));
 }
-function readHexDigit(char) {
-    if (char === undefined)
-        return -1;
-    const code = char.charCodeAt(0);
-    if (code >= 0x30 && code <= 0x39)
-        return code - 0x30;
-    if (code >= 0x41 && code <= 0x46)
-        return code - 0x41 + 10;
-    if (code >= 0x61 && code <= 0x66)
-        return code - 0x61 + 10;
-    return -1;
-}
-function readFixedHex(value, start, length) {
-    let parsed = 0;
-    for (let index = 0; index < length; index++) {
-        const digit = readHexDigit(value[start + index]);
-        if (digit === -1) {
-            throw new SyntaxError("Invalid escaped module specifier");
-        }
-        parsed = parsed * 16 + digit;
-    }
-    return { value: parsed, end: start + length };
-}
-function decodeModuleSpecifier(value) {
-    if (!value.includes("\\"))
-        return value;
-    let decoded = "";
-    let cursor = 0;
-    while (cursor < value.length) {
-        const char = value[cursor++];
-        if (char !== "\\") {
-            if (char === "\n" || char === "\r") {
-                throw new SyntaxError("Module specifiers cannot contain line terminators");
-            }
-            decoded += char;
-            continue;
-        }
-        if (cursor >= value.length) {
-            throw new SyntaxError("Invalid escaped module specifier");
-        }
-        const escaped = value[cursor++];
-        const simple = {
-            b: "\b",
-            f: "\f",
-            n: "\n",
-            r: "\r",
-            t: "\t",
-            v: "\v",
-            "\\": "\\",
-            "'": "'",
-            '"': '"',
-        };
-        if (Object.hasOwn(simple, escaped)) {
-            decoded += simple[escaped];
-            continue;
-        }
-        if (escaped === "\n")
-            continue;
-        if (escaped === "\r") {
-            if (value[cursor] === "\n")
-                cursor++;
-            continue;
-        }
-        if (escaped === "0") {
-            if (/[0-9]/.test(value[cursor] ?? "")) {
-                throw new SyntaxError("Legacy octal escapes are not valid in module specifiers");
-            }
-            decoded += "\0";
-            continue;
-        }
-        if (escaped === "x") {
-            const parsed = readFixedHex(value, cursor, 2);
-            decoded += String.fromCharCode(parsed.value);
-            cursor = parsed.end;
-            continue;
-        }
-        if (escaped === "u") {
-            if (value[cursor] === "{") {
-                const closing = value.indexOf("}", cursor + 1);
-                if (closing === -1 || closing === cursor + 1) {
-                    throw new SyntaxError("Invalid Unicode escape in module specifier");
-                }
-                let codePoint = 0;
-                for (let index = cursor + 1; index < closing; index++) {
-                    const digit = readHexDigit(value[index]);
-                    if (digit === -1) {
-                        throw new SyntaxError("Invalid Unicode escape in module specifier");
-                    }
-                    codePoint = codePoint * 16 + digit;
-                    if (codePoint > 0x10ffff) {
-                        throw new SyntaxError("Module specifier Unicode escape is out of range");
-                    }
-                }
-                decoded += String.fromCodePoint(codePoint);
-                cursor = closing + 1;
-                continue;
-            }
-            const parsed = readFixedHex(value, cursor, 4);
-            decoded += String.fromCharCode(parsed.value);
-            cursor = parsed.end;
-            continue;
-        }
-        if (escaped >= "1" && escaped <= "9") {
-            throw new SyntaxError("Legacy numeric escapes are not valid in module specifiers");
-        }
-        decoded += escaped;
-    }
-    return decoded;
-}
 function validateImportSpecifier(value) {
-    const decoded = decodeModuleSpecifier(value);
-    if (decoded.length === 0 ||
-        decoded.length > MAX_IMPORT_SPECIFIER_CHARS ||
-        hasControlCharacter(decoded)) {
+    if (value.length === 0 ||
+        value.length > MAX_IMPORT_SPECIFIER_CHARS ||
+        hasControlCharacter(value)) {
         throw new TypeError(`Chunk analysis import specifiers must contain between 1 and ${MAX_IMPORT_SPECIFIER_CHARS} characters without control characters`);
     }
-    return decoded;
+    return value;
 }
 /**
  * Run a span scanner one match past the per-page bound and fail closed there.

package/esm/src/rendering/orchestrator/css-candidate-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"css-candidate-manifest.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/orchestrator/css-candidate-manifest.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kDAAkD,CAAC;AAK1D,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAQD,UAAU,qBAAqB;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,UAAU,uBAAuB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAqBD,wBAAgB,8BAA8B,IAAI;IAChD,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,eAAe,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D,CAUA;AA8GD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,GAAG,CAAC,MAAM,CAAC,CAoD9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,GAAG,CAAC,MAAM,CAAC,CAGlF;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAc/E"}
+{"version":3,"file":"css-candidate-manifest.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/orchestrator/css-candidate-manifest.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kDAAkD,CAAC;AAK1D,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAQD,UAAU,qBAAqB;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,UAAU,uBAAuB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAqBD,wBAAgB,8BAA8B,IAAI;IAChD,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,eAAe,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D,CAUA;AA2ID;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,GAAG,CAAC,MAAM,CAAC,CAoD9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,GAAG,CAAC,MAAM,CAAC,CAGlF;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAc/E"}

package/esm/src/rendering/orchestrator/css-candidate-manifest.js

@@ -40,6 +40,19 @@ function toRelativeProjectPath(path, projectDir) {
     }
     return normalized.replace(/^\/+/, "");
 }
+function toDiagnosticProjectPath(path, projectDir) {
+    const normalized = normalizePath(path);
+    const normalizedProjectDir = normalizePath(projectDir).replace(/\/+$/, "");
+    if (normalized === normalizedProjectDir)
+        return ".";
+    if (normalized.startsWith(`${normalizedProjectDir}/`)) {
+        return normalized.slice(normalizedProjectDir.length + 1);
+    }
+    if (/^(?:[A-Za-z]:)?\//.test(normalized)) {
+        return `[outside-project]/${normalized.split("/").pop() ?? "unknown"}`;
+    }
+    return normalized.replace(/^\/+/, "");
+}
 function buildManifestCacheKey(projectScope, projectVersion, styleProfileHash) {
     return `${projectScope}:${projectVersion}:${styleProfileHash ?? "default"}`;
 }
@@ -71,7 +84,23 @@ function buildCandidateManifest(files, projectDir) {
             continue;
         if (!SOURCE_EXTENSIONS.some((ext) => file.path.endsWith(ext)))
             continue;
-        const candidates = new Set(extractCandidates(file.content));
+        // A file the tokenizer refuses to admit (over the byte or candidate-count
+        // cap) must degrade to "contributes no candidates", not abort the manifest:
+        // an escaping throw here propagates to the SSR boundary and, because it
+        // happens before manifestCache.set, is rebuilt and re-thrown on every
+        // request to the project (VERYFRONT-SERVER-F).
+        let extracted;
+        try {
+            extracted = extractCandidates(file.content);
+        }
+        catch (error) {
+            logger.warn("Skipping file rejected by candidate extraction", {
+                path: toDiagnosticProjectPath(file.path, projectDir),
+                error: error instanceof Error ? error.message : String(error),
+            });
+            continue;
+        }
+        const candidates = new Set(extracted);
         const relativePath = toRelativeProjectPath(file.path, projectDir);
         const absolutePath = normalizePath(file.path);
         fileCandidates.set(relativePath, candidates);

package/esm/src/rendering/orchestrator/module-loader/build-failure.d.ts

@@ -15,6 +15,16 @@
  */
 /** Tag `error` as a build failure and return it. */
 export declare function markBuildFailure(error: unknown): unknown;
+/**
+ * Tag `error` as a build failure the tenant's own source caused, and return it.
+ *
+ * For seams that know the provenance from control flow rather than from a
+ * registry slug — an import specifier that still does not resolve after a full
+ * rebuild, for instance, is a path the project authored.
+ */
+export declare function markTenantBuildFailure(error: unknown): unknown;
 /** True when `error` was raised while compiling or resolving project source. */
 export declare function isBuildFailure(error: unknown): boolean;
+/** True only for a build failure explicitly classified as tenant source. */
+export declare function isTenantBuildFailure(error: unknown): boolean;
 //# sourceMappingURL=build-failure.d.ts.map

package/esm/src/rendering/orchestrator/module-loader/build-failure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-failure.d.ts","sourceRoot":"","sources":["../../../../../src/src/rendering/orchestrator/module-loader/build-failure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGxD;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEtD"}
+{"version":3,"file":"build-failure.d.ts","sourceRoot":"","sources":["../../../../../src/src/rendering/orchestrator/module-loader/build-failure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiCH,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMxD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM9D;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE5D"}

package/esm/src/rendering/orchestrator/module-loader/build-failure.js

@@ -13,14 +13,61 @@
  * Only the loader is in a position to know which happened, so it tags the
  * error at the point of failure instead of leaving later layers to infer it.
  */
+import { isTenantSourceBuildError } from "../../../errors/tenant-classification.js";
+const ObjectDefineProperty = Object.defineProperty;
+const ObjectPrototypeHasOwnProperty = Object.prototype.hasOwnProperty;
+const ReflectApply = Reflect.apply;
+const ReflectGetOwnPropertyDescriptor = Reflect.getOwnPropertyDescriptor;
 const BUILD_FAILURE = Symbol.for("veryfront.module-loader.build-failure");
+const TENANT_BUILD_FAILURE = Symbol.for("veryfront.module-loader.tenant-build-failure");
+/**
+ * Modules are strict mode, so a plain assignment onto a frozen error throws.
+ * These taggers run inside `catch` blocks, where a throw would replace the
+ * original error with a `TypeError` and lose the failure entirely.
+ */
+function defineTag(error, tag) {
+    try {
+        ObjectDefineProperty(error, tag, { value: true, configurable: true });
+    }
+    catch {
+        // Sealed or non-configurable: the error stays untagged, which degrades to
+        // the pre-classification behavior rather than destroying the error.
+    }
+}
+function hasOwnTrueTag(error, tag) {
+    const descriptor = ReflectGetOwnPropertyDescriptor(error, tag);
+    return descriptor !== undefined &&
+        ReflectApply(ObjectPrototypeHasOwnProperty, descriptor, ["value"]) === true &&
+        descriptor.value === true;
+}
 /** Tag `error` as a build failure and return it. */
 export function markBuildFailure(error) {
-    if (error instanceof Error)
-        error[BUILD_FAILURE] = true;
+    if (error instanceof Error) {
+        defineTag(error, BUILD_FAILURE);
+        if (isTenantSourceBuildError(error))
+            defineTag(error, TENANT_BUILD_FAILURE);
+    }
+    return error;
+}
+/**
+ * Tag `error` as a build failure the tenant's own source caused, and return it.
+ *
+ * For seams that know the provenance from control flow rather than from a
+ * registry slug — an import specifier that still does not resolve after a full
+ * rebuild, for instance, is a path the project authored.
+ */
+export function markTenantBuildFailure(error) {
+    if (error instanceof Error) {
+        defineTag(error, BUILD_FAILURE);
+        defineTag(error, TENANT_BUILD_FAILURE);
+    }
     return error;
 }
 /** True when `error` was raised while compiling or resolving project source. */
 export function isBuildFailure(error) {
-    return error instanceof Error && error[BUILD_FAILURE] === true;
+    return error instanceof Error && hasOwnTrueTag(error, BUILD_FAILURE);
+}
+/** True only for a build failure explicitly classified as tenant source. */
+export function isTenantBuildFailure(error) {
+    return error instanceof Error && hasOwnTrueTag(error, TENANT_BUILD_FAILURE);
 }

package/esm/src/rendering/orchestrator/module-loader/dependency-resolver.d.ts

@@ -10,6 +10,8 @@ export type ResolvedModuleDependency = {
     isLocalLib: boolean;
     /** True when discovered inside `import("…")` rather than a static import. */
     isDynamic: boolean;
+    /** True when discovered in a bare `import "…"` statement. */
+    isSideEffect?: boolean;
 };
 /** Resolved dependency after its source module has been transformed to a temp file. */
 export type TransformedModuleDependency = ResolvedModuleDependency & {

package/esm/src/rendering/orchestrator/module-loader/dependency-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dependency-resolver.d.ts","sourceRoot":"","sources":["../../../../../src/src/rendering/orchestrator/module-loader/dependency-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAmDzE,sEAAsE;AACtE,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,2BAA2B,GAAG,wBAAwB,GAAG;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,sEAAsE;AACtE,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;CACzB;AAwHD,yEAAyE;AACzE,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAuBrC;AAED,2EAA2E;AAC3E,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,2BAA2B,EAAE,GAC7C,MAAM,CAaR"}
+{"version":3,"file":"dependency-resolver.d.ts","sourceRoot":"","sources":["../../../../../src/src/rendering/orchestrator/module-loader/dependency-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAsDzE,sEAAsE;AACtE,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,SAAS,EAAE,OAAO,CAAC;IACnB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,2BAA2B,GAAG,wBAAwB,GAAG;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,sEAAsE;AACtE,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;CACzB;AAyID,yEAAyE;AACzE,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAuBrC;AAED,2EAA2E;AAC3E,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,2BAA2B,EAAE,GAC7C,MAAM,CAiBR"}

package/esm/src/rendering/orchestrator/module-loader/dependency-resolver.js

@@ -1,6 +1,6 @@
 import { dirname, join, normalize, toFileUrl } from "../../../platform/compat/path/index.js";
 import { parallelMap, rendererLogger } from "../../../utils/index.js";
-import { findDynamicImportSpans, findStaticImportFromSpans, replaceSourceSpans, } from "../../../transforms/mdx/esm-module-loader/utils/source-spans.js";
+import { findDynamicImportSpans, findStaticImportFromSpans, findStaticSideEffectImportSpans, replaceSourceSpans, } from "../../../transforms/mdx/esm-module-loader/utils/source-spans.js";
 import { findSourceFile } from "../file-resolver/index.js";
 const logger = rendererLogger.component("module-loader");
 const MAX_IMPORTS_PER_KIND = 500;
@@ -22,16 +22,26 @@ function collectBoundedSpans(scan, kind) {
 const matchAlias = (specifier) => specifier.startsWith("@/") ? specifier : null;
 const matchRelative = (specifier) => specifier.match(/^(\.\.?\/[^?]+)(?:\?.*)?$/)?.[1];
 function collectAliasImports(fileContent) {
-    const toAlias = (isDynamic) => ({ original, path, start, end }) => ({ full: original, path, start, end, isDynamic });
+    const toAlias = (isDynamic, isSideEffect = false) => ({ original, path, start, end }) => ({ full: original, path, start, end, isDynamic, isSideEffect });
     return [
         ...collectBoundedSpans((maxMatches) => findStaticImportFromSpans(fileContent, matchAlias, maxMatches), "static alias").map(toAlias(false)),
+        ...collectBoundedSpans((maxMatches) => findStaticSideEffectImportSpans(fileContent, matchAlias, maxMatches), "side-effect alias").map(toAlias(false, true)),
         ...collectBoundedSpans((maxMatches) => findDynamicImportSpans(fileContent, matchAlias, maxMatches), "dynamic alias").map(toAlias(true)),
     ];
 }
 function collectRelativeImports(fileContent, fileDir) {
-    const toRelative = (isDynamic) => ({ original, path, start, end }) => ({ full: original, path, fromDir: fileDir, start, end, isDynamic });
+    const toRelative = (isDynamic, isSideEffect = false) => ({ original, path, start, end }) => ({
+        full: original,
+        path,
+        fromDir: fileDir,
+        start,
+        end,
+        isDynamic,
+        isSideEffect,
+    });
     return [
         ...collectBoundedSpans((maxMatches) => findStaticImportFromSpans(fileContent, matchRelative, maxMatches), "static relative").map(toRelative(false)),
+        ...collectBoundedSpans((maxMatches) => findStaticSideEffectImportSpans(fileContent, matchRelative, maxMatches), "side-effect relative").map(toRelative(false, true)),
         ...collectBoundedSpans((maxMatches) => findDynamicImportSpans(fileContent, matchRelative, maxMatches), "dynamic relative").map(toRelative(true)),
     ]
         // Ignore already-transformed file:// imports.
@@ -85,6 +95,7 @@ async function resolveRelativeImport(imp, adapter) {
         depFilePath,
         isLocalLib: false,
         isDynamic: imp.isDynamic,
+        isSideEffect: imp.isSideEffect,
     };
 }
 /** Resolves @/ alias and relative local imports from a source module. */
@@ -111,9 +122,13 @@ export function rewriteResolvedDependencyImports(fileContent, transformedDeps) {
             start: dep.start,
             end: dep.end,
             expected: dep.full,
-            // A dynamic span covers only the quoted specifier; a static one covers the
-            // whole `from "…"` clause.
-            replacement: dep.isDynamic ? `"${moduleUrl}"` : `from "${moduleUrl}"`,
+            // A dynamic span covers only the quoted specifier, a side-effect span
+            // covers the bare import, and a static binding span covers `from "…"`.
+            replacement: dep.isSideEffect
+                ? `import "${moduleUrl}"`
+                : dep.isDynamic
+                    ? `"${moduleUrl}"`
+                    : `from "${moduleUrl}"`,
         };
     });
     return replaceSourceSpans(fileContent, replacements);