basalt-ui 1.40.3 → 2.0.0

package/dist/commands/overlays-mount.d.ts

@@ -1,122 +0,0 @@
-/**
- * overlays-mount — composable overlay mount for basalt-ui apps.
- *
- * `BasaltOverlays` bundles ModalsProvider, Spotlight, and Notifications into a single mount point.
- * Put it inside BasaltProvider, before the router. It is the ONLY notifications mount — the
- * standalone `basalt-ui/notifications` overlay it superseded is gone (C1 consolidation); mounting
- * a second, hand-rolled `<Notifications />` alongside `<BasaltOverlays notifications />` still
- * double-mounts the overlay and is still wrong for the same reason.
- *
- * Every layer — ModalsProvider included — mounts as a SIBLING of `children`, never as a wrapper:
- * see the comment in the component body (R1). `@mantine/modals`' imperative API (`modals.open*`,
- * and so basalt's own `overlays.open`) is a window CustomEvent bus that ModalsProvider subscribes
- * to, so nothing needs to be inside it; the one thing a sibling cannot serve is Mantine's
- * `useModals()` context hook.
- *
- * Each overlay system is opt-in via props (all default to true). Use flags to disable layers the
- * app does not need — e.g. a charts-only app that has no commands can set `spotlight={false}`.
- * A disabled layer's optional peer is NEVER imported — each layer is lazy-loaded (React.lazy +
- * dynamic import()) only when its flag is true, and degrades to a no-op fallback instead of
- * crashing when the peer is absent.
- *
- * Optional peers required (only when the corresponding layer is enabled):
- *   @mantine/modals ^9.3.0     (for modals)
- *   @mantine/spotlight ^9.3.0  (for spotlight)
- *   @mantine/notifications ^9.3.0 (for notifications)
- *   @tanstack/react-hotkeys ^0.10.0 (optional — keybindings degrade to no-op when absent)
- *
- * Spotlight live store: BasaltOverlays uses a basalt-owned createSpotlight() store so the
- * spotlight instance is separate from Mantine's default global. The store is created lazily (on
- * first use, whether from mounting the spotlight layer or from calling openSpotlight()/
- * closeSpotlight()) so @mantine/spotlight is never imported until actually needed. Import
- * `basaltSpotlight` and call `basaltSpotlight.open()` / `basaltSpotlight.close()` from consumer
- * code. The re-exported `openSpotlight` / `closeSpotlight` helpers delegate to this store.
- *
- * @example
- * // main.tsx — mount <BasaltOverlays>. Use the layered bundle — the unlayered one outranks
- * // basalt's `@layer basalt` styles regardless of specificity:
- * import { BasaltOverlays } from 'basalt-ui/commands'
- * import '@mantine/spotlight/styles.layer.css'
- *
- * createRoot(root).render(
- *   <BasaltProvider>
- *     <BasaltOverlays>
- *       <App />
- *     </BasaltOverlays>
- *   </BasaltProvider>
- * )
- *
- * // Disable spotlight for apps without commands — @mantine/spotlight is then never imported:
- * <BasaltOverlays spotlight={false}>
- *   <App />
- * </BasaltOverlays>
- *
- * // Open/close programmatically:
- * import { openSpotlight, closeSpotlight } from 'basalt-ui/commands'
- * openSpotlight()
- */
-import type { ReactNode } from 'react';
-import type { NotificationsProps } from '@mantine/notifications';
-import type { SpotlightActionData } from '@mantine/spotlight';
-/**
- * Basalt-owned Spotlight actions (open/close/toggle), backed by a lazily-created
- * createSpotlight() store so @mantine/spotlight is only imported on first use.
- *
- * @example
- * import { basaltSpotlight } from 'basalt-ui/commands'
- * basaltSpotlight.open()
- */
-export declare const basaltSpotlight: {
-    open: () => void;
-    close: () => void;
-    toggle: () => void;
-};
-/** Open the basalt Spotlight palette programmatically. */
-export declare function openSpotlight(): void;
-/** Close the basalt Spotlight palette programmatically. */
-export declare function closeSpotlight(): void;
-export type BasaltOverlaysProps = {
-    /** Mount @mantine/modals ModalsProvider. Default: true. */
-    modals?: boolean;
-    /** Mount @mantine/spotlight Spotlight with mod+K shortcut. Default: true. */
-    spotlight?: boolean;
-    /** Mount @mantine/notifications Notifications overlay. Default: true. */
-    notifications?: boolean;
-    /**
-     * Activate @tanstack/react-hotkeys keybindings for all registered commands. Default: true.
-     * Degrades to no-op when @tanstack/react-hotkeys peer is absent — safe to leave enabled.
-     */
-    hotkeys?: boolean;
-    /** Override or extend the Notifications props (position, autoClose, limit, etc.). Defaults: position="bottom-right", autoClose=4000, limit=5. */
-    notificationsProps?: Omit<NotificationsProps, 'children'>;
-    /**
-     * Extra Spotlight actions merged with the command-projected actions — e.g.
-     * toRouteActions(nav, { onNavigate }) for page navigation. Rendered BEFORE the command actions
-     * and grouped by each action's `group`. A static snapshot, same as the command projection.
-     */
-    spotlightActions?: SpotlightActionData[];
-    /**
-     * Auto-project the registered command bus into Spotlight actions. Default: true. Set false when
-     * the app supplies the FULL action list itself via `spotlightActions` (e.g. to decorate commands
-     * with kind badges built from `toSpotlightActions()`) — this avoids the commands appearing twice.
-     */
-    projectCommands?: boolean;
-    /** App content (required). */
-    children: ReactNode;
-};
-/**
- * Composable overlay mount — renders ModalsProvider, Spotlight and Notifications as siblings of
- * `children`. All three layers are enabled by default; pass `false` to disable. A disabled layer's
- * optional peer is never imported.
- *
- * Mount exactly ONE BasaltOverlays per app — a second instance double-mounts `<Notifications />`.
- *
- * @example
- * <BasaltProvider>
- *   <BasaltOverlays>
- *     <RouterProvider router={router} />
- *   </BasaltOverlays>
- * </BasaltProvider>
- */
-export declare function BasaltOverlays({ modals: enableModals, spotlight: enableSpotlight, notifications: enableNotifications, hotkeys: enableHotkeys, notificationsProps, spotlightActions, projectCommands, children, }: BasaltOverlaysProps): import("react").JSX.Element;
-//# sourceMappingURL=overlays-mount.d.ts.map

