@ds-mo/ui 2.10.0 → 2.10.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ds-mo/ui",
-  "version": "2.10.0",
+  "version": "2.10.2",
   "description": "CompoMo — composable web components styled with TokoMo design tokens",
   "keywords": [
     "web-components",
@@ -42,12 +42,12 @@
       "import": "./dist/components/index.js"
     },
     "./nav": {
-      "types": "./src/wc/nav/index.ts",
-      "import": "./src/wc/nav/index.ts"
+      "types": "./dist/lib/nav/index.d.ts",
+      "import": "./dist/lib/nav/index.js"
     },
     "./utils": {
-      "types": "./src/wc/utils/index.ts",
-      "import": "./src/wc/utils/index.ts"
+      "types": "./dist/lib/utils/index.d.ts",
+      "import": "./dist/lib/utils/index.js"
     },
     "./dist/components/*": "./dist/components/*"
   },
@@ -67,7 +67,7 @@
     "prebuild": "node scripts/generate-icon-catalog.mjs",
     "pretypecheck": "node scripts/generate-icon-catalog.mjs",
     "pretest": "node scripts/generate-icon-catalog.mjs",
-    "build": "stencil build && node scripts/patch-index-types.mjs && node scripts/patch-components-d-exports.mjs && node scripts/verify-icons-externalized.mjs && node scripts/write-build-stamp.mjs",
+    "build": "stencil build && node scripts/patch-index-types.mjs && node scripts/patch-components-d-exports.mjs && node scripts/verify-icons-externalized.mjs && node scripts/write-build-stamp.mjs && node scripts/build-lib-exports.mjs",
     "verify:pack": "node scripts/verify-npm-pack.mjs && node scripts/verify-nav-import.mjs",
     "test": "node --import tsx/esm --test tests/panel-nav-utils.test.ts tests/panel-tools.test.ts tests/shell-shortcuts.test.ts tests/shell-gradient-presets.test.ts tests/shell-view-transition.test.ts tests/shell-gradient.test.ts tests/shell-chrome-metrics.test.ts tests/shell-chrome-layer.test.ts tests/chrome-transition.test.ts tests/bar-nav-overflow-hysteresis.test.ts tests/badge-gradient-ring.test.ts tests/scroll-edge-fade.test.ts tests/resolve-css-length-px.test.ts tests/resolve-css-time-ms.test.ts tests/overlay-positioning.test.ts tests/menu-position.test.ts tests/menu-placement.test.ts tests/bar-nav-utils.test.ts tests/bar-nav-tabs-menu-utils.test.ts tests/bar-nav-dom-utils.test.ts tests/icon-catalog.test.ts tests/icon-cache.test.ts tests/icon-svg.test.ts",
     "test:e2e": "npm run build && playwright test",
@@ -130,7 +130,8 @@
     "typescript": "~6.0.3",
     "typescript-eslint": "^8.59.1",
     "vite": "^8.0.16",
