@hjmds/react 1.12.0 → 1.13.0

package/dist/actions.d.ts

@@ -74,6 +74,8 @@ export type LinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & Readonly<{
     trailing?: ReactNode;
     /** Framework adapter, for example Next.js Link, while HJM keeps link semantics and state. */
     renderAnchor?: (props: LinkRenderProps) => ReactElement;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }>;
 export declare const Link: import("react").ForwardRefExoticComponent<AnchorHTMLAttributes<HTMLAnchorElement> & Readonly<{
     tone?: LinkTone;
@@ -83,5 +85,7 @@ export declare const Link: import("react").ForwardRefExoticComponent<AnchorHTMLA
     trailing?: ReactNode;
     /** Framework adapter, for example Next.js Link, while HJM keeps link semantics and state. */
     renderAnchor?: (props: LinkRenderProps) => ReactElement;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }> & import("react").RefAttributes<HTMLAnchorElement>>;
 //# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

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

package/dist/actions.js

@@ -33,7 +33,7 @@ export const IconButton = forwardRef(function IconButton({ label, tone = iconBut
     };
     return (_jsx("button", { ...props, style: { ...style, ...layoutStyle }, ref: ref, type: type, className: classNames("hjm-icon-button", className), "data-tone": tone, "data-size": size, "data-shape": shape, ...(selected === undefined ? {} : { "data-selected": selected, "aria-pressed": selected }), "data-state": loading ? "loading" : unavailable ? "disabled" : "idle", "aria-label": label, "aria-busy": loading || undefined, "aria-disabled": unavailable || undefined, disabled: disabled, onClick: handleClick, children: loading ? _jsx("span", { className: "hjm-button__spinner", "aria-hidden": "true" }) : children }));
 });
