@dereekb/dbx-web 13.21.0 → 13.23.0

package/eslint/src/lib/require-action-error-handler.rule.d.ts

@@ -0,0 +1,30 @@
+import { type AstNode } from './util';
+/**
+ * ESLint rule definition shape used by `require-action-error-handler`.
+ */
+export interface DbxWebRequireActionErrorHandlerRuleDefinition {
+    readonly meta: {
+        readonly type: 'suggestion';
+        readonly fixable: undefined;
+        readonly docs: {
+            readonly description: string;
+            readonly recommended: boolean;
+        };
+        readonly messages: {
+            readonly missingErrorHandler: string;
+        };
+        readonly schema: readonly object[];
+    };
+    create(context: AstNode): Record<string, (node: AstNode) => void>;
+}
+/**
+ * ESLint (Angular template) rule that flags a `dbxAction` which runs work (has a
+ * handler or a trigger) but presents no errors to the user.
+ *
+ * Satisfied by ANY error directive in the context: `dbxActionSnackbarError`,
+ * `[dbxActionError]`, `[dbxActionSnackbar]`, or `[dbxActionErrorHandler]`.
+ *
+ * Shares the same context-scoping bail conditions as `require-action-value-source`
+ * (`[dbxActionSource]` on self/ancestor, or a nested `dbxAction`).
+ */
+export declare const DBX_WEB_REQUIRE_ACTION_ERROR_HANDLER_RULE: DbxWebRequireActionErrorHandlerRuleDefinition;

package/eslint/src/lib/require-action-value-source.rule.d.ts

@@ -0,0 +1,36 @@
+import { type AstNode } from './util';
+/**
+ * ESLint rule definition shape used by `require-action-value-source`.
+ */
+export interface DbxWebRequireActionValueSourceRuleDefinition {
+    readonly meta: {
+        readonly type: 'problem';
+        readonly fixable: undefined;
+        readonly docs: {
+            readonly description: string;
+            readonly recommended: boolean;
+        };
+        readonly messages: {
+            readonly missingValueSource: string;
+        };
+        readonly schema: readonly object[];
+    };
+    create(context: AstNode): Record<string, (node: AstNode) => void>;
+}
+/**
+ * ESLint (Angular template) rule that flags a `dbxAction` whose context has a
+ * trigger but no value source.
+ *
+ * Such an action hangs: clicking the trigger moves the store to TRIGGERED, but with
+ * nothing to call `readyValue()` it never advances to VALUE_READY, so the handler
+ * never runs.
+ *
+ * Targets simple, inline cases only. It bails (does not report) when the value may
+ * be supplied in a way a static template scan cannot see:
+ * - `[dbxActionSource]` on the element or an ancestor (store forwarded from TS), or
+ * - a nested `dbxAction` inside the subtree (ambiguous which context owns a value source).
+ *
+ * For legitimate programmatic-value cases (or a demo intentionally showing the
+ * TRIGGERED state) suppress with `<!-- eslint-disable-next-line dereekb-dbx-web/require-action-value-source -->`.
+ */
+export declare const DBX_WEB_REQUIRE_ACTION_VALUE_SOURCE_RULE: DbxWebRequireActionValueSourceRuleDefinition;

package/lib/interaction/prompt/_prompt.scss

@@ -13,21 +13,29 @@ $dbx-popup-controls-height: 33px;
   }
 
   /// @dbx-utility prompt-box