package/dist/commands/overlays-mount.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"overlays-mount.d.ts","sourceRoot":"","sources":["../../src/commands/overlays-mount.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AAGrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAmC7D;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;gBAChB,IAAI;iBAGH,IAAI;kBAGH,IAAI;CAGjB,CAAA;AAID,0DAA0D;AAC1D,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAID,MAAM,MAAM,mBAAmB,GAAG;IAChC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,iJAAiJ;IACjJ,kBAAkB,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAA;IACzD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,CAAA;IACxC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,8BAA8B;IAC9B,QAAQ,EAAE,SAAS,CAAA;CACpB,CAAA;AAqHD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EAAE,YAAmB,EAC3B,SAAS,EAAE,eAAsB,EACjC,aAAa,EAAE,mBAA0B,EACzC,OAAO,EAAE,aAAoB,EAC7B,kBAAkB,EAClB,gBAAgB,EAChB,eAAsB,EACtB,QAAQ,GACT,EAAE,mBAAmB,+BAkCrB"}

package/dist/commands/overlays-mount.js

@@ -1,125 +0,0 @@
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { lazy, Suspense } from "react";
-import { runCommand } from "./define-commands.js";
-import { useModalsLayer } from "./define-overlays.js";
-import { toSpotlightActions } from "./projectors.js";
-import { useCommandHotkeys } from "./useCommandHotkeys.js";
-import { useNotificationsMountGuard } from "../notifications/mount-guard.js";
-let spotlightHandlePromise;
-function loadSpotlightHandle() {
-  spotlightHandlePromise ??= import("@mantine/spotlight").then(({ createSpotlight }) => {
-    const [store, actions] = createSpotlight();
-    return { store, actions };
-  }).catch(() => void 0);
-  return spotlightHandlePromise;
-}
-const basaltSpotlight = {
-  open: () => {
-    void loadSpotlightHandle().then((handle) => handle?.actions.open());
-  },
-  close: () => {
-    void loadSpotlightHandle().then((handle) => handle?.actions.close());
-  },
-  toggle: () => {
-    void loadSpotlightHandle().then((handle) => handle?.actions.toggle());
-  }
-};
-function openSpotlight() {
-  basaltSpotlight.open();
-}
-function closeSpotlight() {
-  basaltSpotlight.close();
-}
-function PassthroughFragment({ children }) {
-  return /* @__PURE__ */ jsx(Fragment, { children });
-}
-const LazyModalsProvider = lazy(
-  () => import("@mantine/modals").then((m) => ({ default: m.ModalsProvider })).catch(() => ({ default: PassthroughFragment }))
-);
-Object.assign(LazyModalsProvider, { displayName: "LazyModalsProvider" });
-function NullFallback() {
-  return null;
-}
-const LazySpotlightMount = lazy(
-  () => Promise.all([import("@mantine/spotlight"), loadSpotlightHandle()]).then(([{ Spotlight }, handle]) => {
-    if (handle === void 0) return { default: NullFallback };
-    const spotlightHandle = handle;
-    function SpotlightMountInner({
-      extraActions,
-      projectCommands = true
-    }) {
-      const commandActions = projectCommands ? toSpotlightActions((id) => {
-        spotlightHandle.actions.close();
-        void runCommand(id);
-      }) : [];
-      const actions = [...extraActions ?? [], ...commandActions];
-      return /* @__PURE__ */ jsx(
-        Spotlight,
-        {
-          store: spotlightHandle.store,
-          actions,
-          shortcut: "mod + K",
-          maxHeight: 420
-        }
-      );
-    }
-    return { default: SpotlightMountInner };
-  }).catch(() => ({ default: NullFallback }))
-);
-Object.assign(LazySpotlightMount, { displayName: "LazySpotlightMount" });
-function NotificationsFallback(_props) {
-  return null;
-}
-const LazyNotifications = lazy(
-  () => import("@mantine/notifications").then((m) => ({ default: m.Notifications })).catch(() => ({ default: NotificationsFallback }))
-);
-Object.assign(LazyNotifications, { displayName: "LazyNotifications" });
-function NotificationsLayer({
-  notificationsProps
-}) {
-  useNotificationsMountGuard();
-  return /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(
-    LazyNotifications,
-    {
-      position: "bottom-right",
-      autoClose: 4e3,
-      limit: 5,
-      ...notificationsProps
-    }
-  ) });
-}
-function HotkeysMount() {
-  useCommandHotkeys();
-  return null;
-}
-function BasaltOverlays({
-  modals: enableModals = true,
-  spotlight: enableSpotlight = true,
-  notifications: enableNotifications = true,
-  hotkeys: enableHotkeys = true,
-  notificationsProps,
-  spotlightActions,
-  projectCommands = true,
-  children
-}) {
-  useModalsLayer(enableModals);
-  return /* @__PURE__ */ jsxs(Fragment, { children: [
-    enableSpotlight && /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(
-      LazySpotlightMount,
-      {
-        projectCommands,
-        ...spotlightActions !== void 0 && { extraActions: spotlightActions }
-      }
-    ) }),
-    enableNotifications && /* @__PURE__ */ jsx(NotificationsLayer, { notificationsProps }),
-    enableHotkeys && /* @__PURE__ */ jsx(HotkeysMount, {}),
-    enableModals && /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(LazyModalsProvider, {}) }),
-    children
-  ] });
-}
-export {
-  BasaltOverlays,
-  basaltSpotlight,
-  closeSpotlight,
-  openSpotlight
-};