-    "zod": "^4.4.3"
+    "zod": "^4.4.3",
+    "esbuild": "^0.28.0"
   },
   "engines": {
     "node": "^20.19.0 || >=22.12.0"

package/src/angular/proxies.ts

@@ -398,14 +398,14 @@ export declare interface DsEmptyState extends Components.DsEmptyState {}
 
 
 @ProxyCmp({
-  inputs: ['background', 'height', 'side', 'size', 'surface', 'visible']
+  inputs: ['height', 'side', 'size', 'visible']
 })
 @Component({
   selector: 'ds-fade',
   changeDetection: ChangeDetectionStrategy.OnPush,
   template: '<ng-content></ng-content>',
   // eslint-disable-next-line @angular-eslint/no-inputs-metadata-property
-  inputs: ['background', 'height', 'side', 'size', 'surface', 'visible'],
+  inputs: ['height', 'side', 'size', 'visible'],
   standalone: false
 })
 export class DsFade {

package/src/wc/components/Fade/Fade.tsx

@@ -1,54 +1,21 @@
-import { Component, Prop, Element, State, h, Host } from '@stencil/core';
-import { isShellGradientActive } from '../../nav/badge-gradient-ring';
+import { Component, Element, Prop, State, Watch, h, Host } from '@stencil/core';
+import {
+  isScrollAtEdge,
+  scrollEdgeFadeClassMap,
+  scrollEdgeFadeSizeStyle,
+  type ScrollEdgeFadeEdge,
+  type ScrollEdgeFadeSize,
+  type ScrollEdgeFadeSizeToken,
+} from '../../utils/scroll-edge-fade';
 
-export type FadeSide = 'top' | 'bottom' | 'left' | 'right';
-export type FadeSurface =
-  | 'default'
-  | 'primary'
-  | 'secondary'
-  | 'navigation'
-  | 'media'
-  | 'always-dark'
-  | 'inverted';
-export type FadeSizeToken =
-  | 'size-000'
-  | 'size-050'
-  | 'size-075'
-  | 'size-100'
-  | 'size-150'
-  | 'size-200'
-  | 'size-250'
-  | 'size-300'
-  | 'size-400'
-  | 'size-500'
-  | 'size-600'
-  | 'size-800';
-export type FadeSize = FadeSizeToken | (string & {});
+/** @deprecated Use `ScrollEdgeFadeEdge` from `@ds-mo/ui/utils`. */
+export type FadeSide = ScrollEdgeFadeEdge;
 
-const SIZE_VALUE: Record<FadeSizeToken, string> = {
-  'size-000': 'var(--dimension-size-000)',
-  'size-050': 'var(--dimension-size-050)',
-  'size-075': 'var(--dimension-size-075)',
-  'size-100': 'var(--dimension-size-100)',
-  'size-150': 'var(--dimension-size-150)',
-  'size-200': 'var(--dimension-size-200)',
-  'size-250': 'var(--dimension-size-250)',
-  'size-300': 'var(--dimension-size-300)',
-  'size-400': 'var(--dimension-size-400)',
-  'size-500': 'var(--dimension-size-500)',
-  'size-600': 'var(--dimension-size-600)',
-  'size-800': 'var(--dimension-size-800)',
-};
+/** @deprecated Use `ScrollEdgeFadeSizeToken` from `@ds-mo/ui/utils`. */
+export type FadeSizeToken = ScrollEdgeFadeSizeToken;
 
-const SURFACE_BACKGROUND: Record<FadeSurface, string> = {
-  default: 'var(--color-background-secondary)',
-  primary: 'var(--color-background-primary)',
-  secondary: 'var(--color-background-secondary)',
-  navigation: 'var(--color-navigation-background)',
-  media: 'var(--color-media-background)',
-  'always-dark': 'var(--color-always-dark-background)',
-  inverted: 'var(--color-inverted-background)',
-};
+/** @deprecated Use `ScrollEdgeFadeSize` from `@ds-mo/ui/utils`. */
+export type FadeSize = ScrollEdgeFadeSize;
 
 @Component({
   tag: 'ds-fade',
@@ -58,10 +25,7 @@ const SURFACE_BACKGROUND: Record<FadeSurface, string> = {
 export class Fade {
   @Element() el!: HTMLElement;
 
-  /** When under `ds-app-shell[gradient]`, composites the shell wash over the base fade. */
-  @State() private shellGradientChrome: 'panel' | 'bar' | null = null;
-
-  /** Edge where the fade is anchored. */
+  /** Edge where content fades as it approaches the scroll boundary. */
   @Prop() side: FadeSide = 'bottom';
 
   /** Fade depth along the fade axis. Accepts dimension size token names or any CSS length. */
@@ -73,61 +37,43 @@ export class Fade {
    */
   @Prop() height: string | undefined;
 
-  /** Surface context used to choose the fade target background token. */
-  @Prop() surface: FadeSurface = 'default';
-
-  /** Direct background override for contexts that already expose a resolved surface var. */
-  @Prop() background: string = 'var(--color-background-secondary)';
-
-  /** Controls visibility without removing the element from layout/positioning. */
+  /** Controls the mask without removing the scroll container from layout. */
   @Prop() visible: boolean = true;
 
-  componentDidLoad() {
-    this.syncShellGradient();
-  }
+  @State() private atEnd = false;
 
-  private syncShellGradient() {
-    if (!isShellGradientActive(this.el)) {
-      this.shellGradientChrome = null;
-      return;
-    }
-    this.shellGradientChrome = this.el.closest('ds-bar-nav') ? 'bar' : 'panel';
+  @Watch('side')
+  @Watch('visible')
+  protected onFadeConfigChange() {
+    this.syncAtEnd();
   }
 
-  private resolveSize(): string {
-    if (this.height) return this.height;
+  componentDidLoad() {
+    this.syncAtEnd();
+  }
 
-    return Object.prototype.hasOwnProperty.call(SIZE_VALUE, this.size)
-      ? SIZE_VALUE[this.size as FadeSizeToken]
-      : this.size;
+  private syncAtEnd() {
+    this.atEnd = isScrollAtEdge(this.el, this.side);
   }
 
-  private resolveBackground(): string {
-    if (this.background !== 'var(--color-background-secondary)') return this.background;
-    return SURFACE_BACKGROUND[this.surface];
+  private handleScroll(e: Event) {
+    const target = e.currentTarget as HTMLElement;
+    this.atEnd = isScrollAtEdge(target, this.side);
   }
 
   render() {
-    const isVerticalEdge = this.side === 'top' || this.side === 'bottom';
-
     return (
       <Host
-        aria-hidden="true"
-        class={{
-          fade: true,
-          'fade--hidden': !this.visible,
-          'fade--vertical-edge': isVerticalEdge,
-          'fade--horizontal-edge': !isVerticalEdge,
-          'fade--shell-gradient': this.shellGradientChrome !== null,
-          'fade--shell-gradient-panel': this.shellGradientChrome === 'panel',
-          'fade--shell-gradient-bar': this.shellGradientChrome === 'bar',
-          [`fade--${this.side}`]: true,
-        }}
-        style={{
-          '--ds-fade-size': this.resolveSize(),
-          '--ds-fade-bg': this.resolveBackground(),
-        } as Record<string, string>}
-      />
+        class={scrollEdgeFadeClassMap({
+          edges: this.side,
+          atEnd: { [this.side]: this.atEnd },
+          hidden: !this.visible,
+        })}
+        style={scrollEdgeFadeSizeStyle(this.size, this.height) as Record<string, string>}
+        onScroll={(e: Event) => this.handleScroll(e)}
+      >
+        <slot />
+      </Host>
     );
   }
 }

package/src/wc/components/Fade/index.ts

@@ -1 +1 @@
-export type { FadeSide, FadeSize, FadeSizeToken, FadeSurface } from './Fade';
+export type { FadeSide, FadeSize, FadeSizeToken } from './Fade';

package/src/wc/components/PanelNav/PanelNav.tsx

@@ -17,6 +17,7 @@ import {
   type PanelNavRouterMode,
   type PanelNavUserActionDetail,
 } from './panel-nav-types';
+import { scrollEdgeFadeClassMap } from '../../utils/scroll-edge-fade';
 
 @Component({
   tag: 'ds-panel-nav',
@@ -88,7 +89,6 @@ export class PanelNav {
 
   @State() private renderedStyle: NavChromeStyle = 'dashboard';
   @State() private parsedGroups: PanelNavGroup[] = [];
-  @State() private atBottom = false;
   @State() private isAnimating = false;
   @State() private rovingIndex: number = 0;
   @State() private viewportNarrow: boolean = false;
@@ -179,7 +179,6 @@ export class PanelNav {
   componentDidLoad() {
     this.syncHostPropsIfNeeded();
     this.scheduleDeferredHostPropSync();
-    this.checkScroll();
     if (this.breakpoint > 0) this.connectResizeObserver();
   }
 
@@ -389,19 +388,6 @@ export class PanelNav {
     this.focusRovingAt(next);
   }
 
-  private checkScroll() {
-    const body = this.el.querySelector('.panel-nav__body') as HTMLElement | null;
-    if (!body) return;
-    const remaining = body.scrollHeight - body.scrollTop - body.clientHeight;
-    this.atBottom = remaining < 2;
-  }
-
-  private handleBodyScroll(e: Event) {
-    const body = e.target as HTMLElement;
-    const remaining = body.scrollHeight - body.scrollTop - body.clientHeight;
-    this.atBottom = remaining < 2;
-  }
-
   private handleItemClick(id: string) {
     this.dsNavSelect.emit(id);
   }
@@ -558,7 +544,6 @@ export class PanelNav {
       'panel-nav--settings': !isDashboard,
       'panel-nav--collapsed': collapsed,
       'panel-nav--animating': this.isAnimating,
-      'panel-nav--at-bottom': this.atBottom,
     };
 
     return (
@@ -601,11 +586,8 @@ export class PanelNav {
           <div
             class={{
               'panel-nav__body': true,
-              'scroll-edge-fade': true,
-              'scroll-edge-fade--bottom': true,
-              'scroll-edge-fade--at-end': this.atBottom,
+              ...scrollEdgeFadeClassMap({ edges: 'bottom' }),
             }}
-            onScroll={e => this.handleBodyScroll(e)}
           >
             {(() => {
               let flatIdx = 0;

package/src/wc/components.d.ts

@@ -19,7 +19,7 @@ import { CardSettingWidth } from "./components/CardSetting/CardSetting";
 import { ChipBackground, ChipContrast, ChipElevation, ChipIntent, ChipSize } from "./components/Chip/Chip";
 import { DividerInset, DividerLength, DividerOrientation, DividerSurface } from "./components/Divider/Divider";
 import { EmptyStateType } from "./components/EmptyState/EmptyState";
-import { FadeSide, FadeSize, FadeSurface } from "./components/Fade/Fade";
+import { FadeSide, FadeSize } from "./components/Fade/Fade";
 import { HeaderBackground } from "./components/Header/Header";
 import { IconColor, IconSize } from "./components/Icon/Icon";
 import { InputType } from "./components/Input/Input";
@@ -57,7 +57,7 @@ export { CardSettingWidth } from "./components/CardSetting/CardSetting";
 export { ChipBackground, ChipContrast, ChipElevation, ChipIntent, ChipSize } from "./components/Chip/Chip";
 export { DividerInset, DividerLength, DividerOrientation, DividerSurface } from "./components/Divider/Divider";
 export { EmptyStateType } from "./components/EmptyState/EmptyState";
-export { FadeSide, FadeSize, FadeSurface } from "./components/Fade/Fade";
+export { FadeSide, FadeSize } from "./components/Fade/Fade";
 export { HeaderBackground } from "./components/Header/Header";
 export { IconColor, IconSize } from "./components/Icon/Icon";
 export { InputType } from "./components/Input/Input";
@@ -445,17 +445,12 @@ export namespace Components {
         "type": EmptyStateType;
     }
     interface DsFade {
-        /**
-          * Direct background override for contexts that already expose a resolved surface var.
-          * @default 'var(--color-background-secondary)'
-         */
-        "background": string;
         /**
           * Deprecated alias for size. Kept for existing consumers that pass a raw CSS length. Prefer `size`.
          */
         "height": string | undefined;
         /**
-          * Edge where the fade is anchored.
+          * Edge where content fades as it approaches the scroll boundary.
           * @default 'bottom'
          */
         "side": FadeSide;
@@ -465,12 +460,7 @@ export namespace Components {
          */
         "size": FadeSize;
         /**
-          * Surface context used to choose the fade target background token.
-          * @default 'default'
-         */
-        "surface": FadeSurface;
-        /**
-          * Controls visibility without removing the element from layout/positioning.
+          * Controls the mask without removing the scroll container from layout.
           * @default true
          */
         "visible": boolean;
@@ -2134,17 +2124,12 @@ declare namespace LocalJSX {
         "type"?: EmptyStateType;
     }
     interface DsFade {
-        /**
-          * Direct background override for contexts that already expose a resolved surface var.
-          * @default 'var(--color-background-secondary)'
-         */
-        "background"?: string;
         /**
           * Deprecated alias for size. Kept for existing consumers that pass a raw CSS length. Prefer `size`.
          */
         "height"?: string | undefined;
         /**
-          * Edge where the fade is anchored.
+          * Edge where content fades as it approaches the scroll boundary.
           * @default 'bottom'
          */
         "side"?: FadeSide;
@@ -2154,12 +2139,7 @@ declare namespace LocalJSX {
          */
         "size"?: FadeSize;
         /**
-          * Surface context used to choose the fade target background token.
-          * @default 'default'
-         */
-        "surface"?: FadeSurface;
-        /**
-          * Controls visibility without removing the element from layout/positioning.
+          * Controls the mask without removing the scroll container from layout.
           * @default true
          */
         "visible"?: boolean;
@@ -2916,8 +2896,6 @@ declare namespace LocalJSX {
         "side": FadeSide;
         "size": FadeSize;
         "height": string | undefined;
-        "surface": FadeSurface;
-        "background": string;
         "visible": boolean;
     }
     interface DsFieldAttributes {

package/src/wc/nav/index.ts

@@ -48,6 +48,7 @@ export {
   SHELL_GRADIENT_PRESET_LABELS,
   buildShellRadialGradientForPreset,
   isShellGradientPreset,
+  normalizeShellGradientPreset,
   shellGradientPresetStopToken,
 } from './shell-gradient-presets';
 export type { ChromeTransitionDetail, ChromeTransitionSource } from './chrome-transition';

package/src/wc/nav/shell-gradient-presets.ts

@@ -37,10 +37,24 @@ export function isShellGradientPreset(value: string): value is ShellGradientPres
   return (SHELL_GRADIENT_PRESETS as string[]).includes(value);
 }
 
+/**
+ * Coerce unknown/absent presets to the default. Runtime values escape the
+ * type: removing the reflected `gradient-preset` attribute (e.g. an Angular
+ * `[attr.gradient-preset]="null"` binding) drives the prop to null past its
+ * field default — without normalization the stop lookup interpolates the
+ * literal string "undefined" into CSS and the wash silently disappears.
+ */
+export function normalizeShellGradientPreset(
+  value: string | null | undefined,
+): ShellGradientPreset {
+  return value != null && isShellGradientPreset(value) ? value : DEFAULT_SHELL_GRADIENT_PRESET;
+}
+
 /** Radial wash for a preset — transparent at top-left into the intent stop. `none` returns no image. */
 export function buildShellRadialGradientForPreset(preset: ShellGradientPreset): string {
-  if (preset === 'none') return 'none';
+  const normalized = normalizeShellGradientPreset(preset);
+  if (normalized === 'none') return 'none';
 
-  const stop = shellGradientPresetStopToken(preset);
+  const stop = shellGradientPresetStopToken(normalized);
   return `radial-gradient(${GRADIENT_GEOMETRY}, var(--color-background-transparent) 0%, ${stop} 100%)`;
 }

package/src/wc/utils/index.ts

@@ -4,9 +4,18 @@ export { parseCssTimeMs, resolveCssTimeMs } from './resolve-css-time-ms';
 export {
   SCROLL_EDGE_FADE_DEFAULT_SIZE,
   SCROLL_EDGE_FADE_SIZE_VAR,
+  isScrollAtEdge,
+  resolveScrollEdgeFadeSize,
+  scrollEdgeFadeClassMap,
   scrollEdgeFadeMaskImage,
   scrollEdgeFadeMaskStyle,
+  scrollEdgeFadeSizeStyle,
+} from './scroll-edge-fade';
+export type {
+  ScrollEdgeFadeEdge,
+  ScrollEdgeFadeOptions,
+  ScrollEdgeFadeSize,
+  ScrollEdgeFadeSizeToken,
 } from './scroll-edge-fade';
-export type { ScrollEdgeFadeEdge } from './scroll-edge-fade';
 export { TOKEN_DEFAULTS, TOKEN_CSS_LENGTHS } from './token-defaults';
 export type { TokenDefaultKey } from './token-defaults';

package/src/wc/utils/scroll-edge-fade.css

@@ -1,8 +1,9 @@
 /**
- * Scroll-edge alpha fade — apply to overflow scroll containers.
- * Pair with `.scroll-edge-fade--at-end` when the relevant edge is flush (no fade).
+ * Scroll-edge alpha fade — the single edge-fade utility for overflow containers.
+ * Masks scrolling content to transparent so flat surfaces, shell gradients, and
+ * images show through. Pair with `.scroll-edge-fade--at-end` when flush.
  *
- * @see scroll-edge-fade.ts for programmatic mask helpers.
+ * @see scroll-edge-fade.ts — `scrollEdgeFadeClassMap`, `isScrollAtEdge`, size helpers.
  */
 
 .scroll-edge-fade {
@@ -67,7 +68,8 @@
   mask-size: 100% 100%;
 }
 
-.scroll-edge-fade--at-end {
+.scroll-edge-fade--at-end,
+.scroll-edge-fade--hidden {
   -webkit-mask-image: none;
   mask-image: none;
 }

package/src/wc/utils/scroll-edge-fade.ts

@@ -5,12 +5,75 @@ export const SCROLL_EDGE_FADE_DEFAULT_SIZE = 'var(--dimension-size-600)';
 
 export type ScrollEdgeFadeEdge = 'top' | 'bottom' | 'left' | 'right';
 
+export type ScrollEdgeFadeSizeToken =
+  | 'size-000'
+  | 'size-050'
+  | 'size-075'
+  | 'size-100'
+  | 'size-150'
+  | 'size-200'
+  | 'size-250'
+  | 'size-300'
+  | 'size-400'
+  | 'size-500'
+  | 'size-600'
+  | 'size-800';
+
+export type ScrollEdgeFadeSize = ScrollEdgeFadeSizeToken | (string & {});
+
+const SIZE_VALUE: Record<ScrollEdgeFadeSizeToken, string> = {
+  'size-000': 'var(--dimension-size-000)',
+  'size-050': 'var(--dimension-size-050)',
+  'size-075': 'var(--dimension-size-075)',
+  'size-100': 'var(--dimension-size-100)',
+  'size-150': 'var(--dimension-size-150)',
+  'size-200': 'var(--dimension-size-200)',
+  'size-250': 'var(--dimension-size-250)',
+  'size-300': 'var(--dimension-size-300)',
+  'size-400': 'var(--dimension-size-400)',
+  'size-500': 'var(--dimension-size-500)',
+  'size-600': 'var(--dimension-size-600)',
+  'size-800': 'var(--dimension-size-800)',
+};
+
 const SIZE_REF = `var(${SCROLL_EDGE_FADE_SIZE_VAR}, ${SCROLL_EDGE_FADE_DEFAULT_SIZE})`;
 
+export interface ScrollEdgeFadeOptions {
+  /** One or more edges to fade. */
+  edges: ScrollEdgeFadeEdge | ScrollEdgeFadeEdge[];
+  /**
+   * When true, or when every listed edge is at its scroll limit, removes the mask.
+   * Pass a per-edge map to hide only the edges that are flush (panel-nav bottom fade).
+   */
+  atEnd?: boolean | Partial<Record<ScrollEdgeFadeEdge, boolean>>;
+  /** Force the mask off regardless of scroll position (`ds-fade` `visible={false}`). */
+  hidden?: boolean;
+}
+
+/** Resolve a dimension size token name or raw CSS length for `--ds-scroll-edge-fade-size`. */
+export function resolveScrollEdgeFadeSize(
+  size: ScrollEdgeFadeSize = 'size-600',
+  height?: string,
+): string {
+  if (height) return height;
+  return Object.prototype.hasOwnProperty.call(SIZE_VALUE, size)
+    ? SIZE_VALUE[size as ScrollEdgeFadeSizeToken]
+    : size;
+}
+
+/** Inline style map setting fade depth on a scroll container. */
+export function scrollEdgeFadeSizeStyle(
+  size: ScrollEdgeFadeSize = 'size-600',
+  height?: string,
+): Record<string, string> {
+  return {
+    [SCROLL_EDGE_FADE_SIZE_VAR]: resolveScrollEdgeFadeSize(size, height),
+  };
+}
+
 /**
  * Alpha mask for a scroll container edge — content fades to transparent so
- * textured backgrounds (gradients, images) show through. Prefer over painted
- * `ds-fade` overlays on non-flat surfaces.
+ * textured backgrounds (shell gradients, images) show through.
  */
 export function scrollEdgeFadeMaskImage(edge: ScrollEdgeFadeEdge): string {
   switch (edge) {
@@ -25,14 +88,61 @@ export function scrollEdgeFadeMaskImage(edge: ScrollEdgeFadeEdge): string {
   }
 }
 
-/** Inline style map for a masked scroll region. */
-export function scrollEdgeFadeMaskStyle(edge: ScrollEdgeFadeEdge): Record<string, string> {
+/** Inline style map for a masked scroll region (single edge). */
+export function scrollEdgeFadeMaskStyle(
+  edge: ScrollEdgeFadeEdge,
+  size: ScrollEdgeFadeSize = 'size-600',
+  height?: string,
+): Record<string, string> {
   const mask = scrollEdgeFadeMaskImage(edge);
   return {
-    [SCROLL_EDGE_FADE_SIZE_VAR]: SCROLL_EDGE_FADE_DEFAULT_SIZE,
+    ...scrollEdgeFadeSizeStyle(size, height),
     WebkitMaskImage: mask,
     maskImage: mask,
     WebkitMaskSize: '100% 100%',
     maskSize: '100% 100%',
   };
 }
+
+/** Class map for `scroll-edge-fade` modifiers — pair with `scroll-edge-fade.css`. */
+export function scrollEdgeFadeClassMap(opts: ScrollEdgeFadeOptions): Record<string, boolean> {
+  const edges = Array.isArray(opts.edges) ? opts.edges : [opts.edges];
+  const classes: Record<string, boolean> = {
+    'scroll-edge-fade': true,
+    'scroll-edge-fade--hidden': opts.hidden === true,
+  };
+
+  for (const edge of edges) {
+    classes[`scroll-edge-fade--${edge}`] = true;
+  }
+
+  const { atEnd } = opts;
+  if (atEnd === true) {
+    classes['scroll-edge-fade--at-end'] = true;
+  } else if (atEnd && typeof atEnd === 'object') {
+    const allAtEnd = edges.every(edge => atEnd[edge]);
+    if (allAtEnd) {
+      classes['scroll-edge-fade--at-end'] = true;
+    }
+  }
+
+  return classes;
+}
+
+/** Whether a scroll container is flush with the given edge (within `threshold` px). */
+export function isScrollAtEdge(
+  el: HTMLElement,
+  edge: ScrollEdgeFadeEdge,
+  threshold = 2,
+): boolean {
+  switch (edge) {
+    case 'top':
+      return el.scrollTop <= threshold;
+    case 'bottom':
+      return el.scrollHeight - el.scrollTop - el.clientHeight <= threshold;
+    case 'left':
+      return el.scrollLeft <= threshold;
+    case 'right':
+      return el.scrollWidth - el.scrollLeft - el.clientWidth <= threshold;
+  }
+}

package/dist/components/p-0y48zKIF.js

@@ -1,2 +0,0 @@
-const n=["cool","neutral","warm"];const t="neutral";const o={none:"None",cool:"Cool",neutral:"Neutral",warm:"Warm"};const r={cool:"var(--color-color-intent-blue-strong-background)",neutral:"var(--color-color-intent-grey-strong-background)",warm:"var(--color-color-intent-yellow-strong-background)"};const a="100% 100% at 0% 0%";function e(n){if(n==="none")return null;return r[n]}function s(n){if(n==="none")return"none";const t=e(n);return`radial-gradient(${a}, var(--color-background-transparent) 0%, ${t} 100%)`}const c="--ds-shell-gradient-image";const l="--ds-shell-gradient-size";const i="--ds-shell-gradient-position-panel";const u="--ds-shell-gradient-position-bar";const d="--ds-shell-gradient-opacity";const g="0.1";function h(n=t){return s(n)}function f(n){const t=typeof globalThis.window!=="undefined"?globalThis.window:undefined;if(!t)return{width:0,height:0};const o=t.visualViewport;return{width:Math.round(o?.width??t.innerWidth),height:Math.round(o?.height??t.innerHeight)}}function p(n){return`${Math.round(n.width)}px ${Math.round(n.height)}px`}function b(){return"0 0"}function w(n){return`${-Math.round(n)}px 0`}export{t as D,n as S,o as a,g as b,s as c,c as d,l as e,d as f,i as g,u as h,w as i,h as j,p as k,f as r,b as s};
-//# sourceMappingURL=p-0y48zKIF.js.map

package/dist/components/p-0y48zKIF.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["SHELL_GRADIENT_WASH_PRESETS","DEFAULT_SHELL_GRADIENT_PRESET","SHELL_GRADIENT_PRESET_LABELS","none","cool","neutral","warm","SHELL_GRADIENT_PRESET_STOP","GRADIENT_GEOMETRY","shellGradientPresetStopToken","preset","buildShellRadialGradientForPreset","stop","SHELL_GRADIENT_IMAGE_VAR","SHELL_GRADIENT_SIZE_VAR","SHELL_GRADIENT_POSITION_PANEL_VAR","SHELL_GRADIENT_POSITION_BAR_VAR","SHELL_GRADIENT_OPACITY_VAR","SHELL_GRADIENT_OPACITY","buildShellRadialGradient","readShellViewportDimensions","win","w","globalThis","window","undefined","width","height","visual","visualViewport","Math","round","innerWidth","innerHeight","shellGradientSize","layout","shellGradientPositionPanel","shellGradientPositionBar","panelWidth"],"sources":["src/wc/nav/shell-gradient-presets.ts","src/wc/nav/shell-gradient.ts"],"sourcesContent":["/** Built-in shell chrome wash presets — none (solid secondary), cool, neutral, warm. */\nexport type ShellGradientPreset = 'none' | 'cool' | 'neutral' | 'warm';\n\nexport const SHELL_GRADIENT_PRESETS: ShellGradientPreset[] = ['none', 'cool', 'neutral', 'warm'];\n\n/** Wash presets shown after the `none` option in pickers. */\nexport const SHELL_GRADIENT_WASH_PRESETS: Exclude<ShellGradientPreset, 'none'>[] = [\n  'cool',\n  'neutral',\n  'warm',\n];\n\n/** Default wash when `gradient-preset` is omitted. */\nexport const DEFAULT_SHELL_GRADIENT_PRESET: ShellGradientPreset = 'neutral';\n\nexport const SHELL_GRADIENT_PRESET_LABELS: Record<ShellGradientPreset, string> = {\n  none: 'None',\n  cool: 'Cool',\n  neutral: 'Neutral',\n  warm: 'Warm',\n};\n\nconst SHELL_GRADIENT_PRESET_STOP: Record<Exclude<ShellGradientPreset, 'none'>, string> = {\n  cool: 'var(--color-color-intent-blue-strong-background)',\n  neutral: 'var(--color-color-intent-grey-strong-background)',\n  warm: 'var(--color-color-intent-yellow-strong-background)',\n};\n\nconst GRADIENT_GEOMETRY = '100% 100% at 0% 0%';\n\nexport function shellGradientPresetStopToken(preset: ShellGradientPreset): string | null {\n  if (preset === 'none') return null;\n  return SHELL_GRADIENT_PRESET_STOP[preset];\n}\n\nexport function isShellGradientPreset(value: string): value is ShellGradientPreset {\n  return (SHELL_GRADIENT_PRESETS as string[]).includes(value);\n}\n\n/** Radial wash for a preset — transparent at top-left into the intent stop. `none` returns no image. */\nexport function buildShellRadialGradientForPreset(preset: ShellGradientPreset): string {\n  if (preset === 'none') return 'none';\n\n  const stop = shellGradientPresetStopToken(preset);\n  return `radial-gradient(${GRADIENT_GEOMETRY}, var(--color-background-transparent) 0%, ${stop} 100%)`;\n}\n","/** CSS var names consumed by `ds-panel-nav` / `ds-bar-nav` inside `ds-app-shell`. */\nimport type { ShellGradientPreset } from './shell-gradient-presets';\nimport {\n  DEFAULT_SHELL_GRADIENT_PRESET,\n  buildShellRadialGradientForPreset,\n} from './shell-gradient-presets';\n\nexport type { ShellGradientPreset } from './shell-gradient-presets';\nexport {\n  DEFAULT_SHELL_GRADIENT_PRESET,\n  SHELL_GRADIENT_PRESETS,\n  SHELL_GRADIENT_PRESET_LABELS,\n  buildShellRadialGradientForPreset,\n  isShellGradientPreset,\n  shellGradientPresetStopToken,\n} from './shell-gradient-presets';\n\nexport const SHELL_GRADIENT_IMAGE_VAR = '--ds-shell-gradient-image';\nexport const SHELL_GRADIENT_SIZE_VAR = '--ds-shell-gradient-size';\nexport const SHELL_GRADIENT_POSITION_PANEL_VAR = '--ds-shell-gradient-position-panel';\nexport const SHELL_GRADIENT_POSITION_BAR_VAR = '--ds-shell-gradient-position-bar';\nexport const SHELL_GRADIENT_OPACITY_VAR = '--ds-shell-gradient-opacity';\n/** Per chrome-surface background-position — offsets wash + grid to shell row origin. */\nexport const SHELL_CHROME_SURFACE_POSITION_VAR = '--ds-shell-chrome-surface-position';\n\n/** Layer opacity for the nav gradient wash. */\nexport const SHELL_GRADIENT_OPACITY = '0.1';\n\n/** Whether the shared chrome layer (secondary bg + optional wash) should mount. */\nexport function shellChromeLayerActive(gradient: boolean): boolean {\n  return gradient;\n}\n\n/**\n * Shell radial wash — same for panel and bar nav.\n * Tokens follow `data-theme` (light/dark intent stops).\n */\nexport function buildShellRadialGradient(\n  preset: ShellGradientPreset = DEFAULT_SHELL_GRADIENT_PRESET,\n): string {\n  return buildShellRadialGradientForPreset(preset);\n}\n\n/** Built-in radial image (`gradientSrc` on shell overrides). */\nexport function shellGradientImage(\n  preset: ShellGradientPreset = DEFAULT_SHELL_GRADIENT_PRESET,\n): string {\n  return buildShellRadialGradient(preset);\n}\n\nexport interface ShellViewportDimensions {\n  width: number;\n  height: number;\n}\n\n/**\n * Viewport size for shell chrome with `background-attachment: fixed`.\n * Must not use the `ds-app-shell` element box — the shell can be shorter or\n * taller than the viewport when host height chains break or content overflows.\n */\nexport function readShellViewportDimensions(win?: Window): ShellViewportDimensions {\n  const w = win ?? (typeof globalThis.window !== 'undefined' ? globalThis.window : undefined);\n  if (!w) return { width: 0, height: 0 };\n\n  const visual = w.visualViewport;\n  return {\n    width: Math.round(visual?.width ?? w.innerWidth),\n    height: Math.round(visual?.height ?? w.innerHeight),\n  };\n}\n\nexport interface ShellGradientLayout {\n  width: number;\n  height: number;\n  panelWidth: number;\n}\n\n/** Pixel `background-size` for the fixed-attachment radial wash. */\nexport function shellGradientSize(layout: Pick<ShellGradientLayout, 'width' | 'height'>): string {\n  return `${Math.round(layout.width)}px ${Math.round(layout.height)}px`;\n}\n\nexport function shellGradientPositionPanel(): string {\n  return '0 0';\n}\n\nexport function shellGradientPositionBar(panelWidth: number): string {\n  return `${-Math.round(panelWidth)}px 0`;\n}\n\n/** Phase-lock a chrome rect to the shell row coordinate system (wash + grid). */\nexport function shellChromeSurfacePosition(leftPx: number, topPx: number): string {\n  return `${-Math.round(leftPx)}px ${-Math.round(topPx)}px`;\n}\n"],"mappings":"AAMO,MAAMA,EAAsE,CACjF,OACA,UACA,QAIK,MAAMC,EAAqD,UAE3D,MAAMC,EAAoE,CAC/EC,KAAM,OACNC,KAAM,OACNC,QAAS,UACTC,KAAM,QAGR,MAAMC,EAAmF,CACvFH,KAAM,mDACNC,QAAS,mDACTC,KAAM,sDAGR,MAAME,EAAoB,qBAEpB,SAAUC,EAA6BC,GAC3C,GAAIA,IAAW,OAAQ,OAAO,KAC9B,OAAOH,EAA2BG,EACpC,CAOM,SAAUC,EAAkCD,GAChD,GAAIA,IAAW,OAAQ,MAAO,OAE9B,MAAME,EAAOH,EAA6BC,GAC1C,MAAO,mBAAmBF,8CAA8DI,SAC1F,CC5BO,MAAMC,EAA2B,4BACjC,MAAMC,EAA0B,2BAChC,MAAMC,EAAoC,qCAC1C,MAAMC,EAAkC,mCACxC,MAAMC,EAA6B,8BAKnC,MAAMC,EAAyB,MAWhC,SAAUC,EACdT,EAA8BT,GAE9B,OAAOU,EAAkCD,EAC3C,CAmBM,SAAUU,EAA4BC,GAC1C,MAAMC,SAAmBC,WAAWC,SAAW,YAAcD,WAAWC,OAASC,UACjF,IAAKH,EAAG,MAAO,CAAEI,MAAO,EAAGC,OAAQ,GAEnC,MAAMC,EAASN,EAAEO,eACjB,MAAO,CACLH,MAAOI,KAAKC,MAAMH,GAAQF,OAASJ,EAAEU,YACrCL,OAAQG,KAAKC,MAAMH,GAAQD,QAAUL,EAAEW,aAE3C,CASM,SAAUC,EAAkBC,GAChC,MAAO,GAAGL,KAAKC,MAAMI,EAAOT,YAAYI,KAAKC,MAAMI,EAAOR,WAC5D,C,SAEgBS,IACd,MAAO,KACT,CAEM,SAAUC,EAAyBC,GACvC,MAAO,IAAIR,KAAKC,MAAMO,QACxB,Q","ignoreList":[]}

package/dist/components/p-BFPfyJ8Z.js

@@ -1,2 +0,0 @@
-const t="--_badge-gradient-position";function n(t){const n=t.closest("ds-app-shell");return n?.hasAttribute("gradient")===true}export{t as B,n as i};
-//# sourceMappingURL=p-BFPfyJ8Z.js.map

package/dist/components/p-BFPfyJ8Z.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["BADGE_GRADIENT_POSITION_VAR","isShellGradientActive","from","shell","closest","hasAttribute"],"sources":["src/wc/nav/badge-gradient-ring.ts"],"sourcesContent":["import {\n  SHELL_GRADIENT_POSITION_BAR_VAR,\n  SHELL_GRADIENT_POSITION_PANEL_VAR,\n} from './shell-gradient';\n\n/** Per-badge background-position for shell gradient ring sampling. */\nexport const BADGE_GRADIENT_POSITION_VAR = '--_badge-gradient-position';\n\nexport interface GradientSurface {\n  element: HTMLElement;\n  chromeHost: HTMLElement;\n  positionVar: string;\n}\n\n/** Whether the badge sits under `ds-app-shell[gradient]`. */\nexport function isShellGradientActive(from: HTMLElement): boolean {\n  // Explicit <HTMLElement>: the inferred HTMLDsAppShellElement type only\n  // resolves where @stencil/core types are installed — consumers importing\n  // `@ds-mo/ui/nav` (raw TS) compile this without them.\n  const shell = from.closest<HTMLElement>('ds-app-shell');\n  return shell?.hasAttribute('gradient') === true;\n}\n\n/** Bar or panel chrome surface that owns the shell gradient stack. */\nexport function findGradientSurface(from: HTMLElement): GradientSurface | null {\n  const barHost = from.closest('ds-bar-nav') as HTMLElement | null;\n  if (barHost) {\n    const root = barHost.shadowRoot ?? barHost;\n    const element = root.querySelector('.bar-nav');\n    if (element) {\n      return {\n        element: element as HTMLElement,\n        chromeHost: barHost,\n        positionVar: SHELL_GRADIENT_POSITION_BAR_VAR,\n      };\n    }\n  }\n\n  const panelHost = from.closest('ds-panel-nav') as HTMLElement | null;\n  if (panelHost) {\n    const root = panelHost.shadowRoot ?? panelHost;\n    const element = root.querySelector('.panel-nav');\n    if (element) {\n      return {\n        element: element as HTMLElement,\n        chromeHost: panelHost,\n        positionVar: SHELL_GRADIENT_POSITION_PANEL_VAR,\n      };\n    }\n  }\n\n  return null;\n}\n\ninterface ParsedPosition {\n  x: number;\n  y: number;\n}\n\n/** Parse a two-value CSS background-position (e.g. `-200px 0`). */\nexport function parseCssBackgroundPosition(value: string): ParsedPosition {\n  const trimmed = value.trim();\n  if (!trimmed) return { x: 0, y: 0 };\n\n  const parts = trimmed.split(/\\s+/);\n  const x = parseLength(parts[0] ?? '0');\n  const y = parseLength(parts[1] ?? '0');\n  return { x, y };\n}\n\nfunction parseLength(token: string): number {\n  const px = token.match(/^(-?[\\d.]+)px$/);\n  if (px) return Number(px[1]);\n  return 0;\n}\n\n/**\n * Background position for a badge ring so the shell gradient aligns with nav chrome.\n * Uses badge center relative to the painted chrome surface.\n */\nexport function badgeGradientPosition(\n  badgeHost: HTMLElement,\n  surface: GradientSurface,\n  shellPosition: string,\n): string {\n  const badgeRect = badgeHost.getBoundingClientRect();\n  const surfaceRect = surface.element.getBoundingClientRect();\n  const anchorX = badgeRect.left + badgeRect.width / 2 - surfaceRect.left;\n  const anchorY = badgeRect.top + badgeRect.height / 2 - surfaceRect.top;\n  const { x, y } = parseCssBackgroundPosition(shellPosition);\n\n  return `${Math.round(x - anchorX)}px ${Math.round(y - anchorY)}px`;\n}\n\n/** Resolve shell gradient position from chrome host custom properties. */\nexport function readShellGradientPosition(surface: GradientSurface): string {\n  const styles = getComputedStyle(surface.chromeHost);\n  return styles.getPropertyValue(surface.positionVar).trim() || '0 0';\n}\n\n/** Stamp `--_badge-gradient-position` on the badge host (fixed viewport chrome). */\nexport function syncBadgeGradientPosition(badgeHost: HTMLElement): void {\n  if (!isShellGradientActive(badgeHost)) {\n    badgeHost.style.removeProperty(BADGE_GRADIENT_POSITION_VAR);\n    return;\n  }\n\n  badgeHost.style.setProperty(BADGE_GRADIENT_POSITION_VAR, '0 0');\n}\n"],"mappings":"AAMO,MAAMA,EAA8B,6BASrC,SAAUC,EAAsBC,GAIpC,MAAMC,EAAQD,EAAKE,QAAqB,gBACxC,OAAOD,GAAOE,aAAa,cAAgB,IAC7C,Q","ignoreList":[]}