@hjmds/react 0.8.2

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  useCallback,\n  useEffect,\n  useState,\n  useSyncExternalStore,\n  type Dispatch,\n  type Ref,\n  type SetStateAction,\n} from \"react\";\n\nexport function classNames(\n  ...values: readonly (string | false | null | undefined)[]\n): string | undefined {\n  const result = values.filter(Boolean).join(\" \");\n  return result.length > 0 ? result : undefined;\n}\n\nexport function assignRef<Element>(ref: Ref<Element> | undefined, value: Element | null): void {\n  if (typeof ref === \"function\") ref(value);\n  else if (ref) ref.current = value;\n}\n\nexport function composeRefs<Element>(\n  ...refs: readonly (Ref<Element> | undefined)[]\n): (value: Element | null) => void {\n  return (value) => {\n    for (const ref of refs) assignRef(ref, value);\n  };\n}\n\ntype ControllableStateOptions<Value> = Readonly<{\n  value?: Value;\n  defaultValue: Value;\n  onChange?: (value: Value) => void;\n}>;\n\nexport function useControllableState<Value>({\n  value,\n  defaultValue,\n  onChange,\n}: ControllableStateOptions<Value>): readonly [\n  Value,\n  Dispatch<SetStateAction<Value>>,\n] {\n  const [internalValue, setInternalValue] = useState(defaultValue);\n  const controlled = value !== undefined;\n  const currentValue = controlled ? value : internalValue;\n\n  const setValue: Dispatch<SetStateAction<Value>> = useCallback(\n    (next) => {\n      const resolved = typeof next === \"function\"\n        ? (next as (previous: Value) => Value)(currentValue)\n        : next;\n      if (!controlled) setInternalValue(resolved);\n      if (!Object.is(resolved, currentValue)) onChange?.(resolved);\n    },\n    [controlled, currentValue, onChange],\n  );\n\n  return [currentValue, setValue] as const;\n}\n\nfunction subscribeWindowResize(callback: () => void): () => void {\n  window.addEventListener(\"resize\", callback);\n  return () => window.removeEventListener(\"resize\", callback);\n}\n\nfunction getWindowWidth(): number {\n  return window.innerWidth;\n}\n\nfunction getServerWindowWidth(): number {\n  return 0;\n}\n\nexport function useWindowWidth(): number {\n  return useSyncExternalStore(\n    subscribeWindowResize,\n    getWindowWidth,\n    getServerWindowWidth,\n  );\n}\n\nexport function useElementWidth<Element extends HTMLElement>(\n  externalRef?: Ref<Element>,\n): readonly [number | undefined, (node: Element | null) => void] {\n  const [node, setNode] = useState<Element | null>(null);\n  const [width, setWidth] = useState<number>();\n  const ref = useCallback(\n    (nextNode: Element | null) => {\n      setNode(nextNode);\n      assignRef(externalRef, nextNode);\n    },\n    [externalRef],\n  );\n\n  useEffect(() => {\n    if (!node) return;\n    const update = () => setWidth(node.getBoundingClientRect().width);\n    update();\n    if (typeof ResizeObserver === \"undefined\") {\n      window.addEventListener(\"resize\", update);\n      return () => window.removeEventListener(\"resize\", update);\n    }\n    const observer = new ResizeObserver(update);\n    observer.observe(node);\n    return () => observer.disconnect();\n  }, [node]);\n\n  return [width, ref] as const;\n}\n"]}

package/dist/layout.d.ts

