@hjmds/react 1.30.0 → 1.32.0

package/dist/steps.d.ts

@@ -6,10 +6,15 @@ export type StepsProps<Id extends string = string> = Omit<HTMLAttributes<HTMLOLi
     statusLabels: StepsStatusLabels;
     composeAccessibleName: ComposeStepsAccessibleName;
     renderMark?: (status: StepStatus, position: number) => ReactNode;
+    /**
+     * Return to a step before the cursor (2026-10-18, spint compose). Only those steps become buttons; the cursor and
+     * later steps stay static so the flow never skips forward past validation. Omit it while the flow is locked.
+     */
+    onStepPress?: (id: Id) => void;
     /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
     layoutStyle?: HjmCompositionStyleProp;
 }>;
-/** Linear, read-only progress steps with one canonical cursor. */
+/** Linear progress steps with one canonical cursor; steps before it can be pressed to go back. */
 export declare const Steps: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLOListElement>, "children"> & Readonly<{
     descriptor: Readonly<{
         steps: readonly Readonly<{
@@ -28,6 +33,11 @@ export declare const Steps: import("react").ForwardRefExoticComponent<Omit<HTMLA
     }>;
     composeAccessibleName: ComposeStepsAccessibleName;
     renderMark?: (status: StepStatus, position: number) => ReactNode;
+    /**
+     * Return to a step before the cursor (2026-10-18, spint compose). Only those steps become buttons; the cursor and
+     * later steps stay static so the flow never skips forward past validation. Omit it while the flow is locked.
+     */
+    onStepPress?: (id: string) => void;
     /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */
     layoutStyle?: HjmCompositionStyleProp;
 }> & import("react").RefAttributes<HTMLOListElement>>;

package/dist/steps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../src/steps.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAc,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEtE,MAAM,MAAM,UAAU,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,IAAI,IAAI,CACvD,cAAc,CAAC,gBAAgB,CAAC,EAChC,UAAU,CACX,GAAG,QAAQ,CAAC;IACX,UAAU,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC;IAChC,YAAY,EAAE,iBAAiB,CAAC;IAChC,qBAAqB,EAAE,0BAA0B,CAAC;IAClD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,KAAK,SAAS,CAAC;IACjE,gGAAgG;IAChG,WAAW,CAAC,EAAE,uBAAuB,CAAC;CACvC,CAAC,CAAC;AAEH,kEAAkE;AAClE,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;2BAPO,0BAA0B;iBACpC,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,KAAK,SAAS;IAChE,gGAAgG;kBAClF,uBAAuB;qDAsCrC,CAAC"}
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../src/steps.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAqB,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAG/E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEtE,MAAM,MAAM,UAAU,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,IAAI,IAAI,CACvD,cAAc,CAAC,gBAAgB,CAAC,EAChC,UAAU,CACX,GAAG,QAAQ,CAAC;IACX,UAAU,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC;IAChC,YAAY,EAAE,iBAAiB,CAAC;IAChC,qBAAqB,EAAE,0BAA0B,CAAC;IAClD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,KAAK,SAAS,CAAC;IACjE;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,IAAI,CAAC;IAC/B,gGAAgG;IAChG,WAAW,CAAC,EAAE,uBAAuB,CAAC;CACvC,CAAC,CAAC;AAEH,kGAAkG;AAClG,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;2BAZO,0BAA0B;iBACpC,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,KAAK,SAAS;IAChE;;;OAGG;kCACuB,IAAI;IAC9B,gGAAgG;kBAClF,uBAAuB;qDAgDrC,CAAC"}

package/dist/steps.js

@@ -1,10 +1,15 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { resolveStepsDescriptor, } from "@hjmds/design-contracts/components/steps";
-import { forwardRef } from "react";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { resolveStepsDescriptor, stepsRecipe, } from "@hjmds/design-contracts/components/steps";
+import { forwardRef, useId } from "react";
 import { classNames } from "./internal.js";
-/** Linear, read-only progress steps with one canonical cursor. */
-export const Steps = forwardRef(function Steps({ descriptor, statusLabels, composeAccessibleName, renderMark, className, layoutStyle, ...props }, ref) {
+/** Linear progress steps with one canonical cursor; steps before it can be pressed to go back. */
+export const Steps = forwardRef(function Steps({ descriptor, statusLabels, composeAccessibleName, renderMark, onStepPress, className, layoutStyle, ...props }, ref) {
     const steps = resolveStepsDescriptor(descriptor, { statusLabels, composeAccessibleName });
-    return (_jsx("ol", { ...props, style: { ...props.style, ...layoutStyle }, ref: ref, className: classNames("hjm-steps", className), children: steps.map((step, index) => (_jsxs("li", { "aria-label": step.accessibleName, "aria-current": step.status === "current" || step.status === "error" ? "step" : undefined, className: "hjm-steps__step", "data-status": step.status, children: [_jsxs("div", { className: "hjm-steps__rail", "aria-hidden": "true", children: [_jsx("span", { className: "hjm-steps__indicator", children: renderMark?.(step.status, step.position) ?? (step.status === "complete" ? "✓" : step.status === "error" ? "!" : step.position) }), index === steps.length - 1 ? null : _jsx("span", { className: "hjm-steps__connector" })] }), _jsxs("div", { className: "hjm-steps__copy", children: [_jsx("span", { className: "hjm-steps__label", children: step.label }), step.description === undefined ? null : (_jsx("span", { className: "hjm-steps__description", children: step.description })), _jsx("span", { className: "hjm-visually-hidden", children: step.statusLabel })] })] }, step.id))) }));
+    const statusId = useId();
+    return (_jsx("ol", { ...props, style: { ["--hjm-steps-press-target"]: `${stepsRecipe.press.minTouchTarget}px`, ...props.style, ...layoutStyle }, ref: ref, className: classNames("hjm-steps", className), children: steps.map((step, index) => {
+            const content = _jsxs(_Fragment, { children: [_jsxs("div", { className: "hjm-steps__rail", "aria-hidden": "true", children: [_jsx("span", { className: "hjm-steps__indicator", children: renderMark?.(step.status, step.position) ?? (step.status === "complete" ? "✓" : step.status === "error" ? "!" : step.position) }), index === steps.length - 1 ? null : _jsx("span", { className: "hjm-steps__connector" })] }), _jsxs("div", { className: "hjm-steps__copy", children: [_jsx("span", { className: "hjm-steps__label", children: step.label }), step.description === undefined ? null : (_jsx("span", { className: "hjm-steps__description", children: step.description })), _jsx("span", { className: "hjm-visually-hidden", id: `${statusId}-${index}`, children: step.statusLabel })] })] });
+            // A pressable step is one named button; its status stays a description so the name keeps order + label.
+            return step.revisitable && onStepPress ? (_jsx("li", { className: "hjm-steps__step", "data-status": step.status, children: _jsx("button", { type: "button", className: "hjm-steps__press", "aria-label": step.accessibleName, "aria-describedby": `${statusId}-${index}`, onClick: () => onStepPress(step.id), children: content }) }, step.id)) : (_jsx("li", { "aria-label": step.accessibleName, "aria-current": step.status === "current" || step.status === "error" ? "step" : undefined, className: "hjm-steps__step", "data-status": step.status, children: content }, step.id));
+        }) }));
 });
 //# sourceMappingURL=steps.js.map

package/dist/steps.js.map

@@ -1 +1 @@
-{"version":3,"file":"steps.js","sourceRoot":"","sources":["../src/steps.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,sBAAsB,GAKvB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,UAAU,EAAuC,MAAM,OAAO,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAe3C,kEAAkE;AAClE,MAAM,CAAC,MAAM,KAAK,GAAG,UAAU,CAA+B,SAAS,KAAK,CAC1E,EAAE,UAAU,EAAE,YAAY,EAAE,qBAAqB,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,EACjG,GAAG;IAEH,MAAM,KAAK,GAAG,sBAAsB,CAAC,UAAU,EAAE,EAAE,YAAY,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAC1F,OAAO,CACL,gBAAQ,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,GAAG,WAAW,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,WAAW,EAAE,SAAS,CAAC,YAC9G,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAC1B,4BACc,IAAI,CAAC,cAAc,kBACjB,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EACvF,SAAS,EAAC,iBAAiB,iBACd,IAAI,CAAC,MAAM,aAGxB,eAAK,SAAS,EAAC,iBAAiB,iBAAa,MAAM,aACjD,eAAM,SAAS,EAAC,sBAAsB,YACnC,UAAU,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAC3C,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CACjF,GACI,EACN,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,sBAAsB,GAAG,IAC1E,EACN,eAAK,SAAS,EAAC,iBAAiB,aAC9B,eAAM,SAAS,EAAC,kBAAkB,YAAE,IAAI,CAAC,KAAK,GAAQ,EACrD,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACvC,eAAM,SAAS,EAAC,wBAAwB,YAAE,IAAI,CAAC,WAAW,GAAQ,CACnE,EACD,eAAM,SAAS,EAAC,qBAAqB,YAAE,IAAI,CAAC,WAAW,GAAQ,IAC3D,KAhBD,IAAI,CAAC,EAAE,CAiBT,CACN,CAAC,GACC,CACN,CAAC;AACJ,CAAC,CAAC,CAAC","sourcesContent":["import {\n  resolveStepsDescriptor,\n  type ComposeStepsAccessibleName,\n  type StepStatus,\n  type StepsDescriptor,\n  type StepsStatusLabels,\n} from \"@hjmds/design-contracts/components/steps\";\nimport { forwardRef, type HTMLAttributes, type ReactNode } from \"react\";\n\nimport { classNames } from \"./internal.js\";\nimport type { HjmCompositionStyleProp } from \"./composition-style.js\";\n\nexport type StepsProps<Id extends string = string> = Omit<\n  HTMLAttributes<HTMLOListElement>,\n  \"children\"\n> & Readonly<{\n  descriptor: StepsDescriptor<Id>;\n  statusLabels: StepsStatusLabels;\n  composeAccessibleName: ComposeStepsAccessibleName;\n  renderMark?: (status: StepStatus, position: number) => ReactNode;\n  /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */\n  layoutStyle?: HjmCompositionStyleProp;\n}>;\n\n/** Linear, read-only progress steps with one canonical cursor. */\nexport const Steps = forwardRef<HTMLOListElement, StepsProps>(function Steps(\n  { descriptor, statusLabels, composeAccessibleName, renderMark, className, layoutStyle, ...props },\n  ref,\n) {\n  const steps = resolveStepsDescriptor(descriptor, { statusLabels, composeAccessibleName });\n  return (\n    <ol {...props} style={{ ...props.style, ...layoutStyle }} ref={ref} className={classNames(\"hjm-steps\", className)}>\n      {steps.map((step, index) => (\n        <li\n          aria-label={step.accessibleName}\n          aria-current={step.status === \"current\" || step.status === \"error\" ? \"step\" : undefined}\n          className=\"hjm-steps__step\"\n          data-status={step.status}\n          key={step.id}\n        >\n          <div className=\"hjm-steps__rail\" aria-hidden=\"true\">\n            <span className=\"hjm-steps__indicator\">\n              {renderMark?.(step.status, step.position) ?? (\n                step.status === \"complete\" ? \"✓\" : step.status === \"error\" ? \"!\" : step.position\n              )}\n            </span>\n            {index === steps.length - 1 ? null : <span className=\"hjm-steps__connector\" />}\n          </div>\n          <div className=\"hjm-steps__copy\">\n            <span className=\"hjm-steps__label\">{step.label}</span>\n            {step.description === undefined ? null : (\n              <span className=\"hjm-steps__description\">{step.description}</span>\n            )}\n            <span className=\"hjm-visually-hidden\">{step.statusLabel}</span>\n          </div>\n        </li>\n      ))}\n    </ol>\n  );\n});\n"]}
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../src/steps.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  resolveStepsDescriptor,\n  stepsRecipe,\n  type ComposeStepsAccessibleName,\n  type StepStatus,\n  type StepsDescriptor,\n  type StepsStatusLabels,\n} from \"@hjmds/design-contracts/components/steps\";\nimport { forwardRef, useId, type HTMLAttributes, type ReactNode } from \"react\";\n\nimport { classNames } from \"./internal.js\";\nimport type { HjmCompositionStyleProp } from \"./composition-style.js\";\n\nexport type StepsProps<Id extends string = string> = Omit<\n  HTMLAttributes<HTMLOListElement>,\n  \"children\"\n> & Readonly<{\n  descriptor: StepsDescriptor<Id>;\n  statusLabels: StepsStatusLabels;\n  composeAccessibleName: ComposeStepsAccessibleName;\n  renderMark?: (status: StepStatus, position: number) => ReactNode;\n  /**\n   * Return to a step before the cursor (2026-10-18, spint compose). Only those steps become buttons; the cursor and\n   * later steps stay static so the flow never skips forward past validation. Omit it while the flow is locked.\n   */\n  onStepPress?: (id: Id) => void;\n  /** Canonical layout-only placement on the root element. Controlled visual keys are excluded. */\n  layoutStyle?: HjmCompositionStyleProp;\n}>;\n\n/** Linear progress steps with one canonical cursor; steps before it can be pressed to go back. */\nexport const Steps = forwardRef<HTMLOListElement, StepsProps>(function Steps(\n  { descriptor, statusLabels, composeAccessibleName, renderMark, onStepPress, className, layoutStyle, ...props },\n  ref,\n) {\n  const steps = resolveStepsDescriptor(descriptor, { statusLabels, composeAccessibleName });\n  const statusId = useId();\n  return (\n    <ol {...props} style={{ [\"--hjm-steps-press-target\" as string]: `${stepsRecipe.press.minTouchTarget}px`, ...props.style, ...layoutStyle }} ref={ref} className={classNames(\"hjm-steps\", className)}>\n      {steps.map((step, index) => {\n        const content = <>\n          <div className=\"hjm-steps__rail\" aria-hidden=\"true\">\n            <span className=\"hjm-steps__indicator\">\n              {renderMark?.(step.status, step.position) ?? (\n                step.status === \"complete\" ? \"✓\" : step.status === \"error\" ? \"!\" : step.position\n              )}\n            </span>\n            {index === steps.length - 1 ? null : <span className=\"hjm-steps__connector\" />}\n          </div>\n          <div className=\"hjm-steps__copy\">\n            <span className=\"hjm-steps__label\">{step.label}</span>\n            {step.description === undefined ? null : (\n              <span className=\"hjm-steps__description\">{step.description}</span>\n            )}\n            <span className=\"hjm-visually-hidden\" id={`${statusId}-${index}`}>{step.statusLabel}</span>\n          </div>\n        </>;\n        // A pressable step is one named button; its status stays a description so the name keeps order + label.\n        return step.revisitable && onStepPress ? (\n          <li className=\"hjm-steps__step\" data-status={step.status} key={step.id}>\n            <button type=\"button\" className=\"hjm-steps__press\" aria-label={step.accessibleName} aria-describedby={`${statusId}-${index}`}\n              onClick={() => onStepPress(step.id)}>{content}</button>\n          </li>\n        ) : (\n          <li\n            aria-label={step.accessibleName}\n            aria-current={step.status === \"current\" || step.status === \"error\" ? \"step\" : undefined}\n            className=\"hjm-steps__step\"\n            data-status={step.status}\n            key={step.id}\n          >{content}</li>\n        );\n      })}\n    </ol>\n  );\n});\n"]}

package/dist/styles.css

@@ -372,7 +372,7 @@
    the support text fades, so a custom Field control dims without needing a class. A component
    recipe value (Select, NumberField, OtpField, SearchField, PasswordField) arrives as an
    inline --hjm-field-disabled-opacity on the root. */
-.hjm-field[data-state="disabled"] > :not(.hjm-field__description):not(.hjm-field__error) { opacity: var(--hjm-field-disabled-opacity); }
+.hjm-field[data-state="disabled"] > :not(.hjm-field__description):not(.hjm-field__error):not([data-hjm-field-error]) { opacity: var(--hjm-field-disabled-opacity); }
 .hjm-field__input {
   inline-size: 100%;
   min-inline-size: 0;
@@ -524,6 +524,13 @@
   border-radius: var(--hjm-radius-xl);
   box-shadow: var(--hjm-shadow-floating);
 }
+/* configuration.shape (bottomNavigationRecipe.shapes): the renderer sets the frame radius token and inner padding. */
+.hjm-bottom-navigation[data-presentation="floating"]:not([data-shape="standard"]) .hjm-bottom-navigation__surface {
+  border-radius: var(--hjm-bottom-navigation-shape-radius);
+}
+.hjm-bottom-navigation[data-presentation="floating"]:not([data-shape="standard"]) .hjm-bottom-navigation__list {
+  padding: var(--hjm-bottom-navigation-shape-padding);
+}
 .hjm-bottom-navigation__list {
   display: grid;
   grid-template-columns: repeat(var(--hjm-bottom-navigation-columns), minmax(var(--hjm-bottom-navigation-item-min-width), 1fr));
@@ -573,6 +580,14 @@
 }
 .hjm-bottom-navigation__indicator > :first-child { transition: transform 160ms ease; }
 .hjm-bottom-navigation__indicator[data-state="selected"] > :first-child { transform: scale(1.06); }
+/* iconEmphasis "lift" (bottomNavigationRecipe.icon.liftEmphasis): the selected icon rises one step above the shared
+   scale and idle icons dim, the non-color cue for full-color artwork. The badge is a later sibling and stays opaque. */
+.hjm-bottom-navigation[data-icon-emphasis="lift"] .hjm-bottom-navigation__indicator[data-state="selected"] > :first-child {
+  transform: translateY(var(--hjm-bottom-navigation-lift-offset)) scale(1.06);
+}
+.hjm-bottom-navigation[data-icon-emphasis="lift"] li:not([data-prominent="true"]) .hjm-bottom-navigation__indicator[data-state="idle"] > :first-child {
+  opacity: var(--hjm-bottom-navigation-lift-idle-opacity);
+}
 /* Icon-only items center the indicator in the density's minimum height instead of leaving an empty label row. */
 .hjm-bottom-navigation[data-labels="hidden"] .hjm-bottom-navigation__item { justify-content: center; }
 .hjm-bottom-navigation__label { font-size: var(--hjm-type-caption-size); line-height: var(--hjm-type-caption-line-height); font-weight: var(--hjm-text-emphasis-medium); }
@@ -600,6 +615,18 @@
   inset-block-start: 50%;
   translate: -50% -50%;
 }