package/dist/commands/useCommandHotkeys.d.ts

@@ -1,14 +0,0 @@
-/**
- * Reads the active command registry and binds each command's `shortcut` to its `run()` via
- * the @tanstack/react-hotkeys HotkeyManager singleton. Degrades to a no-op when the optional
- * peer is absent.
- *
- * Registers on mount, unregisters on unmount. Re-runs whenever the effect deps change.
- * Commands without a shortcut are skipped. Commands where `when()` returns false at press time
- * are silently skipped (the binding stays registered; the when-gate fires in the callback).
- *
- * @example
- * useCommandHotkeys()
- */
-export declare function useCommandHotkeys(): void;
-//# sourceMappingURL=useCommandHotkeys.d.ts.map

package/dist/commands/useCommandHotkeys.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useCommandHotkeys.d.ts","sourceRoot":"","sources":["../../src/commands/useCommandHotkeys.ts"],"names":[],"mappings":"AAqDA;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAgDxC"}

package/dist/commands/useCommandHotkeys.js

@@ -1,45 +0,0 @@
-import { useEffect } from "react";
-import { getActiveCommands } from "./define-commands.js";
-function useCommandHotkeys() {
-  useEffect(() => {
-    let handles = [];
-    let cancelled = false;
-    const bind = async () => {
-      let peer;
-      try {
-        peer = await import("@tanstack/react-hotkeys");
-      } catch {
-        return;
-      }
-      if (cancelled) return;
-      if (typeof peer.getHotkeyManager !== "function") return;
-      const manager = peer.getHotkeyManager();
-      const cmds = getActiveCommands();
-      for (const [, cmd] of Object.entries(cmds)) {
-        if (cmd.shortcut === void 0) continue;
-        const handle = manager.register(
-          cmd.shortcut,
-          (event) => {
-            if (cmd.when !== void 0 && !cmd.when()) return;
-            event.preventDefault();
-            void cmd.run();
-          },
-          // preventDefault: false — we handle it manually above, gated on when()
-          { preventDefault: false }
-        );
-        handles.push(handle);
-      }
-    };
-    void bind();
-    return () => {
-      cancelled = true;
-      for (const handle of handles) {
-        handle.unregister();
-      }
-      handles = [];
-    };
-  }, []);
-}
-export {
-  useCommandHotkeys
-};