-export const Link = forwardRef(function Link({ tone = linkRecipe.defaults.tone, variant = linkRecipe.defaults.variant, disabled = false, leading, trailing, renderAnchor, target, rel, tabIndex, onClick, className, children, ...props }, ref) {
+export const Link = forwardRef(function Link({ tone = linkRecipe.defaults.tone, variant = linkRecipe.defaults.variant, disabled = false, leading, trailing, renderAnchor, target, rel, tabIndex, onClick, className, children, layoutStyle, ...props }, ref) {
     const handleClick = (event) => {
         if (disabled) {
             event.preventDefault();
@@ -43,6 +43,9 @@ export const Link = forwardRef(function Link({ tone = linkRecipe.defaults.tone,
     };
     const anchorProps = {
         ...props,
+        // `renderAnchor` adapters receive the merged placement, so a framework Link
+        // gets the same position as the plain <a>.
+        ...(props.style === undefined && layoutStyle === undefined ? {} : { style: { ...props.style, ...layoutStyle } }),
         ref,
         className: classNames("hjm-link", className),
         "data-tone": tone,

package/dist/actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  buttonRecipe,\n  type ButtonAlign,\n  type ButtonShape,\n  type ButtonSize,\n  type ButtonTone,\n} from \"@hjmds/design-contracts/recipes/base\";\n\nexport type { ButtonAlign, ButtonShape };\nimport {\n  iconButtonRecipe,\n  linkRecipe,\n  type IconButtonShape,\n  type IconButtonSize,\n  type IconButtonTone,\n  type LinkTone,\n  type LinkVariant,\n} from \"@hjmds/design-contracts/recipes\";\nimport {\n  forwardRef,\n  type AnchorHTMLAttributes,\n  type CSSProperties,\n  type ButtonHTMLAttributes,\n  type ForwardedRef,\n  type MouseEvent,\n  type ReactElement,\n  type ReactNode,\n} from \"react\";\nimport { classNames } from \"./internal.js\";\n\nexport type { ButtonSize, ButtonTone } from \"@hjmds/design-contracts/recipes/base\";\nexport type {\n  IconButtonShape,\n  IconButtonSize,\n  IconButtonTone,\n} from \"@hjmds/design-contracts/recipes\";\nimport type { HjmCompositionStyleProp } from \"./composition-style.js\";\n\nexport type ButtonProps = ButtonHTMLAttributes<HTMLButtonElement> &\n  Readonly<{\n    tone?: ButtonTone;\n    size?: ButtonSize;\n    /** Frame geometry. `pill` replaces product code that overrode `border-radius`. */\n    shape?: ButtonShape;\n    /** Label placement inside the frame; `leading` suits a full-width row action. */\n    align?: ButtonAlign;\n    /** Toggle state. Paints the selected treatment and sets `aria-pressed`. */\n    selected?: boolean;\n    loading?: boolean;\n    leading?: ReactNode;\n    trailing?: ReactNode;\n      /** Canonical layout-only placement. Controlled visual keys are excluded. */\n    layoutStyle?: HjmCompositionStyleProp;\n}>;\n\nexport const Button = forwardRef<HTMLButtonElement, ButtonProps>(function Button(\n  {\n    tone = buttonRecipe.defaults.tone,\n    size = buttonRecipe.defaults.size,\n    shape = buttonRecipe.defaults.shape,\n    align = buttonRecipe.defaults.align,\n    selected,\n    loading = false,\n    leading,\n    trailing,\n    disabled,\n    onClick,\n    type = \"button\",\n    className,\n    children,\n    layoutStyle,\n    style,\n    ...props\n  },\n  ref,\n) {\n  // Preserve a focusable disabled action (e.g. a Carousel boundary).\n  const ariaDisabled = props[\"aria-disabled\"] === true || props[\"aria-disabled\"] === \"true\";\n  const unavailable = disabled === true || loading || ariaDisabled;\n  const handleClick = (event: MouseEvent<HTMLButtonElement>) => {\n    if (unavailable) {\n      event.preventDefault();\n      event.stopPropagation();\n      return;\n    }\n    onClick?.(event);\n  };\n  return (\n    <button\n      {...props}\n      // The cap lives in the recipe, not in the stylesheet: one number, one place.\n      style={{ \"--hjm-button-label-lines\": buttonRecipe.label.maxLines, ...style, ...layoutStyle } as CSSProperties}\n      ref={ref}\n      type={type}\n      className={classNames(\"hjm-button\", className)}\n      data-tone={tone}\n      data-size={size}\n      data-shape={shape}\n      data-align={align}\n      {...(selected === undefined ? {} : { \"data-selected\": selected, \"aria-pressed\": selected })}\n      data-state={loading ? \"loading\" : unavailable ? \"disabled\" : \"idle\"}\n      aria-busy={loading || undefined}\n      aria-disabled={unavailable || undefined}\n      disabled={disabled}\n      onClick={handleClick}\n    >\n      {leading}\n      <span className=\"hjm-button__label\">{children}</span>\n      {trailing}\n      {loading ? <span className=\"hjm-button__loading-indicator\" aria-hidden=\"true\"><span className=\"hjm-button__spinner\" /></span> : null}\n    </button>\n  );\n});\n\nexport type IconButtonProps = Omit<\n  ButtonHTMLAttributes<HTMLButtonElement>,\n  \"aria-label\"\n> &\n  Readonly<{\n    label: string;\n    tone?: IconButtonTone;\n    size?: IconButtonSize;\n    shape?: IconButtonShape;\n    /** Toggle state. Paints the selected treatment and sets `aria-pressed`. */\n    selected?: boolean;\n    loading?: boolean;\n    children: ReactNode;\n      /** Canonical layout-only placement. Controlled visual keys are excluded. */\n    layoutStyle?: HjmCompositionStyleProp;\n}>;\n\nexport const IconButton = forwardRef<HTMLButtonElement, IconButtonProps>(\n  function IconButton(\n    {\n      label,\n      tone = iconButtonRecipe.defaults.tone,\n      size = iconButtonRecipe.defaults.size,\n      shape = iconButtonRecipe.defaults.shape,\n      selected,\n      loading = false,\n      disabled,\n      onClick,\n      type = \"button\",\n      className,\n      children,\n      layoutStyle,\n      style,\n      ...props\n    },\n    ref,\n  ) {\n    // Preserve a focusable disabled action (e.g. a Carousel boundary).\n    const ariaDisabled = props[\"aria-disabled\"] === true || props[\"aria-disabled\"] === \"true\";\n    const unavailable = disabled === true || loading || ariaDisabled;\n    const handleClick = (event: MouseEvent<HTMLButtonElement>) => {\n      if (unavailable) {\n        event.preventDefault();\n        event.stopPropagation();\n        return;\n      }\n      onClick?.(event);\n    };\n    return (\n      <button\n        {...props}\n        style={{ ...style, ...layoutStyle }}\n        ref={ref}\n        type={type}\n        className={classNames(\"hjm-icon-button\", className)}\n        data-tone={tone}\n        data-size={size}\n        data-shape={shape}\n        {...(selected === undefined ? {} : { \"data-selected\": selected, \"aria-pressed\": selected })}\n        data-state={loading ? \"loading\" : unavailable ? \"disabled\" : \"idle\"}\n        aria-label={label}\n        aria-busy={loading || undefined}\n        aria-disabled={unavailable || undefined}\n        disabled={disabled}\n        onClick={handleClick}\n      >\n        {loading ? <span className=\"hjm-button__spinner\" aria-hidden=\"true\" /> : children}\n      </button>\n    );\n  },\n);\n\nexport type LinkRenderProps = AnchorHTMLAttributes<HTMLAnchorElement> &\n  Readonly<{\n    children: ReactNode;\n    ref: ForwardedRef<HTMLAnchorElement>;\n    \"data-tone\": LinkTone;\n    \"data-variant\": LinkVariant;\n    \"data-state\": \"disabled\" | \"idle\";\n  }>;\n\nexport type LinkProps = AnchorHTMLAttributes<HTMLAnchorElement> &\n  Readonly<{\n    tone?: LinkTone;\n    variant?: LinkVariant;\n    disabled?: boolean;\n    leading?: ReactNode;\n    trailing?: ReactNode;\n    /** Framework adapter, for example Next.js Link, while HJM keeps link semantics and state. */\n    renderAnchor?: (props: LinkRenderProps) => ReactElement;\n  }>;\n\nexport const Link = forwardRef<HTMLAnchorElement, LinkProps>(function Link(\n  {\n    tone = linkRecipe.defaults.tone,\n    variant = linkRecipe.defaults.variant,\n    disabled = false,\n    leading,\n    trailing,\n    renderAnchor,\n    target,\n    rel,\n    tabIndex,\n    onClick,\n    className,\n    children,\n    ...props\n  },\n  ref,\n) {\n  const handleClick = (event: MouseEvent<HTMLAnchorElement>) => {\n    if (disabled) {\n      event.preventDefault();\n      return;\n    }\n    onClick?.(event);\n  };\n  const anchorProps: LinkRenderProps = {\n    ...props,\n    ref,\n    className: classNames(\"hjm-link\", className),\n    \"data-tone\": tone,\n    \"data-variant\": variant,\n    \"data-state\": disabled ? \"disabled\" : \"idle\",\n    \"aria-disabled\": disabled || undefined,\n    tabIndex: disabled ? -1 : tabIndex,\n    target,\n    rel: rel ?? (target === \"_blank\" ? \"noreferrer noopener\" : undefined),\n    onClick: handleClick,\n    children: (\n      <>\n      {leading}\n      <span>{children}</span>\n      {trailing}\n      </>\n    ),\n  };\n  return renderAnchor ? renderAnchor(anchorProps) : <a {...anchorProps} />;\n});\n"]}
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  buttonRecipe,\n  type ButtonAlign,\n  type ButtonShape,\n  type ButtonSize,\n  type ButtonTone,\n} from \"@hjmds/design-contracts/recipes/base\";\n\nexport type { ButtonAlign, ButtonShape };\nimport {\n  iconButtonRecipe,\n  linkRecipe,\n  type IconButtonShape,\n  type IconButtonSize,\n  type IconButtonTone,\n  type LinkTone,\n  type LinkVariant,\n} from \"@hjmds/design-contracts/recipes\";\nimport {\n  forwardRef,\n  type AnchorHTMLAttributes,\n  type CSSProperties,\n  type ButtonHTMLAttributes,\n  type ForwardedRef,\n  type MouseEvent,\n  type ReactElement,\n  type ReactNode,\n} from \"react\";\nimport { classNames } from \"./internal.js\";\n\nexport type { ButtonSize, ButtonTone } from \"@hjmds/design-contracts/recipes/base\";\nexport type {\n  IconButtonShape,\n  IconButtonSize,\n  IconButtonTone,\n} from \"@hjmds/design-contracts/recipes\";\nimport type { HjmCompositionStyleProp } from \"./composition-style.js\";\n\nexport type ButtonProps = ButtonHTMLAttributes<HTMLButtonElement> &\n  Readonly<{\n    tone?: ButtonTone;\n    size?: ButtonSize;\n    /** Frame geometry. `pill` replaces product code that overrode `border-radius`. */\n    shape?: ButtonShape;\n    /** Label placement inside the frame; `leading` suits a full-width row action. */\n    align?: ButtonAlign;\n    /** Toggle state. Paints the selected treatment and sets `aria-pressed`. */\n    selected?: boolean;\n    loading?: boolean;\n    leading?: ReactNode;\n    trailing?: ReactNode;\n      /** Canonical layout-only placement. Controlled visual keys are excluded. */\n    layoutStyle?: HjmCompositionStyleProp;\n}>;\n\nexport const Button = forwardRef<HTMLButtonElement, ButtonProps>(function Button(\n  {\n    tone = buttonRecipe.defaults.tone,\n    size = buttonRecipe.defaults.size,\n    shape = buttonRecipe.defaults.shape,\n    align = buttonRecipe.defaults.align,\n    selected,\n    loading = false,\n    leading,\n    trailing,\n    disabled,\n    onClick,\n    type = \"button\",\n    className,\n    children,\n    layoutStyle,\n    style,\n    ...props\n  },\n  ref,\n) {\n  // Preserve a focusable disabled action (e.g. a Carousel boundary).\n  const ariaDisabled = props[\"aria-disabled\"] === true || props[\"aria-disabled\"] === \"true\";\n  const unavailable = disabled === true || loading || ariaDisabled;\n  const handleClick = (event: MouseEvent<HTMLButtonElement>) => {\n    if (unavailable) {\n      event.preventDefault();\n      event.stopPropagation();\n      return;\n    }\n    onClick?.(event);\n  };\n  return (\n    <button\n      {...props}\n      // The cap lives in the recipe, not in the stylesheet: one number, one place.\n      style={{ \"--hjm-button-label-lines\": buttonRecipe.label.maxLines, ...style, ...layoutStyle } as CSSProperties}\n      ref={ref}\n      type={type}\n      className={classNames(\"hjm-button\", className)}\n      data-tone={tone}\n      data-size={size}\n      data-shape={shape}\n      data-align={align}\n      {...(selected === undefined ? {} : { \"data-selected\": selected, \"aria-pressed\": selected })}\n      data-state={loading ? \"loading\" : unavailable ? \"disabled\" : \"idle\"}\n      aria-busy={loading || undefined}\n      aria-disabled={unavailable || undefined}\n      disabled={disabled}\n      onClick={handleClick}\n    >\n      {leading}\n      <span className=\"hjm-button__label\">{children}</span>\n      {trailing}\n      {loading ? <span className=\"hjm-button__loading-indicator\" aria-hidden=\"true\"><span className=\"hjm-button__spinner\" /></span> : null}\n    </button>\n  );\n});\n\nexport type IconButtonProps = Omit<\n  ButtonHTMLAttributes<HTMLButtonElement>,\n  \"aria-label\"\n> &\n  Readonly<{\n    label: string;\n    tone?: IconButtonTone;\n    size?: IconButtonSize;\n    shape?: IconButtonShape;\n    /** Toggle state. Paints the selected treatment and sets `aria-pressed`. */\n    selected?: boolean;\n    loading?: boolean;\n    children: ReactNode;\n      /** Canonical layout-only placement. Controlled visual keys are excluded. */\n    layoutStyle?: HjmCompositionStyleProp;\n}>;\n\nexport const IconButton = forwardRef<HTMLButtonElement, IconButtonProps>(\n  function IconButton(\n    {\n      label,\n      tone = iconButtonRecipe.defaults.tone,\n      size = iconButtonRecipe.defaults.size,\n      shape = iconButtonRecipe.defaults.shape,\n      selected,\n      loading = false,\n      disabled,\n      onClick,\n      type = \"button\",\n      className,\n      children,\n      layoutStyle,\n      style,\n      ...props\n    },\n    ref,\n  ) {\n    // Preserve a focusable disabled action (e.g. a Carousel boundary).\n    const ariaDisabled = props[\"aria-disabled\"] === true || props[\"aria-disabled\"] === \"true\";\n    const unavailable = disabled === true || loading || ariaDisabled;\n    const handleClick = (event: MouseEvent<HTMLButtonElement>) => {\n      if (unavailable) {\n        event.preventDefault();\n        event.stopPropagation();\n        return;\n      }\n      onClick?.(event);\n    };\n    return (\n      <button\n        {...props}\n        style={{ ...style, ...layoutStyle }}\n        ref={ref}\n        type={type}\n        className={classNames(\"hjm-icon-button\", className)}\n        data-tone={tone}\n        data-size={size}\n        data-shape={shape}\n        {...(selected === undefined ? {} : { \"data-selected\": selected, \"aria-pressed\": selected })}\n        data-state={loading ? \"loading\" : unavailable ? \"disabled\" : \"idle\"}\n        aria-label={label}\n        aria-busy={loading || undefined}\n        aria-disabled={unavailable || undefined}\n        disabled={disabled}\n        onClick={handleClick}\n      >\n        {loading ? <span className=\"hjm-button__spinner\" aria-hidden=\"true\" /> : children}\n      </button>\n    );\n  },\n);\n\nexport type LinkRenderProps = AnchorHTMLAttributes<HTMLAnchorElement> &\n  Readonly<{\n    children: ReactNode;\n    ref: ForwardedRef<HTMLAnchorElement>;\n    \"data-tone\": LinkTone;\n    \"data-variant\": LinkVariant;\n    \"data-state\": \"disabled\" | \"idle\";\n  }>;\n\nexport type LinkProps = AnchorHTMLAttributes<HTMLAnchorElement> &\n  Readonly<{\n    tone?: LinkTone;\n    variant?: LinkVariant;\n    disabled?: boolean;\n    leading?: ReactNode;\n    trailing?: ReactNode;\n    /** Framework adapter, for example Next.js Link, while HJM keeps link semantics and state. */\n    renderAnchor?: (props: LinkRenderProps) => ReactElement;\n    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */\n    layoutStyle?: HjmCompositionStyleProp;\n  }>;\n\nexport const Link = forwardRef<HTMLAnchorElement, LinkProps>(function Link(\n  {\n    tone = linkRecipe.defaults.tone,\n    variant = linkRecipe.defaults.variant,\n    disabled = false,\n    leading,\n    trailing,\n    renderAnchor,\n    target,\n    rel,\n    tabIndex,\n    onClick,\n    className,\n    children,\n    layoutStyle,\n    ...props\n  },\n  ref,\n) {\n  const handleClick = (event: MouseEvent<HTMLAnchorElement>) => {\n    if (disabled) {\n      event.preventDefault();\n      return;\n    }\n    onClick?.(event);\n  };\n  const anchorProps: LinkRenderProps = {\n    ...props,\n    // `renderAnchor` adapters receive the merged placement, so a framework Link\n    // gets the same position as the plain <a>.\n    ...(props.style === undefined && layoutStyle === undefined ? {} : { style: { ...props.style, ...layoutStyle } }),\n    ref,\n    className: classNames(\"hjm-link\", className),\n    \"data-tone\": tone,\n    \"data-variant\": variant,\n    \"data-state\": disabled ? \"disabled\" : \"idle\",\n    \"aria-disabled\": disabled || undefined,\n    tabIndex: disabled ? -1 : tabIndex,\n    target,\n    rel: rel ?? (target === \"_blank\" ? \"noreferrer noopener\" : undefined),\n    onClick: handleClick,\n    children: (\n      <>\n      {leading}\n      <span>{children}</span>\n      {trailing}\n      </>\n    ),\n  };\n  return renderAnchor ? renderAnchor(anchorProps) : <a {...anchorProps} />;\n});\n"]}

package/dist/activity-heatmap.d.ts

@@ -1,10 +1,13 @@
 import { type ActivityHeatmapDescriptor } from '@hjmds/design-contracts/activity-heatmap';
+import type { HjmCompositionStyleProp } from "./composition-style.js";
 export type ActivityHeatmapProps = Readonly<{
     descriptor: ActivityHeatmapDescriptor;
     label: string;
     formatDay: (date: string, value: number | null) => string;
     view?: 'grid' | 'list';
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }>;
 /** The product formats both missing data and measured zero; color never owns meaning. */
-export declare function ActivityHeatmap({ descriptor, label, formatDay, view }: ActivityHeatmapProps): import("react").JSX.Element;
+export declare function ActivityHeatmap({ descriptor, label, formatDay, view, layoutStyle }: ActivityHeatmapProps): import("react").JSX.Element;
 //# sourceMappingURL=activity-heatmap.d.ts.map

package/dist/activity-heatmap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity-heatmap.d.ts","sourceRoot":"","sources":["../src/activity-heatmap.tsx"],"names":[],"mappings":"AAAA,OAAM,EAAwB,KAAK,yBAAyB,EAAC,MAAI,0CAA0C,CAAC;AAC5G,MAAM,MAAM,oBAAoB,GAAC,QAAQ,CAAC;IAAC,UAAU,EAAC,yBAAyB,CAAC;IAAA,KAAK,EAAC,MAAM,CAAC;IAAA,SAAS,EAAC,CAAC,IAAI,EAAC,MAAM,EAAC,KAAK,EAAC,MAAM,GAAC,IAAI,KAAG,MAAM,CAAC;IAAA,IAAI,CAAC,EAAC,MAAM,GAAC,MAAM,CAAA;CAAC,CAAC,CAAC;AAErK,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,EAAC,UAAU,EAAC,KAAK,EAAC,SAAS,EAAC,IAAW,EAAC,EAAC,oBAAoB,+BAA+6B"}
+{"version":3,"file":"activity-heatmap.d.ts","sourceRoot":"","sources":["../src/activity-heatmap.tsx"],"names":[],"mappings":"AAAA,OAAM,EAAwB,KAAK,yBAAyB,EAAC,MAAI,0CAA0C,CAAC;AAC5G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAC,QAAQ,CAAC;IAAC,UAAU,EAAC,yBAAyB,CAAC;IAAA,KAAK,EAAC,MAAM,CAAC;IAAA,SAAS,EAAC,CAAC,IAAI,EAAC,MAAM,EAAC,KAAK,EAAC,MAAM,GAAC,IAAI,KAAG,MAAM,CAAC;IAAA,IAAI,CAAC,EAAC,MAAM,GAAC,MAAM,CAAC;IACjK,gGAAgG;IAChG,WAAW,CAAC,EAAE,uBAAuB,CAAC;CACvC,CAAC,CAAC;AAEH,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,EAAC,UAAU,EAAC,KAAK,EAAC,SAAS,EAAC,IAAW,EAAC,WAAW,EAAC,EAAC,oBAAoB,+BAA87B"}

package/dist/activity-heatmap.js

@@ -2,5 +2,5 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { resolveActivityHeatmap } from '@hjmds/design-contracts/activity-heatmap';
 // Compact data cells use a quarter of the control radius so the grid reads as dates, not round controls.
 /** The product formats both missing data and measured zero; color never owns meaning. */
-export function ActivityHeatmap({ descriptor, label, formatDay, view = 'grid' }) { const { days, columns } = resolveActivityHeatmap(descriptor); return _jsx("div", { role: "region", "aria-label": label, tabIndex: view === 'grid' ? 0 : undefined, style: { overflowX: 'auto' }, children: _jsx("ul", { "aria-label": label, style: view === 'grid' ? { display: 'grid', gridTemplateRows: 'repeat(7, 1rem)', gridTemplateColumns: `repeat(${columns}, 1rem)`, gap: 'var(--hjm-space-xxs)', listStyle: 'none', padding: 0, margin: 0 } : undefined, children: days.map(day => _jsx("li", { "aria-label": view === 'grid' ? formatDay(day.date, day.value) : undefined, title: formatDay(day.date, day.value), style: view === 'grid' ? { gridRow: day.row + 1, gridColumn: day.column + 1, borderRadius: 'calc(var(--hjm-radius-sm) / 4)', background: day.level === 0 ? 'var(--hjm-color-surface-alt)' : `color-mix(in srgb, var(--hjm-color-content-brand) ${25 * day.level}%, var(--hjm-color-surface-alt))`, outline: day.value === null ? '1px dashed var(--hjm-color-border)' : undefined } : undefined, children: view === 'list' ? formatDay(day.date, day.value) : null }, day.date)) }) }); }
+export function ActivityHeatmap({ descriptor, label, formatDay, view = 'grid', layoutStyle }) { const { days, columns } = resolveActivityHeatmap(descriptor); return _jsx("div", { role: "region", "aria-label": label, tabIndex: view === 'grid' ? 0 : undefined, style: { ...layoutStyle, overflowX: 'auto' }, children: _jsx("ul", { "aria-label": label, style: view === 'grid' ? { display: 'grid', gridTemplateRows: 'repeat(7, 1rem)', gridTemplateColumns: `repeat(${columns}, 1rem)`, gap: 'var(--hjm-space-xxs)', listStyle: 'none', padding: 0, margin: 0 } : undefined, children: days.map(day => _jsx("li", { "aria-label": view === 'grid' ? formatDay(day.date, day.value) : undefined, title: formatDay(day.date, day.value), style: view === 'grid' ? { gridRow: day.row + 1, gridColumn: day.column + 1, borderRadius: 'calc(var(--hjm-radius-sm) / 4)', background: day.level === 0 ? 'var(--hjm-color-surface-alt)' : `color-mix(in srgb, var(--hjm-color-content-brand) ${25 * day.level}%, var(--hjm-color-surface-alt))`, outline: day.value === null ? '1px dashed var(--hjm-color-border)' : undefined } : undefined, children: view === 'list' ? formatDay(day.date, day.value) : null }, day.date)) }) }); }
 //# sourceMappingURL=activity-heatmap.js.map

package/dist/activity-heatmap.js.map

@@ -1 +1 @@
-{"version":3,"file":"activity-heatmap.js","sourceRoot":"","sources":["../src/activity-heatmap.tsx"],"names":[],"mappings":";AAAA,OAAM,EAAC,sBAAsB,EAAgC,MAAI,0CAA0C,CAAC;AAE5G,yGAAyG;AACzG,yFAAyF;AACzF,MAAM,UAAU,eAAe,CAAC,EAAC,UAAU,EAAC,KAAK,EAAC,SAAS,EAAC,IAAI,GAAC,MAAM,EAAsB,IAAE,MAAM,EAAC,IAAI,EAAC,OAAO,EAAC,GAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAA,OAAO,cAAK,IAAI,EAAC,QAAQ,gBAAa,KAAK,EAAE,QAAQ,EAAE,IAAI,KAAG,MAAM,CAAA,CAAC,CAAA,CAAC,CAAA,CAAC,CAAA,SAAS,EAAE,KAAK,EAAE,EAAC,SAAS,EAAC,MAAM,EAAC,YAAE,2BAAgB,KAAK,EAAE,KAAK,EAAE,IAAI,KAAG,MAAM,CAAA,CAAC,CAAA,EAAC,OAAO,EAAC,MAAM,EAAC,gBAAgB,EAAC,iBAAiB,EAAC,mBAAmB,EAAC,UAAU,OAAO,SAAS,EAAC,GAAG,EAAC,sBAAsB,EAAC,SAAS,EAAC,MAAM,EAAC,OAAO,EAAC,CAAC,EAAC,MAAM,EAAC,CAAC,EAAC,CAAA,CAAC,CAAA,SAAS,YAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA,EAAE,CAAA,2BAA+B,IAAI,KAAG,MAAM,CAAA,CAAC,CAAA,SAAS,CAAC,GAAG,CAAC,IAAI,EAAC,GAAG,CAAC,KAAK,CAAC,CAAA,CAAC,CAAA,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,EAAC,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,KAAG,MAAM,CAAA,CAAC,CAAA,EAAC,OAAO,EAAC,GAAG,CAAC,GAAG,GAAC,CAAC,EAAC,UAAU,EAAC,GAAG,CAAC,MAAM,GAAC,CAAC,EAAC,YAAY,EAAC,gCAAgC,EAAC,UAAU,EAAC,GAAG,CAAC,KAAK,KAAG,CAAC,CAAA,CAAC,CAAA,8BAA8B,CAAA,CAAC,CAAA,qDAAqD,EAAE,GAAC,GAAG,CAAC,KAAK,kCAAkC,EAAC,OAAO,EAAC,GAAG,CAAC,KAAK,KAAG,IAAI,CAAA,CAAC,CAAA,oCAAoC,CAAA,CAAC,CAAA,SAAS,EAAC,CAAA,CAAC,CAAA,SAAS,YAAG,IAAI,KAAG,MAAM,CAAA,CAAC,CAAA,SAAS,CAAC,GAAG,CAAC,IAAI,EAAC,GAAG,CAAC,KAAK,CAAC,CAAA,CAAC,CAAA,IAAI,IAAlgB,GAAG,CAAC,IAAI,CAAggB,CAAC,GAAM,GAAM,CAAC,CAAA,CAAC","sourcesContent":["import{resolveActivityHeatmap,type ActivityHeatmapDescriptor}from'@hjmds/design-contracts/activity-heatmap';\nexport type ActivityHeatmapProps=Readonly<{descriptor:ActivityHeatmapDescriptor;label:string;formatDay:(date:string,value:number|null)=>string;view?:'grid'|'list'}>;\n// Compact data cells use a quarter of the control radius so the grid reads as dates, not round controls.\n/** The product formats both missing data and measured zero; color never owns meaning. */\nexport function ActivityHeatmap({descriptor,label,formatDay,view='grid'}:ActivityHeatmapProps){const {days,columns}=resolveActivityHeatmap(descriptor);return <div role=\"region\" aria-label={label} tabIndex={view==='grid'?0:undefined} style={{overflowX:'auto'}}><ul aria-label={label} style={view==='grid'?{display:'grid',gridTemplateRows:'repeat(7, 1rem)',gridTemplateColumns:`repeat(${columns}, 1rem)`,gap:'var(--hjm-space-xxs)',listStyle:'none',padding:0,margin:0}:undefined}>{days.map(day=><li key={day.date} aria-label={view==='grid'?formatDay(day.date,day.value):undefined} title={formatDay(day.date,day.value)} style={view==='grid'?{gridRow:day.row+1,gridColumn:day.column+1,borderRadius:'calc(var(--hjm-radius-sm) / 4)',background:day.level===0?'var(--hjm-color-surface-alt)':`color-mix(in srgb, var(--hjm-color-content-brand) ${25*day.level}%, var(--hjm-color-surface-alt))`,outline:day.value===null?'1px dashed var(--hjm-color-border)':undefined}:undefined}>{view==='list'?formatDay(day.date,day.value):null}</li>)}</ul></div>;}\n"]}
+{"version":3,"file":"activity-heatmap.js","sourceRoot":"","sources":["../src/activity-heatmap.tsx"],"names":[],"mappings":";AAAA,OAAM,EAAC,sBAAsB,EAAgC,MAAI,0CAA0C,CAAC;AAM5G,yGAAyG;AACzG,yFAAyF;AACzF,MAAM,UAAU,eAAe,CAAC,EAAC,UAAU,EAAC,KAAK,EAAC,SAAS,EAAC,IAAI,GAAC,MAAM,EAAC,WAAW,EAAsB,IAAE,MAAM,EAAC,IAAI,EAAC,OAAO,EAAC,GAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAA,OAAO,cAAK,IAAI,EAAC,QAAQ,gBAAa,KAAK,EAAE,QAAQ,EAAE,IAAI,KAAG,MAAM,CAAA,CAAC,CAAA,CAAC,CAAA,CAAC,CAAA,SAAS,EAAE,KAAK,EAAE,EAAC,GAAG,WAAW,EAAC,SAAS,EAAC,MAAM,EAAC,YAAE,2BAAgB,KAAK,EAAE,KAAK,EAAE,IAAI,KAAG,MAAM,CAAA,CAAC,CAAA,EAAC,OAAO,EAAC,MAAM,EAAC,gBAAgB,EAAC,iBAAiB,EAAC,mBAAmB,EAAC,UAAU,OAAO,SAAS,EAAC,GAAG,EAAC,sBAAsB,EAAC,SAAS,EAAC,MAAM,EAAC,OAAO,EAAC,CAAC,EAAC,MAAM,EAAC,CAAC,EAAC,CAAA,CAAC,CAAA,SAAS,YAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA,EAAE,CAAA,2BAA+B,IAAI,KAAG,MAAM,CAAA,CAAC,CAAA,SAAS,CAAC,GAAG,CAAC,IAAI,EAAC,GAAG,CAAC,KAAK,CAAC,CAAA,CAAC,CAAA,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,EAAC,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,KAAG,MAAM,CAAA,CAAC,CAAA,EAAC,OAAO,EAAC,GAAG,CAAC,GAAG,GAAC,CAAC,EAAC,UAAU,EAAC,GAAG,CAAC,MAAM,GAAC,CAAC,EAAC,YAAY,EAAC,gCAAgC,EAAC,UAAU,EAAC,GAAG,CAAC,KAAK,KAAG,CAAC,CAAA,CAAC,CAAA,8BAA8B,CAAA,CAAC,CAAA,qDAAqD,EAAE,GAAC,GAAG,CAAC,KAAK,kCAAkC,EAAC,OAAO,EAAC,GAAG,CAAC,KAAK,KAAG,IAAI,CAAA,CAAC,CAAA,oCAAoC,CAAA,CAAC,CAAA,SAAS,EAAC,CAAA,CAAC,CAAA,SAAS,YAAG,IAAI,KAAG,MAAM,CAAA,CAAC,CAAA,SAAS,CAAC,GAAG,CAAC,IAAI,EAAC,GAAG,CAAC,KAAK,CAAC,CAAA,CAAC,CAAA,IAAI,IAAlgB,GAAG,CAAC,IAAI,CAAggB,CAAC,GAAM,GAAM,CAAC,CAAA,CAAC","sourcesContent":["import{resolveActivityHeatmap,type ActivityHeatmapDescriptor}from'@hjmds/design-contracts/activity-heatmap';\nimport type { HjmCompositionStyleProp } from \"./composition-style.js\";\nexport type ActivityHeatmapProps=Readonly<{descriptor:ActivityHeatmapDescriptor;label:string;formatDay:(date:string,value:number|null)=>string;view?:'grid'|'list';\n  /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */\n  layoutStyle?: HjmCompositionStyleProp;\n}>;\n// Compact data cells use a quarter of the control radius so the grid reads as dates, not round controls.\n/** The product formats both missing data and measured zero; color never owns meaning. */\nexport function ActivityHeatmap({descriptor,label,formatDay,view='grid',layoutStyle}:ActivityHeatmapProps){const {days,columns}=resolveActivityHeatmap(descriptor);return <div role=\"region\" aria-label={label} tabIndex={view==='grid'?0:undefined} style={{...layoutStyle,overflowX:'auto'}}><ul aria-label={label} style={view==='grid'?{display:'grid',gridTemplateRows:'repeat(7, 1rem)',gridTemplateColumns:`repeat(${columns}, 1rem)`,gap:'var(--hjm-space-xxs)',listStyle:'none',padding:0,margin:0}:undefined}>{days.map(day=><li key={day.date} aria-label={view==='grid'?formatDay(day.date,day.value):undefined} title={formatDay(day.date,day.value)} style={view==='grid'?{gridRow:day.row+1,gridColumn:day.column+1,borderRadius:'calc(var(--hjm-radius-sm) / 4)',background:day.level===0?'var(--hjm-color-surface-alt)':`color-mix(in srgb, var(--hjm-color-content-brand) ${25*day.level}%, var(--hjm-color-surface-alt))`,outline:day.value===null?'1px dashed var(--hjm-color-border)':undefined}:undefined}>{view==='list'?formatDay(day.date,day.value):null}</li>)}</ul></div>;}\n"]}

package/dist/advanced-display.d.ts

@@ -1,4 +1,4 @@
-import type { AvatarFallbackContext } from "@hjmds/design-contracts/avatar-fallback";
+import { type AvatarFallbackContext } from "@hjmds/design-contracts/avatar-fallback";
 import { type DescriptionItemDescriptor, type DescriptionListColumns } from "@hjmds/design-contracts/components/description-list";
 import { type ComposeTimelineAccessibleName, type TimelineItemDescriptor } from "@hjmds/design-contracts/components/timeline";
 import { type ResolvedStatisticDescriptor, type StatisticDescriptor, type StatisticGroupDescriptor } from "@hjmds/design-contracts/components/statistic";
@@ -19,6 +19,8 @@ export type AccordionProps = Omit<HTMLAttributes<HTMLDivElement>, "onChange"> &
     allowsMultipleExpanded?: boolean;
     density?: AccordionDensity;
     headingLevel?: 2 | 3 | 4 | 5 | 6;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }>;
 export declare const Accordion: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivElement>, "onChange"> & Readonly<{
     items: readonly AccordionItem[];
@@ -28,6 +30,8 @@ export declare const Accordion: import("react").ForwardRefExoticComponent<Omit<H
     allowsMultipleExpanded?: boolean;
     density?: AccordionDensity;
     headingLevel?: 2 | 3 | 4 | 5 | 6;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }> & RefAttributes<HTMLDivElement>>;
 export type AvatarProps = Omit<HTMLAttributes<HTMLSpanElement>, "children"> & Readonly<{
     name: string;
@@ -38,6 +42,8 @@ export type AvatarProps = Omit<HTMLAttributes<HTMLSpanElement>, "children"> & Re
     size?: AvatarSize;
     shape?: AvatarShape;
     imageProps?: Omit<ImgHTMLAttributes<HTMLImageElement>, "alt" | "src">;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }>;
 export declare const Avatar: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLSpanElement>, "children"> & Readonly<{
     name: string;
@@ -48,6 +54,8 @@ export declare const Avatar: import("react").ForwardRefExoticComponent<Omit<HTML
     size?: AvatarSize;
     shape?: AvatarShape;
     imageProps?: Omit<ImgHTMLAttributes<HTMLImageElement>, "alt" | "src">;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }> & RefAttributes<HTMLSpanElement>>;
 export type AvatarGroupProps = Omit<HTMLAttributes<HTMLSpanElement>, "children"> & Readonly<{
     /** Required: a pile of faces is meaningless to a screen reader otherwise. */
@@ -56,6 +64,8 @@ export type AvatarGroupProps = Omit<HTMLAttributes<HTMLSpanElement>, "children">
     size?: AvatarSize;
     /** Product-composed overflow copy such as "+3"; the count is the product's. */
     overflow?: ReactNode;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }>;
 /**
  * Overlapping avatars. The overlap comes from the recipe ratio rather than a
@@ -69,6 +79,8 @@ export declare const AvatarGroup: import("react").ForwardRefExoticComponent<Omit
     size?: AvatarSize;
     /** Product-composed overflow copy such as "+3"; the count is the product's. */
     overflow?: ReactNode;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }> & RefAttributes<HTMLSpanElement>>;
 export type DividerOrientation = "horizontal" | "vertical";
 export type DividerInset = keyof typeof dividerRecipe.insets;
@@ -76,11 +88,15 @@ export type DividerProps = HTMLAttributes<HTMLElement> & Readonly<{
     orientation?: DividerOrientation;
     inset?: DividerInset;
     decorative?: boolean;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }>;
 export declare const Divider: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & Readonly<{
     orientation?: DividerOrientation;
     inset?: DividerInset;
     decorative?: boolean;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }> & RefAttributes<HTMLElement>>;
 export type ListAppearance = "grouped" | "plain";
 export type ListProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & Readonly<{
@@ -88,6 +104,8 @@ export type ListProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & Reado
     children: ReactNode;
     separator?: keyof typeof listRecipe.separators;
     appearance?: ListAppearance;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }>;
 /** Semantic list container that owns separators around composed rows. */
 export declare const List: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivElement>, "children"> & Readonly<{
@@ -95,6 +113,8 @@ export declare const List: import("react").ForwardRefExoticComponent<Omit<HTMLAt
     children: ReactNode;
     separator?: keyof typeof listRecipe.separators;
     appearance?: ListAppearance;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }> & RefAttributes<HTMLDivElement>>;
 export type StatisticTrendMarkRenderProps = Readonly<{
     name: "trendUp" | "trendDown" | "trendFlat";
@@ -116,8 +136,10 @@ export type StatisticProps<Id extends string = string> = Omit<HTMLAttributes<HTM
     renderTrendMark?: (props: StatisticTrendMarkRenderProps) => ReactNode;
     /** Optional visual adapter; the descriptor remains the accessible value source. */
     renderValue?: (value: string) => ReactNode;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }>;
-export declare function Statistic<Id extends string = string>({ descriptor, density, presentation, contextLabel, accessibilityLabel, composeAccessibilityLabel, renderTrendMark, renderValue, className, ...props }: StatisticProps<Id>): import("react").JSX.Element;
+export declare function Statistic<Id extends string = string>({ descriptor, density, presentation, contextLabel, accessibilityLabel, composeAccessibilityLabel, renderTrendMark, renderValue, className, layoutStyle, ...props }: StatisticProps<Id>): import("react").JSX.Element;
 export type StatisticGroupProps<Id extends string = string> = Omit<HTMLAttributes<HTMLDivElement>, "children"> & Readonly<{
     label: string;
     descriptor: StatisticGroupDescriptor<Id>;
@@ -125,8 +147,10 @@ export type StatisticGroupProps<Id extends string = string> = Omit<HTMLAttribute
     presentation?: StatisticPresentation;
     composeAccessibilityLabel?: ComposeStatisticAccessibilityLabel<Id>;
     renderTrendMark?: (props: StatisticTrendMarkRenderProps) => ReactNode;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }>;
-export declare function StatisticGroup<Id extends string = string>({ label, descriptor, density, presentation, composeAccessibilityLabel, renderTrendMark, className, style, ...props }: StatisticGroupProps<Id>): import("react").JSX.Element;
+export declare function StatisticGroup<Id extends string = string>({ label, descriptor, density, presentation, composeAccessibilityLabel, renderTrendMark, className, style, layoutStyle, ...props }: StatisticGroupProps<Id>): import("react").JSX.Element;
 export type DescriptionListProps<Id extends string = string> = Omit<HTMLAttributes<HTMLDListElement>, "children"> & Readonly<{
     items: readonly DescriptionItemDescriptor<Id>[];
     columns?: DescriptionListColumns;
@@ -152,11 +176,15 @@ export type TableProps<Row> = Omit<TableHTMLAttributes<HTMLTableElement>, "child
     emptyState: ReactNode;
     onSortChange?: (columnId: string, direction: TableSortDirection) => void;
     wrapperClassName?: string;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }>;
 export declare const Table: <Row>(props: TableProps<Row> & RefAttributes<HTMLTableElement>) => ReactElement;
 export type TimelineProps<Id extends string = string> = Omit<HTMLAttributes<HTMLOListElement>, "children"> & Readonly<{
     items: readonly TimelineItemDescriptor<Id>[];
     composeAccessibleName: ComposeTimelineAccessibleName;
+    /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
+    layoutStyle?: HjmCompositionStyleProp;
 }>;
 export declare const Timeline: <Id extends string = string>(props: TimelineProps<Id> & RefAttributes<HTMLOListElement>) => ReactElement;
 //# sourceMappingURL=advanced-display.d.ts.map

package/dist/advanced-display.d.ts.map

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

package/dist/advanced-display.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { resolveAvatarInitials } from "@hjmds/design-contracts/avatar-fallback";
 import { TableSortButton } from "./table-sort-button.js";
 import { getNextDataTableSortState } from "@hjmds/design-contracts/components/data-table";
 import { resolveDescriptionListColumnCount, resolveDescriptionListDescriptor, } from "@hjmds/design-contracts/components/description-list";
@@ -40,7 +41,7 @@ function accordionFocusTarget(items, currentIndex, key) {
     }
     return currentIndex;
 }