+/* Prominent center destination: bottomNavigationRecipe.prominentDestination, lifted so its label stays on the
+   other labels' line. The circle keeps brand fill in both states; the label carries selection. */
+.hjm-bottom-navigation li[data-prominent="true"] .hjm-bottom-navigation__indicator {
+  inline-size: var(--hjm-bottom-navigation-prominent-diameter);
+  block-size: var(--hjm-bottom-navigation-prominent-diameter);
+  margin-block-start: calc(-1 * var(--hjm-bottom-navigation-prominent-lift));
+  border-radius: var(--hjm-radius-full);
+  color: var(--hjm-color-on-primary);
+  background: var(--hjm-color-primary);
+  box-shadow: var(--hjm-shadow-floating);
+}
+.hjm-bottom-navigation li[data-prominent="true"] .hjm-bottom-navigation__indicator > :first-child { transform: none; }
 
 .hjm-number-field__control {
   padding-inline: 0;
@@ -1719,6 +1746,22 @@ button.hjm-list-row, a.hjm-list-row { cursor: pointer; }
      AuthScreenLayout safeAreaBottom (2026-10-17 1.28 adoption: products wrapped the layout in their own inset). */
   padding-block-end: max(var(--hjm-auth-screen-padding-block), env(safe-area-inset-bottom, 0px));
 }