-  /// @intent centered prompt panel — auto-margined max-width box with a 40px inset (override via `--dbx-prompt-box-padding`) and a "medium" corner radius (override via `--dbx-prompt-box-border-radius`); compose with `.elevate` to lift it with elevation 2
+  /// @intent centered prompt panel — auto-margined max-width box with a 40px inset (override via `--dbx-prompt-box-padding`) and a "medium" corner radius (override via `--dbx-prompt-box-border-radius`); compose with `.elevate` to lift it M3-style — a brighter `surface-bright` tonal wash plus a soft lift shadow
   /// @role layout
   /// @see-also content-box, content-elevate
   .dbx-prompt-box {
     margin: auto;
     padding: var(--dbx-prompt-box-padding, 40px);
     max-width: $box-max-width;
-    // Visible via the `.elevate` shadow (default) or any app-supplied background;
-    // the box itself intentionally has no background. Deliberately NOT chained
-    // through `--mat-dialog-container-shape` — a prompt box is a page surface,
+    // Visible via `.elevate` (a bright tonal surface + soft lift shadow, default) or any
+    // app-supplied background; the box itself intentionally has no background. Deliberately
+    // NOT chained through `--mat-dialog-container-shape` — a prompt box is a page surface,
     // not a dialog.
     border-radius: var(--dbx-prompt-box-border-radius, var(--mat-sys-corner-medium, 12px));
 
+    // M3 elevation: an elevated prompt panel reads as raised primarily through a brighter
+    // tonal surface — a low-opacity wash of the active dbxColor (`--dbx-bg-color-current`,
+    // primary by default, driven by an ancestor/host `[dbxColor]`) over `surface-bright` —
+    // plus a soft lift shadow for protection against the background, replacing the former
+    // Material elevation(2) shadow. Override `--dbx-prompt-box-elevate-tone` (percentage) to
+    // tune the wash, `--dbx-prompt-box-elevate-bg` to replace the background outright, or
+    // `--dbx-prompt-box-elevate-shadow` to retune/remove (`none`) the lift shadow.
     &.elevate {
-      @include theming.elevation(2);
+      background: var(--dbx-prompt-box-elevate-bg, color-mix(in srgb, #{theming.$dbx-bg-color} var(--dbx-prompt-box-elevate-tone, 8%), var(--mat-sys-surface-bright)));
+      box-shadow: var(--dbx-prompt-box-elevate-shadow, var(--mat-sys-level2));
     }
   }
 }

package/lib/layout/column/_column.scss

@@ -9,7 +9,7 @@ $two-columns-right-padding-size: var(--dbx-padding-2);
 // MARK: Mixin
 @mixin core() {
   /// @dbx-utility two-column
-  /// @intent two-column page layout — fixed-width left column with elevated right content area
+  /// @intent two-column page layout — fixed-width left column divided from the right content area by a border
   /// @role layout
   .dbx-two-column {
     height: 100%;
@@ -29,13 +29,18 @@ $two-columns-right-padding-size: var(--dbx-padding-2);
     }
 
     .left-column {
-      @include theming.elevation(1);
+      /// Color of the right boundary separating the fixed left column from the right content
+      /// area (replaces the former elevation shadow). Column-specific override point; defaults
+      /// to the shared --dbx-divider-color. Retint just this boundary by overriding it, or set
+      /// it to `transparent` to hide the divider while keeping the layout box.
+      /// @role color
+      /// @intent two column divider color, two column border color, left column separator color
+      border-right: 1px solid var(--dbx-two-column-border-color, var(--dbx-divider-color));
 
       width: $two-column-left-width;
       flex: 0 0 auto;
 
       overflow: auto;
-      // background: red;
     }
 
     .right-column {

package/lib/layout/list/_list.scss

@@ -188,6 +188,9 @@ $list-item-padded-min-height: 42px;
 
   .dbx-list-empty-content {
     text-align: center;
+    // Breathing room around the empty-state content so it doesn't sit flush against its container.
+    // Override point (`--dbx-list-empty-content-padding`) defaults to the global `--dbx-padding-2` spacing token.
+    padding: var(--dbx-list-empty-content-padding, var(--dbx-padding-2));
   }
 
   .dbx-list-content {

package/lib/style/_theming.scss

@@ -1,5 +1,3 @@
-@forward '@angular/material' show elevation;
-
 @forward './config';
 @forward './variables';
 @forward './mixin';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-web",
-  "version": "13.21.0",
+  "version": "13.23.0",
   "sideEffects": [
     "*.scss",
     "*.css"
@@ -13,12 +13,12 @@
     "@angular/material": "^21.2.9",
     "@angular/platform-browser": "21.2.11",
     "@cantoo/pdf-lib": "^2.6.5",
-    "@dereekb/browser": "13.21.0",
-    "@dereekb/date": "13.21.0",
-    "@dereekb/dbx-core": "13.21.0",
-    "@dereekb/rxjs": "13.21.0",
-    "@dereekb/util": "13.21.0",
-    "@dereekb/vitest": "13.21.0",
+    "@dereekb/browser": "13.23.0",
+    "@dereekb/date": "13.23.0",
+    "@dereekb/dbx-core": "13.23.0",
+    "@dereekb/rxjs": "13.23.0",
+    "@dereekb/util": "13.23.0",
+    "@dereekb/vitest": "13.23.0",
     "@ngbracket/ngx-layout": "^21.0.0",
     "@ngrx/component-store": "^21.1.0",
     "@ngrx/effects": "^21.1.0",