package/dist/content/article-actions.d.ts

@@ -1,39 +0,0 @@
-/**
- * toArticleActions — projects an article list into Mantine Spotlight actions
- * (docs/CONTENT-SPEC.md). A pure in-memory PROJECTOR into the already-shipped Spotlight surface —
- * the same tier as `toRouteActions` (`basalt-ui/commands`). It does not tokenize, rank, index, or
- * persist; an app that outgrows substring matching brings its own index.
- *
- * `SpotlightActionData` is imported TYPE-ONLY — it erases at build, so `./content` stays a types-
- * only optional peer of `@mantine/spotlight` and adds no runtime edge. The consumer merges the
- * result into its own `<Spotlight>`/`toSpotlightActions()` action array.
- *
- * @example
- * const articleActions = toArticleActions(ARTICLES, {
- *   onNavigate: (href) => router.navigate({ to: href as never }),
- *   href: (article) => (article.slug === 'reading-dashboards' ? '/content' : '#'),
- *   group: 'Guides',
- * })
- */
-import type { SpotlightActionData } from '@mantine/spotlight';
-import type { ReactNode } from 'react';
-import type { Article } from './article-model.js';
-export type ToArticleActionsOptions = {
-    /** Navigate to an article's href — e.g. `(href) => router.navigate({ to: href })`. */
-    onNavigate: (href: string) => void;
-    /** Consumer owns routing — maps an article to its destination href. */
-    href: (article: Article) => string;
-    /** Prefix for generated action ids so they never collide with route/command ids. Default 'article:'. */
-    idPrefix?: string;
-    /** Spotlight group for every produced action (e.g. 'Guides'). Omit for an ungrouped, flat list. */
-    group?: string;
-    /** Node rendered on the right of every action — e.g. a kind badge (`<Badge>Guide</Badge>`). */
-    rightSection?: ReactNode;
-};
-/**
- * Project an article list into Mantine Spotlight actions. `keywords` joins title, description,
- * category, tags, and slug — this is why tags/category live on the model, they make an article
- * findable by topic even when the title itself doesn't mention it.
- */
-export declare function toArticleActions(articles: readonly Article[], options: ToArticleActionsOptions): SpotlightActionData[];
-//# sourceMappingURL=article-actions.d.ts.map

package/dist/content/article-actions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"article-actions.d.ts","sourceRoot":"","sources":["../../src/content/article-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAE9C,MAAM,MAAM,uBAAuB,GAAG;IACpC,sFAAsF;IACtF,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,uEAAuE;IACvE,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAA;IAClC,wGAAwG;IACxG,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mGAAmG;IACnG,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+FAA+F;IAC/F,YAAY,CAAC,EAAE,SAAS,CAAA;CACzB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,OAAO,EAAE,uBAAuB,GAC/B,mBAAmB,EAAE,CA6BvB"}

package/dist/content/article-actions.js