+/* With title/exit the layout owns the ScreenLayout centered header band: full-bleed over the inline padding, at the
+   shared screen gutter, with the former top padding moved below it (2026-10-18: products kept a TopBar above). */
+.hjm-auth-screen[data-header] { padding-block-start: 0; }
+.hjm-auth-screen__header {
+  display: grid;
+  grid-template-columns: 1fr minmax(0, auto) 1fr;
+  align-items: center;
+  box-sizing: border-box;
+  min-block-size: var(--hjm-auth-screen-header-min-height);
+  margin-inline: calc(var(--hjm-auth-screen-padding-inline) * -1);
+  margin-block-end: var(--hjm-auth-screen-padding-block);
+  padding-inline: var(--hjm-auth-screen-header-padding-inline);
+  padding-block: var(--hjm-auth-screen-header-padding-block);
+}
+.hjm-auth-screen__header-title { min-inline-size: 0; text-align: center; overflow-wrap: anywhere; }
+.hjm-auth-screen__header-title > * { margin: 0; }
 .hjm-auth-screen__block {
   display: flex;
   flex: 1;
@@ -1770,17 +1813,18 @@ button.hjm-list-row, a.hjm-list-row { cursor: pointer; }
   flex-wrap: wrap;
   justify-content: center;
   align-items: center;
-  column-gap: var(--hjm-auth-screen-link-gap);
 }