@@ -0,0 +1,134 @@
+import { type GridDescriptor, type GridGap } from "@hjmds/design-contracts/grid";
+import { type LayoutSidebarRole } from "@hjmds/design-contracts/components/layout";
+import { type SurfacePadding, type SurfaceRadius, type SurfaceTone } from "@hjmds/design-contracts/recipes/base";
+import { type StackAlign, type StackAxis, type StackGap, type StackJustify, type TextEmphasis, type TextTone } from "@hjmds/design-contracts/recipes";
+import type { TextVariant } from "@hjmds/design-contracts/foundations";
+import { type AnchorHTMLAttributes, type HTMLAttributes, type ReactElement, type ReactNode, type Ref } from "react";
+export type { SurfacePadding, SurfaceRadius, SurfaceTone, } from "@hjmds/design-contracts/recipes/base";
+export type { StackAlign, StackAxis, StackGap, StackJustify, TextEmphasis, TextTone, } from "@hjmds/design-contracts/recipes";
+type LayoutRegionProps = Omit<HTMLAttributes<HTMLElement>, "children" | "role">;
+type LayoutSidebarBase = Readonly<{
+    children: ReactNode;
+    role: LayoutSidebarRole;
+    label: string;
+    landmarkProps?: Omit<LayoutRegionProps, "aria-label">;
+    landmarkRef?: Ref<HTMLElement>;
+}>;
+/**
+ * A persistent sidebar is rendered in the shell grid. An overlay sidebar is
+ * deliberately handed to the product's SidePanel (or equivalent) through
+ * `renderOverlay`; Layout never owns a second open/dismiss lifecycle.
+ */
+export type LayoutSidebar = (LayoutSidebarBase & Readonly<{
+    mode: "persistent";
+    renderOverlay?: never;
+}>) | (LayoutSidebarBase & Readonly<{
+    mode: "overlay";
+    renderOverlay(sidebarLandmark: ReactElement): ReactNode;
+}>);
+export type LayoutProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & Readonly<{
+    children: ReactNode;
+    header?: ReactNode;
+    footer?: ReactNode;
+    sidebar?: LayoutSidebar;
+    skipLinkLabel?: string;
+    /** Stable product id for deep links; a hydration-safe id is generated when omitted. */
+    mainId?: string;
+    mainRef?: Ref<HTMLElement>;
+    headerProps?: LayoutRegionProps;
+    mainProps?: Omit<LayoutRegionProps, "id" | "tabIndex">;
+    footerProps?: LayoutRegionProps;
+    skipLinkProps?: Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "children" | "href">;
+}>;
+/** Accessible Web app shell with real landmarks and bypass navigation. */
+export declare const Layout: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivElement>, "children"> & Readonly<{
+    children: ReactNode;
+    header?: ReactNode;
+    footer?: ReactNode;
+    sidebar?: LayoutSidebar;
+    skipLinkLabel?: string;
+    /** Stable product id for deep links; a hydration-safe id is generated when omitted. */
+    mainId?: string;
+    mainRef?: Ref<HTMLElement>;
+    headerProps?: LayoutRegionProps;
+    mainProps?: Omit<LayoutRegionProps, "id" | "tabIndex">;
+    footerProps?: LayoutRegionProps;
+    skipLinkProps?: Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "children" | "href">;
+}> & import("react").RefAttributes<HTMLDivElement>>;
+export type TextProps = Omit<HTMLAttributes<HTMLElement>, "children"> & Readonly<{
+    children: ReactNode;
+    as?: "span" | "p" | "div" | "strong" | "small";
+    variant?: TextVariant;
+    tone?: TextTone;
+    emphasis?: TextEmphasis;
+}>;
+export declare const Text: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLElement>, "children"> & Readonly<{
+    children: ReactNode;
+    as?: "span" | "p" | "div" | "strong" | "small";
+    variant?: TextVariant;
+    tone?: TextTone;
+    emphasis?: TextEmphasis;
+}> & import("react").RefAttributes<HTMLElement>>;
+export type SurfaceProps = HTMLAttributes<HTMLElement> & Readonly<{
+    as?: "div" | "section" | "article";
+    tone?: SurfaceTone;
+    bordered?: boolean;
+    padding?: SurfacePadding;
+    radius?: SurfaceRadius;
+}>;
+export declare const Surface: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & Readonly<{
+    as?: "div" | "section" | "article";
+    tone?: SurfaceTone;
+    bordered?: boolean;
+    padding?: SurfacePadding;
+    radius?: SurfaceRadius;
+}> & import("react").RefAttributes<HTMLElement>>;
+export type StackProps = HTMLAttributes<HTMLDivElement> & Readonly<{
+    axis?: StackAxis;
+    gap?: StackGap;
+    align?: StackAlign;
+    justify?: StackJustify;
+    wrap?: boolean;
+}>;
+export declare const Stack: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & Readonly<{
+    axis?: StackAxis;
+    gap?: StackGap;
+    align?: StackAlign;
+    justify?: StackJustify;
+    wrap?: boolean;
+}> & import("react").RefAttributes<HTMLDivElement>>;
+export type GridProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & Pick<GridDescriptor, "columns" | "gap" | "minColumnWidth"> & Readonly<{
+    children?: ReactNode;
+    /** Test/SSR override. Browser renderers otherwise observe window.innerWidth. */
+    windowWidth?: number;
+    /** Container measurement override; ResizeObserver is used when omitted. */
+    availableWidth?: number;
+}>;
+export declare const Grid: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivElement>, "children"> & Pick<Readonly<{
+    columns: import("@hjmds/design-contracts/responsive").ResponsiveValue<number>;
+    gap?: import("@hjmds/design-contracts/responsive").ResponsiveValue<GridGap>;
+    minColumnWidth?: import("@hjmds/design-contracts/responsive").ResponsiveValue<number>;
+}>, "gap" | "columns" | "minColumnWidth"> & Readonly<{
+    children?: ReactNode;
+    /** Test/SSR override. Browser renderers otherwise observe window.innerWidth. */
+    windowWidth?: number;
+    /** Container measurement override; ResizeObserver is used when omitted. */
+    availableWidth?: number;
+}> & import("react").RefAttributes<HTMLDivElement>>;
+export type SectionProps = Omit<HTMLAttributes<HTMLElement>, "children" | "title"> & Readonly<{
+    title?: ReactNode;
+    description?: ReactNode;
+    action?: ReactNode;
+    children: ReactNode;
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+}>;
+/** Large-text-safe semantic content section with an optional header action. */
+export declare const Section: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLElement>, "children" | "title"> & Readonly<{
+    title?: ReactNode;
+    description?: ReactNode;
+    action?: ReactNode;
+    children: ReactNode;
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+}> & import("react").RefAttributes<HTMLElement>>;
+export type { GridGap };
+//# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

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

package/dist/layout.js