@@ -1,28 +0,0 @@
-function toArticleActions(articles, options) {
-  const { onNavigate, href, idPrefix = "article:", group, rightSection } = options;
-  const actions = [];
-  for (const article of articles) {
-    const target = href(article);
-    const keywords = [
-      article.title,
-      article.description,
-      article.category,
-      ...article.tags ?? [],
-      article.slug
-    ].filter((part) => part !== void 0).join(" ");
-    const action = {
-      id: `${idPrefix}${target}`,
-      label: article.title,
-      keywords,
-      onClick: () => onNavigate(target)
-    };
-    if (article.description !== void 0) action.description = article.description;
-    if (group !== void 0) action.group = group;
-    if (rightSection !== void 0) action.rightSection = rightSection;
-    actions.push(action);
-  }
-  return actions;
-}
-export {
-  toArticleActions
-};

package/dist/content/article-card.d.ts

@@ -1,58 +0,0 @@
-/**
- * ArticleCard / ArticleGrid — the docs-landing overview building blocks (docs/CONTENT-SPEC.md
- * §3/§7): an icon/title/description/meta card over the shipped `Card` chrome, and the responsive
- * grid that lays a set of them out.
- *
- * `ArticleCard` is clickable three ways — pick whichever fits: `href` alone renders the `Card`
- * itself as an anchor; `href` + `renderLink` hands the card to a router bridge (e.g. TanStack
- * `Link`); `onClick` alone renders a keyboard-operable button-role card. Omit all three for a
- * static, non-interactive card.
- *
- * @example
- * import { ArticleCard, ArticleGrid } from 'basalt-ui/content'
- * import { Link } from '@tanstack/react-router'
- *
- * <ArticleGrid>
- *   <ArticleCard
- *     title="Reading dashboards"
- *     description="Why most internal dashboards fail the five-second glance test."
- *     date="2026-07-16"
- *     readingTime={6}
- *     category="guide"
- *     tags={['dashboards', 'ux']}
- *     href="/content"
- *     renderLink={(target, node) => <Link to={target.href}>{node}</Link>}
- *   />
- * </ArticleGrid>
- */
-import type { CSSProperties, ReactNode } from 'react';
-import type { ArticleNavTarget } from './article-layout.js';
-export type ArticleCardProps = {
-    readonly title: string;
-    readonly description?: string;
-    readonly icon?: ReactNode;
-    /** ISO 8601 — rendered via `formatArticleDate`. */
-    readonly date?: string;
-    readonly category?: string;
-    readonly tags?: readonly string[];
-    /** Minutes; rendered as `"N min read"`. */
-    readonly readingTime?: number;
-    /** Locale passed to `formatArticleDate`. Default `'en-US'` — see its JSDoc for why this is
-     * pinned rather than defaulting to the runtime locale. */
-    readonly locale?: string;
-    readonly href?: string;
-    /** Router bridge — when given alongside `href`, the card is handed to it instead of rendering a
-     * plain anchor itself. */
-    readonly renderLink?: (target: ArticleNavTarget, node: ReactNode) => ReactNode;
-    readonly onClick?: () => void;
-    readonly className?: string;
-    readonly style?: CSSProperties;
-};
-export declare function ArticleCard({ title, description, icon, date, category, tags, readingTime, locale, href, renderLink, onClick, className, style, }: ArticleCardProps): import("react").JSX.Element;
-export type ArticleGridProps = {
-    readonly children: ReactNode;
-    /** Columns at the `lg` breakpoint. Default `3`. */
-    readonly cols?: number;
-};
-export declare function ArticleGrid({ children, cols }: ArticleGridProps): import("react").JSX.Element;
-//# sourceMappingURL=article-card.d.ts.map

package/dist/content/article-card.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"article-card.d.ts","sourceRoot":"","sources":["../../src/content/article-card.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAIrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B;8DAC0D;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB;8BAC0B;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,KAAK,SAAS,CAAA;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAA;CAC/B,CAAA;AAMD,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,WAAW,EACX,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,WAAW,EACX,MAAgB,EAChB,IAAI,EACJ,UAAU,EACV,OAAO,EACP,SAAS,EACT,KAAK,GACN,EAAE,gBAAgB,+BAqFlB;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,IAAQ,EAAE,EAAE,gBAAgB,+BAOnE"}

package/dist/content/article-card.js