-/* 2026-10-17 "간격 줄여": 보이는 간격은 gap + 구분점뿐이다. 44 터치 높이는 배경 없는 min-block-size,
-   가로 터치 폭은 보이지 않는 가상 요소가 구분점 앞까지 넓힌다 — 버튼 안쪽 여백으로 만들면 글자 사이가 다시 벌어진다. */
+/* 2026-10-17 "간격 줄여": 보이는 간격은 linkGap + 구분점뿐이다. 44 터치 높이는 배경 없는 min-block-size다.
+   2026-10-18 링크 사이 간격을 flex column-gap에서 링크의 inline 여백으로 옮겼다. 보이는 간격은 같고(column-gap 0),
+   가로 터치 폭이 그 여백만큼 링크 상자 안에 든다. 예전 가상 요소는 상자 밖으로 linkGap만큼 뻗어, 긴 링크가 푸터 폭을
+   다 쓰면 푸터의 스크롤 폭을 넓혔다(웹 scenario-matrix auth-screen long-copy 288 > 282). 여백을 gap과 함께 두면
+   글자 사이가 두 배로 벌어지므로 gap은 두지 않는다. */
 .hjm-auth-screen__link {
-  position: relative;
   display: inline-flex;
   align-items: center;
   min-block-size: var(--hjm-auth-screen-link-target);
   margin: 0;
-  padding: 0;
+  padding: 0 var(--hjm-auth-screen-link-gap);
   border: 0;
   background: none;
   font-family: var(--hjm-font-family-ui, inherit);
@@ -1788,12 +1832,6 @@ button.hjm-list-row, a.hjm-list-row { cursor: pointer; }
   text-underline-offset: 0.18em;
   cursor: pointer;
 }
-.hjm-auth-screen__link::after {
-  content: "";
-  position: absolute;
-  inset-block: 0;
-  inset-inline: calc(var(--hjm-auth-screen-link-gap) * -1);
-}
 .hjm-auth-screen__link:focus-visible {
   outline: var(--hjm-focus-width) solid var(--hjm-color-focus);
   outline-offset: var(--hjm-focus-offset);
@@ -2191,6 +2229,46 @@ button.hjm-list-row, a.hjm-list-row { cursor: pointer; }
   background: var(--hjm-backdrop-modal);
   overscroll-behavior: contain;
 }