@@ -0,0 +1,167 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { resolveGridLayout, } from "@hjmds/design-contracts/grid";
+import { layoutRecipe, validateLayoutWebDescriptor, } from "@hjmds/design-contracts/components/layout";
+import { surfaceDefaults, surfaceGeometry, surfaceRecipe, } from "@hjmds/design-contracts/recipes/base";
+import { stackRecipe, textRecipe, } from "@hjmds/design-contracts/recipes";
+import { createElement, forwardRef, useId, useRef, } from "react";
+import { classNames, composeRefs, useElementWidth, useWindowWidth, } from "./internal.js";
+function hasRegionContent(content) {
+    return content !== undefined && content !== null && content !== false;
+}
+function assertMainId(id) {
+    if (id.trim().length === 0) {
+        throw new TypeError("Layout mainId must not be empty");
+    }
+    if (/\s/u.test(id)) {
+        throw new TypeError("Layout mainId must not contain whitespace");
+    }
+}
+/** Accessible Web app shell with real landmarks and bypass navigation. */
+export const Layout = forwardRef(function Layout({ children, header, footer, sidebar, skipLinkLabel, mainId: mainIdProp, mainRef: forwardedMainRef, headerProps, mainProps, footerProps, skipLinkProps, className, ...props }, ref) {
+    const generatedId = `hjm-main-${useId().replaceAll(":", "")}`;
+    const internalMainRef = useRef(null);
+    const mainId = mainIdProp ?? generatedId;
+    assertMainId(mainId);
+    const hasHeader = hasRegionContent(header);
+    const hasFooter = hasRegionContent(footer);
+    const descriptor = {
+        ...(hasHeader ? { hasHeader: true } : {}),
+        ...(hasFooter ? { hasFooter: true } : {}),
+        ...(sidebar === undefined
+            ? {}
+            : {
+                sidebar: {
+                    role: sidebar.role,
+                    mode: sidebar.mode,
+                    label: sidebar.label,
+                },
+            }),
+        ...(skipLinkLabel === undefined ? {} : { skipLinkLabel }),
+    };
+    validateLayoutWebDescriptor(descriptor);
+    if (sidebar?.mode === "overlay" &&
+        typeof sidebar.renderOverlay !== "function") {
+        throw new TypeError("Layout overlay sidebar requires renderOverlay so SidePanel owns its lifecycle");
+    }
+    const { className: headerClassName, ...restHeaderProps } = headerProps ?? {};
+    const { className: mainClassName, style: mainStyle, ...restMainProps } = mainProps ?? {};
+    const { className: footerClassName, ...restFooterProps } = footerProps ?? {};
+    const { className: skipLinkClassName, onClick: onSkipLinkClick, ...restSkipLinkProps } = skipLinkProps ?? {};
+    let sidebarNode;
+    if (sidebar !== undefined) {
+        const { className: sidebarClassName, style: sidebarStyle, ...restSidebarProps } = sidebar.landmarkProps ?? {};
+        const sidebarLandmark = createElement(sidebar.role === "navigation" ? "nav" : "aside", {
+            ...restSidebarProps,
+            ref: sidebar.landmarkRef,
+            className: classNames("hjm-layout__sidebar", sidebarClassName),
+            "aria-label": sidebar.label,
+            "data-mode": sidebar.mode,
+            style: {
+                ...(sidebar.mode === "persistent"
+                    ? { inlineSize: layoutRecipe.sidebar.width }
+                    : {}),
+                ...sidebarStyle,
+            },
+        }, sidebar.children);
+        sidebarNode = sidebar.mode === "overlay"
+            ? sidebar.renderOverlay(sidebarLandmark)
+            : sidebarLandmark;
+    }
+    const moveFocusToMain = (event) => {
+        onSkipLinkClick?.(event);
+        if (event.defaultPrevented)
+            return;
+        const main = internalMainRef.current;
+        if (main === null)
+            return;
+        event.preventDefault();
+        const url = new URL(window.location.href);
+        url.hash = mainId;
+        window.history.replaceState(window.history.state, "", url);
+        main.focus({ preventScroll: true });
+        main.scrollIntoView?.({ block: "start" });
+    };
+    return (_jsxs("div", { ...props, ref: ref, className: classNames("hjm-layout", className), "data-hjm-component": "Layout", "data-sidebar-mode": sidebar?.mode ?? "none", children: [skipLinkLabel === undefined ? null : (_jsx("a", { ...restSkipLinkProps, href: `#${mainId}`, className: classNames("hjm-layout__skip-link", skipLinkClassName), onClick: moveFocusToMain, children: skipLinkLabel })), hasHeader ? (_jsx("header", { ...restHeaderProps, className: classNames("hjm-layout__header", headerClassName), children: header })) : null, sidebarNode, _jsx("main", { ...restMainProps, ref: composeRefs(internalMainRef, forwardedMainRef), id: mainId, className: classNames("hjm-layout__main", mainClassName), tabIndex: -1, style: {
+                    maxInlineSize: layoutRecipe.main.maxWidth,
+                    paddingInline: layoutRecipe.main.paddingHorizontal,
+                    ...mainStyle,
+                }, children: children }), hasFooter ? (_jsx("footer", { ...restFooterProps, className: classNames("hjm-layout__footer", footerClassName), children: footer })) : null] }));
+});
+export const Text = forwardRef(function Text({ as = "span", variant = textRecipe.defaults.variant, tone = textRecipe.defaults.tone, emphasis = textRecipe.defaults.emphasis, className, ...props }, ref) {
+    return createElement(as, {
+        ...props,
+        ref,
+        className: classNames("hjm-text", className),
+        "data-variant": variant,
+        "data-tone": tone,
+        "data-emphasis": emphasis,
+    });
+});
+export const Surface = forwardRef(function Surface({ as = "div", tone = surfaceDefaults.tone, bordered = surfaceDefaults.bordered, padding = surfaceDefaults.padding, radius = surfaceDefaults.radius, className, style, ...props }, ref) {
+    const contract = surfaceRecipe[tone];
+    return createElement(as, {
+        ...props,
+        ref,
+        className: classNames("hjm-surface", className),
+        "data-tone": tone,
+        "data-bordered": bordered || contract.borderAlways,
+        "data-elevated": contract.elevated,
+        "data-padding": padding,
+        "data-radius": radius,
+        style: {
+            padding: surfaceGeometry.paddings[padding],
+            borderRadius: surfaceGeometry.radii[radius],
+            ...style,
+        },
+    });
+});
+const justifyValues = {
+    start: "flex-start",
+    center: "center",
+    end: "flex-end",
+    between: "space-between",
+};
+export const Stack = forwardRef(function Stack({ axis = stackRecipe.defaults.axis, gap = stackRecipe.defaults.gap, align = stackRecipe.defaults.align, justify = stackRecipe.defaults.justify, wrap = stackRecipe.defaults.wrap, className, style, ...props }, ref) {
+    return (_jsx("div", { ...props, ref: ref, className: classNames("hjm-stack", className), "data-axis": axis, "data-gap": gap, style: {
+            display: "flex",
+            flexDirection: stackRecipe.axes[axis],
+            gap: stackRecipe.gaps[gap],
+            alignItems: align === "start" || align === "end" ? `flex-${align}` : align,
+            justifyContent: justifyValues[justify],
+            flexWrap: wrap ? "wrap" : "nowrap",
+            ...style,
+        } }));
+});
+export const Grid = forwardRef(function Grid({ columns, gap, minColumnWidth, windowWidth, availableWidth, className, style, ...props }, forwardedRef) {
+    const browserWindowWidth = useWindowWidth();
+    const [measuredWidth, gridRef] = useElementWidth(forwardedRef);
+    const compactSsrWidth = 320;
+    const effectiveWindowWidth = windowWidth ??
+        (browserWindowWidth > 0 ? browserWindowWidth : compactSsrWidth);
+    const effectiveAvailableWidth = availableWidth ??
+        (measuredWidth !== undefined && measuredWidth > 0
+            ? measuredWidth
+            : effectiveWindowWidth);
+    const descriptor = {
+        columns,
+        ...(gap === undefined ? {} : { gap }),
+        ...(minColumnWidth === undefined ? {} : { minColumnWidth }),
+    };
+    const layout = resolveGridLayout(descriptor, {
+        windowWidth: effectiveWindowWidth,
+        availableWidth: effectiveAvailableWidth,
+    });
+    return (_jsx("div", { ...props, ref: gridRef, className: classNames("hjm-grid", className), "data-window-class": layout.windowClass, "data-columns": layout.columns, "data-requested-columns": layout.requestedColumns, "data-state": layout.columns < layout.requestedColumns ? "collapsed" : "resolved", style: {
+            display: "grid",
+            gridTemplateColumns: `repeat(${layout.columns}, minmax(0, 1fr))`,
+            rowGap: layout.rowGap,
+            columnGap: layout.columnGap,
+            ...style,
+        } }));
+});
+/** Large-text-safe semantic content section with an optional header action. */
+export const Section = forwardRef(function Section({ title, description, action, children, headingLevel = 2, className, ...props }, ref) {
+    const hasHeader = title !== undefined || description !== undefined || action !== undefined;
+    return (_jsxs("section", { ...props, ref: ref, className: classNames("hjm-section", className), children: [hasHeader ? (_jsxs("header", { className: "hjm-section__header", children: [_jsxs("div", { className: "hjm-section__copy", children: [title === undefined ? null : createElement(`h${headingLevel}`, { className: "hjm-section__title" }, title), description === undefined ? null : (_jsx("div", { className: "hjm-section__description", children: description }))] }), action === undefined ? null : _jsx("div", { className: "hjm-section__action", children: action })] })) : null, _jsx("div", { className: "hjm-section__content", children: children })] }));
+});
+//# sourceMappingURL=layout.js.map