@@ -1,79 +0,0 @@
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { Card, SimpleGrid } from "@mantine/core";
-import classes from "./article-card.module.css";
-import { formatArticleDate } from "./article-model.js";
-const CARD_STYLE = {
-  padding: "var(--mantine-spacing-xs) var(--mantine-spacing-sm)"
-};
-function ArticleCard({
-  title,
-  description,
-  icon,
-  date,
-  category,
-  tags,
-  readingTime,
-  locale = "en-US",
-  href,
-  renderLink,
-  onClick,
-  className,
-  style
-}) {
-  const cardClass = [
-    classes.card,
-    (href !== void 0 || onClick !== void 0) && classes.clickable,
-    className
-  ].filter(Boolean).join(" ");
-  const mergedStyle = { ...CARD_STYLE, ...style };
-  const meta = [
-    date !== void 0 ? formatArticleDate(date, locale) : void 0,
-    readingTime !== void 0 ? `${readingTime} min read` : void 0,
-    category
-  ].filter((part) => part !== void 0).join(" \xB7 ");
-  const body = /* @__PURE__ */ jsxs(Fragment, { children: [
-    icon !== void 0 && /* @__PURE__ */ jsx("span", { className: classes.icon, children: icon }),
-    /* @__PURE__ */ jsx("span", { className: classes.title, children: title }),
-    description !== void 0 && /* @__PURE__ */ jsx("span", { className: classes.description, children: description }),
-    tags !== void 0 && tags.length > 0 && /* @__PURE__ */ jsx("span", { className: classes.tags, children: tags.map((tag) => /* @__PURE__ */ jsx("span", { className: classes.tag, children: tag }, tag)) }),
-    meta !== "" && /* @__PURE__ */ jsx("span", { className: classes.meta, children: meta })
-  ] });
-  if (href !== void 0 && renderLink !== void 0) {
-    const target = {
-      label: title,
-      href,
-      ...description !== void 0 && { description }
-    };
-    return /* @__PURE__ */ jsx("span", { className: classes.linkWrap, children: renderLink(
-      target,
-      /* @__PURE__ */ jsx(Card, { className: cardClass, style: mergedStyle, children: body })
-    ) });
-  }
-  if (href !== void 0) {
-    return /* @__PURE__ */ jsx(Card, { component: "a", href, className: cardClass, style: mergedStyle, children: body });
-  }
-  if (onClick !== void 0) {
-    return /* @__PURE__ */ jsx(
-      Card,
-      {
-        component: "button",
-        type: "button",
-        onClick,
-        className: cardClass,
-        style: mergedStyle,
-        children: body
-      }
-    );
-  }
-  return /* @__PURE__ */ jsx(Card, { className: cardClass, style: mergedStyle, children: body });
-}
-function ArticleGrid({ children, cols = 3 }) {
-  return (
-    // theme-allow raw-breakpoint — `cols` is documented per viewport `lg`; container keys would re-flow every consumer's grid, so that move ships opt-in
-    /* @__PURE__ */ jsx(SimpleGrid, { cols: { base: 1, sm: 2, lg: cols }, spacing: "sm", children })
-  );
-}
-export {
-  ArticleCard,
-  ArticleGrid
-};

package/dist/content/article-card.module.css

