@astryxdesign/core 0.2.0 → 0.3.0-canary.041a0ef

package/src/theme/useTheme.ts

@@ -5,17 +5,17 @@
 /**
  * @file useTheme.ts
  * @input ThemeContext provided by Theme
- * @output Exports useTheme hook for programmatic access to resolved theme tokens
+ * @output Exports useTheme and useThemeName hooks for programmatic theme access
  * @position Theme hook; used by data viz, canvas, and non-CSS consumers
  *
  * Provides synchronous access to theme token values resolved for the
  * current color mode — no DOM reads on the provider path, no double render.
- * Without a reachable ThemeContext it consults `<html data-theme>` (kept in
- * sync by Theme) via a single shared, refcounted MutationObserver before
- * assuming OS preference; provider-path consumers subscribe to a no-op
- * store instead (the same args-switch technique useMediaQuery uses), so
- * mounting under a Theme never creates an observer. Token resolution is
- * shared with the server-safe helpers in ./tokens.ts.
+ * Without a reachable ThemeContext it consults `<html data-theme>` and
+ * `<html data-astryx-theme>` (kept in sync by Theme) via shared, refcounted
+ * MutationObservers before assuming OS preference/default tokens. Provider-path
+ * consumers subscribe to no-op stores instead, so mounting under a Theme never
+ * creates an observer. Token resolution is shared with the server-safe helpers
+ * in ./tokens.ts.
  *
  * SYNC: When modified, update:
  * - /packages/core/src/theme/index.ts
@@ -25,6 +25,8 @@ import {createContext, use, useMemo, useSyncExternalStore} from 'react';
 import type {ThemeMode} from './types';
 import type {DefinedTheme} from './defineTheme';
 import {resolveThemeTokens} from './tokens';
+import {getRegisteredTheme} from './themeRegistry';
+import {dataAttr} from '../naming';
 import {useMediaQuery} from '../hooks/useMediaQuery';
 
 // =============================================================================
@@ -92,7 +94,7 @@ export interface UseThemeReturn {
 // Hook
 // =============================================================================
 
-function getRootThemeAttrSnapshot(): 'light' | 'dark' | null {
+function getRootModeAttrSnapshot(): 'light' | 'dark' | null {
   if (typeof document === 'undefined') {
     return null;
   }
@@ -100,45 +102,88 @@ function getRootThemeAttrSnapshot(): 'light' | 'dark' | null {
   return attr === 'light' || attr === 'dark' ? attr : null;
 }
 
-function getRootThemeAttrServerSnapshot(): 'light' | 'dark' | null {
+function getRootModeAttrServerSnapshot(): 'light' | 'dark' | null {
   return null;
 }
 
-function getNullThemeMode(): null {
+function getRootNameAttrSnapshot(): string | null {
+  if (typeof document === 'undefined') {
+    return null;
+  }
+  return document.documentElement.getAttribute(dataAttr('theme'));
+}
+
+function getRootNameAttrServerSnapshot(): string | null {
+  return null;
+}
+
+function getNullThemeSnapshot(): null {
   return null;
 }
 
 // Every no-context consumer wants the same <html data-theme> attribute, so
 // one MutationObserver — refcounted via this listener set — serves all of
 // them instead of one per consumer.
-const rootThemeAttrListeners = new Set<() => void>();
-let rootThemeAttrObserver: MutationObserver | null = null;
+const rootModeAttrListeners = new Set<() => void>();
+let rootModeAttrObserver: MutationObserver | null = null;
 
-function notifyRootThemeAttrListeners(): void {
-  for (const listener of rootThemeAttrListeners) {
+const rootNameAttrListeners = new Set<() => void>();
+let rootNameAttrObserver: MutationObserver | null = null;
+
+function notifyRootModeAttrListeners(): void {
+  for (const listener of rootModeAttrListeners) {
     listener();
   }
 }
 
-function subscribeRootThemeAttr(onStoreChange: () => void): () => void {
-  rootThemeAttrListeners.add(onStoreChange);
+function subscribeRootModeAttr(onStoreChange: () => void): () => void {
+  rootModeAttrListeners.add(onStoreChange);
 
   if (
-    rootThemeAttrListeners.size === 1 &&
+    rootModeAttrListeners.size === 1 &&
     typeof MutationObserver !== 'undefined'
   ) {
-    rootThemeAttrObserver = new MutationObserver(notifyRootThemeAttrListeners);
-    rootThemeAttrObserver.observe(document.documentElement, {
+    rootModeAttrObserver = new MutationObserver(notifyRootModeAttrListeners);
+    rootModeAttrObserver.observe(document.documentElement, {
       attributes: true,
       attributeFilter: ['data-theme'],
     });
   }
 
   return () => {
-    rootThemeAttrListeners.delete(onStoreChange);
-    if (rootThemeAttrListeners.size === 0 && rootThemeAttrObserver) {
-      rootThemeAttrObserver.disconnect();
-      rootThemeAttrObserver = null;
+    rootModeAttrListeners.delete(onStoreChange);
+    if (rootModeAttrListeners.size === 0 && rootModeAttrObserver) {
+      rootModeAttrObserver.disconnect();
+      rootModeAttrObserver = null;
+    }
+  };
+}
+
+function notifyRootNameAttrListeners(): void {
+  for (const listener of rootNameAttrListeners) {
+    listener();
+  }
+}
+
+function subscribeRootNameAttr(onStoreChange: () => void): () => void {
+  rootNameAttrListeners.add(onStoreChange);
+
+  if (
+    rootNameAttrListeners.size === 1 &&
+    typeof MutationObserver !== 'undefined'
+  ) {
+    rootNameAttrObserver = new MutationObserver(notifyRootNameAttrListeners);
+    rootNameAttrObserver.observe(document.documentElement, {
+      attributes: true,
+      attributeFilter: [dataAttr('theme')],
+    });
+  }
+
+  return () => {
+    rootNameAttrListeners.delete(onStoreChange);
+    if (rootNameAttrListeners.size === 0 && rootNameAttrObserver) {
+      rootNameAttrObserver.disconnect();
+      rootNameAttrObserver = null;
     }
   };
 }
@@ -154,14 +199,38 @@ function subscribeNoop(): () => void {
  * a no-op store when a ThemeContext exists — instead of skipping the hook
  * call, so provider-path consumers never touch the DOM or the observer.
  */