package/dist/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../src/layout.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  resolveGridLayout,\n  type GridDescriptor,\n  type GridGap,\n} from \"@hjmds/design-contracts/grid\";\nimport {\n  layoutRecipe,\n  validateLayoutWebDescriptor,\n  type LayoutSidebarDescriptor,\n  type LayoutSidebarRole,\n} from \"@hjmds/design-contracts/components/layout\";\nimport {\n  surfaceDefaults,\n  surfaceGeometry,\n  surfaceRecipe,\n  type SurfacePadding,\n  type SurfaceRadius,\n  type SurfaceTone,\n} from \"@hjmds/design-contracts/recipes/base\";\nimport {\n  stackRecipe,\n  textRecipe,\n  type StackAlign,\n  type StackAxis,\n  type StackGap,\n  type StackJustify,\n  type TextEmphasis,\n  type TextTone,\n} from \"@hjmds/design-contracts/recipes\";\nimport type { TextVariant } from \"@hjmds/design-contracts/foundations\";\nimport {\n  createElement,\n  forwardRef,\n  useId,\n  useRef,\n  type AnchorHTMLAttributes,\n  type HTMLAttributes,\n  type MouseEvent,\n  type ReactElement,\n  type ReactNode,\n  type Ref,\n} from \"react\";\nimport {\n  classNames,\n  composeRefs,\n  useElementWidth,\n  useWindowWidth,\n} from \"./internal.js\";\n\nexport type {\n  SurfacePadding,\n  SurfaceRadius,\n  SurfaceTone,\n} from \"@hjmds/design-contracts/recipes/base\";\nexport type {\n  StackAlign,\n  StackAxis,\n  StackGap,\n  StackJustify,\n  TextEmphasis,\n  TextTone,\n} from \"@hjmds/design-contracts/recipes\";\n\ntype LayoutRegionProps = Omit<\n  HTMLAttributes<HTMLElement>,\n  \"children\" | \"role\"\n>;\n\ntype LayoutSidebarBase = Readonly<{\n  children: ReactNode;\n  role: LayoutSidebarRole;\n  label: string;\n  landmarkProps?: Omit<LayoutRegionProps, \"aria-label\">;\n  landmarkRef?: Ref<HTMLElement>;\n}>;\n\n/**\n * A persistent sidebar is rendered in the shell grid. An overlay sidebar is\n * deliberately handed to the product's SidePanel (or equivalent) through\n * `renderOverlay`; Layout never owns a second open/dismiss lifecycle.\n */\nexport type LayoutSidebar =\n  | (LayoutSidebarBase &\n      Readonly<{\n        mode: \"persistent\";\n        renderOverlay?: never;\n      }>)\n  | (LayoutSidebarBase &\n      Readonly<{\n        mode: \"overlay\";\n        renderOverlay(sidebarLandmark: ReactElement): ReactNode;\n      }>);\n\nexport type LayoutProps = Omit<HTMLAttributes<HTMLDivElement>, \"children\"> &\n  Readonly<{\n    children: ReactNode;\n    header?: ReactNode;\n    footer?: ReactNode;\n    sidebar?: LayoutSidebar;\n    skipLinkLabel?: string;\n    /** Stable product id for deep links; a hydration-safe id is generated when omitted. */\n    mainId?: string;\n    mainRef?: Ref<HTMLElement>;\n    headerProps?: LayoutRegionProps;\n    mainProps?: Omit<LayoutRegionProps, \"id\" | \"tabIndex\">;\n    footerProps?: LayoutRegionProps;\n    skipLinkProps?: Omit<\n      AnchorHTMLAttributes<HTMLAnchorElement>,\n      \"children\" | \"href\"\n    >;\n  }>;\n\nfunction hasRegionContent(content: ReactNode | undefined): boolean {\n  return content !== undefined && content !== null && content !== false;\n}\n\nfunction assertMainId(id: string): void {\n  if (id.trim().length === 0) {\n    throw new TypeError(\"Layout mainId must not be empty\");\n  }\n  if (/\\s/u.test(id)) {\n    throw new TypeError(\"Layout mainId must not contain whitespace\");\n  }\n}\n\n/** Accessible Web app shell with real landmarks and bypass navigation. */\nexport const Layout = forwardRef<HTMLDivElement, LayoutProps>(function Layout(\n  {\n    children,\n    header,\n    footer,\n    sidebar,\n    skipLinkLabel,\n    mainId: mainIdProp,\n    mainRef: forwardedMainRef,\n    headerProps,\n    mainProps,\n    footerProps,\n    skipLinkProps,\n    className,\n    ...props\n  },\n  ref,\n) {\n  const generatedId = `hjm-main-${useId().replaceAll(\":\", \"\")}`;\n  const internalMainRef = useRef<HTMLElement>(null);\n  const mainId = mainIdProp ?? generatedId;\n  assertMainId(mainId);\n\n  const hasHeader = hasRegionContent(header);\n  const hasFooter = hasRegionContent(footer);\n  const descriptor = {\n    ...(hasHeader ? { hasHeader: true } : {}),\n    ...(hasFooter ? { hasFooter: true } : {}),\n    ...(sidebar === undefined\n      ? {}\n      : {\n          sidebar: {\n            role: sidebar.role,\n            mode: sidebar.mode,\n            label: sidebar.label,\n          } satisfies LayoutSidebarDescriptor,\n        }),\n    ...(skipLinkLabel === undefined ? {} : { skipLinkLabel }),\n  };\n  validateLayoutWebDescriptor(descriptor);\n\n  if (\n    sidebar?.mode === \"overlay\" &&\n    typeof sidebar.renderOverlay !== \"function\"\n  ) {\n    throw new TypeError(\n      \"Layout overlay sidebar requires renderOverlay so SidePanel owns its lifecycle\",\n    );\n  }\n\n  const {\n    className: headerClassName,\n    ...restHeaderProps\n  } = headerProps ?? {};\n  const {\n    className: mainClassName,\n    style: mainStyle,\n    ...restMainProps\n  } = mainProps ?? {};\n  const {\n    className: footerClassName,\n    ...restFooterProps\n  } = footerProps ?? {};\n  const {\n    className: skipLinkClassName,\n    onClick: onSkipLinkClick,\n    ...restSkipLinkProps\n  } = skipLinkProps ?? {};\n\n  let sidebarNode: ReactNode;\n  if (sidebar !== undefined) {\n    const {\n      className: sidebarClassName,\n      style: sidebarStyle,\n      ...restSidebarProps\n    } = sidebar.landmarkProps ?? {};\n    const sidebarLandmark = createElement(\n      sidebar.role === \"navigation\" ? \"nav\" : \"aside\",\n      {\n        ...restSidebarProps,\n        ref: sidebar.landmarkRef,\n        className: classNames(\"hjm-layout__sidebar\", sidebarClassName),\n        \"aria-label\": sidebar.label,\n        \"data-mode\": sidebar.mode,\n        style: {\n          ...(sidebar.mode === \"persistent\"\n            ? { inlineSize: layoutRecipe.sidebar.width }\n            : {}),\n          ...sidebarStyle,\n        },\n      },\n      sidebar.children,\n    );\n    sidebarNode = sidebar.mode === \"overlay\"\n      ? sidebar.renderOverlay(sidebarLandmark)\n      : sidebarLandmark;\n  }\n\n  const moveFocusToMain = (event: MouseEvent<HTMLAnchorElement>) => {\n    onSkipLinkClick?.(event);\n    if (event.defaultPrevented) return;\n    const main = internalMainRef.current;\n    if (main === null) return;\n    event.preventDefault();\n    const url = new URL(window.location.href);\n    url.hash = mainId;\n    window.history.replaceState(window.history.state, \"\", url);\n    main.focus({ preventScroll: true });\n    main.scrollIntoView?.({ block: \"start\" });\n  };\n\n  return (\n    <div\n      {...props}\n      ref={ref}\n      className={classNames(\"hjm-layout\", className)}\n      data-hjm-component=\"Layout\"\n      data-sidebar-mode={sidebar?.mode ?? \"none\"}\n    >\n      {skipLinkLabel === undefined ? null : (\n        <a\n          {...restSkipLinkProps}\n          href={`#${mainId}`}\n          className={classNames(\n            \"hjm-layout__skip-link\",\n            skipLinkClassName,\n          )}\n          onClick={moveFocusToMain}\n        >\n          {skipLinkLabel}\n        </a>\n      )}\n      {hasHeader ? (\n        <header\n          {...restHeaderProps}\n          className={classNames(\"hjm-layout__header\", headerClassName)}\n        >\n          {header}\n        </header>\n      ) : null}\n      {sidebarNode}\n      <main\n        {...restMainProps}\n        ref={composeRefs(internalMainRef, forwardedMainRef)}\n        id={mainId}\n        className={classNames(\"hjm-layout__main\", mainClassName)}\n        tabIndex={-1}\n        style={{\n          maxInlineSize: layoutRecipe.main.maxWidth,\n          paddingInline: layoutRecipe.main.paddingHorizontal,\n          ...mainStyle,\n        }}\n      >\n        {children}\n      </main>\n      {hasFooter ? (\n        <footer\n          {...restFooterProps}\n          className={classNames(\"hjm-layout__footer\", footerClassName)}\n        >\n          {footer}\n        </footer>\n      ) : null}\n    </div>\n  );\n});\n\nexport type TextProps = Omit<HTMLAttributes<HTMLElement>, \"children\"> &\n  Readonly<{\n    children: ReactNode;\n    as?: \"span\" | \"p\" | \"div\" | \"strong\" | \"small\";\n    variant?: TextVariant;\n    tone?: TextTone;\n    emphasis?: TextEmphasis;\n  }>;\n\nexport const Text = forwardRef<HTMLElement, TextProps>(function Text(\n  {\n    as = \"span\",\n    variant = textRecipe.defaults.variant,\n    tone = textRecipe.defaults.tone,\n    emphasis = textRecipe.defaults.emphasis,\n    className,\n    ...props\n  },\n  ref,\n) {\n  return createElement(as, {\n    ...props,\n    ref,\n    className: classNames(\"hjm-text\", className),\n    \"data-variant\": variant,\n    \"data-tone\": tone,\n    \"data-emphasis\": emphasis,\n  });\n});\n\nexport type SurfaceProps = HTMLAttributes<HTMLElement> &\n  Readonly<{\n    as?: \"div\" | \"section\" | \"article\";\n    tone?: SurfaceTone;\n    bordered?: boolean;\n    padding?: SurfacePadding;\n    radius?: SurfaceRadius;\n  }>;\n\nexport const Surface = forwardRef<HTMLElement, SurfaceProps>(function Surface(\n  {\n    as = \"div\",\n    tone = surfaceDefaults.tone,\n    bordered = surfaceDefaults.bordered,\n    padding = surfaceDefaults.padding,\n    radius = surfaceDefaults.radius,\n    className,\n    style,\n    ...props\n  },\n  ref,\n) {\n  const contract = surfaceRecipe[tone];\n  return createElement(as, {\n    ...props,\n    ref,\n    className: classNames(\"hjm-surface\", className),\n    \"data-tone\": tone,\n    \"data-bordered\": bordered || contract.borderAlways,\n    \"data-elevated\": contract.elevated,\n    \"data-padding\": padding,\n    \"data-radius\": radius,\n    style: {\n      padding: surfaceGeometry.paddings[padding],\n      borderRadius: surfaceGeometry.radii[radius],\n      ...style,\n    },\n  });\n});\n\nexport type StackProps = HTMLAttributes<HTMLDivElement> &\n  Readonly<{\n    axis?: StackAxis;\n    gap?: StackGap;\n    align?: StackAlign;\n    justify?: StackJustify;\n    wrap?: boolean;\n  }>;\n\nconst justifyValues = {\n  start: \"flex-start\",\n  center: \"center\",\n  end: \"flex-end\",\n  between: \"space-between\",\n} as const;\n\nexport const Stack = forwardRef<HTMLDivElement, StackProps>(function Stack(\n  {\n    axis = stackRecipe.defaults.axis,\n    gap = stackRecipe.defaults.gap,\n    align = stackRecipe.defaults.align,\n    justify = stackRecipe.defaults.justify,\n    wrap = stackRecipe.defaults.wrap,\n    className,\n    style,\n    ...props\n  },\n  ref,\n) {\n  return (\n    <div\n      {...props}\n      ref={ref}\n      className={classNames(\"hjm-stack\", className)}\n      data-axis={axis}\n      data-gap={gap}\n      style={{\n        display: \"flex\",\n        flexDirection: stackRecipe.axes[axis],\n        gap: stackRecipe.gaps[gap],\n        alignItems: align === \"start\" || align === \"end\" ? `flex-${align}` : align,\n        justifyContent: justifyValues[justify],\n        flexWrap: wrap ? \"wrap\" : \"nowrap\",\n        ...style,\n      }}\n    />\n  );\n});\n\nexport type GridProps = Omit<HTMLAttributes<HTMLDivElement>, \"children\"> &\n  Pick<GridDescriptor, \"columns\" | \"gap\" | \"minColumnWidth\"> &\n  Readonly<{\n    children?: ReactNode;\n    /** Test/SSR override. Browser renderers otherwise observe window.innerWidth. */\n    windowWidth?: number;\n    /** Container measurement override; ResizeObserver is used when omitted. */\n    availableWidth?: number;\n  }>;\n\nexport const Grid = forwardRef<HTMLDivElement, GridProps>(function Grid(\n  {\n    columns,\n    gap,\n    minColumnWidth,\n    windowWidth,\n    availableWidth,\n    className,\n    style,\n    ...props\n  },\n  forwardedRef,\n) {\n  const browserWindowWidth = useWindowWidth();\n  const [measuredWidth, gridRef] = useElementWidth(forwardedRef);\n  const compactSsrWidth = 320;\n  const effectiveWindowWidth =\n    windowWidth ??\n    (browserWindowWidth > 0 ? browserWindowWidth : compactSsrWidth);\n  const effectiveAvailableWidth =\n    availableWidth ??\n    (measuredWidth !== undefined && measuredWidth > 0\n      ? measuredWidth\n      : effectiveWindowWidth);\n  const descriptor: GridDescriptor = {\n    columns,\n    ...(gap === undefined ? {} : { gap }),\n    ...(minColumnWidth === undefined ? {} : { minColumnWidth }),\n  };\n  const layout = resolveGridLayout(descriptor, {\n    windowWidth: effectiveWindowWidth,\n    availableWidth: effectiveAvailableWidth,\n  });\n\n  return (\n    <div\n      {...props}\n      ref={gridRef}\n      className={classNames(\"hjm-grid\", className)}\n      data-window-class={layout.windowClass}\n      data-columns={layout.columns}\n      data-requested-columns={layout.requestedColumns}\n      data-state={layout.columns < layout.requestedColumns ? \"collapsed\" : \"resolved\"}\n      style={{\n        display: \"grid\",\n        gridTemplateColumns: `repeat(${layout.columns}, minmax(0, 1fr))`,\n        rowGap: layout.rowGap,\n        columnGap: layout.columnGap,\n        ...style,\n      }}\n    />\n  );\n});\n\nexport type SectionProps = Omit<HTMLAttributes<HTMLElement>, \"children\" | \"title\"> &\n  Readonly<{\n    title?: ReactNode;\n    description?: ReactNode;\n    action?: ReactNode;\n    children: ReactNode;\n    headingLevel?: 2 | 3 | 4 | 5 | 6;\n  }>;\n\n/** Large-text-safe semantic content section with an optional header action. */\nexport const Section = forwardRef<HTMLElement, SectionProps>(function Section(\n  {\n    title,\n    description,\n    action,\n    children,\n    headingLevel = 2,\n    className,\n    ...props\n  },\n  ref,\n) {\n  const hasHeader = title !== undefined || description !== undefined || action !== undefined;\n  return (\n    <section {...props} ref={ref} className={classNames(\"hjm-section\", className)}>\n      {hasHeader ? (\n        <header className=\"hjm-section__header\">\n          <div className=\"hjm-section__copy\">\n            {title === undefined ? null : createElement(\n              `h${headingLevel}`,\n              { className: \"hjm-section__title\" },\n              title,\n            )}\n            {description === undefined ? null : (\n              <div className=\"hjm-section__description\">{description}</div>\n            )}\n          </div>\n          {action === undefined ? null : <div className=\"hjm-section__action\">{action}</div>}\n        </header>\n      ) : null}\n      <div className=\"hjm-section__content\">{children}</div>\n    </section>\n  );\n});\n\nexport type { GridGap };\n"]}