@@ -1,111 +0,0 @@
-/*
- * ArticleCard — the docs-landing overview building block (docs/CONTENT-SPEC.md §3/§7): panel bg +
- * shadow-card + card-radius (inherited from the shipped `Card` theme, same as StatCard/
- * SettingsSection), a clickable whole-card affordance when `href`/`onClick` is given.
- */
-
-.card {
-  display: flex;
-  flex-direction: column;
-  gap: var(--vx-space-stack-sm);
-  text-decoration: none;
-  color: inherit;
-}
-
-/* The `renderLink` router bridge renders a consumer anchor around the card — neutralize the
- * browser anchor defaults it brings, and keep the grid cell's full height flowing through. */
-.linkWrap {
-  display: block;
-  height: 100%;
-}
-
-.linkWrap a {
-  display: block;
-  height: 100%;
-  text-decoration: none;
-  color: inherit;
-}
-
-.clickable {
-  cursor: pointer;
-  transition: background-color 120ms ease;
-  /* Native-`<button>` reset — ArticleCard's `onClick`-only variant renders `Card component="button"`
-   * for real keyboard/AT semantics. The browser's UA-origin button chrome (border, font, text-align)
-   * always loses to Card's own authored background/shadow/radius, but these three properties are
-   * NOT set by Card itself, so the button's UA defaults would otherwise leak through. */
-  width: 100%;
-  border: none;
-  font: inherit;
-  text-align: inherit;
-}
-
-.clickable:hover,
-.clickable:focus-visible {
-  background-color: var(--vx-surface-panel-hover);
-}
-
-.clickable:hover .title,
-.clickable:focus-visible .title {
-  color: var(--vx-accent);
-}
-
-.clickable:focus-visible {
-  /* Focus-ring width/offset — paired with (and sized off) the outline's own 2px stroke, not a
-   * spacing gap; out of scope like a border-shorthand width. */
-  outline: 2px solid var(--vx-accent);
-  outline-offset: 2px;
-}
-
-.icon {
-  display: flex;
-  color: var(--vx-muted);
-}
-
-.title {
-  font-family: var(--basalt-font-head);
-  font-stretch: 88%;
-  font-weight: 550;
-  font-size: var(--vx-text-md);
-  color: var(--vx-ink);
-  transition: color 120ms ease;
-}
-
-.description {
-  font-size: var(--vx-text-sm);
-  color: var(--vx-ink2);
-  display: -webkit-box;
-  -webkit-line-clamp: 2;
-  -webkit-box-orient: vertical;
-  overflow: hidden;
-}
-
-/* Quiet — a data label, not a status. Muted text on a faint ink tint, same recipe as the code
- * block/callout/prose surfaces (`color-mix(in srgb, var(--vx-ink) 6%, transparent)`); no accent,
- * no status color. */
-.tags {
-  display: flex;
-  flex-wrap: wrap;
-  gap: var(--vx-space-article-card-tags-gap);
-}
-
-.tag {
-  padding: var(--vx-space-article-card-tag-inset-y) var(--vx-space-article-card-tag-inset-x);
-  border-radius: var(--vx-radius-fine);
-  background-color: color-mix(in srgb, var(--vx-ink) 6%, transparent);
-  color: var(--vx-muted);
-  font-size: var(--vx-text-micro);
-}
-
-/* Pinned to the card's floor, not floated up behind a short description: the grid stretches every
- * card in a row to one height, so a content-following meta line lands at a different y in each
- * card and the row reads ragged. `margin-top: auto` in the card's flex column gives the row one
- * meta baseline regardless of how many lines each description clamps to. */
-.meta {
-  margin-top: auto;
-  padding-top: var(--vx-space-article-card-meta-gap-top);
-  font-family: var(--basalt-font-mono);
-  font-size: var(--vx-text-micro);
-  letter-spacing: 0.06em;
-  text-transform: uppercase;
-  color: var(--vx-faint);
-}

package/dist/content/mdx.d.ts

@@ -1,20 +0,0 @@
-import type { Components } from 'react-markdown';
-import { SlugTracker } from './slug.js';
-export type CreateMdxComponentsOptions = {
-    /** Reuse an existing tracker — e.g. to share heading ids with a `TableOfContents` collecting
-     * over the same rendered document. Omit for a fresh, page-scoped tracker. */
-    readonly slugTracker?: SlugTracker;
-};
-/** Builds the MDX element map (slugged/anchored headings, code/mermaid fences, alert-aware
- * blockquotes, external-link treatment). Pass `slugTracker` to share ids across components
- * rendering the same document; omit it to get a fresh tracker per call. */
-export declare function createMdxComponents(options?: CreateMdxComponentsOptions): Components;
-/**
- * A ready-to-use element map for simple cases. Built ONCE at module scope with its own
- * `SlugTracker` — every consumer of this constant shares that single tracker for the lifetime of
- * the app, so a heading text repeated across two DIFFERENT MDX documents will get a `-1`-suffixed
- * id on the second document, not a fresh `overview` on both. Reach for `createMdxComponents()`
- * (called per document/render) instead when that matters — e.g. a multi-document docs site.
- */
-export declare const mdxComponents: Components;
-//# sourceMappingURL=mdx.d.ts.map

package/dist/content/mdx.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mdx.d.ts","sourceRoot":"","sources":["../../src/content/mdx.tsx"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,gBAAgB,CAAA;AAM5D,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAgEpC,MAAM,MAAM,0BAA0B,GAAG;IACvC;iFAC6E;IAC7E,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAA;CACnC,CAAA;AAED;;2EAE2E;AAC3E,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,UAAU,CAQxF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,UAAkC,CAAA"}