+/* Dialog overlayLayer: viewport-sized, decorative, above the card (later sibling) and never a pointer target. */
+.hjm-dialog__overlay-layer {
+  position: absolute;
+  inset: 0;
+  pointer-events: none;
+}
+/* ImmersiveOverlay: an edge-to-edge stage and control bar with no scrim, card or gutter. */
+.hjm-overlay.hjm-immersive-positioner {
+  align-items: stretch;
+  padding: 0;
+  background: var(--hjm-immersive-background);
+}
+.hjm-immersive {
+  display: flex;
+  flex-direction: column;
+  inline-size: 100%;
+  block-size: 100%;
+  color: var(--hjm-color-text);
+  background: var(--hjm-immersive-background);
+  outline: none;
+}
+.hjm-immersive__stage {
+  position: relative;
+  flex: 1 1 auto;
+  min-block-size: 0;
+  overflow: hidden;
+}
+.hjm-immersive__controls {
+  display: flex;
+  flex-direction: column;
+  gap: var(--hjm-immersive-gap);
+  padding: var(--hjm-immersive-padding);
+  padding-inline: max(var(--hjm-immersive-padding), env(safe-area-inset-left)) max(var(--hjm-immersive-padding), env(safe-area-inset-right));
+  padding-block-end: max(var(--hjm-immersive-padding), env(safe-area-inset-bottom));
+}
+.hjm-immersive__actions {
+  display: flex;
+  align-items: center;
+  gap: var(--hjm-immersive-action-gap);
+}
 .hjm-dialog,
 .hjm-alert-dialog,
 .hjm-sheet {
@@ -2207,6 +2285,8 @@ button.hjm-list-row, a.hjm-list-row { cursor: pointer; }
 .hjm-dialog { inline-size: min(36rem, 100%); }
 .hjm-dialog[data-size="small"] { inline-size: min(28rem, 100%); }
 .hjm-dialog[data-size="large"] { inline-size: min(48rem, 100%); }
+/* Dialog scrollEnabled={false}: the card keeps its scroll offset while a gesture in the body owns the pointer. */
+.hjm-dialog[data-scroll="locked"] { overflow: hidden; overscroll-behavior: contain; touch-action: none; }
 .hjm-alert-dialog[data-size="small"] { inline-size: min(28rem, 100%); }
 .hjm-alert-dialog[data-size="large"] { inline-size: min(48rem, 100%); }
 .hjm-dialog__header,
@@ -2724,6 +2804,8 @@ button.hjm-list-row, a.hjm-list-row { cursor: pointer; }
 .hjm-pagination__item[data-state="current"] { border-color: var(--hjm-color-content-brand); color: var(--hjm-color-content-brand); font-weight: var(--hjm-text-emphasis-strong); }
 .hjm-pagination__item[aria-disabled="true"] { opacity: 0.5; cursor: not-allowed; }
 .hjm-pagination__ellipsis { color: var(--hjm-color-text-muted); }
+/* Open-ended current page label (paginationRecipe.pageLabel): text, not a button, on the steps' 44px row. */
+.hjm-pagination__page-label { min-block-size: var(--hjm-control-min-touch-target); display: grid; place-items: center; padding-inline: var(--hjm-space-xs); color: var(--hjm-color-text-body); overflow-wrap: anywhere; }
 .hjm-load-more { display: grid; justify-items: center; gap: var(--hjm-space-sm); padding-block: var(--hjm-space-lg); text-align: center; }
 .hjm-load-more[data-density="compact"] { gap: var(--hjm-space-xs); padding-block: var(--hjm-space-sm); }
 .hjm-load-more__sentinel { inline-size: 1px; block-size: 1px; }
@@ -2748,6 +2830,9 @@ button.hjm-list-row, a.hjm-list-row { cursor: pointer; }
 .hjm-steps__step[data-status="pending"] .hjm-steps__label { color: var(--hjm-color-text-muted); }
 .hjm-steps__step[data-status="error"] .hjm-steps__label { color: var(--hjm-color-danger); }
 .hjm-steps__description { color: var(--hjm-color-text-muted); font-size: var(--hjm-type-caption-size); overflow-wrap: anywhere; }
+/* A step before the cursor is one button over marker and label (Steps onStepPress); the cell keeps its static layout. */
+.hjm-steps__press { display: grid; align-content: start; gap: var(--hjm-space-xs); min-inline-size: 0; min-block-size: var(--hjm-steps-press-target); margin: 0; padding: 0; border: 0; background: none; color: inherit; font: inherit; text-align: start; cursor: pointer; }
+.hjm-steps__press:focus-visible { outline: var(--hjm-focus-width) solid var(--hjm-color-focus); outline-offset: var(--hjm-focus-offset); }
 
 .hjm-file-picker { display: grid; gap: var(--hjm-space-xs); }
 .hjm-file-picker__label { color: var(--hjm-color-text); font-weight: var(--hjm-text-emphasis-medium); }
@@ -2796,14 +2881,14 @@ button.hjm-list-row, a.hjm-list-row { cursor: pointer; }
 /* Cards stay narrow on desktop too; keep close/action rows explicit (docs/toast.md). The card owns its width cap so a
    controlled Toast outside the viewport keeps it too (it stretched to 1200px in the layout story, 2026-10-17 review).
    1.10.0 layout: [tone badge][title + description][close] / action pill on its own row, end-aligned.
-   The 2px tone strip is retired — the tinted badge carries tone (toastRecipe.toneMark width 0). */
+   There is no edge stripe: the tinted badge (or product media) carries tone. 1.10.0 retired the 2px strip and 1.32.0
+   removed its always-hidden element, so no product rule is needed to hide it (docs/toast.md). */
 .hjm-toast { position: relative; min-inline-size: 0; max-inline-size: min(26.25rem, 100%); min-block-size: 3.5rem; display: grid; grid-template-columns: auto minmax(0, 1fr) auto; align-items: start; column-gap: var(--hjm-space-sm); row-gap: var(--hjm-space-xs); padding: var(--hjm-toast-padding-block) var(--hjm-toast-padding-inline); overflow: hidden; border: var(--hjm-toast-border-width) solid var(--hjm-toast-border); border-radius: var(--hjm-toast-radius); color: var(--hjm-color-text); background: var(--hjm-toast-background); box-shadow: var(--hjm-toast-shadow); pointer-events: auto; }
 /* Whole-card activation is a sibling surface; explicit controls stay above it. */
 .hjm-toast__press { position: absolute; inset: 0; z-index: 1; border: 0; border-radius: inherit; padding: 0; background: transparent; cursor: pointer; }
 .hjm-toast__press:focus-visible { outline: 2px solid var(--hjm-color-content-brand); outline-offset: -2px; }
 .hjm-toast:has(> .hjm-toast__press:active) { opacity: var(--hjm-toast-pressed-opacity); }
 .hjm-toast:has(> .hjm-toast__press) > :is(.hjm-toast__action, .hjm-toast__close) { position: relative; z-index: 2; }
-.hjm-toast__tone-mark { display: none; }
 .hjm-toast__icon { grid-column: 1; grid-row: 1; align-self: start; display: grid; place-items: center; inline-size: var(--hjm-toast-badge-size); block-size: var(--hjm-toast-badge-size); border-radius: 50%; color: var(--hjm-toast-accent-neutral); background: var(--hjm-toast-badge-neutral); }
 .hjm-toast[data-tone="info"] .hjm-toast__icon { color: var(--hjm-toast-accent-info); background: var(--hjm-toast-badge-info); }
 .hjm-toast[data-tone="success"] .hjm-toast__icon { color: var(--hjm-toast-accent-success); background: var(--hjm-toast-badge-success); }
@@ -2934,10 +3019,12 @@ button.hjm-list-row, a.hjm-list-row { cursor: pointer; }
 .hjm-carousel__rotation { justify-self: start; }
 .hjm-carousel__controls, .hjm-carousel__dots { display: flex; align-items: center; justify-content: center; flex-wrap: wrap; gap: var(--hjm-space-xs); }
 .hjm-carousel__controls { flex-wrap: nowrap; } .hjm-carousel__dots { flex-shrink: 1; min-inline-size: 0; }
-.hjm-carousel__dot { display: grid; place-items: center; min-inline-size: var(--hjm-control-min-touch-target); min-block-size: var(--hjm-control-min-touch-target); border: 0; border-radius: var(--hjm-radius-full); background: transparent; cursor: pointer; }
-.hjm-carousel__dot > span { inline-size: var(--hjm-space-xs); block-size: var(--hjm-space-xs); border-radius: var(--hjm-radius-full); background: var(--hjm-color-text-weak); } /* carouselRecipe.dot.color.inactive (border.strong), as Native */
-.hjm-carousel__dot[data-current="true"] > span { background: var(--hjm-color-content-brand); }
-.hjm-carousel__dot:focus-visible { outline: 2px solid var(--hjm-color-content-brand); outline-offset: 2px; }
+/* PageIndicator is the same dot row for a product-owned pager (carouselRecipe.dot). */
+.hjm-page-indicator { display: flex; align-items: center; justify-content: center; flex-wrap: wrap; gap: var(--hjm-space-xs); min-inline-size: 0; }
+.hjm-carousel__dot, .hjm-page-indicator__dot { display: grid; place-items: center; min-inline-size: var(--hjm-control-min-touch-target); min-block-size: var(--hjm-control-min-touch-target); border: 0; border-radius: var(--hjm-radius-full); background: transparent; cursor: pointer; }
+.hjm-carousel__dot > span, .hjm-page-indicator__dot > span { inline-size: var(--hjm-space-xs); block-size: var(--hjm-space-xs); border-radius: var(--hjm-radius-full); background: var(--hjm-color-text-weak); } /* carouselRecipe.dot.color.inactive (border.strong), as Native */
+.hjm-carousel__dot[data-current="true"] > span, .hjm-page-indicator__dot[data-current="true"] > span { background: var(--hjm-color-content-brand); }
+.hjm-carousel__dot:focus-visible, .hjm-page-indicator__dot:focus-visible { outline: 2px solid var(--hjm-color-content-brand); outline-offset: 2px; }
 
 /* The viewport action follows the content in DOM order. Its measured clearance
    belongs on the scroll content, not on the fixed button (docs/floating-action-button.md). */
@@ -3113,6 +3200,16 @@ button.hjm-list-row, a.hjm-list-row { cursor: pointer; }
 .hjm-tabs:is([data-appearance="gooey"], [data-appearance="slide"]) .hjm-tabs__list { position: relative; }
 .hjm-tabs:is([data-appearance="gooey"], [data-appearance="slide"]) .hjm-tabs__tab[data-state="selected"]::after { display: none; }
 .hjm-tabs__indicator { position: absolute; bottom: 0; height: 2px; border-radius: var(--hjm-radius-full); background: var(--hjm-color-content-brand); pointer-events: none; }
+/* indicator="filled" (tabsRecipe.indicators.filled): a surface-accent pill behind the selected tab, no list divider.
+   The moving pill spans the tab height and sits under the labels. */
+.hjm-tabs[data-indicator="filled"] .hjm-tabs__list { border: 0; }
+.hjm-tabs[data-indicator="filled"] .hjm-tabs__tab { border-radius: var(--hjm-radius-full); }
+.hjm-tabs[data-indicator="filled"] .hjm-tabs__tab[data-state="selected"] { color: var(--hjm-color-content-brand); }
+.hjm-tabs[data-indicator="filled"] .hjm-tabs__tab[data-state="selected"]::after { display: none; }
+.hjm-tabs[data-indicator="filled"]:not([data-indicator-motion="moving"]) .hjm-tabs__tab[data-state="selected"] { background: var(--hjm-color-surface-accent); }
+.hjm-tabs[data-indicator="filled"] .hjm-tabs__indicator { top: 0; bottom: 0; height: auto; border-radius: var(--hjm-radius-full); background: var(--hjm-color-surface-accent); z-index: 0; }
+.hjm-tabs[data-indicator="filled"] .hjm-tabs__list { position: relative; }
+.hjm-tabs[data-indicator="filled"] .hjm-tabs__tab { z-index: 1; }
 .hjm-tabs__gooey { height: 6px; }
 
 /* Capsule destinations retain route/link semantics. At larger text sizes we show
@@ -3167,6 +3264,7 @@ button.hjm-list-row, a.hjm-list-row { cursor: pointer; }
 .hjm-screen__header { display: flex; flex-wrap: wrap; align-items: center; gap: var(--hjm-screen-item-gap, var(--hjm-space-sm)); padding: var(--hjm-screen-padding); flex: 0 0 auto; }
 .hjm-screen__heading { flex: 1 1 calc(var(--hjm-screen-header-min) * var(--hjm-text-scale, 1)); min-inline-size: 0; overflow-wrap: anywhere; }
 .hjm-screen__heading > * { margin: 0; }
+.hjm-screen__title-leading { display: inline-flex; flex-shrink: 0; align-items: center; justify-content: center; }
 .hjm-screen__notice { padding-inline: var(--hjm-screen-padding); flex: 0 0 auto; }
 /* --hjm-screen-body-inline is the body's inline padding and the distance a bleeding CollectionRail crosses (Native
    ScreenBodyInsetContext); inset variants change this one value instead of the padding itself. */
@@ -3174,8 +3272,15 @@ button.hjm-list-row, a.hjm-list-row { cursor: pointer; }
 /* contentInset="body-edge": header, notice and footer keep the gutter; full-width list rows own their inline inset
    (review S5#9: body 16 + row 16 put DM avatars ~32 from the edge). "none" keeps its host-owns-all meaning. */
 .hjm-screen[data-content-inset="body-edge"] > .hjm-screen__body { --hjm-screen-body-inline: 0px; }
+/* contentInset="body-bleed": the same gutters stay on header, notice and footer; a map or canvas body has none on any
+   side. As the last region it still clears the fixed BottomNavigation, without the gutter (Native twin). */
+.hjm-screen[data-content-inset="body-bleed"] > .hjm-screen__body { --hjm-screen-body-inline: 0px; padding-block: 0; }
+.hjm-screen[data-content-inset="body-bleed"] > .hjm-screen__body:last-child { padding-block-end: var(--hjm-bottom-navigation-inset, 0px); }
+/* Both hand the body gutter to product content; the shared state group has no inset of its own, so it keeps the gutter. */
+.hjm-screen[data-content-inset="body-edge"] > .hjm-screen__body > .hjm-screen__state,
+.hjm-screen[data-content-inset="body-bleed"] > .hjm-screen__body > .hjm-screen__state { padding-inline: var(--hjm-screen-padding); }
 /* Overlay content is not in the screen body, even when rendered inside it: a bleeding rail there stays in its box. */
-.hjm-sheet, .hjm-dialog, .hjm-alert-dialog, .hjm-popover { --hjm-screen-body-inline: 0px; }
+.hjm-sheet, .hjm-dialog, .hjm-alert-dialog, .hjm-popover { --hjm-screen-body-inline: 0px; --hjm-bottom-navigation-inset: 0px; }
 /* contentInset="none" hands every inset to the host: no footer rule, as on Native (BottomCTA then draws its own bar). */
 .hjm-screen[data-content-inset="none"] > .hjm-screen__footer { border-block-start: 0; }
 .hjm-screen__body[data-scroll="screen"] { overflow-y: auto; }
@@ -3184,7 +3289,11 @@ button.hjm-list-row, a.hjm-list-row { cursor: pointer; }
 .hjm-screen__centered-content { margin-block: auto; flex-shrink: 0; inline-size: 100%; }
 .hjm-screen__body[data-replacement="true"] { display: flex; flex-direction: column; }
 .hjm-screen__state { margin-block: auto; flex-shrink: 0; display: flex; flex-direction: column; align-items: center; gap: var(--hjm-screen-state-gap, var(--hjm-space-md)); padding-block: var(--hjm-screen-gap); text-align: center; }
-.hjm-screen__footer { flex: 0 0 auto; padding: var(--hjm-screen-padding); padding-block-end: max(var(--hjm-screen-padding), env(safe-area-inset-bottom)); border-block-start: 1px solid var(--hjm-color-border); }
+.hjm-screen__footer { flex: 0 0 auto; padding: var(--hjm-screen-padding); padding-block-end: max(var(--hjm-screen-padding), env(safe-area-inset-bottom), calc(var(--hjm-screen-padding) + var(--hjm-bottom-navigation-inset, 0px))); border-block-start: 1px solid var(--hjm-color-border); }
+/* --hjm-bottom-navigation-inset (BottomNavigationInsetProvider) is the viewport bottom the fixed bar covers. The last
+   region keeps its gutter above the bar; without a provider the value is 0 and the padding is unchanged. This is the
+   only place the inset is applied: a scroll="content" list inside must not add it again. */
+.hjm-screen__body:last-child { padding-block-end: calc(var(--hjm-screen-padding) + var(--hjm-bottom-navigation-inset, 0px)); }
 /* SearchScreen filtersOverflow=scroll; why: screen-flows.tsx. Block padding keeps focus rings unclipped.
    --hjm-search-filters-bleed = screen padding + hostGutter (1.13.1), set inline by SearchScreen. */
 .hjm-search-screen__filters { --f: calc(var(--hjm-focus-width) + var(--hjm-focus-offset)); --b: var(--hjm-search-filters-bleed, var(--hjm-screen-padding)); overflow-x: auto; margin: calc(-1 * var(--f)) calc(-1 * var(--b)); padding: var(--f) var(--b); scroll-padding-inline: var(--b); scrollbar-width: none; }
@@ -3232,6 +3341,19 @@ button.hjm-list-row, a.hjm-list-row { cursor: pointer; }
 [dir="rtl"] .hjm-chat-message[data-tail] .hjm-chat-message__bubble::before { transform: scaleX(-1); }
 
 .hjm-chat-message__meta { display: flex; flex-shrink: 0; align-items: center; gap: var(--hjm-space-xs); }
+/* Reaction summary pill (sizes inline from chatMessageRecipe.reactionSummary); own reaction shows the brand border. */
+.hjm-chat-message__reaction-summary { display: inline-flex; align-items: center; box-sizing: border-box; border: 1px solid var(--hjm-color-border); border-radius: var(--hjm-radius-full); background: var(--hjm-color-surface); color: var(--hjm-color-text); font: inherit; line-height: 1; cursor: pointer; }
+.hjm-chat-message__reaction-summary[data-selected] { border-color: var(--hjm-color-content-brand); }
+.hjm-chat-message__reaction-summary:hover:not(:disabled) { background: var(--hjm-color-surface-alt); }
+.hjm-chat-message__reaction-summary:focus-visible { outline: 2px solid var(--hjm-color-focus, currentColor); outline-offset: 2px; }
+.hjm-chat-message__reaction-summary:disabled { opacity: 0.5; cursor: default; }
+/* Read-only counts (summary.readOnly): same slot, plain text, no pill surface or pointer affordance. */
+.hjm-chat-message__reaction-counts { display: inline-flex; align-items: center; line-height: 1; }
+/* Typing dots (typingIndicatorRecipe via custom properties): staggered pulse, static under reduced motion. */
+.hjm-typing-indicator__dot { inline-size: var(--hjm-typing-dot); block-size: var(--hjm-typing-dot); border-radius: 50%; background: var(--hjm-color-text-muted); animation: hjm-typing-pulse var(--hjm-typing-cycle) ease-in-out infinite both; }
+.hjm-typing-indicator[data-reduced-motion] .hjm-typing-indicator__dot { animation: none; }
+@media (prefers-reduced-motion: reduce) { .hjm-typing-indicator__dot { animation: none; } }
+@keyframes hjm-typing-pulse { 0%, 100% { opacity: var(--hjm-typing-rest); } 50% { opacity: 1; } }
 /* A quoted reply heads the bubble and is divided from the answer. */
 .hjm-chat-message__reply { border-block-end: 1px solid var(--hjm-color-border); padding-block-end: var(--hjm-space-xs); margin-block-end: var(--hjm-space-xs); display: flex; flex-direction: column; gap: 2px; min-inline-size: 0; }
 .hjm-chat-message__quote { inline-size: 100%; border-inline: 0; border-block-start: 0; background: none; padding-inline: 0; padding-block-start: 0; color: inherit; font: inherit; text-align: start; cursor: pointer; }
@@ -3242,6 +3364,17 @@ button.hjm-list-row, a.hjm-list-row { cursor: pointer; }
 .hjm-chat-message__media-item > img { display: block; inline-size: 100%; block-size: 100%; object-fit: cover; }
 button.hjm-chat-message__media-item { cursor: pointer; }
 button.hjm-chat-message__media-item:focus-visible { outline: 2px solid var(--hjm-color-focus, currentColor); outline-offset: -2px; }
+/* Paged media album (2026-10-18, mediaAlbumRecipe): one mounted page in the host's media width, counter row below. */
+.hjm-media-album { display: flex; flex-direction: column; max-inline-size: 100%; }
+.hjm-media-album__page { position: relative; display: block; inline-size: 100%; overflow: hidden; padding: 0; border: 0; background: var(--hjm-color-surface-alt); }
+/* The page wrapper fills the frame in every state; the open action is a sibling overlay so a page status inside stays reachable. */
+.hjm-media-album__content { inline-size: 100%; block-size: 100%; }
+.hjm-media-album__content > img { display: block; inline-size: 100%; block-size: 100%; object-fit: cover; }
+.hjm-media-album__open { position: absolute; inset: 0; z-index: 1; padding: 0; border: 0; border-radius: inherit; background: transparent; cursor: pointer; }
+.hjm-media-album__open:focus-visible { outline: 2px solid var(--hjm-color-focus, currentColor); outline-offset: -2px; }
+/* Loading / failed page (MediaAlbumPageStatus): one block centered in the frame (VQ-09); gap and padding inline from mediaAlbumRecipe.pageStatus. */
+.hjm-media-album__status { box-sizing: border-box; display: flex; flex-direction: column; align-items: center; justify-content: center; inline-size: 100%; block-size: 100%; text-align: center; }
+.hjm-media-album__controls { display: flex; align-items: center; justify-content: space-between; }
 .hjm-chat-message__bubble[data-photo-only] { background: none; padding: 0; }
 .hjm-chat-message__bubble[data-photo-only]::before { display: none; }
 /* Only the shared default gutter narrows to the timeline gutter; "none" and "body-edge" keep their own meaning. */
@@ -3254,8 +3387,21 @@ button.hjm-chat-message__media-item:focus-visible { outline: 2px solid var(--hjm
 .hjm-image-choice { display: flex; flex-direction: column; gap: var(--hjm-space-xs); }
 .hjm-image-choice__label { font-weight: var(--hjm-text-emphasis-medium); }
 .hjm-image-choice__tiles { display: flex; flex-wrap: wrap; gap: var(--hjm-image-choice-gap); }
-.hjm-image-choice__tile { position: relative; inline-size: calc(var(--hjm-image-choice-size) + (var(--hjm-image-choice-ring) + var(--hjm-image-choice-offset)) * 2); aspect-ratio: 1; padding: var(--hjm-image-choice-offset); border: var(--hjm-image-choice-ring) solid transparent; border-radius: calc(var(--hjm-image-choice-radius) + var(--hjm-image-choice-ring) + var(--hjm-image-choice-offset)); background: none; cursor: pointer; }
-.hjm-image-choice__tile[data-selected] { border-color: var(--hjm-color-content-brand); }
+/* The button is a column (ring frame, optional item label) so the label shares the tap target; the ring is drawn on
+   the inner frame (2026-10-18 showItemLabels). */
+.hjm-image-choice__tile { display: flex; flex-direction: column; gap: var(--hjm-image-choice-item-label-gap); inline-size: calc(var(--hjm-image-choice-size) + (var(--hjm-image-choice-ring) + var(--hjm-image-choice-offset)) * 2); padding: 0; border: 0; border-radius: calc(var(--hjm-image-choice-radius) + var(--hjm-image-choice-ring) + var(--hjm-image-choice-offset)); background: none; color: inherit; cursor: pointer; }
+.hjm-image-choice__ring { position: relative; display: block; inline-size: 100%; aspect-ratio: 1; padding: var(--hjm-image-choice-offset); border: var(--hjm-image-choice-ring) solid transparent; border-radius: inherit; }
+.hjm-image-choice__tile[data-selected] .hjm-image-choice__ring { border-color: var(--hjm-color-content-brand); }
+.hjm-image-choice__item-label { display: block; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; text-align: center; }
+/* Caption block (label lines + optional description line) has the same height in every tile of a group
+   (resolveImageChoiceCaptionLines), so wrapped rows stay even and virtualized rows share one stride. */
+.hjm-image-choice__caption { display: flex; flex-direction: column; min-inline-size: 0; block-size: calc(var(--hjm-type-caption-line-height) * var(--hjm-image-choice-caption-lines)); }
+/* Two-line labels keep words whole (keep-all) and clamp; a single over-long word still breaks rather than overflowing. */
+.hjm-image-choice__item-label[data-lines="2"] { display: -webkit-box; -webkit-box-orient: vertical; -webkit-line-clamp: 2; line-clamp: 2; white-space: normal; word-break: keep-all; overflow-wrap: anywhere; }
+.hjm-image-choice__item-description { display: block; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; text-align: center; }
+/* virtualized: the group is its own fixed-height scroller; the inset keeps the tile focus outline inside the clip. */
+.hjm-image-choice__viewport { position: relative; box-sizing: border-box; overflow-y: auto; padding: var(--hjm-image-choice-viewport-inset); }
+.hjm-image-choice__row { position: absolute; inset-inline: 0; display: flex; gap: var(--hjm-image-choice-gap); }
 .hjm-image-choice__tile:focus-visible { outline: 2px solid var(--hjm-color-focus, currentColor); outline-offset: 2px; }
 .hjm-image-choice__tile:disabled { opacity: 0.5; cursor: default; }
 .hjm-image-choice__image { display: block; inline-size: 100%; block-size: 100%; overflow: hidden; border-radius: var(--hjm-image-choice-radius); background: var(--hjm-color-surface); }
@@ -3303,6 +3449,8 @@ button.hjm-chat-message__media-item:focus-visible { outline: 2px solid var(--hjm
 .hjm-comment-row__reactions:focus-visible { outline: 2px solid var(--hjm-color-focus, currentColor); outline-offset: 2px; }
 .hjm-comment-row__media { align-self: flex-start; overflow: hidden; margin-block-start: 4px; }
 .hjm-comment-row__media > img { display: block; inline-size: 100%; block-size: auto; }
+.hjm-comment-row__album { align-self: flex-start; margin-block-start: 4px; }
+.hjm-comment-row__panel { min-inline-size: 0; }
 /* commentThreadRecipe.actionAnchor (2026-10-17 measured audit): the 44 targets centre on the identity's first line
    (--hjm-comment-anchor-line, set per row), so like/more glyphs share the author line's centre instead of sitting
    12px below it. When HJM's own like/more is the last control (data-edge), the whole column takes the IconButton edge
@@ -3416,6 +3564,17 @@ button.hjm-chat-message__media-item:focus-visible { outline: 2px solid var(--hjm
 .hjm-card[data-interactive="true"] { font: inherit; color: inherit; text-align: inherit; cursor: pointer; min-inline-size: var(--hjm-control-min-touch-target); min-block-size: var(--hjm-control-min-touch-target); }
 .hjm-card[data-interactive="true"]:active:not(:disabled) { opacity: var(--hjm-card-pressed-opacity); }
 .hjm-card[data-interactive="true"]:disabled { opacity: var(--hjm-card-disabled-opacity); cursor: default; }
+/* Whole-card activation beside actions: the article keeps its semantics, a transparent button covers it, and only the
+   action controls rise above that button, so the gaps around them still open the card. */
+.hjm-card[data-activation="overlay"] { position: relative; }
+.hjm-card__activator { position: absolute; inset: 0; z-index: 0; margin: 0; padding: 0; border: 0; border-radius: inherit; background: transparent; cursor: pointer; }
+.hjm-card__activator:disabled { cursor: default; }
+.hjm-card[data-activation="overlay"] > .hjm-card__actions { position: relative; z-index: 1; pointer-events: none; }
+.hjm-card[data-activation="overlay"] > .hjm-card__actions > * { pointer-events: auto; }
+/* Press/disabled feedback belongs to the card target (media and body); action controls keep their own states. */
+.hjm-card[data-activation="overlay"]:has(> .hjm-card__activator:active:not(:disabled)) > :is(.hjm-card__media, .hjm-card__body) { opacity: var(--hjm-card-pressed-opacity); }
+.hjm-card[data-activation="overlay"]:has(> .hjm-card__activator:disabled) > :is(.hjm-card__media, .hjm-card__body) { opacity: var(--hjm-card-disabled-opacity); }
+.hjm-card[data-activation="overlay"]:has(> .hjm-card__activator:focus-visible) { outline: var(--hjm-focus-width) solid var(--hjm-color-focus); outline-offset: var(--hjm-focus-offset); }
 
 /* Full destination cards keep all names and widths stable; colors remain product semantic roles. */
 .hjm-bottom-navigation[data-selection="tile"] .hjm-bottom-navigation__surface { background: var(--hjm-color-surface-accent); }