-function useRootThemeModeAttr(hasCtx: boolean): 'light' | 'dark' | null {
+function useRootModeAttr(hasCtx: boolean): 'light' | 'dark' | null {
+  return useSyncExternalStore(
+    hasCtx ? subscribeNoop : subscribeRootModeAttr,
+    hasCtx ? getNullThemeSnapshot : getRootModeAttrSnapshot,
+    getRootModeAttrServerSnapshot,
+  );
+}
+
+function useRootThemeNameAttr(hasCtx: boolean): string | null {
   return useSyncExternalStore(
-    hasCtx ? subscribeNoop : subscribeRootThemeAttr,
-    hasCtx ? getNullThemeMode : getRootThemeAttrSnapshot,
-    getRootThemeAttrServerSnapshot,
+    hasCtx ? subscribeNoop : subscribeRootNameAttr,
+    hasCtx ? getNullThemeSnapshot : getRootNameAttrSnapshot,
+    getRootNameAttrServerSnapshot,
   );
 }
 
+/**
+ * Return the nearest active Astryx theme name.
+ *
+ * Uses ThemeContext when present and otherwise follows the root Theme's
+ * <html data-astryx-theme> attribute. This is intentionally lighter than
+ * useTheme() for consumers that only need theme identity, such as semantic
+ * icon resolution.
+ */
+export function useThemeName(): string | null {
+  const ctx = use(ThemeContext);
+  const hasCtx = ctx != null;
+  const rootThemeName = useRootThemeNameAttr(hasCtx);
+
+  return ctx?.theme.name ?? rootThemeName;
+}
+
 /**
  * Access the current Astryx theme's token values, resolved for the active color mode.
  *
@@ -193,13 +262,15 @@ export function useTheme(): UseThemeReturn {
   // Falls back to the root Theme's mode via <html data-theme> when there's
   // no ThemeContext ancestor (e.g. useToast's detached fallback viewport).
   // Resolves to null when `ctx` is present, so it has no effect there.
-  const rootAttrMode = useRootThemeModeAttr(ctx != null);
+  const hasCtx = ctx != null;
+  const rootAttrMode = useRootModeAttr(hasCtx);
+  const rootThemeName = useRootThemeNameAttr(hasCtx);
 
   // Resolve 'system' to 'light' | 'dark' using the OS preference
   const prefersDark = useMediaQuery('(prefers-color-scheme: dark)');
 
   const mode = ctx?.mode ?? rootAttrMode ?? 'system';
-  const theme = ctx?.theme ?? null;
+  const theme = ctx?.theme ?? getRegisteredTheme(rootThemeName);
 
   const effectiveMode: 'light' | 'dark' =
     mode === 'system' ? (prefersDark ? 'dark' : 'light') : mode;

package/src/utils/focusOutline.stylex.ts

@@ -0,0 +1,128 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file focusOutline.stylex.ts
+ * @input Uses StyleX and theme color tokens
+ * @output Exports shared focus-outline prop builders
+ * @position Internal utility for consistent keyboard focus outlines across core components
+ *
+ * Centralizes the standard Astryx focus outline, shown only for keyboard focus.
+ * Every focusable surface drew the same 2px accent ring at 2px offset already;
+ * writing it per component meant five identical definitions to keep in step.
+ *
+ * These are utility styles, deliberately NOT a theme target. A shared
+ * `astryx-focus-outline` class was tried and pulled: a theme can only override
+ * the ring unconditionally through it (`generateThemeRules` mangles
+ * `:focus-visible` into `.focus-visible` and truncates `:has(:focus-visible)`
+ * at the paren), so the one thing such a target exists for — restyling a
+ * STATE — is exactly what it cannot express. Making focus outlines themeable
+ * is worth doing on top of this consolidation, once that is fixed.
+ */
+
+import * as stylex from '@stylexjs/stylex';
+import {colorVars} from '../theme/tokens.stylex';
+
+const FOCUS_OUTLINE_WIDTH = '2px';
+// 3px, per Design Conventions §User Interaction States: "2px --color-accent
+// outline at 3px offset". Most components had drifted to 2px; Button, Calendar,
+// Dialog and Pagination were the ones matching the spec, so the consolidation
+// takes their value rather than the majority's.
+const FOCUS_OUTLINE_OFFSET = '3px';
+const FOCUS_OUTLINE_COLOR = colorVars['--color-accent'];
+
+/**
+ * Written as longhands rather than the `outline` shorthand.
+ *
+ * A shorthand resets every longhand it covers, so `outline: 2px solid accent`
+ * would clobber a later `outlineColor` no matter the order — which is how
+ * destructive buttons silently lost their red ring. With longhands, a variant
+ * can re-color the ring and inherit width, style and offset.
+ */
+const focusOutlineLonghands = {
+  outlineWidth: FOCUS_OUTLINE_WIDTH,
+  outlineStyle: 'solid',
+  outlineColor: FOCUS_OUTLINE_COLOR,
+} as const;
+
+export const focusOutlineStyles = stylex.create({
+  focusVisible: {
+    outlineWidth: {
+      default: '0',
+      ':focus-visible': focusOutlineLonghands.outlineWidth,
+    },
+    outlineStyle: {
+      default: 'none',
+      ':focus-visible': focusOutlineLonghands.outlineStyle,
+    },
+    outlineColor: {
+      default: null,
+      ':focus-visible': focusOutlineLonghands.outlineColor,
+    },
+    outlineOffset: {default: '0', ':focus-visible': FOCUS_OUTLINE_OFFSET},
+  },
+  focusWithin: {
+    outlineWidth: {
+      default: '0',
+      ':has(:focus-visible)': focusOutlineLonghands.outlineWidth,
+    },
+    outlineStyle: {
+      default: 'none',
+      ':has(:focus-visible)': focusOutlineLonghands.outlineStyle,
+    },
+    outlineColor: {
+      default: null,
+      ':has(:focus-visible)': focusOutlineLonghands.outlineColor,
+    },
+    outlineOffset: {default: '0', ':has(:focus-visible)': FOCUS_OUTLINE_OFFSET},
+  },
+  publishFocusVisibleVars: {
+    '--_focus-outline': {
+      default: 'none',
+      ':focus-visible': `${FOCUS_OUTLINE_WIDTH} solid ${FOCUS_OUTLINE_COLOR}`,
+    },
+    '--_focus-outline-offset': {
+      default: '0',
+      ':focus-visible': FOCUS_OUTLINE_OFFSET,
+    },
+  },
+  focusWithinOrPublished: {
+    outline: {
+      default: 'var(--_focus-outline, none)',
+      ':has(:focus-visible)': `${FOCUS_OUTLINE_WIDTH} solid ${FOCUS_OUTLINE_COLOR}`,
+    },
+    outlineOffset: {
+      default: 'var(--_focus-outline-offset, 0)',
+      ':has(:focus-visible)': FOCUS_OUTLINE_OFFSET,
+    },
+  },
+});
+
+// StyleX does not expose a stable public input type for stylex.props();
+// keep this helper permissive so it mirrors stylex.props() itself.
+type StyleXPropsArg = unknown;
+
+function makeFocusOutlineProps(style: StyleXPropsArg) {
+  return (...styles: StyleXPropsArg[]) =>
+    // Caller styles LAST, so a component can deliberately re-color its ring —
+    // destructive buttons ring in error red, not accent. StyleX is last-wins,
+    // and reversing this to protect the ring silently ate that override.
+    //
+    // The hazard in this direction is the opposite one: a caller whose base
+    // style carries `outline: 'none'` wipes the ring out entirely (TreeList
+    // did, and shipped a focusable row with no visible focus). Two things
+    // guard it — this file states the rule, and the ring is written as
+    // LONGHANDS, so an override has to name `outlineStyle`/`outlineWidth`
+    // explicitly rather than erasing them through the `outline` shorthand.
+    stylex.props(style as never, ...(styles as never[]));
+}
+
+export const focusOutlineProps = {
+  focusVisible: makeFocusOutlineProps(focusOutlineStyles.focusVisible),
+  focusWithin: makeFocusOutlineProps(focusOutlineStyles.focusWithin),
+  publishFocusVisibleVars: makeFocusOutlineProps(
+    focusOutlineStyles.publishFocusVisibleVars,
+  ),
+  focusWithinOrPublished: makeFocusOutlineProps(
+    focusOutlineStyles.focusWithinOrPublished,
+  ),
+} as const;

package/src/utils/rtlStyles.ts

@@ -4,8 +4,8 @@
  * @file rtlStyles.ts
  * @input None
  * @output Shared StyleX style that horizontally mirrors an element under RTL
- * @position Core utility; applied to directional-icon wrappers in Calendar,
- *   Lightbox, and the Table expand/disclosure plugins
+ * @position Core utility; applied to directional icons in Calendar, Lightbox,
+ *   Pagination, Carousel and the Table expand/disclosure plugins
  *
  * `mirror` flips its element on the horizontal axis only when an ancestor
  * carries `dir="rtl"`. Using `scaleX(-1)` (not `scale(-1, -1)`) keeps the
@@ -14,6 +14,23 @@
  * down when expanded under RTL. The `:is([dir="rtl"] *)` selector matches the
  * MobileNav drawer convention; a bare `direction: rtl` alone won't trigger it.
  *
+ * `centerInline(blockOffset?)` horizontally centers an absolutely-positioned,
+ * auto-width element on the inline axis, correctly in BOTH LTR and RTL, with an
+ * optional block-axis (Y) offset composed into the same transform. It
+ * intentionally uses PHYSICAL `left: 50%` + `translateX(-50%)`: both reference
+ * the same physical edge, so the pair is direction-symmetric and centers
+ * identically regardless of `dir`. A logical `insetInlineStart: 50%` would flip
+ * the anchor edge in RTL while the physical translate does not, leaving the
+ * element off-center by its own width (centered in LTR, broken in RTL). This is
+ * the one case where physical `left` is the correct choice, so the
+ * `no-physical-properties` suppression lives here ONCE rather than at each call
+ * site. The `@astryx/no-physical-properties` lint recognises this exact pattern
+ * and points offenders here.
+ *
+ * `blockOffset` is any CSS length/percentage for translateY (pass `'0px'` for
+ * none): e.g. `centerInline('100%')` sits the element one full height below its
+ * anchor, `centerInline('-50%')` centers it on both axes.
+ *
  * SYNC: When modified, update:
  * - /packages/core/src/utils/index.ts
  */
@@ -24,4 +41,9 @@ export const rtlStyles = stylex.create({
   mirror: {
     transform: {default: null, ':is([dir="rtl"] *)': 'scaleX(-1)'},
   },
+  centerInline: (blockOffset: string) => ({
+    // eslint-disable-next-line @astryx/no-physical-properties -- intentional: physical left+translateX(-50%) is direction-symmetric and the correct way to center; a logical anchor would break RTL centering (see file header).
+    left: '50%',
+    transform: `translate(-50%, ${blockOffset})`,
+  }),
 });

package/dist/NavMenu/NavMenuItem.d.ts

@@ -1,13 +0,0 @@
-/**
- * @file NavMenuItem.tsx
- * @input NavHeadingMenuItem
- * @output Exports deprecated NavMenuItem alias
- * @position Compatibility re-export; prefer NavHeadingMenuItem
- */
-import { NavHeadingMenuItem } from './NavHeadingMenuItem';
-import type { NavHeadingMenuItemProps } from './NavHeadingMenuItem';
-/** @deprecated Use NavHeadingMenuItem instead. */
-export type NavMenuItemProps = NavHeadingMenuItemProps;
-/** @deprecated Use NavHeadingMenuItem instead. */
-export declare const NavMenuItem: typeof NavHeadingMenuItem;
-//# sourceMappingURL=NavMenuItem.d.ts.map

package/dist/NavMenu/NavMenuItem.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"NavMenuItem.d.ts","sourceRoot":"","sources":["../../src/NavMenu/NavMenuItem.tsx"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,sBAAsB,CAAC;AAElE,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEvD,kDAAkD;AAClD,eAAO,MAAM,WAAW,2BAAqB,CAAC"}

package/dist/NavMenu/NavMenuItem.js

@@ -1,16 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-'use client';
-
-/**
- * @file NavMenuItem.tsx
- * @input NavHeadingMenuItem
- * @output Exports deprecated NavMenuItem alias
- * @position Compatibility re-export; prefer NavHeadingMenuItem
- */
-import { NavHeadingMenuItem } from "./NavHeadingMenuItem.js";
-
-/** @deprecated Use NavHeadingMenuItem instead. */
-
-/** @deprecated Use NavHeadingMenuItem instead. */
-export const NavMenuItem = NavHeadingMenuItem;

package/dist/Thumbnail/thumbnail.markers.stylex.d.ts

@@ -1,9 +0,0 @@
-import * as stylex from '@stylexjs/stylex';
-/**
- * Scoped marker for Thumbnail ancestor selectors. Applied to the image
- * container so the remove button's hover/focus reveal (`showRemoveOn="hover"`)
- * responds only to this thumbnail — not to hover/focus state from an outer
- * container the thumbnail happens to sit inside.
- */
-export declare const thumbnailScope: ReturnType<typeof stylex.defineMarker>;
-//# sourceMappingURL=thumbnail.markers.stylex.d.ts.map

package/dist/Thumbnail/thumbnail.markers.stylex.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"thumbnail.markers.stylex.d.ts","sourceRoot":"","sources":["../../src/Thumbnail/thumbnail.markers.stylex.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,UAAU,CAAC,OAAO,MAAM,CAAC,YAAY,CAC3C,CAAC"}

package/dist/Thumbnail/thumbnail.markers.stylex.js

@@ -1,14 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-import * as stylex from '@stylexjs/stylex';
-
-/**
- * Scoped marker for Thumbnail ancestor selectors. Applied to the image
- * container so the remove button's hover/focus reveal (`showRemoveOn="hover"`)
- * responds only to this thumbnail — not to hover/focus state from an outer
- * container the thumbnail happens to sit inside.
- */
-export const thumbnailScope = {
-  x9jk0ni: "x9jk0ni",
-  $$css: true
-};

package/dist/authoring/doc.d.ts

@@ -1,145 +0,0 @@
-/**
- * @file doc.ts
- * @input A component/function/generic doc object (without the `type` tag).
- * @output Type-preserving `createComponentDoc`/`createFunctionDoc`/`createDoc`
- *   helpers plus the doc-authoring TypeScript surface.
- * @position Integration-author authoring surface. See `./index.ts` for why
- *   these authoring factories live in `@astryxdesign/core`.
- *
- * A doc describes a documentable unit of the design system so the CLI and docs
- * surfaces can list, search, and render it. There are three kinds, each a tiny
- * runtime identity helper that stamps a `type` discriminant:
- *
- *   - `createComponentDoc` -> `type: 'component'` — a component (or a family).
- *   - `createFunctionDoc`  -> `type: 'function'`  — any function, including
- *      hooks: an "inputs + outputs" surface (`params` + `returns`).
- *   - `createDoc`          -> `type: 'generic'`   — reference/topic docs.
- *
- * These factories do NOT validate. Validation happens at the CLI load boundary,
- * where doc discovery runs the loaded value through a schema that accepts BOTH
- * the stamped formats and the legacy loose `export const docs = {...}` shape.
- */
-/**
- * Fields shared by every doc kind (component + function + generic).
- *
- * `group` vs `parent` are distinct:
- *   - `group` is a FLAT sidebar bucket label; many docs can share it and it is
- *     NOT an inheritance key.
- *   - `parent` is a DIRECTED inheritance/composition pointer — a doc naming the
- *     doc it belongs to (e.g. a sub-component naming its parent component). The
- *     legacy `subComponentOf` field is a synonym.
- *
- * `relatedDocs` is a single flat curated cross-reference list; it replaces the
- * legacy split `relatedComponents` + `relatedHooks`.
- */
-export interface AstryxBaseDocInput {
-    /** Name of the documented unit, without any prefix, PascalCase. Required. */
-    name: string;
-    /** Human-readable display name for gallery/sidebar. */
-    displayName?: string;
-    /** Short description. */
-    description?: string;
-    /** Usage documentation (description, best practices, anatomy, slotElements). */
-    usage?: unknown;
-    /** Flat sidebar grouping label (not an inheritance key). */
-    group?: string;
-    /** Overview-page functional category. */
-    category?: string;
-    /** CLI fuzzy-search keywords. */
-    keywords?: string[];
-    /** Directed inheritance/composition pointer to the doc this belongs to. */
-    parent?: string;
-    /** Flat curated cross-reference list of related doc names. */
-    relatedDocs?: string[];
-    /** Hide the whole doc from human-facing UI (stays importable/discoverable). */
-    hidden?: boolean;
-    /** Exclude from the categorized overview page (kept in sidebar/CLI). */
-    isHiddenFromOverview?: boolean;
-    /** Any additional fields the rich doc surface carries. */
-    [key: string]: unknown;
-}
-/** A single documented prop (mirrors `PropDoc` from core docs-types). */
-export interface AstryxPropInput {
-    name: string;
-    type: string;
-    description: string;
-    default?: string;
-    required?: boolean;
-    [key: string]: unknown;
-}
-/** A single documented param (mirrors `HookParamDoc`). */
-export interface AstryxParamInput {
-    name: string;
-    type: string;
-    description: string;
-    default?: string;
-    required?: boolean;
-    [key: string]: unknown;
-}
-/** A single documented return field (mirrors `HookReturnDoc`). */
-export interface AstryxReturnInput {
-    name: string;
-    type: string;
-    description: string;
-    [key: string]: unknown;
-}
-/**
- * Input accepted by {@link createComponentDoc}. A component (or a family). The
- * `type` discriminant is injected by the factory. `anatomy`/`slotElements` live
- * inside `usage`; `importPath` is DERIVED (never authored).
- */
-export interface AstryxComponentDocInput extends AstryxBaseDocInput {
-    /** All public props for the component. */
-    props: AstryxPropInput[];
-    /** Theming/selector-surface metadata. */
-    theming?: unknown;
-    /** Interactive-preview playground configuration. */
-    playground?: unknown;
-    /** Short code examples rendered after the props table. */
-    examples?: unknown[];
-}
-/**
- * Input accepted by {@link createFunctionDoc}. Covers any function, including
- * hooks: an inputs (`params`) + outputs (`returns`) surface. The `type`
- * discriminant is injected by the factory; `importPath` is DERIVED.
- */
-export interface AstryxFunctionDocInput extends AstryxBaseDocInput {
-    /** Function/hook parameters or options-object fields. */
-    params: AstryxParamInput[];
-    /** Return value documentation. One entry per field (or a single primitive). */
-    returns: AstryxReturnInput[];
-}
-/**
- * Input accepted by {@link createDoc}. A generic reference/topic doc — just the
- * shared base. The `type` discriminant is injected by the factory.
- */
-export type AstryxGenericDocInput = AstryxBaseDocInput;
-/**
- * Back-compat alias. Previously `createDoc` accepted a broad component-doc
- * record; the union of the three input kinds preserves that permissiveness for
- * any code referring to the old name.
- */
-export type AstryxComponentDoc = AstryxComponentDocInput | AstryxFunctionDocInput | AstryxGenericDocInput;
-/**
- * Author a component doc. Stamp-only: returns the def with `type: 'component'`
- * injected. Validation happens at the CLI load boundary.
- */
-export declare function createComponentDoc<T extends AstryxComponentDocInput>(def: T): T & {
-    type: 'component';
-};
-/**
- * Author a function doc (covers any function, including hooks). Stamp-only:
- * returns the def with `type: 'function'` injected. Validation happens at the
- * CLI load boundary.
- */
-export declare function createFunctionDoc<T extends AstryxFunctionDocInput>(def: T): T & {
-    type: 'function';
-};
-/**
- * Author a generic reference/topic doc. Stamp-only: returns the def with
- * `type: 'generic'` injected. Validation happens at the CLI load boundary.
- */
-export declare function createDoc<T extends AstryxGenericDocInput>(def: T): T & {
-    type: 'generic';
-};
-//# sourceMappingURL=doc.d.ts.map

package/dist/authoring/doc.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../src/authoring/doc.ts"],"names":[],"mappings":"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"}