-export const Accordion = forwardRef(function Accordion({ items, value: valueProp, defaultValue = [], onValueChange, allowsMultipleExpanded = accordionRecipe.defaults.allowsMultipleExpanded, density = accordionRecipe.defaults.density, headingLevel = 3, className, ...props }, ref) {
+export const Accordion = forwardRef(function Accordion({ items, value: valueProp, defaultValue = [], onValueChange, allowsMultipleExpanded = accordionRecipe.defaults.allowsMultipleExpanded, density = accordionRecipe.defaults.density, headingLevel = 3, className, layoutStyle, ...props }, ref) {
     validateAccordionItems(items);
     const [value, setValue] = useControllableState({
         ...(valueProp === undefined ? {} : { value: valueProp }),
@@ -69,7 +70,7 @@ export const Accordion = forwardRef(function Accordion({ items, value: valueProp
                 ? [...value, id]
                 : [id]);
     };
-    return (_jsx("div", { ...props, ref: ref, className: classNames("hjm-accordion", className), "data-density": density, "data-multiple": allowsMultipleExpanded || undefined, children: items.map((item, index) => {
+    return (_jsx("div", { ...props, style: { ...props.style, ...layoutStyle }, ref: ref, className: classNames("hjm-accordion", className), "data-density": density, "data-multiple": allowsMultipleExpanded || undefined, children: items.map((item, index) => {
             const expanded = value.includes(item.id);
             const triggerId = `${baseId}-accordion-trigger-${index}`;
             const panelId = `${baseId}-accordion-panel-${index}`;
@@ -88,40 +89,35 @@ export const Accordion = forwardRef(function Accordion({ items, value: valueProp
             return (_jsxs("div", { className: "hjm-accordion__item", "data-state": item.disabled ? "disabled" : expanded ? "expanded" : "collapsed", children: [createElement(`h${headingLevel}`, { className: "hjm-accordion__header" }, trigger), _jsx("div", { id: panelId, role: "region", className: "hjm-accordion__panel", "aria-labelledby": triggerId, hidden: !expanded, children: item.panel })] }, item.id));
         }) }));
 });
-function initials(name) {
-    return name
-        .trim()
-        .split(/\s+/u)
-        .slice(0, 2)
-        .map((part) => Array.from(part)[0] ?? "")
-        .join("")
-        .toLocaleUpperCase();
-}
-export const Avatar = forwardRef(function Avatar({ name, src, alt = name, fallback, renderFallback, size = avatarRecipe.defaults.size, shape = avatarRecipe.defaults.shape, imageProps, className, ...props }, ref) {
+export const Avatar = forwardRef(function Avatar({ name, src, alt = name, fallback, renderFallback, size = avatarRecipe.defaults.size, shape = avatarRecipe.defaults.shape, imageProps, className, layoutStyle, ...props }, ref) {
     if (name.trim().length === 0)
         throw new TypeError("Avatar name must not be empty");
     const [imageAvailable, setImageAvailable] = useState(Boolean(src));
     useEffect(() => setImageAvailable(Boolean(src)), [src]);
     const { onError, className: imageClassName, ...restImageProps } = imageProps ?? {};
-    return (_jsx("span", { ...props, ref: ref, className: classNames("hjm-avatar", className), "data-size": size, "data-shape": shape, "data-state": imageAvailable ? "image" : "fallback", children: src && imageAvailable ? (_jsx("img", { ...restImageProps, src: src, alt: alt, className: classNames("hjm-avatar__image", imageClassName), onError: (event) => {
+    return (_jsx("span", { ...props, style: { ...props.style, ...layoutStyle }, ref: ref, className: classNames("hjm-avatar", className), "data-size": size, "data-shape": shape, "data-state": imageAvailable ? "image" : "fallback", children: src && imageAvailable ? (_jsx("img", { ...restImageProps, src: src, alt: alt, className: classNames("hjm-avatar__image", imageClassName), onError: (event) => {
                 setImageAvailable(false);
                 onError?.(event);
-            } })) : (_jsx("span", { className: "hjm-avatar__fallback", role: alt.length > 0 ? "img" : undefined, "aria-label": alt.length > 0 ? alt : undefined, "aria-hidden": alt.length === 0 || undefined, children: renderFallback?.({ size: avatarRecipe.sizes[size], decorative: true }) ?? fallback ?? initials(name) })) }));
+            } })) : (_jsx("span", { className: "hjm-avatar__fallback", role: alt.length > 0 ? "img" : undefined, "aria-label": alt.length > 0 ? alt : undefined, "aria-hidden": alt.length === 0 || undefined, children: renderFallback?.({ size: avatarRecipe.sizes[size], decorative: true }) ?? fallback ?? resolveAvatarInitials(name) })) }));
 });
 /**
  * Overlapping avatars. The overlap comes from the recipe ratio rather than a
  * pixel value so it holds across all four sizes, and the group carries one
  * accessible name instead of letting a reader walk five unlabelled images.
  */
-export const AvatarGroup = forwardRef(function AvatarGroup({ label, children, size = avatarRecipe.defaults.size, overflow, className, ...props }, ref) {
+export const AvatarGroup = forwardRef(function AvatarGroup({ label, children, size = avatarRecipe.defaults.size, overflow, className, layoutStyle, style, ...props }, ref) {
     if (label.trim().length === 0)
         throw new TypeError("AvatarGroup label must not be empty");
     const offset = Math.round(avatarRecipe.sizes[size] * avatarRecipe.overlapRatio);
-    return (_jsxs("span", { ...props, ref: ref, role: "group", "aria-label": label, className: classNames("hjm-avatar-group", className), "data-size": size, style: { "--hjm-avatar-overlap": `${offset}px` }, children: [children, overflow ? _jsx("span", { className: "hjm-avatar-group__overflow", "aria-hidden": "true", children: overflow }) : null] }));
+    return (_jsxs("span", { ...props, ref: ref, role: "group", "aria-label": label, className: classNames("hjm-avatar-group", className), "data-size": size, 
+        // The caller `style` used to be replaced by the overlap variable; merge it
+        // and keep the recipe overlap last so it stays size-derived.
+        style: { ...style, ...layoutStyle, "--hjm-avatar-overlap": `${offset}px` }, children: [children, overflow ? _jsx("span", { className: "hjm-avatar-group__overflow", "aria-hidden": "true", children: overflow }) : null] }));
 });
-export const Divider = forwardRef(function Divider({ orientation = dividerRecipe.defaults.orientation, inset = dividerRecipe.defaults.inset, decorative = false, className, ...props }, ref) {
+export const Divider = forwardRef(function Divider({ orientation = dividerRecipe.defaults.orientation, inset = dividerRecipe.defaults.inset, decorative = false, className, layoutStyle, ...props }, ref) {
     return createElement(orientation === "horizontal" ? "hr" : "div", {
         ...props,
+        style: { ...props.style, ...layoutStyle },
         ref,
         className: classNames("hjm-divider", className),
         "data-orientation": orientation,
@@ -132,13 +128,13 @@ export const Divider = forwardRef(function Divider({ orientation = dividerRecipe
     });
 });
 /** Semantic list container that owns separators around composed rows. */
-export const List = forwardRef(function List({ label, children, separator = listRecipe.defaults.separator, appearance = "plain", className, ...props }, ref) {
+export const List = forwardRef(function List({ label, children, separator = listRecipe.defaults.separator, appearance = "plain", className, layoutStyle, ...props }, ref) {
     if (!label.trim())
         throw new TypeError("List label must not be empty");
     const items = Children.toArray(children);
-    return (_jsx("div", { ...props, ref: ref, "aria-label": label, className: classNames("hjm-list", className), "data-appearance": appearance, "data-separator": separator, role: "list", children: items.map((item, index) => (_jsx("div", { className: "hjm-list__item", role: "listitem", children: item }, isValidElement(item) && item.key !== null ? item.key : `hjm-list-${index}`))) }));
+    return (_jsx("div", { ...props, style: { ...props.style, ...layoutStyle }, ref: ref, "aria-label": label, className: classNames("hjm-list", className), "data-appearance": appearance, "data-separator": separator, role: "list", children: items.map((item, index) => (_jsx("div", { className: "hjm-list__item", role: "listitem", children: item }, isValidElement(item) && item.key !== null ? item.key : `hjm-list-${index}`))) }));
 });
-export function Statistic({ descriptor, density = "comfortable", presentation = "plain", contextLabel, accessibilityLabel, composeAccessibilityLabel, renderTrendMark, renderValue, className, ...props }) {
+export function Statistic({ descriptor, density = "comfortable", presentation = "plain", contextLabel, accessibilityLabel, composeAccessibilityLabel, renderTrendMark, renderValue, className, layoutStyle, ...props }) {
     const resolved = resolveStatisticDescriptor(descriptor);
     const valueText = `${resolved.prefix ?? ""}${resolved.value}${resolved.suffix ?? ""}`;
     const announcement = accessibilityLabel ?? composeAccessibilityLabel?.({
@@ -153,13 +149,13 @@ export function Statistic({ descriptor, density = "comfortable", presentation =
     const trendName = resolved.trend
         ? statisticRecipe.trend.marks[resolved.trend.direction]
         : undefined;
-    return (_jsxs("article", { ...props, "aria-label": announcement, className: classNames("hjm-statistic", className), "data-density": density, "data-presentation": presentation, children: [_jsx("span", { "aria-hidden": "true", className: "hjm-statistic__label", children: resolved.label }), _jsxs("span", { "aria-hidden": "true", className: "hjm-statistic__value-row", children: [resolved.prefix ? _jsx("span", { className: "hjm-statistic__affix", children: resolved.prefix }) : null, _jsx("strong", { className: "hjm-statistic__value", children: renderValue?.(resolved.value) ?? resolved.value }), resolved.suffix ? _jsx("span", { className: "hjm-statistic__affix", children: resolved.suffix }) : null] }), resolved.trend ? (_jsxs("span", { "aria-hidden": "true", className: "hjm-statistic__trend", "data-tone": resolved.trend.tone, children: [_jsx("span", { className: "hjm-statistic__trend-mark", children: renderTrendMark?.({ name: trendName, color: "currentColor", size: 16 }) ?? (resolved.trend.direction === "up" ? "↑" : resolved.trend.direction === "down" ? "↓" : "—") }), resolved.trend.label] })) : null, resolved.hint ? _jsx("span", { "aria-hidden": "true", className: "hjm-statistic__hint", children: resolved.hint }) : null] }));
+    return (_jsxs("article", { ...props, style: { ...props.style, ...layoutStyle }, "aria-label": announcement, className: classNames("hjm-statistic", className), "data-density": density, "data-presentation": presentation, children: [_jsx("span", { "aria-hidden": "true", className: "hjm-statistic__label", children: resolved.label }), _jsxs("span", { "aria-hidden": "true", className: "hjm-statistic__value-row", children: [resolved.prefix ? _jsx("span", { className: "hjm-statistic__affix", children: resolved.prefix }) : null, _jsx("strong", { className: "hjm-statistic__value", children: renderValue?.(resolved.value) ?? resolved.value }), resolved.suffix ? _jsx("span", { className: "hjm-statistic__affix", children: resolved.suffix }) : null] }), resolved.trend ? (_jsxs("span", { "aria-hidden": "true", className: "hjm-statistic__trend", "data-tone": resolved.trend.tone, children: [_jsx("span", { className: "hjm-statistic__trend-mark", children: renderTrendMark?.({ name: trendName, color: "currentColor", size: 16 }) ?? (resolved.trend.direction === "up" ? "↑" : resolved.trend.direction === "down" ? "↓" : "—") }), resolved.trend.label] })) : null, resolved.hint ? _jsx("span", { "aria-hidden": "true", className: "hjm-statistic__hint", children: resolved.hint }) : null] }));
 }
-export function StatisticGroup({ label, descriptor, density, presentation, composeAccessibilityLabel, renderTrendMark, className, style, ...props }) {
+export function StatisticGroup({ label, descriptor, density, presentation, composeAccessibilityLabel, renderTrendMark, className, style, layoutStyle, ...props }) {
     validateStatisticGroup(descriptor);
     if (!label.trim())
         throw new TypeError("StatisticGroup label must not be empty");
-    return (_jsx("div", { ...props, "aria-label": label, className: classNames("hjm-statistic-group", className), role: "list", style: { ...style, "--hjm-statistic-columns": descriptor.columns ?? statisticRecipe.defaults.columns }, children: descriptor.items.map((item) => (_jsx("div", { role: "listitem", children: _jsx(Statistic, { contextLabel: label, descriptor: item, ...(composeAccessibilityLabel === undefined ? {} : { composeAccessibilityLabel }), ...(density === undefined ? {} : { density }), ...(presentation === undefined ? {} : { presentation }), ...(renderTrendMark === undefined ? {} : { renderTrendMark }) }) }, item.id))) }));
+    return (_jsx("div", { ...props, "aria-label": label, className: classNames("hjm-statistic-group", className), role: "list", style: { ...style, ...layoutStyle, "--hjm-statistic-columns": descriptor.columns ?? statisticRecipe.defaults.columns }, children: descriptor.items.map((item) => (_jsx("div", { role: "listitem", children: _jsx(Statistic, { contextLabel: label, descriptor: item, ...(composeAccessibilityLabel === undefined ? {} : { composeAccessibilityLabel }), ...(density === undefined ? {} : { density }), ...(presentation === undefined ? {} : { presentation }), ...(renderTrendMark === undefined ? {} : { renderTrendMark }) }) }, item.id))) }));
 }
 function DescriptionListInner({ items, columns, className, layoutStyle, style, ...props }, forwardedRef) {
     const descriptor = resolveDescriptionListDescriptor({
@@ -178,7 +174,7 @@ function DescriptionListInner({ items, columns, className, layoutStyle, style, .
 }
 export const DescriptionList = forwardRef(DescriptionListInner);
 // Table's callback cannot express null; share the sort policy with a two-state cycle.
-function TableInner({ columns, rows, getRowKey, caption, emptyState, onSortChange, wrapperClassName, className, ...props }, ref) {
+function TableInner({ columns, rows, getRowKey, caption, emptyState, onSortChange, wrapperClassName, className, layoutStyle, ...props }, ref) {
     if (columns.length === 0)
         throw new TypeError("Table requires at least one column");
     const ids = new Set();
@@ -201,15 +197,18 @@ function TableInner({ columns, rows, getRowKey, caption, emptyState, onSortChang
             throw new TypeError(`Duplicate Table row key: ${rowKey}`);
         seenRowKeys.add(rowKey);
     }
-    return (_jsx("div", { className: classNames("hjm-table-scroll", wrapperClassName), tabIndex: 0, children: _jsxs("table", { ...props, ref: ref, className: classNames("hjm-table", className), children: [caption ? _jsx("caption", { className: "hjm-table__caption", children: caption }) : null, _jsx("thead", { children: _jsx("tr", { children: columns.map((column) => (_jsx("th", { scope: "col", className: "hjm-table__header", "data-align": column.align ?? "start", "aria-sort": column.sortDirection ?? (column.sortable ? "none" : undefined), children: column.sortable ? (_jsx(TableSortButton, { header: column.header, ...(column.sortDirection === undefined ? {} : { direction: column.sortDirection }), glyphs: { ascending: " ↑", descending: " ↓", none: " ↕" }, className: "hjm-table__sort", onSort: () => {
+    return (
+    // Placement belongs to the scroll wrapper (the visual root); `style` keeps
+    // going to the <table>, where it always went.
+    _jsx("div", { className: classNames("hjm-table-scroll", wrapperClassName), style: layoutStyle, tabIndex: 0, children: _jsxs("table", { ...props, ref: ref, className: classNames("hjm-table", className), children: [caption ? _jsx("caption", { className: "hjm-table__caption", children: caption }) : null, _jsx("thead", { children: _jsx("tr", { children: columns.map((column) => (_jsx("th", { scope: "col", className: "hjm-table__header", "data-align": column.align ?? "start", "aria-sort": column.sortDirection ?? (column.sortable ? "none" : undefined), children: column.sortable ? (_jsx(TableSortButton, { header: column.header, ...(column.sortDirection === undefined ? {} : { direction: column.sortDirection }), glyphs: { ascending: " ↑", descending: " ↓", none: " ↕" }, className: "hjm-table__sort", onSort: () => {
                                     const next = getNextDataTableSortState(column.sortDirection ? { columnId: column.id, direction: column.sortDirection } : null, column.id, "two-state");
                                     onSortChange?.(column.id, next.direction);
                                 } })) : column.header }, column.id))) }) }), _jsx("tbody", { children: rows.length === 0 ? (_jsx("tr", { children: _jsx("td", { className: "hjm-table__empty", colSpan: columns.length, children: emptyState }) })) : (rows.map((row, rowIndex) => (_jsx("tr", { className: "hjm-table__row", children: columns.map((column) => (_jsx("td", { className: "hjm-table__cell", "data-align": column.align ?? "start", children: column.cell(row, rowIndex) }, column.id))) }, rowKeys[rowIndex])))) })] }) }));
 }
 export const Table = forwardRef(TableInner);
-function TimelineInner({ items, composeAccessibleName, className, ...props }, ref) {
+function TimelineInner({ items, composeAccessibleName, className, layoutStyle, ...props }, ref) {
     const resolved = resolveTimelineDescriptor({ items }, { composeAccessibleName });
-    return (_jsx("ol", { ...props, ref: ref, className: classNames("hjm-timeline", className), children: resolved.map((item, index) => (_jsxs("li", { "aria-label": item.accessibleName, className: "hjm-timeline__item", "data-tone": item.tone, children: [_jsxs("span", { className: "hjm-timeline__rail", "aria-hidden": "true", children: [_jsx("span", { className: "hjm-timeline__dot" }), index < resolved.length - 1 ? (_jsx("span", { className: "hjm-timeline__connector" })) : null] }), _jsxs("span", { className: "hjm-timeline__content", children: [_jsxs("span", { className: "hjm-timeline__heading", children: [_jsx("strong", { className: "hjm-timeline__label", children: item.label }), item.timestamp ? (_jsx("time", { className: "hjm-timeline__timestamp", children: item.timestamp })) : null] }), item.description ? (_jsx("span", { className: "hjm-timeline__description", children: item.description })) : null] })] }, item.id))) }));
+    return (_jsx("ol", { ...props, style: { ...props.style, ...layoutStyle }, ref: ref, className: classNames("hjm-timeline", className), children: resolved.map((item, index) => (_jsxs("li", { "aria-label": item.accessibleName, className: "hjm-timeline__item", "data-tone": item.tone, children: [_jsxs("span", { className: "hjm-timeline__rail", "aria-hidden": "true", children: [_jsx("span", { className: "hjm-timeline__dot" }), index < resolved.length - 1 ? (_jsx("span", { className: "hjm-timeline__connector" })) : null] }), _jsxs("span", { className: "hjm-timeline__content", children: [_jsxs("span", { className: "hjm-timeline__heading", children: [_jsx("strong", { className: "hjm-timeline__label", children: item.label }), item.timestamp ? (_jsx("time", { className: "hjm-timeline__timestamp", children: item.timestamp })) : null] }), item.description ? (_jsx("span", { className: "hjm-timeline__description", children: item.description })) : null] })] }, item.id))) }));
 }
 export const Timeline = forwardRef(TimelineInner);
 //# sourceMappingURL=advanced-display.js.map