package/dist/navigation-public.d.ts

@@ -0,0 +1,6 @@
+export * from "./navigation.js";
+export * from "./advanced-navigation.js";
+export * from "./supplemental-navigation.js";
+export * from "./steps.js";
+export * from "./bottom-navigation.js";
+//# sourceMappingURL=navigation-public.d.ts.map

package/dist/navigation-public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-public.d.ts","sourceRoot":"","sources":["../src/navigation-public.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC"}

package/dist/navigation-public.js

@@ -0,0 +1,6 @@
+export * from "./navigation.js";
+export * from "./advanced-navigation.js";
+export * from "./supplemental-navigation.js";
+export * from "./steps.js";
+export * from "./bottom-navigation.js";
+//# sourceMappingURL=navigation-public.js.map

package/dist/navigation-public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-public.js","sourceRoot":"","sources":["../src/navigation-public.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC","sourcesContent":["export * from \"./navigation.js\";\nexport * from \"./advanced-navigation.js\";\nexport * from \"./supplemental-navigation.js\";\nexport * from \"./steps.js\";\nexport * from \"./bottom-navigation.js\";\n"]}

package/dist/navigation.d.ts

@@ -0,0 +1,65 @@
+import { type TabsActivationMode, type TabsDirection, type TabsMountPolicy, type TabsOrientation, type TabsPanelMode } from "@hjmds/design-contracts/behaviors";
+import { type TabSize, type TabsLayout, type TabsOverflow } from "@hjmds/design-contracts/recipes";
+import { type HTMLAttributes, type ReactNode } from "react";
+export type TabLeadingRenderProps = Readonly<{
+    selected: boolean;
+    disabled: boolean;
+    color: "currentColor";
+    /** Pixel size resolved from `tabsRecipe.icon.glyph`. */
+    size: number;
+    /** Compatibility alias for product icon libraries that name this value explicitly. */
+    glyphSize: number;
+}>;
+export type TabItem = Readonly<{
+    id: string;
+    label: ReactNode;
+    panel?: ReactNode;
+    renderLeading?: (state: TabLeadingRenderProps) => ReactNode;
+    disabled?: boolean;
+}>;
+type TabsSelection = Readonly<{
+    value: string;
+    defaultValue?: never;
+    onValueChange(value: string): void;
+}> | Readonly<{
+    value?: never;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+}>;
+export type TabsProps = Omit<HTMLAttributes<HTMLDivElement>, "dir" | "onChange"> & TabsSelection & Readonly<{
+    label: string;
+    items: readonly TabItem[];
+    activationMode?: TabsActivationMode;
+    mountPolicy?: TabsMountPolicy;
+    panelMode?: TabsPanelMode;
+    orientation?: TabsOrientation;
+    direction?: TabsDirection;
+    loop?: boolean;
+    size?: TabSize;
+    layout?: TabsLayout;
+    overflow?: TabsOverflow;
+    /** Set false when panels are rendered separately with `TabPanel`. */
+    renderPanels?: boolean;
+}>;
+export declare function getTabId(tabsId: string, value: string): string;
+export declare function getTabPanelId(tabsId: string, value: string, mode?: TabsPanelMode): string;
+export declare function getDynamicTabPanelId(tabsId: string): string;
+type ExternalTabPanelBaseProps = Omit<HTMLAttributes<HTMLDivElement>, "id"> & Readonly<{
+    tabsId: string;
+    activeValue: string;
+    children: ReactNode;
+}>;
+export type TabPanelProps = ExternalTabPanelBaseProps & (Readonly<{
+    mode: "dynamic";
+    value?: never;
+    mountPolicy?: never;
+}> | Readonly<{
+    mode?: "keyed";
+    value: string;
+    mountPolicy?: TabsMountPolicy;
+}>);
+/** External panel host for products that keep routing, query, or scroll state outside Tabs. */
+export declare function TabPanel(props: TabPanelProps): import("react").JSX.Element | null;
+export declare const Tabs: import("react").ForwardRefExoticComponent<TabsProps & import("react").RefAttributes<HTMLDivElement>>;
+export {};
+//# sourceMappingURL=navigation.d.ts.map

package/dist/navigation.d.ts.map

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