@fgv/ts-app-shell 5.1.0-3 → 5.1.0-31

package/lib/packlets/badge/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/*
+ * Copyright (c) 2026 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderStatusBadge = void 0;
+var renderStatusBadge_1 = require("./renderStatusBadge");
+Object.defineProperty(exports, "renderStatusBadge", { enumerable: true, get: function () { return renderStatusBadge_1.renderStatusBadge; } });
+//# sourceMappingURL=index.js.map

package/lib/packlets/badge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/badge/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport { renderStatusBadge } from './renderStatusBadge';\n"]}

package/lib/packlets/badge/renderStatusBadge.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+type BadgeTone = 'info' | 'warning' | 'danger';
+interface IBadgeLike {
+    readonly kind: 'dot' | 'count';
+    readonly tone?: BadgeTone;
+    readonly count?: number;
+    readonly ariaLabel?: string;
+}
+export declare function renderStatusBadge(badge: IBadgeLike): React.ReactElement;
+export {};
+//# sourceMappingURL=renderStatusBadge.d.ts.map

package/lib/packlets/badge/renderStatusBadge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderStatusBadge.d.ts","sourceRoot":"","sources":["../../../src/packlets/badge/renderStatusBadge.tsx"],"names":[],"mappings":"AAsBA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,KAAK,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE/C,UAAU,UAAU;IAClB,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAmBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,CAAC,YAAY,CAevE"}

package/lib/packlets/badge/renderStatusBadge.js

@@ -0,0 +1,50 @@
+"use strict";
+/*
+ * Copyright (c) 2026 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderStatusBadge = renderStatusBadge;
+const react_1 = __importDefault(require("react"));
+const BADGE_COUNT_BASE_CLASSES = 'ml-1.5 min-w-4 px-1.5 py-0.5 text-[0.6875rem] inline-flex shrink-0 items-center justify-center rounded-full font-medium leading-none';
+const BADGE_DOT_BASE_CLASSES = 'ml-1.5 h-2 w-2 inline-block shrink-0 rounded-full';
+const BADGE_COUNT_TONE_CLASSES = {
+    info: 'bg-status-info-bg text-status-info-text',
+    warning: 'bg-status-warning-bg text-status-warning-text',
+    danger: 'bg-status-error-bg text-status-error-text'
+};
+const BADGE_DOT_TONE_CLASSES = {
+    info: 'bg-status-info-icon',
+    warning: 'bg-status-warning-icon',
+    danger: 'bg-status-error-icon'
+};
+function renderStatusBadge(badge) {
+    var _a, _b;
+    const tone = (_a = badge.tone) !== null && _a !== void 0 ? _a : 'info';
+    const ariaLabel = badge.ariaLabel;
+    if (badge.kind === 'dot') {
+        return (react_1.default.createElement("span", { className: `${BADGE_DOT_BASE_CLASSES} ${BADGE_DOT_TONE_CLASSES[tone]}`, "aria-label": ariaLabel }));
+    }
+    return (react_1.default.createElement("span", { className: `${BADGE_COUNT_BASE_CLASSES} ${BADGE_COUNT_TONE_CLASSES[tone]}`, "aria-label": ariaLabel }, (_b = badge.count) !== null && _b !== void 0 ? _b : 0));
+}
+//# sourceMappingURL=renderStatusBadge.js.map

package/lib/packlets/badge/renderStatusBadge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderStatusBadge.js","sourceRoot":"","sources":["../../../src/packlets/badge/renderStatusBadge.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;AA8BH,8CAeC;AA3CD,kDAA0B;AAW1B,MAAM,wBAAwB,GAC5B,sIAAsI,CAAC;AAEzI,MAAM,sBAAsB,GAAW,mDAAmD,CAAC;AAE3F,MAAM,wBAAwB,GAA8B;IAC1D,IAAI,EAAE,yCAAyC;IAC/C,OAAO,EAAE,+CAA+C;IACxD,MAAM,EAAE,2CAA2C;CACpD,CAAC;AAEF,MAAM,sBAAsB,GAA8B;IACxD,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE,wBAAwB;IACjC,MAAM,EAAE,sBAAsB;CAC/B,CAAC;AAEF,SAAgB,iBAAiB,CAAC,KAAiB;;IACjD,MAAM,IAAI,GAAG,MAAA,KAAK,CAAC,IAAI,mCAAI,MAAM,CAAC;IAClC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAElC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACzB,OAAO,CACL,wCAAM,SAAS,EAAE,GAAG,sBAAsB,IAAI,sBAAsB,CAAC,IAAI,CAAC,EAAE,gBAAc,SAAS,GAAI,CACxG,CAAC;IACJ,CAAC;IAED,OAAO,CACL,wCAAM,SAAS,EAAE,GAAG,wBAAwB,IAAI,wBAAwB,CAAC,IAAI,CAAC,EAAE,gBAAc,SAAS,IACpG,MAAA,KAAK,CAAC,KAAK,mCAAI,CAAC,CACZ,CACR,CAAC;AACJ,CAAC","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport React from 'react';\n\ntype BadgeTone = 'info' | 'warning' | 'danger';\n\ninterface IBadgeLike {\n  readonly kind: 'dot' | 'count';\n  readonly tone?: BadgeTone;\n  readonly count?: number;\n  readonly ariaLabel?: string;\n}\n\nconst BADGE_COUNT_BASE_CLASSES: string =\n  'ml-1.5 min-w-4 px-1.5 py-0.5 text-[0.6875rem] inline-flex shrink-0 items-center justify-center rounded-full font-medium leading-none';\n\nconst BADGE_DOT_BASE_CLASSES: string = 'ml-1.5 h-2 w-2 inline-block shrink-0 rounded-full';\n\nconst BADGE_COUNT_TONE_CLASSES: Record<BadgeTone, string> = {\n  info: 'bg-status-info-bg text-status-info-text',\n  warning: 'bg-status-warning-bg text-status-warning-text',\n  danger: 'bg-status-error-bg text-status-error-text'\n};\n\nconst BADGE_DOT_TONE_CLASSES: Record<BadgeTone, string> = {\n  info: 'bg-status-info-icon',\n  warning: 'bg-status-warning-icon',\n  danger: 'bg-status-error-icon'\n};\n\nexport function renderStatusBadge(badge: IBadgeLike): React.ReactElement {\n  const tone = badge.tone ?? 'info';\n  const ariaLabel = badge.ariaLabel;\n\n  if (badge.kind === 'dot') {\n    return (\n      <span className={`${BADGE_DOT_BASE_CLASSES} ${BADGE_DOT_TONE_CLASSES[tone]}`} aria-label={ariaLabel} />\n    );\n  }\n\n  return (\n    <span className={`${BADGE_COUNT_BASE_CLASSES} ${BADGE_COUNT_TONE_CLASSES[tone]}`} aria-label={ariaLabel}>\n      {badge.count ?? 0}\n    </span>\n  );\n}\n"]}

package/lib/packlets/cascade/CascadeContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CascadeContainer.d.ts","sourceRoot":"","sources":["../../../src/packlets/cascade/CascadeContainer.tsx"],"names":[],"mappings":"AAsBA;;;GAGG;AAEH,OAAO,KAAyC,MAAM,OAAO,CAAC;AAQ9D;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;CACnC;AAMD;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAChD,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,2DAA2D;IAC3D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,sBAAsB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA2FzF"}

package/lib/packlets/cascade/CascadeContainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CascadeContainer.js","sourceRoot":"","sources":["../../../src/packlets/cascade/CascadeContainer.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Column cascade container — horizontal scroll of detail columns.\n * @packageDocumentation\n */\n\nimport React, { useCallback, useEffect, useRef } from 'react';\nimport { useResponsive } from '../responsive';\nimport { MobileCascadeStack } from './MobileCascadeStack';\n\n// ============================================================================\n// Cascade Column\n// ============================================================================\n\n/**\n * Describes a single column in the cascade.\n * @public\n */\nexport interface ICascadeColumn {\n  /** Unique key for React reconciliation */\n  readonly key: string;\n  /** Breadcrumb label for this column */\n  readonly label: string;\n  /** Column content */\n  readonly content: React.ReactNode;\n}\n\n// ============================================================================\n// CascadeContainer Props\n// ============================================================================\n\n/**\n * Props for the CascadeContainer component.\n * @public\n */\nexport interface ICascadeContainerProps {\n  /** Ordered columns (left-to-right) */\n  readonly columns: ReadonlyArray<ICascadeColumn>;\n  /** Callback to pop the cascade back to a specific depth (0 = clear all) */\n  readonly onPopTo: (depth: number) => void;\n  /** Minimum column width in CSS units (default: '400px') */\n  readonly minColumnWidth?: string;\n  /** Callback when the user clicks inside a cascade column (signals list should collapse) */\n  readonly onFocus?: () => void;\n  /** Label for the breadcrumb root link (default: 'List') */\n  readonly rootLabel?: string;\n}\n\n// ============================================================================\n// CascadeContainer Component\n// ============================================================================\n\n/**\n * Horizontal scroll container for the column cascade.\n *\n * Renders a breadcrumb trail at the top and horizontally-scrollable\n * detail columns below. Auto-scrolls to the rightmost column when\n * a new column is pushed.\n *\n * @public\n */\nexport function CascadeContainer(props: ICascadeContainerProps): React.ReactElement | null {\n  const { columns, onPopTo, minColumnWidth = '400px', onFocus, rootLabel = 'List' } = props;\n  const { layoutMode } = useResponsive();\n  const scrollRef = useRef<HTMLDivElement>(null);\n\n  const handleMouseDown = useCallback((): void => {\n    onFocus?.();\n  }, [onFocus]);\n\n  const handleKeyDown = useCallback(\n    (e: React.KeyboardEvent): void => {\n      if (e.key === 'Escape' || e.key === 'ArrowLeft') {\n        e.preventDefault();\n        e.stopPropagation();\n        if (columns.length > 1) {\n          onPopTo(columns.length - 1);\n        } else {\n          onPopTo(0);\n        }\n      }\n    },\n    [columns.length, onPopTo]\n  );\n\n  // Auto-scroll to rightmost column when columns change\n  useEffect(() => {\n    if (scrollRef.current) {\n      scrollRef.current.scrollTo({\n        left: scrollRef.current.scrollWidth,\n        behavior: 'smooth'\n      });\n    }\n  }, [columns.length]);\n\n  if (layoutMode === 'mobile') {\n    return <MobileCascadeStack {...props} />;\n  }\n\n  if (columns.length === 0) {\n    return null;\n  }\n\n  return (\n    <div\n      className=\"flex flex-col flex-1 overflow-hidden outline-none\"\n      tabIndex={-1}\n      onKeyDown={handleKeyDown}\n    >\n      {/* Breadcrumb trail */}\n      <div className=\"flex items-center gap-1 px-3 py-1.5 bg-surface-alt border-b border-border text-xs shrink-0 overflow-x-auto\">\n        <button\n          onClick={(): void => onPopTo(0)}\n          className=\"text-brand-accent hover:text-brand-primary hover:underline shrink-0\"\n        >\n          {rootLabel}\n        </button>\n        {columns.map((col, idx) => (\n          <React.Fragment key={col.key}>\n            <span className=\"text-muted shrink-0\">/</span>\n            {idx < columns.length - 1 ? (\n              <button\n                onClick={(): void => onPopTo(idx + 1)}\n                className=\"text-brand-accent hover:text-brand-primary hover:underline truncate max-w-[200px] shrink-0\"\n              >\n                {col.label}\n              </button>\n            ) : (\n              <span className=\"text-secondary font-medium truncate max-w-[200px] shrink-0\">{col.label}</span>\n            )}\n          </React.Fragment>\n        ))}\n      </div>\n\n      {/* Columns */}\n      <div\n        ref={scrollRef}\n        className=\"flex flex-1 overflow-x-auto overflow-y-hidden\"\n        onMouseDown={handleMouseDown}\n      >\n        {columns.map((col) => (\n          <div\n            key={col.key}\n            className=\"flex flex-col shrink-0 border-r border-border overflow-y-auto\"\n            style={{ minWidth: minColumnWidth, width: minColumnWidth }}\n          >\n            {col.content}\n          </div>\n        ))}\n      </div>\n    </div>\n  );\n}\n"]}

package/lib/packlets/cascade/ComparisonView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComparisonView.d.ts","sourceRoot":"","sources":["../../../src/packlets/cascade/ComparisonView.tsx"],"names":[],"mappings":"AAsBA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;CACpD;AAMD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,oBAAoB,GAAG,KAAK,CAAC,YAAY,CA4B9E"}

package/lib/packlets/cascade/ComparisonView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComparisonView.js","sourceRoot":"","sources":["../../../src/packlets/cascade/ComparisonView.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;AA+CH,wCA4BC;AAzED;;;GAGG;AAEH,kDAA0B;AA4B1B,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;;;;;;GAOG;AACH,SAAgB,cAAc,CAAC,KAA2B;IACxD,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAE1B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CACL,uCAAK,SAAS,EAAC,4DAA4D,0CAErE,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,uCAAK,SAAS,EAAC,6BAA6B,IACzC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CACpB,uCACE,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,SAAS,EAAC,qFAAqF;QAG/F,uCAAK,SAAS,EAAC,4DAA4D;YACzE,wCAAM,SAAS,EAAC,mDAAmD,IAAE,GAAG,CAAC,KAAK,CAAQ,CAClF;QAEN,uCAAK,SAAS,EAAC,wBAAwB,IAAE,GAAG,CAAC,OAAO,CAAO,CACvD,CACP,CAAC,CACE,CACP,CAAC;AACJ,CAAC","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * ComparisonView — side-by-side read-only comparison of 2–4 entities.\n * @packageDocumentation\n */\n\nimport React from 'react';\n\n// ============================================================================\n// ComparisonView Props\n// ============================================================================\n\n/**\n * A single column in the comparison view.\n * @public\n */\nexport interface IComparisonColumn {\n  /** Unique key for React reconciliation */\n  readonly key: string;\n  /** Column header label */\n  readonly label: string;\n  /** Column content (typically a detail component) */\n  readonly content: React.ReactNode;\n}\n\n/**\n * Props for the ComparisonView component.\n * @public\n */\nexport interface IComparisonViewProps {\n  /** Columns to compare (2–4) */\n  readonly columns: ReadonlyArray<IComparisonColumn>;\n}\n\n// ============================================================================\n// ComparisonView Component\n// ============================================================================\n\n/**\n * Side-by-side comparison view for entities.\n *\n * Renders 2–4 entity detail views in equal-width columns with\n * synchronized scrolling (future) and column headers.\n *\n * @public\n */\nexport function ComparisonView(props: IComparisonViewProps): React.ReactElement {\n  const { columns } = props;\n\n  if (columns.length < 2) {\n    return (\n      <div className=\"flex flex-1 items-center justify-center text-muted text-sm\">\n        Select at least 2 items to compare.\n      </div>\n    );\n  }\n\n  return (\n    <div className=\"flex flex-1 overflow-hidden\">\n      {columns.map((col) => (\n        <div\n          key={col.key}\n          className=\"flex flex-col flex-1 min-w-0 border-r border-border last:border-r-0 overflow-hidden\"\n        >\n          {/* Column header */}\n          <div className=\"px-3 py-1.5 bg-surface-alt border-b border-border shrink-0\">\n            <span className=\"text-xs font-medium text-secondary truncate block\">{col.label}</span>\n          </div>\n          {/* Column content */}\n          <div className=\"flex-1 overflow-y-auto\">{col.content}</div>\n        </div>\n      ))}\n    </div>\n  );\n}\n"]}

package/lib/packlets/cascade/EntityTabLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityTabLayout.d.ts","sourceRoot":"","sources":["../../../src/packlets/cascade/EntityTabLayout.tsx"],"names":[],"mappings":"AAsBA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE3E,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAM1E;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,4DAA4D;IAC5D,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IACvD,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,qDAAqD;IACrD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,mFAAmF;IACnF,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC;IACpC,qCAAqC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,uFAAuF;IACvF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC9D,kFAAkF;IAClF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,oEAAoE;IACpE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IACvC,sFAAsF;IACtF,QAAQ,CAAC,uBAAuB,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACpE,iDAAiD;IACjD,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC9C;AAMD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CA2HhF"}

package/lib/packlets/cascade/EntityTabLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityTabLayout.js","sourceRoot":"","sources":["../../../src/packlets/cascade/EntityTabLayout.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * EntityTabLayout — shared layout for entity tab content with list + cascade + collapse-on-focus.\n * @packageDocumentation\n */\n\nimport React from 'react';\n\nimport { CascadeContainer, type ICascadeColumn } from './CascadeContainer';\nimport { useResponsive } from '../responsive';\nimport { ComparisonView, type IComparisonColumn } from './ComparisonView';\n\n// ============================================================================\n// EntityTabLayout Props\n// ============================================================================\n\n/**\n * Props for the EntityTabLayout component.\n * @public\n */\nexport interface IEntityTabLayoutProps {\n  /** The entity list content (rendered in the collapsible left panel) */\n  readonly list: React.ReactNode;\n  /** Cascade columns to display (empty array = no cascade) */\n  readonly cascadeColumns: ReadonlyArray<ICascadeColumn>;\n  /** Callback to pop the cascade back to a specific depth (0 = clear all) */\n  readonly onPopTo: (depth: number) => void;\n  /** Whether the entity list is currently collapsed */\n  readonly listCollapsed: boolean;\n  /** Callback to collapse the entity list (fired when user clicks inside cascade) */\n  readonly onListCollapse: () => void;\n  /** Whether compare mode is active */\n  readonly compareMode?: boolean;\n  /** Columns for the comparison view (when compare mode is active with 2+ selections) */\n  readonly comparisonColumns?: ReadonlyArray<IComparisonColumn>;\n  /** Whether the comparison view is actively showing (user explicitly triggered) */\n  readonly showingComparison?: boolean;\n  /** Callback to exit the comparison view (back to selection list) */\n  readonly onExitComparison?: () => void;\n  /** Columns for variation comparison (when comparing variations of a single recipe) */\n  readonly variationCompareColumns?: ReadonlyArray<IComparisonColumn>;\n  /** Callback to exit variation comparison mode */\n  readonly onExitVariationCompare?: () => void;\n}\n\n// ============================================================================\n// EntityTabLayout Component\n// ============================================================================\n\n/**\n * Shared layout for entity tab content.\n *\n * Renders an entity list on the left and a cascade container on the right.\n * The list stays expanded while browsing (selecting items in the list).\n * It collapses when the user clicks inside the cascade detail pane,\n * signaling they are focused on the detail rather than browsing.\n *\n * @public\n */\nexport function EntityTabLayout(props: IEntityTabLayoutProps): React.ReactElement {\n  const { list, cascadeColumns, onPopTo, listCollapsed, onListCollapse, compareMode, comparisonColumns } =\n    props;\n\n  const variationCompareColumns = props.variationCompareColumns;\n  const onExitVariationCompare = props.onExitVariationCompare;\n  const showingComparison = props.showingComparison ?? false;\n  const onExitComparison = props.onExitComparison;\n  const { layoutMode } = useResponsive();\n\n  const isVariationCompare = variationCompareColumns !== undefined && variationCompareColumns.length >= 2;\n  const showComparison =\n    !isVariationCompare &&\n    showingComparison &&\n    comparisonColumns !== undefined &&\n    comparisonColumns.length >= 2;\n  const showCascade = !compareMode && !isVariationCompare && !showComparison && cascadeColumns.length > 0;\n  const hasCascadeOrCompare = cascadeColumns.length > 0 || showComparison;\n\n  // Variation compare banner — shared between mobile and desktop\n  const variationCompareBanner = isVariationCompare && onExitVariationCompare && (\n    <div className=\"flex items-center gap-2 px-3 py-1.5 bg-status-warning-bg border-b border-status-warning-border shrink-0\">\n      <span className=\"text-xs text-status-warning-text\">\n        Comparing {variationCompareColumns.length} variations\n      </span>\n      <button\n        onClick={onExitVariationCompare}\n        className=\"px-2 py-0.5 text-xs rounded border border-status-warning-border text-status-warning-text hover:bg-status-warning-surface transition-colors\"\n      >\n        Exit\n      </button>\n    </div>\n  );\n\n  // Mobile: show one pane at a time — list or cascade/comparison full-screen\n  if (layoutMode === 'mobile') {\n    const hasCascadeContent = showCascade || showComparison || isVariationCompare;\n\n    return (\n      <div className=\"flex flex-col flex-1 overflow-hidden\">\n        {variationCompareBanner}\n        {hasCascadeContent ? (\n          <>\n            {showCascade && <CascadeContainer columns={cascadeColumns} onPopTo={onPopTo} />}\n            {showComparison && (\n              <div className=\"flex flex-col flex-1 overflow-hidden\">\n                <div className=\"flex items-center gap-2 px-3 py-1.5 bg-status-info-bg border-b border-status-info-border shrink-0\">\n                  <span className=\"text-xs text-status-info-text\">\n                    Comparing {comparisonColumns.length} items\n                  </span>\n                  {onExitComparison && (\n                    <button\n                      onClick={onExitComparison}\n                      className=\"px-2 py-0.5 text-xs rounded border border-status-info-border text-status-info-text hover:bg-status-info-surface transition-colors\"\n                    >\n                      ← Back to list\n                    </button>\n                  )}\n                </div>\n                <ComparisonView columns={comparisonColumns} />\n              </div>\n            )}\n            {isVariationCompare && <ComparisonView columns={variationCompareColumns} />}\n          </>\n        ) : (\n          <div className=\"flex flex-col flex-1 overflow-hidden\">{list}</div>\n        )}\n      </div>\n    );\n  }\n\n  // Desktop/compact: side-by-side list and cascade\n  return (\n    <div className=\"flex flex-col flex-1 overflow-hidden\">\n      {variationCompareBanner}\n\n      {/* Main content area */}\n      <div className=\"flex flex-1 overflow-hidden\">\n        {/* Entity list — proportional width when cascade is showing, full width when browsing */}\n        <div\n          className={`flex flex-col overflow-hidden transition-all ${\n            isVariationCompare || showComparison\n              ? 'w-0 min-w-0'\n              : listCollapsed\n              ? 'w-0 min-w-0'\n              : hasCascadeOrCompare\n              ? 'w-1/4 max-w-xs shrink-0 border-r border-border'\n              : 'w-full max-w-sm shrink-0 border-r border-border'\n          }`}\n        >\n          {list}\n        </div>\n\n        {/* Cascade columns (normal mode) */}\n        {showCascade && (\n          <CascadeContainer columns={cascadeColumns} onPopTo={onPopTo} onFocus={onListCollapse} />\n        )}\n\n        {/* Entity comparison view (compare mode — explicitly triggered) */}\n        {showComparison && (\n          <div className=\"flex flex-col flex-1 overflow-hidden\">\n            <div className=\"flex items-center gap-2 px-3 py-1.5 bg-status-info-bg border-b border-status-info-border shrink-0\">\n              <span className=\"text-xs text-status-info-text\">\n                Comparing {comparisonColumns.length} items\n              </span>\n              {onExitComparison && (\n                <button\n                  onClick={onExitComparison}\n                  className=\"px-2 py-0.5 text-xs rounded border border-status-info-border text-status-info-text hover:bg-status-info-surface transition-colors\"\n                >\n                  ← Back to list\n                </button>\n              )}\n            </div>\n            <ComparisonView columns={comparisonColumns} />\n          </div>\n        )}\n\n        {/* Variation comparison view */}\n        {isVariationCompare && <ComparisonView columns={variationCompareColumns} />}\n      </div>\n    </div>\n  );\n}\n"]}

package/lib/packlets/cascade/MobileCascadeStack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileCascadeStack.d.ts","sourceRoot":"","sources":["../../../src/packlets/cascade/MobileCascadeStack.tsx"],"names":[],"mappings":"AAsBA;;;GAGG;AAEH,OAAO,KAAsB,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,sBAAsB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA+C3F"}

package/lib/packlets/cascade/MobileCascadeStack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileCascadeStack.js","sourceRoot":"","sources":["../../../src/packlets/cascade/MobileCascadeStack.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsBH,gDA+CC;AAnED;;;GAGG;AAEH,+CAA2C;AAG3C;;;;;;;;;;;GAWG;AACH,SAAgB,kBAAkB,CAAC,KAA6B;IAC9D,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC;IAEvD,MAAM,UAAU,GAAG,IAAA,mBAAW,EAAC,GAAS,EAAE;QACxC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAErF,OAAO,CACL,uCAAK,SAAS,EAAC,sCAAsC;QAEnD,uCAAK,SAAS,EAAC,kFAAkF;YAC/F,0CACE,OAAO,EAAE,UAAU,EACnB,SAAS,EAAC,4EAA4E,gBAC1E,WAAW,SAAS,EAAE;gBAElC,uCACE,SAAS,EAAC,kBAAkB,EAC5B,IAAI,EAAC,MAAM,EACX,OAAO,EAAC,WAAW,EACnB,WAAW,EAAE,CAAC,EACd,MAAM,EAAC,cAAc;oBAErB,wCAAM,aAAa,EAAC,OAAO,EAAC,cAAc,EAAC,OAAO,EAAC,CAAC,EAAC,6BAA6B,GAAG,CACjF;gBACL,SAAS,CACH;YACR,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CACrB,wCAAM,SAAS,EAAC,qCAAqC,IAAE,aAAa,CAAC,KAAK,CAAQ,CACnF,CACG;QAGN,uCAAK,SAAS,EAAC,sCAAsC,IAAE,aAAa,CAAC,OAAO,CAAO,CAC/E,CACP,CAAC;AACJ,CAAC","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Mobile view-stack cascade — one full-screen column at a time with back navigation.\n * @packageDocumentation\n */\n\nimport React, { useCallback } from 'react';\nimport { type ICascadeContainerProps } from './CascadeContainer';\n\n/**\n * Mobile replacement for {@link CascadeContainer}.\n *\n * Shows the rightmost (deepest) cascade column full-screen with a back button\n * that pops one level at a time. At the first column, back returns to the list\n * by calling `onPopTo(0)`.\n *\n * Accepts the same props as {@link CascadeContainer} so `CascadeContainer` can\n * delegate to it transparently on mobile.\n *\n * @public\n */\nexport function MobileCascadeStack(props: ICascadeContainerProps): React.ReactElement | null {\n  const { columns, onPopTo, rootLabel = 'List' } = props;\n\n  const handleBack = useCallback((): void => {\n    if (columns.length > 1) {\n      onPopTo(columns.length - 1);\n    } else {\n      onPopTo(0);\n    }\n  }, [columns.length, onPopTo]);\n\n  if (columns.length === 0) {\n    return null;\n  }\n\n  const currentColumn = columns[columns.length - 1];\n  const backLabel = columns.length > 1 ? columns[columns.length - 2].label : rootLabel;\n\n  return (\n    <div className=\"flex flex-col flex-1 overflow-hidden\">\n      {/* Back navigation header */}\n      <div className=\"flex items-center gap-2 px-3 py-2 bg-surface-alt border-b border-border shrink-0\">\n        <button\n          onClick={handleBack}\n          className=\"flex items-center gap-1 text-sm text-brand-accent hover:text-brand-primary\"\n          aria-label={`Back to ${backLabel}`}\n        >\n          <svg\n            className=\"w-4 h-4 shrink-0\"\n            fill=\"none\"\n            viewBox=\"0 0 24 24\"\n            strokeWidth={2}\n            stroke=\"currentColor\"\n          >\n            <path strokeLinecap=\"round\" strokeLinejoin=\"round\" d=\"M15.75 19.5L8.25 12l7.5-7.5\" />\n          </svg>\n          {backLabel}\n        </button>\n        {columns.length > 1 && (\n          <span className=\"ml-auto text-xs text-muted truncate\">{currentColumn.label}</span>\n        )}\n      </div>\n\n      {/* Current column — full screen, scrollable */}\n      <div className=\"flex flex-col flex-1 overflow-y-auto\">{currentColumn.content}</div>\n    </div>\n  );\n}\n"]}

package/lib/packlets/cascade/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/cascade/index.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrG,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG3E,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,aAAa,EACd,MAAM,iBAAiB,CAAC"}

package/lib/packlets/cascade/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/cascade/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH;;;GAGG;AAEH,gBAAgB;AAChB,uDAAwG;AAA/F,oHAAA,gBAAgB,OAAA;AACzB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,qDAAgF;AAAvE,kHAAA,eAAe,OAAA;AACxB,mDAAqG;AAA5F,gHAAA,cAAc,OAAA;AAEvB,sBAAsB;AACtB,iCAKiB;AADf,8GAAA,qBAAqB,OAAA;AAGvB,2BAA2B;AAC3B,iEAA2E;AAAlE,oHAAA,WAAW,OAAA;AAAE,4HAAA,mBAAmB,OAAA;AAEzC,8BAA8B;AAC9B,iDAMyB;AADvB,8GAAA,aAAa,OAAA","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Cascade packlet - column cascade container, layout, and semantic operations.\n * @packageDocumentation\n */\n\n// UI components\nexport { CascadeContainer, type ICascadeContainerProps, type ICascadeColumn } from './CascadeContainer';\nexport { MobileCascadeStack } from './MobileCascadeStack';\nexport { EntityTabLayout, type IEntityTabLayoutProps } from './EntityTabLayout';\nexport { ComparisonView, type IComparisonViewProps, type IComparisonColumn } from './ComparisonView';\n\n// Cascade model types\nexport {\n  type CascadeColumnMode,\n  type CascadeEntryOrigin,\n  type ICascadeEntryBase,\n  CASCADE_NEW_ENTITY_ID\n} from './model';\n\n// Cascade transition hooks\nexport { useSquashAt, useCascadeDrillDown } from './useCascadeTransitions';\n\n// Semantic cascade operations\nexport {\n  type ICascadeConflict,\n  type ICascadeFind,\n  type CascadeEntrySpec,\n  type ICascadeOps,\n  useCascadeOps\n} from './useCascadeOps';\n"]}

package/lib/packlets/cascade/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/packlets/cascade/model.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;GASG;AAMH;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvE;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAMtD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAqB,CAAC;AAE1D;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IACrC,iDAAiD;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,wFAAwF;IACxF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,oFAAoF;IACpF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B"}

package/lib/packlets/cascade/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../src/packlets/cascade/model.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAkCH,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;GAGG;AACU,QAAA,qBAAqB,GAAc,SAAS,CAAC","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Base cascade model types for column cascade navigation.\n *\n * These types are domain-agnostic — they define the structure and semantics\n * of cascade navigation without knowledge of specific entity types.\n * Domain-specific applications extend {@link ICascadeEntryBase} with their\n * own entity types and additional fields.\n *\n * @packageDocumentation\n */\n\n// ============================================================================\n// Cascade Column Modes\n// ============================================================================\n\n/**\n * Mode for a cascade column (view-only, editing, or creating a new entity).\n * @public\n */\nexport type CascadeColumnMode = 'view' | 'edit' | 'create' | 'preview';\n\n/**\n * How a cascade entry was opened — determines save/cancel behavior.\n *\n * - `'primary'` — selected from the entity list. Save/cancel transitions to view mode in-place.\n * - `'nested'` — reached via drill-down, typeahead-create, or sub-entity editing. Save/cancel pops (removes entry).\n *\n * Entries without an explicit origin are treated as `'primary'` for backwards compatibility.\n * @public\n */\nexport type CascadeEntryOrigin = 'primary' | 'nested';\n\n// ============================================================================\n// Cascade Entry Base\n// ============================================================================\n\n/**\n * Sentinel value used as entityId when creating a new entity.\n * @public\n */\nexport const CASCADE_NEW_ENTITY_ID: '__new__' = '__new__';\n\n/**\n * Base interface for a single entry in the column cascade stack.\n *\n * This interface contains only the fields needed by the generic cascade\n * operations ({@link useCascadeOps}, {@link useSquashAt}, {@link useCascadeDrillDown}).\n * Domain-specific applications should extend this interface with additional\n * fields (e.g., target weights, source references, session context).\n *\n * @public\n */\nexport interface ICascadeEntryBase {\n  /** The type of entity displayed in this column (domain-specific string). */\n  readonly entityType: string;\n  /** The ID of the entity (qualified ID, e.g. 'collection.base-id'). */\n  readonly entityId: string;\n  /** Whether the column is in view, edit, create, or preview mode. */\n  readonly mode: CascadeColumnMode;\n  /** How this entry was opened. Determines save/cancel behavior. @see CascadeEntryOrigin */\n  readonly origin?: CascadeEntryOrigin;\n  /** Optional pre-resolved materialized entity. */\n  readonly entity?: unknown;\n  /** Whether this cascade entry has unsaved changes (set by the owning tab component). */\n  readonly hasChanges?: boolean;\n  /** Pre-fill name for entity creation (set when on-blur typeahead doesn't match). */\n  readonly prefillName?: string;\n}\n"]}

package/lib/packlets/cascade/useCascadeOps.d.ts.map

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

package/lib/packlets/cascade/useCascadeOps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCascadeOps.js","sourceRoot":"","sources":["../../../src/packlets/cascade/useCascadeOps.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Semantic cascade operations hook.\n *\n * Encodes cascade navigation rules so tabs declare intent (select, drillDown,\n * openEditor, pop) rather than manually computing cascade stacks.\n *\n * The hook is generic over the entry type `TEntry extends ICascadeEntryBase`.\n * Domain-specific applications pass their extended entry type to preserve\n * full type information through the cascade operations.\n *\n * @packageDocumentation\n */\n\nimport { useCallback, useMemo } from 'react';\n\nimport { type Result, fail, succeed } from '@fgv/ts-utils';\n\nimport type { CascadeColumnMode, ICascadeEntryBase } from './model';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Describes a located entry in the cascade stack.\n * @public\n */\nexport interface ICascadeFind<TEntry extends ICascadeEntryBase = ICascadeEntryBase> {\n  readonly depth: number;\n  readonly entry: TEntry;\n}\n\n/**\n * Describes editors that would be affected by a cascade operation.\n * Returned by {@link ICascadeOps.openEditor} when the operation is blocked.\n * @public\n */\nexport interface ICascadeConflict<TEntry extends ICascadeEntryBase = ICascadeEntryBase> {\n  readonly conflictingEditors: ReadonlyArray<ICascadeFind<TEntry>>;\n}\n\n/**\n * Partial cascade entry for operations that set mode and origin automatically.\n * @public\n */\nexport type CascadeEntrySpec<TEntry extends ICascadeEntryBase = ICascadeEntryBase> = Omit<\n  TEntry,\n  'mode' | 'origin'\n> & { readonly mode?: CascadeColumnMode };\n\n/**\n * Semantic cascade operations.\n *\n * These operations encode the cascade navigation rules:\n * 1. Views stack on views\n * 2. Editor replaces its view and trims views above (but not below)\n * 3. Editors never squash editors — blocked if editors exist above target\n * 4. Editors can stack on editors (child above parent is fine)\n * 5. Save/cancel on nested panels pops; on primary panels returns to view\n * 6. Preview behaves like view for all stacking/trimming rules\n * 7. Save/cancel blocked when child editors exist above\n *\n * @typeParam TEntry - The cascade entry type, defaults to {@link ICascadeEntryBase}.\n * @public\n */\nexport interface ICascadeOps<TEntry extends ICascadeEntryBase = ICascadeEntryBase> {\n  /**\n   * Replace entire stack with a single view entry (from list selection).\n   * @returns The created entry at depth 0.\n   */\n  readonly select: (entry: CascadeEntrySpec<TEntry>) => Result<ICascadeFind<TEntry>>;\n\n  /**\n   * Push a view entry after `fromDepth`, trimming anything beyond.\n   * Toggle: if the same entity is already at `fromDepth + 1`, collapse instead.\n   * @returns The pushed entry, or the collapsed entry on toggle.\n   */\n  readonly drillDown: (fromDepth: number, entry: CascadeEntrySpec<TEntry>) => Result<ICascadeFind<TEntry>>;\n\n  /**\n   * Switch panel at `depth` to edit mode.\n   * Trims view/preview panels above `depth`. Blocked if editors/creates exist above.\n   * @returns The entry switched to edit mode, or failure if blocked by conflicting editors.\n   */\n  readonly openEditor: (depth: number) => Result<ICascadeFind<TEntry>>;\n\n  /**\n   * Push a nested panel (create or edit) on top of the current stack.\n   * Used for typeahead-on-blur creation and sub-entity editing.\n   * @returns The pushed nested entry.\n   */\n  readonly openNested: (fromDepth: number, entry: Omit<TEntry, 'origin'>) => Result<ICascadeFind<TEntry>>;\n\n  /**\n   * Pop the topmost entry (for nested save/cancel). Always safe.\n   * @returns The removed entry, or failure if the stack was empty.\n   */\n  readonly pop: () => Result<ICascadeFind<TEntry>>;\n\n  /**\n   * Transition entry at `depth` from edit/create to view mode.\n   * Used for primary entity save/cancel.\n   * @returns The entry transitioned to view mode.\n   */\n  readonly popToView: (depth: number, refreshedEntity?: unknown) => Result<ICascadeFind<TEntry>>;\n\n  /**\n   * Trim the stack to keep only entries below `depth` (exclusive).\n   * Removes the entry at `depth` and everything above it.\n   * @returns The last remaining entry after trimming, or failure if stack becomes empty.\n   */\n  readonly trimTo: (depth: number) => Result<ICascadeFind<TEntry>>;\n\n  /** Return editors/creates above a given depth. */\n  readonly editorsAbove: (depth: number) => ReadonlyArray<ICascadeFind<TEntry>>;\n\n  /** Whether any editors/creates exist anywhere in the stack. */\n  readonly hasUnsavedEditors: () => boolean;\n\n  /** Whether save/cancel is allowed at `depth` (false if child editors exist above). */\n  readonly canSaveOrCancel: (depth: number) => boolean;\n\n  /** Clear the entire cascade stack. */\n  readonly clear: () => void;\n\n  /** Clear the cascade if any entry has the given entity ID. */\n  readonly clearById: (entityId: string) => void;\n\n  /** Clear the cascade if any entry matches the predicate. */\n  readonly clearIf: (predicate: (entry: TEntry) => boolean) => void;\n\n  /** Find the first entry matching a predicate. */\n  readonly find: (predicate: (entry: TEntry) => boolean) => Result<ICascadeFind<TEntry>>;\n\n  /** The current cascade stack (for rendering). */\n  readonly stack: ReadonlyArray<TEntry>;\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\nfunction isEditOrCreate(mode: CascadeColumnMode): boolean {\n  return mode === 'edit' || mode === 'create';\n}\n\nfunction findEditorsAbove<TEntry extends ICascadeEntryBase>(\n  stack: ReadonlyArray<TEntry>,\n  depth: number\n): ReadonlyArray<ICascadeFind<TEntry>> {\n  const result: Array<ICascadeFind<TEntry>> = [];\n  for (let i = depth + 1; i < stack.length; i++) {\n    if (isEditOrCreate(stack[i].mode)) {\n      result.push({ depth: i, entry: stack[i] });\n    }\n  }\n  return result;\n}\n\n// ============================================================================\n// Hook\n// ============================================================================\n\n/**\n * Hook providing semantic cascade operations.\n *\n * Takes the cascade stack and a squash function as parameters, making it\n * independent of any specific state management solution. Domain-specific\n * applications typically provide a convenience wrapper that reads these\n * values from their own store.\n *\n * @typeParam TEntry - The cascade entry type. Inferred from `cascadeStack`.\n * @public\n */\nexport function useCascadeOps<TEntry extends ICascadeEntryBase>(\n  cascadeStack: ReadonlyArray<TEntry>,\n  squashCascade: (entries: ReadonlyArray<TEntry>) => void\n): ICascadeOps<TEntry> {\n  // Internal helper: spread-override mode/origin on a stack entry.\n  // The spread preserves all TEntry fields, but TypeScript can't prove that\n  // Omit<TEntry, K> & { K: V } is assignable to TEntry. The cast is safe\n  // because we only override properties defined on ICascadeEntryBase.\n  type AsTEntry = (entry: ICascadeEntryBase) => TEntry;\n  const asTEntry: AsTEntry = (entry) => entry as unknown as TEntry;\n\n  const select = useCallback(\n    (entry: CascadeEntrySpec<TEntry>): Result<ICascadeFind<TEntry>> => {\n      const created = asTEntry({ ...entry, mode: entry.mode ?? 'view', origin: 'primary' });\n      squashCascade([created]);\n      return succeed({ depth: 0, entry: created });\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [squashCascade]\n  );\n\n  const drillDown = useCallback(\n    (fromDepth: number, entry: CascadeEntrySpec<TEntry>): Result<ICascadeFind<TEntry>> => {\n      const nextEntry = cascadeStack[fromDepth + 1];\n      if (nextEntry?.entityType === entry.entityType && nextEntry.entityId === entry.entityId) {\n        // Toggle: collapse if same entity is already at fromDepth + 1\n        squashCascade(cascadeStack.slice(0, fromDepth + 1));\n        return succeed({ depth: fromDepth + 1, entry: nextEntry });\n      }\n      const created = asTEntry({ ...entry, mode: entry.mode ?? 'view', origin: 'nested' });\n      squashCascade([...cascadeStack.slice(0, fromDepth + 1), created]);\n      return succeed({ depth: fromDepth + 1, entry: created });\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [cascadeStack, squashCascade]\n  );\n\n  const editorsAbove = useCallback(\n    (depth: number): ReadonlyArray<ICascadeFind<TEntry>> => {\n      return findEditorsAbove(cascadeStack, depth);\n    },\n    [cascadeStack]\n  );\n\n  const openEditor = useCallback(\n    (depth: number): Result<ICascadeFind<TEntry>> => {\n      const entry = cascadeStack[depth];\n      if (!entry) {\n        return fail(`depth ${depth} out of bounds for cascade stack of length ${cascadeStack.length}`);\n      }\n\n      // Check for editors above the target depth\n      const conflicts = findEditorsAbove(cascadeStack, depth);\n      if (conflicts.length > 0) {\n        const names = conflicts.map((c) => `${c.entry.entityType}(${c.entry.mode}) at depth ${c.depth}`);\n        return fail(`blocked by editors above: ${names.join(', ')}`);\n      }\n\n      // Trim everything above depth (downstream views become incoherent),\n      // switch target to edit mode, preserving origin\n      const edited = asTEntry({ ...entry, mode: 'edit' });\n      squashCascade([...cascadeStack.slice(0, depth), edited]);\n      return succeed({ depth, entry: edited });\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [cascadeStack, squashCascade]\n  );\n\n  const openNested = useCallback(\n    (fromDepth: number, entry: Omit<TEntry, 'origin'>): Result<ICascadeFind<TEntry>> => {\n      const created = asTEntry({ ...entry, origin: 'nested' });\n      const newDepth = fromDepth + 1;\n      squashCascade([...cascadeStack.slice(0, newDepth), created]);\n      return succeed({ depth: newDepth, entry: created });\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [cascadeStack, squashCascade]\n  );\n\n  const pop = useCallback((): Result<ICascadeFind<TEntry>> => {\n    if (cascadeStack.length === 0) {\n      return fail('cannot pop from empty cascade stack');\n    }\n    const removed = cascadeStack[cascadeStack.length - 1];\n    squashCascade(cascadeStack.slice(0, -1));\n    return succeed({ depth: cascadeStack.length - 1, entry: removed });\n  }, [cascadeStack, squashCascade]);\n\n  const popToView = useCallback(\n    (depth: number, refreshedEntity?: unknown): Result<ICascadeFind<TEntry>> => {\n      const entry = cascadeStack[depth];\n      if (!entry) {\n        return fail(`depth ${depth} out of bounds for cascade stack of length ${cascadeStack.length}`);\n      }\n      const viewed = asTEntry({\n        ...entry,\n        mode: 'view' as const,\n        ...(refreshedEntity !== undefined ? { entity: refreshedEntity } : {})\n      });\n      squashCascade([...cascadeStack.slice(0, depth), viewed]);\n      return succeed({ depth, entry: viewed });\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [cascadeStack, squashCascade]\n  );\n\n  const trimTo = useCallback(\n    (depth: number): Result<ICascadeFind<TEntry>> => {\n      const trimmed = Math.max(0, depth);\n      const newStack = cascadeStack.slice(0, trimmed);\n      squashCascade(newStack);\n      if (newStack.length === 0) {\n        return fail('cascade stack is empty after trim');\n      }\n      const lastIdx = newStack.length - 1;\n      return succeed({ depth: lastIdx, entry: newStack[lastIdx] });\n    },\n    [cascadeStack, squashCascade]\n  );\n\n  const hasUnsavedEditors = useCallback((): boolean => {\n    return cascadeStack.some((e) => isEditOrCreate(e.mode));\n  }, [cascadeStack]);\n\n  const canSaveOrCancel = useCallback(\n    (depth: number): boolean => {\n      return findEditorsAbove(cascadeStack, depth).length === 0;\n    },\n    [cascadeStack]\n  );\n\n  const clear = useCallback((): void => {\n    squashCascade([] as unknown as ReadonlyArray<TEntry>);\n  }, [squashCascade]);\n\n  const clearIf = useCallback(\n    (predicate: (entry: TEntry) => boolean): void => {\n      if (cascadeStack.some(predicate)) {\n        squashCascade([] as unknown as ReadonlyArray<TEntry>);\n      }\n    },\n    [cascadeStack, squashCascade]\n  );\n\n  const clearById = useCallback(\n    (entityId: string): void => {\n      clearIf((e) => e.entityId === entityId);\n    },\n    [clearIf]\n  );\n\n  const find = useCallback(\n    (predicate: (entry: TEntry) => boolean): Result<ICascadeFind<TEntry>> => {\n      const depth = cascadeStack.findIndex(predicate);\n      if (depth < 0) {\n        return fail('no matching entry in cascade stack');\n      }\n      return succeed({ depth, entry: cascadeStack[depth] });\n    },\n    [cascadeStack]\n  );\n\n  return useMemo(\n    () => ({\n      select,\n      drillDown,\n      openEditor,\n      openNested,\n      pop,\n      popToView,\n      trimTo,\n      editorsAbove,\n      hasUnsavedEditors,\n      canSaveOrCancel,\n      clear,\n      clearById,\n      clearIf,\n      find,\n      stack: cascadeStack\n    }),\n    [\n      select,\n      drillDown,\n      openEditor,\n      openNested,\n      pop,\n      popToView,\n      trimTo,\n      editorsAbove,\n      hasUnsavedEditors,\n      canSaveOrCancel,\n      clear,\n      clearById,\n      clearIf,\n      find,\n      cascadeStack\n    ]\n  );\n}\n"]}

package/lib/packlets/cascade/useCascadeTransitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCascadeTransitions.d.ts","sourceRoot":"","sources":["../../../src/packlets/cascade/useCascadeTransitions.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,YAAY,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAC9C,aAAa,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,KAAK,IAAI,GACjE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAOnD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAC9C,aAAa,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,KAAK,IAAI,EAClE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAC1D,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAYnG"}

package/lib/packlets/cascade/useCascadeTransitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCascadeTransitions.js","sourceRoot":"","sources":["../../../src/packlets/cascade/useCascadeTransitions.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AAmBH,kCAUC;AAUD,kDAgBC;AArDD;;;;GAIG;AAEH,iCAAoC;AAIpC;;;;;;GAMG;AACH,SAAgB,WAAW,CACzB,YAA8C,EAC9C,aAAkE;IAElE,OAAO,IAAA,mBAAW,EAChB,CAAC,KAAa,EAAE,KAAwB,EAAQ,EAAE;QAChD,aAAa,CAAC,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC9D,CAAC,EACD,CAAC,YAAY,EAAE,aAAa,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CACjC,YAA8C,EAC9C,aAAkE,EAClE,QAA2D;IAE3D,OAAO,IAAA,mBAAW,EAChB,CAAC,KAAa,EAAE,UAAkB,EAAE,QAAgB,EAAE,KAAkC,EAAQ,EAAE;QAChG,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,UAAU,MAAK,UAAU,IAAI,SAAS,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC5E,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QACD,QAAQ,CAAC,KAAK,kBAAI,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,IAAK,KAAK,EAAG,CAAC;IACpE,CAAC,EACD,CAAC,YAAY,EAAE,QAAQ,EAAE,aAAa,CAAC,CACxC,CAAC;AACJ,CAAC","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Shared cascade transition hooks for entity tabs.\n *\n * @packageDocumentation\n */\n\nimport { useCallback } from 'react';\n\nimport type { ICascadeEntryBase } from './model';\n\n/**\n * Returns a depth-aware squash helper used by cascade views.\n *\n * Keeps stack entries up to and including `depth`, then appends `entry`.\n *\n * @public\n */\nexport function useSquashAt(\n  cascadeStack: ReadonlyArray<ICascadeEntryBase>,\n  squashCascade: (entries: ReadonlyArray<ICascadeEntryBase>) => void\n): (depth: number, entry: ICascadeEntryBase) => void {\n  return useCallback(\n    (depth: number, entry: ICascadeEntryBase): void => {\n      squashCascade([...cascadeStack.slice(0, depth + 1), entry]);\n    },\n    [cascadeStack, squashCascade]\n  );\n}\n\n/**\n * Returns a shared drill-down toggle helper for cascade columns.\n *\n * If the target entry is already immediately to the right of `depth`, it collapses\n * back to `depth`. Otherwise, it appends a new view entry at `depth + 1`.\n *\n * @public\n */\nexport function useCascadeDrillDown(\n  cascadeStack: ReadonlyArray<ICascadeEntryBase>,\n  squashCascade: (entries: ReadonlyArray<ICascadeEntryBase>) => void,\n  squashAt: (depth: number, entry: ICascadeEntryBase) => void\n): (depth: number, entityType: string, entityId: string, extra?: Partial<ICascadeEntryBase>) => void {\n  return useCallback(\n    (depth: number, entityType: string, entityId: string, extra?: Partial<ICascadeEntryBase>): void => {\n      const nextEntry = cascadeStack[depth + 1];\n      if (nextEntry?.entityType === entityType && nextEntry.entityId === entityId) {\n        squashCascade(cascadeStack.slice(0, depth + 1));\n        return;\n      }\n      squashAt(depth, { entityType, entityId, mode: 'view', ...extra });\n    },\n    [cascadeStack, squashAt, squashCascade]\n  );\n}\n"]}

package/lib/packlets/detail/DetailHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetailHelpers.d.ts","sourceRoot":"","sources":["../../../src/packlets/detail/DetailHelpers.tsx"],"names":[],"mappings":"AAsBA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAO1B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,CAO1F;AAMD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACvC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAiB,EAAE,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAkBzG;AAMD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,aAAa,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAa1E;AAMD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CAMxF;AAMD,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACtC,oDAAoD;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,2FAA2F;IAC3F,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,QAAQ,EACR,WAAW,EACX,UAAU,EACV,OAAO,EACP,OAAO,EACR,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CA0BzC"}

package/lib/packlets/detail/DetailHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetailHelpers.js","sourceRoot":"","sources":["../../../src/packlets/detail/DetailHelpers.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Generic detail-view primitive components.\n *\n * Domain-agnostic building blocks for entity detail panels:\n * - `DetailSection` — labeled section wrapper\n * - `DetailRow` — key/value row with spread or inline layout\n * - `TagList` — pill tag row\n * - `StatusBadge` — colored pill badge (caller supplies color classes)\n * - `DetailHeader` — two-line header with indicators and action slots\n *\n * @packageDocumentation\n */\n\nimport React from 'react';\nimport { XMarkIcon } from '@heroicons/react/20/solid';\n\n// ============================================================================\n// DetailSection\n// ============================================================================\n\nexport interface IDetailSectionProps {\n  readonly title: string;\n  readonly children: React.ReactNode;\n}\n\n/**\n * Labeled section wrapper with uppercase tracking header.\n * @public\n */\nexport function DetailSection({ title, children }: IDetailSectionProps): React.ReactElement {\n  return (\n    <div className=\"mb-4\">\n      <h3 className=\"text-xs font-semibold text-muted uppercase tracking-wider mb-1.5\">{title}</h3>\n      {children}\n    </div>\n  );\n}\n\n// ============================================================================\n// DetailRow\n// ============================================================================\n\nexport interface IDetailRowProps {\n  readonly label: string;\n  readonly value: React.ReactNode;\n  /**\n   * Layout variant:\n   * - `'spread'` (default) — label left, value right, justify-between\n   * - `'inline'` — label fixed-width, value follows immediately\n   */\n  readonly layout?: 'spread' | 'inline';\n}\n\n/**\n * Key/value row for detail panels.\n * Returns `null` if `value` is `null` or `undefined`.\n * @public\n */\nexport function DetailRow({ label, value, layout = 'spread' }: IDetailRowProps): React.ReactElement | null {\n  if (value === null || value === undefined) {\n    return null;\n  }\n  if (layout === 'inline') {\n    return (\n      <div className=\"flex items-baseline gap-2 py-0.5\">\n        <span className=\"text-xs text-muted w-32 shrink-0\">{label}</span>\n        <span className=\"text-sm text-primary\">{value}</span>\n      </div>\n    );\n  }\n  return (\n    <div className=\"flex items-baseline justify-between py-0.5 text-sm\">\n      <span className=\"text-muted shrink-0 mr-2\">{label}</span>\n      <span className=\"text-primary text-right\">{value}</span>\n    </div>\n  );\n}\n\n// ============================================================================\n// TagList\n// ============================================================================\n\nexport interface ITagListProps {\n  readonly tags: ReadonlyArray<string>;\n}\n\n/**\n * Horizontal pill row for string tags. Returns `null` if tags is empty.\n * @public\n */\nexport function TagList({ tags }: ITagListProps): React.ReactElement | null {\n  if (tags.length === 0) {\n    return null;\n  }\n  return (\n    <div className=\"flex flex-wrap gap-1\">\n      {tags.map((tag) => (\n        <span key={tag} className=\"px-2 py-0.5 text-xs rounded-full bg-surface-raised text-secondary\">\n          {tag}\n        </span>\n      ))}\n    </div>\n  );\n}\n\n// ============================================================================\n// StatusBadge\n// ============================================================================\n\nexport interface IStatusBadgeProps {\n  readonly label: string;\n  /** Tailwind color classes, e.g. `'bg-amber-100 text-amber-800'` */\n  readonly colorClass: string;\n}\n\n/**\n * Generic pill badge. Caller supplies the Tailwind color classes.\n * @public\n */\nexport function StatusBadge({ label, colorClass }: IStatusBadgeProps): React.ReactElement {\n  return (\n    <span className={`inline-block px-2 py-0.5 text-[11px] font-medium rounded-full ${colorClass}`}>\n      {label}\n    </span>\n  );\n}\n\n// ============================================================================\n// DetailHeader\n// ============================================================================\n\nexport interface IDetailHeaderProps {\n  /** Primary entity name — rendered full-width on its own line */\n  readonly title: string;\n  /** Optional de-emphasized subtitle (e.g. entity ID) rendered below the title */\n  readonly subtitle?: string;\n  /** Optional description rendered below the status bar */\n  readonly description?: string;\n  /** Left slot of the status bar — badges, icons, etc. */\n  readonly indicators?: React.ReactNode;\n  /** Right slot of the status bar — action buttons */\n  readonly actions?: React.ReactNode;\n  /** If provided, renders a close button in the upper-right corner, inline with the title */\n  readonly onClose?: () => void;\n}\n\n/**\n * Three-line entity detail header.\n *\n * Line 1: full-width `title` (bold headline)\n * Line 2: optional `subtitle` (de-emphasized, monospace — e.g. entity ID)\n * Line 3: `indicators` left-justified, `actions` right-justified (status bar)\n * Below: optional `description`\n *\n * Both `indicators` and `actions` are `React.ReactNode` — callers own the content.\n * @public\n */\nexport function DetailHeader({\n  title,\n  subtitle,\n  description,\n  indicators,\n  actions,\n  onClose\n}: IDetailHeaderProps): React.ReactElement {\n  return (\n    <div className=\"mb-4 relative\">\n      <div className=\"flex items-start\">\n        <h2 className=\"text-lg font-semibold text-primary flex-1 min-w-0\">{title}</h2>\n        {onClose && (\n          <button\n            type=\"button\"\n            onClick={onClose}\n            title=\"Close\"\n            className=\"shrink-0 ml-2 mt-0.5 p-0.5 text-muted hover:text-secondary hover:bg-surface-raised rounded transition-colors\"\n          >\n            <XMarkIcon className=\"w-4 h-4\" />\n          </button>\n        )}\n      </div>\n      {subtitle && <p className=\"text-xs text-muted font-mono mt-0.5 mb-1\">{subtitle}</p>}\n      {(indicators !== undefined || actions !== undefined) && (\n        <div className=\"flex items-center justify-between gap-2 mt-1\">\n          <div className=\"flex items-center gap-2\">{indicators}</div>\n          {actions !== undefined && <div className=\"flex items-center gap-1 shrink-0\">{actions}</div>}\n        </div>\n      )}\n      {description && <p className=\"text-sm text-secondary mt-1\">{description}</p>}\n    </div>\n  );\n}\n"]}

package/lib/packlets/detail/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/detail/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,EACxB,SAAS,EACT,KAAK,eAAe,EACpB,OAAO,EACP,KAAK,aAAa,EAClB,WAAW,EACX,KAAK,iBAAiB,EACtB,YAAY,EACZ,KAAK,kBAAkB,EACxB,MAAM,iBAAiB,CAAC"}

package/lib/packlets/detail/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/detail/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,iDAWyB;AAVvB,8GAAA,aAAa,OAAA;AAEb,0GAAA,SAAS,OAAA;AAET,wGAAA,OAAO,OAAA;AAEP,4GAAA,WAAW,OAAA;AAEX,6GAAA,YAAY,OAAA","sourcesContent":["/**\n * Detail packlet - generic detail-view primitive components.\n * @packageDocumentation\n */\n\nexport {\n  DetailSection,\n  type IDetailSectionProps,\n  DetailRow,\n  type IDetailRowProps,\n  TagList,\n  type ITagListProps,\n  StatusBadge,\n  type IStatusBadgeProps,\n  DetailHeader,\n  type IDetailHeaderProps\n} from './DetailHelpers';\n"]}

package/lib/packlets/drop-zone/JsonDropZone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonDropZone.d.ts","sourceRoot":"","sources":["../../../src/packlets/drop-zone/JsonDropZone.tsx"],"names":[],"mappings":"AAsBA,OAAO,KAAgC,MAAM,OAAO,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7C,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,qDAAqD;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,CAuGhF"}

package/lib/packlets/drop-zone/JsonDropZone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonDropZone.js","sourceRoot":"","sources":["../../../src/packlets/drop-zone/JsonDropZone.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport React, { useCallback, useState } from 'react';\nimport { Converter } from '@fgv/ts-utils';\n\n/**\n * Strips markdown code fences from text.\n * AI agents often wrap JSON in code fences.\n * @param text - Raw text that may contain code fences\n * @returns Text with outer code fences removed\n * @internal\n */\nexport function stripCodeFences(text: string): string {\n  const trimmed = text.trim();\n  const fencePattern = /^```(?:\\w+)?\\s*\\n?([\\s\\S]*?)\\n?\\s*```$/;\n  const match = fencePattern.exec(trimmed);\n  return match ? match[1].trim() : trimmed;\n}\n\n/**\n * Props for the JsonDropZone component.\n * @typeParam T - The expected validated type\n * @public\n */\nexport interface IJsonDropZoneProps<T> {\n  /** Converter to validate parsed JSON against */\n  readonly converter: Converter<T>;\n  /** Called with the validated value on successful drop/paste */\n  readonly onValueReceived: (value: T) => void;\n  /** Called with an error message on parse/validation failure */\n  readonly onError?: (message: string) => void;\n  /** Externally-controlled error message to display */\n  readonly error?: string;\n  /** Placeholder hint text */\n  readonly hint?: string;\n  /** Additional CSS class names */\n  readonly className?: string;\n}\n\n/**\n * Generic JSON drop/paste target with converter-based validation.\n * Accepts text via drag-and-drop or paste, strips markdown code fences,\n * parses as JSON, validates through the provided converter, and calls\n * the appropriate callback.\n *\n * @typeParam T - The expected validated type\n * @public\n */\nexport function JsonDropZone<T>(props: IJsonDropZoneProps<T>): React.ReactElement {\n  const { converter, onValueReceived, onError, error, hint, className } = props;\n  const [isDragOver, setIsDragOver] = useState(false);\n  const [internalError, setInternalError] = useState<string | undefined>(undefined);\n\n  const displayError = error ?? internalError;\n\n  const processText = useCallback(\n    (rawText: string): void => {\n      setInternalError(undefined);\n\n      const stripped = stripCodeFences(rawText);\n\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(stripped);\n      } catch {\n        const message = 'Invalid JSON: could not parse the dropped text.';\n        setInternalError(message);\n        onError?.(message);\n        return;\n      }\n\n      const result = converter.convert(parsed);\n      if (result.isSuccess()) {\n        setInternalError(undefined);\n        onValueReceived(result.value);\n      } else {\n        const message = `Validation failed: ${result.message}`;\n        setInternalError(message);\n        onError?.(message);\n      }\n    },\n    [converter, onValueReceived, onError]\n  );\n\n  const handleDragOver = useCallback((e: React.DragEvent<HTMLDivElement>): void => {\n    e.preventDefault();\n    e.stopPropagation();\n    setIsDragOver(true);\n  }, []);\n\n  const handleDragLeave = useCallback((e: React.DragEvent<HTMLDivElement>): void => {\n    e.preventDefault();\n    e.stopPropagation();\n    setIsDragOver(false);\n  }, []);\n\n  const handleDrop = useCallback(\n    (e: React.DragEvent<HTMLDivElement>): void => {\n      e.preventDefault();\n      e.stopPropagation();\n      setIsDragOver(false);\n\n      const text = e.dataTransfer.getData('text/plain') || e.dataTransfer.getData('text');\n      if (text) {\n        processText(text);\n      } else {\n        const message = 'No text data found in the dropped content.';\n        setInternalError(message);\n        onError?.(message);\n      }\n    },\n    [processText, onError]\n  );\n\n  const handlePaste = useCallback(\n    (e: React.ClipboardEvent<HTMLDivElement>): void => {\n      e.preventDefault();\n      const text = e.clipboardData.getData('text/plain') || e.clipboardData.getData('text');\n      if (text) {\n        processText(text);\n      }\n    },\n    [processText]\n  );\n\n  const borderClass = displayError\n    ? 'border-status-error-border bg-status-error-bg'\n    : isDragOver\n    ? 'border-status-info-border bg-status-info-bg'\n    : 'border-border bg-surface-alt';\n\n  return (\n    <div\n      className={`border-2 border-dashed rounded-md p-3 text-center text-sm transition-colors cursor-default ${borderClass} ${\n        className ?? ''\n      }`}\n      onDragOver={handleDragOver}\n      onDragLeave={handleDragLeave}\n      onDrop={handleDrop}\n      onPaste={handlePaste}\n      tabIndex={0}\n      role=\"region\"\n      aria-label={hint ?? 'Drop or paste JSON here'}\n    >\n      {displayError ? (\n        <span className=\"text-status-error-text text-xs\">{displayError}</span>\n      ) : (\n        <span className=\"text-muted\">{hint ?? 'Drop or paste JSON here'}</span>\n      )}\n    </div>\n  );\n}\n"]}

package/lib/packlets/drop-zone/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/drop-zone/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/packlets/drop-zone/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/drop-zone/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,+CAAuE;AAA9D,4GAAA,YAAY,OAAA","sourcesContent":["/**\n * Drop zone packlet - generic JSON drop/paste target with converter-based validation.\n * @packageDocumentation\n */\n\nexport { JsonDropZone, type IJsonDropZoneProps } from './JsonDropZone';\n"]}

package/lib/packlets/editing/EditFieldHelpers.d.ts

@@ -15,6 +15,8 @@ import React from 'react';
 export interface IEditFieldProps {
     /** Label text displayed to the left of the field */
     readonly label: string;
+    /** Optional tooltip shown on hover over the label */
+    readonly tooltip?: string;
     /** The input control(s) to render */
     readonly children: React.ReactNode;
 }
@@ -22,7 +24,7 @@ export interface IEditFieldProps {
  * Horizontal label + field layout for a single edit field.
  * @public
  */
-export declare function EditField({ label, children }: IEditFieldProps): React.ReactElement;
+export declare function EditField({ label, tooltip, children }: IEditFieldProps): React.ReactElement;
 /**
  * Props for the EditSection component.
  * @public
@@ -30,6 +32,8 @@ export declare function EditField({ label, children }: IEditFieldProps): React.R
 export interface IEditSectionProps {
     /** Section heading text */
     readonly title: string;
+    /** Optional tooltip shown on hover over the section heading */
+    readonly tooltip?: string;
     /** Section content (typically EditField components) */
     readonly children: React.ReactNode;
 }
@@ -37,7 +41,7 @@ export interface IEditSectionProps {
  * Titled section wrapper for grouping related edit fields.
  * @public
  */
-export declare function EditSection({ title, children }: IEditSectionProps): React.ReactElement;
+export declare function EditSection({ title, tooltip, children }: IEditSectionProps): React.ReactElement;
 /**
  * Props for the TextInput component.
  * @public

package/lib/packlets/editing/EditFieldHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EditFieldHelpers.d.ts","sourceRoot":"","sources":["../../../src/packlets/editing/EditFieldHelpers.tsx"],"names":[],"mappings":"AAsBA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAS3F;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CAS/F;AAMD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,uBAAuB;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAU/F;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACvD,uBAAuB;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,QAAQ,EACR,WAAW,EACZ,EAAE,uBAAuB,GAAG,KAAK,CAAC,YAAY,CAU9C;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACvD,uBAAuB;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,CAUvG;AAMD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACvD,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,QAAQ,EACR,KAAK,EACL,GAAG,EACH,GAAG,EACH,IAAI,EACL,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CAuBxC;AAMD;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM;IACjD,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,wBAAwB;IACxB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACnC,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,EAC5C,KAAK,EACL,OAAO,EACP,QAAQ,EACT,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,CAc3C;AAMD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAClD,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC;IACtE,uBAAuB;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAuB/F;AAMD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,KAAK,IAAI,CAAC;IACxD,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,CAYjG"}

package/lib/packlets/editing/EditFieldHelpers.js

@@ -47,18 +47,18 @@ const react_1 = __importDefault(require("react"));
  * Horizontal label + field layout for a single edit field.
  * @public
  */
-function EditField({ label, children }) {
+function EditField({ label, tooltip, children }) {
     return (react_1.default.createElement("div", { className: "flex items-baseline gap-2 py-1" },
-        react_1.default.createElement("label", { className: "text-xs text-muted w-32 shrink-0" }, label),
+        react_1.default.createElement("label", { className: "text-xs text-muted w-32 shrink-0", title: tooltip }, label),
         react_1.default.createElement("div", { className: "flex-1" }, children)));
 }
 /**
  * Titled section wrapper for grouping related edit fields.
  * @public
  */
-function EditSection({ title, children }) {
+function EditSection({ title, tooltip, children }) {
     return (react_1.default.createElement("div", { className: "mb-4" },
-        react_1.default.createElement("h4", { className: "text-xs font-medium text-muted uppercase tracking-wider mb-1.5" }, title),
+        react_1.default.createElement("h4", { className: "text-xs font-medium text-muted uppercase tracking-wider mb-1.5", title: tooltip }, title),
         children));
 }
 /**

package/lib/packlets/editing/EditFieldHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EditFieldHelpers.js","sourceRoot":"","sources":["../../../src/packlets/editing/EditFieldHelpers.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Generic edit field helper components for entity editors.\n *\n * Provides reusable form field primitives: text inputs, number inputs,\n * select dropdowns, tag editors, checkboxes, and layout wrappers.\n * These components are domain-agnostic and can be used by any entity editor.\n *\n * @packageDocumentation\n */\n\nimport React from 'react';\n\n// ============================================================================\n// Layout Helpers\n// ============================================================================\n\n/**\n * Props for the EditField component.\n * @public\n */\nexport interface IEditFieldProps {\n  /** Label text displayed to the left of the field */\n  readonly label: string;\n  /** Optional tooltip shown on hover over the label */\n  readonly tooltip?: string;\n  /** The input control(s) to render */\n  readonly children: React.ReactNode;\n}\n\n/**\n * Horizontal label + field layout for a single edit field.\n * @public\n */\nexport function EditField({ label, tooltip, children }: IEditFieldProps): React.ReactElement {\n  return (\n    <div className=\"flex items-baseline gap-2 py-1\">\n      <label className=\"text-xs text-muted w-32 shrink-0\" title={tooltip}>\n        {label}\n      </label>\n      <div className=\"flex-1\">{children}</div>\n    </div>\n  );\n}\n\n/**\n * Props for the EditSection component.\n * @public\n */\nexport interface IEditSectionProps {\n  /** Section heading text */\n  readonly title: string;\n  /** Optional tooltip shown on hover over the section heading */\n  readonly tooltip?: string;\n  /** Section content (typically EditField components) */\n  readonly children: React.ReactNode;\n}\n\n/**\n * Titled section wrapper for grouping related edit fields.\n * @public\n */\nexport function EditSection({ title, tooltip, children }: IEditSectionProps): React.ReactElement {\n  return (\n    <div className=\"mb-4\">\n      <h4 className=\"text-xs font-medium text-muted uppercase tracking-wider mb-1.5\" title={tooltip}>\n        {title}\n      </h4>\n      {children}\n    </div>\n  );\n}\n\n// ============================================================================\n// Text Inputs\n// ============================================================================\n\n/**\n * Props for the TextInput component.\n * @public\n */\nexport interface ITextInputProps {\n  /** Current value */\n  readonly value: string;\n  /** Called when value changes */\n  readonly onChange: (value: string) => void;\n  /** Placeholder text */\n  readonly placeholder?: string;\n}\n\n/**\n * Single-line text input for required string fields.\n * @public\n */\nexport function TextInput({ value, onChange, placeholder }: ITextInputProps): React.ReactElement {\n  return (\n    <input\n      type=\"text\"\n      value={value}\n      onChange={(e) => onChange(e.target.value)}\n      placeholder={placeholder}\n      className=\"w-full px-2 py-1 text-sm border border-border rounded focus:outline-none focus:ring-1 focus:ring-focus-ring focus:border-focus-ring\"\n    />\n  );\n}\n\n/**\n * Props for the OptionalTextInput component.\n * @public\n */\nexport interface IOptionalTextInputProps {\n  /** Current value (undefined means empty) */\n  readonly value: string | undefined;\n  /** Called when value changes (empty string → undefined) */\n  readonly onChange: (value: string | undefined) => void;\n  /** Placeholder text */\n  readonly placeholder?: string;\n}\n\n/**\n * Single-line text input for optional string fields.\n * Empty input produces `undefined`.\n * @public\n */\nexport function OptionalTextInput({\n  value,\n  onChange,\n  placeholder\n}: IOptionalTextInputProps): React.ReactElement {\n  return (\n    <input\n      type=\"text\"\n      value={value ?? ''}\n      onChange={(e) => onChange(e.target.value || undefined)}\n      placeholder={placeholder}\n      className=\"w-full px-2 py-1 text-sm border border-border rounded focus:outline-none focus:ring-1 focus:ring-focus-ring focus:border-focus-ring\"\n    />\n  );\n}\n\n/**\n * Props for the TextAreaInput component.\n * @public\n */\nexport interface ITextAreaInputProps {\n  /** Current value (undefined means empty) */\n  readonly value: string | undefined;\n  /** Called when value changes (empty string → undefined) */\n  readonly onChange: (value: string | undefined) => void;\n  /** Placeholder text */\n  readonly placeholder?: string;\n}\n\n/**\n * Multi-line text input for optional string fields.\n * Empty input produces `undefined`.\n * @public\n */\nexport function TextAreaInput({ value, onChange, placeholder }: ITextAreaInputProps): React.ReactElement {\n  return (\n    <textarea\n      value={value ?? ''}\n      onChange={(e) => onChange(e.target.value || undefined)}\n      placeholder={placeholder}\n      rows={3}\n      className=\"w-full px-2 py-1 text-sm border border-border rounded focus:outline-none focus:ring-1 focus:ring-focus-ring focus:border-focus-ring resize-y\"\n    />\n  );\n}\n\n// ============================================================================\n// Number Input\n// ============================================================================\n\n/**\n * Props for the NumberInput component.\n * @public\n */\nexport interface INumberInputProps {\n  /** Current value (undefined means empty) */\n  readonly value: number | undefined;\n  /** Called when value changes (empty input → undefined) */\n  readonly onChange: (value: number | undefined) => void;\n  /** Accessible label for the input */\n  readonly label: string;\n  /** Minimum allowed value */\n  readonly min?: number;\n  /** Maximum allowed value */\n  readonly max?: number;\n  /** Step increment */\n  readonly step?: number;\n}\n\n/**\n * Numeric input for optional number fields.\n * Empty input produces `undefined`.\n * @public\n */\nexport function NumberInput({\n  value,\n  onChange,\n  label,\n  min,\n  max,\n  step\n}: INumberInputProps): React.ReactElement {\n  return (\n    <input\n      type=\"number\"\n      value={value ?? ''}\n      onChange={(e) => {\n        const raw = e.target.value;\n        if (!raw.trim()) {\n          onChange(undefined);\n        } else {\n          const num = parseFloat(raw);\n          if (!isNaN(num)) {\n            onChange(num);\n          }\n        }\n      }}\n      min={min}\n      max={max}\n      step={step ?? 0.1}\n      className=\"w-24 px-2 py-1 text-sm border border-border rounded focus:outline-none focus:ring-1 focus:ring-focus-ring focus:border-focus-ring text-right\"\n      aria-label={label}\n    />\n  );\n}\n\n// ============================================================================\n// Select Input\n// ============================================================================\n\n/**\n * Props for the SelectInput component.\n * @public\n */\nexport interface ISelectInputProps<T extends string> {\n  /** Currently selected value */\n  readonly value: T;\n  /** Available options */\n  readonly options: ReadonlyArray<T>;\n  /** Called when selection changes */\n  readonly onChange: (value: T) => void;\n}\n\n/**\n * Dropdown select for enumerated string values.\n * @public\n */\nexport function SelectInput<T extends string>({\n  value,\n  options,\n  onChange\n}: ISelectInputProps<T>): React.ReactElement {\n  return (\n    <select\n      value={value}\n      onChange={(e) => onChange(e.target.value as T)}\n      className=\"px-2 py-1 text-sm border border-border rounded focus:outline-none focus:ring-1 focus:ring-focus-ring focus:border-focus-ring\"\n    >\n      {options.map((opt) => (\n        <option key={opt} value={opt}>\n          {opt}\n        </option>\n      ))}\n    </select>\n  );\n}\n\n// ============================================================================\n// Tags Input\n// ============================================================================\n\n/**\n * Props for the TagsInput component.\n * @public\n */\nexport interface ITagsInputProps {\n  /** Current tags (undefined means no tags) */\n  readonly value: ReadonlyArray<string> | undefined;\n  /** Called when tags change (empty → undefined) */\n  readonly onChange: (value: ReadonlyArray<string> | undefined) => void;\n  /** Placeholder text */\n  readonly placeholder?: string;\n}\n\n/**\n * Comma-separated tag editor for string arrays.\n * Empty input produces `undefined`.\n * @public\n */\nexport function TagsInput({ value, onChange, placeholder }: ITagsInputProps): React.ReactElement {\n  const text = value?.join(', ') ?? '';\n  return (\n    <input\n      type=\"text\"\n      value={text}\n      onChange={(e) => {\n        const raw = e.target.value;\n        if (!raw.trim()) {\n          onChange(undefined);\n        } else {\n          onChange(\n            raw\n              .split(',')\n              .map((s) => s.trim())\n              .filter((s) => s.length > 0)\n          );\n        }\n      }}\n      placeholder={placeholder ?? 'comma-separated values'}\n      className=\"w-full px-2 py-1 text-sm border border-border rounded focus:outline-none focus:ring-1 focus:ring-focus-ring focus:border-focus-ring\"\n    />\n  );\n}\n\n// ============================================================================\n// Checkbox Input\n// ============================================================================\n\n/**\n * Props for the CheckboxInput component.\n * @public\n */\nexport interface ICheckboxInputProps {\n  /** Current value (undefined treated as false) */\n  readonly value: boolean | undefined;\n  /** Called when value changes (false → undefined) */\n  readonly onChange: (value: boolean | undefined) => void;\n  /** Label text displayed next to the checkbox */\n  readonly label: string;\n}\n\n/**\n * Checkbox input for optional boolean fields.\n * Unchecked produces `undefined`.\n * @public\n */\nexport function CheckboxInput({ value, onChange, label }: ICheckboxInputProps): React.ReactElement {\n  return (\n    <label className=\"flex items-center gap-2 text-sm text-secondary cursor-pointer\">\n      <input\n        type=\"checkbox\"\n        checked={value ?? false}\n        onChange={(e) => onChange(e.target.checked || undefined)}\n        className=\"rounded border-border text-brand-primary focus:ring-focus-ring\"\n      />\n      {label}\n    </label>\n  );\n}\n"]}

package/lib/packlets/editing/MultiActionButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiActionButton.d.ts","sourceRoot":"","sources":["../../../src/packlets/editing/MultiActionButton.tsx"],"names":[],"mappings":"AAsBA;;;GAGG;AAEH,OAAO,KAAsC,MAAM,OAAO,CAAC;AAO3D;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,QAAQ,CAAC,aAAa,EAAE,wBAAwB,CAAC;IACjD,sDAAsD;IACtD,QAAQ,CAAC,kBAAkB,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACjE,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACpD,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,uBAAuB,GAAG,KAAK,CAAC,YAAY,CAoFpF"}

package/lib/packlets/editing/MultiActionButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiActionButton.js","sourceRoot":"","sources":["../../../src/packlets/editing/MultiActionButton.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Multi-action button component with dropdown for alternative actions.\n * @packageDocumentation\n */\n\nimport React, { useState, useRef, useEffect } from 'react';\nimport { ChevronDownIcon } from '@heroicons/react/20/solid';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Action definition for multi-action button.\n * @public\n */\nexport interface IMultiActionButtonAction {\n  /** Unique identifier for the action. */\n  readonly id: string;\n  /** Display label for the action. */\n  readonly label: string;\n  /** Optional icon element to display before the label. */\n  readonly icon?: React.ReactNode;\n  /** Callback when this action is selected. */\n  readonly onSelect: () => void;\n}\n\n/**\n * Props for MultiActionButton component.\n * @public\n */\nexport interface IMultiActionButtonProps {\n  /** Primary action that appears on the main button. */\n  readonly primaryAction: IMultiActionButtonAction;\n  /** Alternative actions shown in the dropdown menu. */\n  readonly alternativeActions: readonly IMultiActionButtonAction[];\n  /** Optional variant for button styling. */\n  readonly variant?: 'primary' | 'default' | 'danger';\n  /** If true, the primary action button is disabled. */\n  readonly disabled?: boolean;\n  /** If true, the dropdown toggle is disabled. Defaults to `disabled`. */\n  readonly dropdownDisabled?: boolean;\n  /** Optional CSS class name. */\n  readonly className?: string;\n}\n\n// ============================================================================\n// Component\n// ============================================================================\n\n/**\n * Multi-action button with dropdown for alternative actions.\n * Similar to Git commit button with \"Commit\", \"Commit & Push\", etc.\n *\n * @public\n */\nexport function MultiActionButton(props: IMultiActionButtonProps): React.ReactElement {\n  const {\n    primaryAction,\n    alternativeActions,\n    variant = 'primary',\n    disabled = false,\n    dropdownDisabled,\n    className = ''\n  } = props;\n  const isDropdownDisabled = dropdownDisabled ?? disabled;\n  const [isOpen, setIsOpen] = useState(false);\n  const dropdownRef = useRef<HTMLDivElement>(null);\n\n  // Close dropdown when clicking outside\n  useEffect(() => {\n    const handleClickOutside = (event: MouseEvent): void => {\n      if (dropdownRef.current && !dropdownRef.current.contains(event.target as Node)) {\n        setIsOpen(false);\n      }\n    };\n\n    if (isOpen) {\n      document.addEventListener('mousedown', handleClickOutside);\n      return () => document.removeEventListener('mousedown', handleClickOutside);\n    }\n  }, [isOpen]);\n\n  const variantClasses: Record<string, string> = {\n    primary: 'bg-brand-primary hover:bg-brand-primary/90 text-white',\n    default: 'bg-surface-raised hover:bg-surface-raised text-secondary',\n    danger: 'bg-status-error-btn hover:bg-status-error-btn-hover text-white'\n  };\n\n  const baseClasses =\n    'inline-flex items-center text-xs font-medium rounded transition-colors disabled:opacity-40 disabled:cursor-not-allowed';\n\n  return (\n    <div className={`relative inline-flex ${className}`} ref={dropdownRef}>\n      {/* Primary action button */}\n      <button\n        type=\"button\"\n        onClick={primaryAction.onSelect}\n        disabled={disabled}\n        className={`${baseClasses} ${variantClasses[variant]} px-2.5 py-1 ${\n          alternativeActions.length > 0 ? 'rounded-r-none' : 'rounded'\n        }`}\n      >\n        {primaryAction.icon}\n        <span>{primaryAction.label}</span>\n      </button>\n\n      {/* Dropdown toggle button — only shown when there are alternative actions */}\n      {alternativeActions.length > 0 && (\n        <button\n          type=\"button\"\n          onClick={(): void => setIsOpen(!isOpen)}\n          disabled={isDropdownDisabled}\n          className={`${baseClasses} ${variantClasses[variant]} px-1 py-1 rounded-l-none border-l border-white/20`}\n        >\n          <ChevronDownIcon className=\"h-3.5 w-3.5\" />\n        </button>\n      )}\n\n      {/* Dropdown menu */}\n      {isOpen && alternativeActions.length > 0 && (\n        <div className=\"absolute top-full right-0 mt-1 w-48 bg-surface rounded-md shadow-lg border border-border py-1 z-50\">\n          {alternativeActions.map((action) => (\n            <button\n              key={action.id}\n              type=\"button\"\n              onClick={(): void => {\n                action.onSelect();\n                setIsOpen(false);\n              }}\n              className=\"w-full text-left px-3 py-2 text-xs text-secondary hover:bg-surface-raised flex items-center gap-2\"\n            >\n              {action.icon}\n              <span>{action.label}</span>\n            </button>\n          ))}\n        </div>\n      )}\n    </div>\n  );\n}\n"]}

package/lib/packlets/editing/NumericInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumericInput.d.ts","sourceRoot":"","sources":["../../../src/packlets/editing/NumericInput.tsx"],"names":[],"mappings":"AAsBA;;;;;;;;GAQG;AAEH,OAAO,KAAmD,MAAM,OAAO,CAAC;AAexE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACvD,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,sBAAsB;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAyBD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CA8E1E"}

package/lib/packlets/editing/NumericInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumericInput.js","sourceRoot":"","sources":["../../../src/packlets/editing/NumericInput.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Numeric input with select-all-on-focus and empty-string support.\n *\n * Uses `type=\"text\"` with `inputMode=\"decimal\"` to avoid native number-input\n * quirks (spinner buttons, empty-string rejection). Manages a string internally\n * but exposes `number | undefined` to callers.\n *\n * @packageDocumentation\n */\n\nimport React, { useCallback, useEffect, useRef, useState } from 'react';\n\n// ============================================================================\n// Constants\n// ============================================================================\n\nconst NUMERIC_PATTERN: RegExp = /^-?\\d*\\.?\\d*$/;\n\nconst DEFAULT_CLASS: string =\n  'text-sm border border-border rounded-md px-3 py-2 focus:outline-none focus:ring-2 focus:ring-focus-ring focus:border-focus-ring';\n\n// ============================================================================\n// Props\n// ============================================================================\n\n/**\n * Props for the {@link NumericInput} component.\n * @public\n */\nexport interface INumericInputProps {\n  /** Current numeric value (`undefined` = empty field). */\n  readonly value: number | undefined;\n  /** Called with the parsed number on blur, or `undefined` if the field is empty. */\n  readonly onChange: (value: number | undefined) => void;\n  /** Accessible label (maps to `aria-label`). */\n  readonly label?: string;\n  /** Minimum allowed value (clamped on blur). */\n  readonly min?: number;\n  /** Maximum allowed value (clamped on blur). */\n  readonly max?: number;\n  /** Step for arrow-key increment/decrement. Defaults to 1. */\n  readonly step?: number;\n  /** Additional or replacement CSS classes. */\n  readonly className?: string;\n  /** Placeholder text shown when the field is empty. */\n  readonly placeholder?: string;\n  /** Auto-focus the input on mount. */\n  readonly autoFocus?: boolean;\n  /** Disabled state. */\n  readonly disabled?: boolean;\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\nfunction formatValue(value: number | undefined): string {\n  return value !== undefined ? String(value) : '';\n}\n\nfunction clamp(value: number, min: number | undefined, max: number | undefined): number {\n  let result = value;\n  if (min !== undefined && result < min) {\n    result = min;\n  }\n  if (max !== undefined && result > max) {\n    result = max;\n  }\n  return result;\n}\n\n// ============================================================================\n// Component\n// ============================================================================\n\n/**\n * Numeric input that selects all on focus and allows empty values.\n *\n * Internally manages a string so the user can freely type, backspace to empty,\n * and replace the entire value. On blur, the string is parsed to a number\n * (clamped to min/max) and reported to the parent via `onChange`.\n *\n * @public\n */\nexport function NumericInput(props: INumericInputProps): React.ReactElement {\n  const { value, onChange, label, min, max, step, className, placeholder, autoFocus, disabled } = props;\n\n  const [displayValue, setDisplayValue] = useState(() => formatValue(value));\n  const focusedRef = useRef(false);\n\n  // Sync display when value prop changes externally (but not while focused)\n  useEffect(() => {\n    if (!focusedRef.current) {\n      setDisplayValue(formatValue(value));\n    }\n  }, [value]);\n\n  const handleFocus = useCallback((e: React.FocusEvent<HTMLInputElement>): void => {\n    focusedRef.current = true;\n    e.target.select();\n  }, []);\n\n  const handleChange = useCallback((e: React.ChangeEvent<HTMLInputElement>): void => {\n    const raw = e.target.value;\n    if (raw === '' || NUMERIC_PATTERN.test(raw)) {\n      setDisplayValue(raw);\n    }\n  }, []);\n\n  const handleBlur = useCallback((): void => {\n    focusedRef.current = false;\n    const trimmed = displayValue.trim();\n    if (trimmed === '' || trimmed === '-' || trimmed === '.') {\n      setDisplayValue('');\n      onChange(undefined);\n      return;\n    }\n    const parsed = parseFloat(trimmed);\n    if (isNaN(parsed)) {\n      setDisplayValue('');\n      onChange(undefined);\n      return;\n    }\n    const clamped = clamp(parsed, min, max);\n    setDisplayValue(String(clamped));\n    onChange(clamped);\n  }, [displayValue, onChange, min, max]);\n\n  const handleKeyDown = useCallback(\n    (e: React.KeyboardEvent<HTMLInputElement>): void => {\n      if (e.key !== 'ArrowUp' && e.key !== 'ArrowDown') {\n        return;\n      }\n      e.preventDefault();\n      const effectiveStep = step ?? 1;\n      const current = parseFloat(displayValue) || 0;\n      const next = e.key === 'ArrowUp' ? current + effectiveStep : current - effectiveStep;\n      const clamped = clamp(next, min, max);\n      // Round to avoid floating-point drift\n      const rounded = parseFloat(clamped.toFixed(10));\n      setDisplayValue(String(rounded));\n      onChange(rounded);\n    },\n    [displayValue, onChange, min, max, step]\n  );\n\n  return (\n    <input\n      type=\"text\"\n      inputMode=\"decimal\"\n      value={displayValue}\n      onChange={handleChange}\n      onFocus={handleFocus}\n      onBlur={handleBlur}\n      onKeyDown={handleKeyDown}\n      className={className ?? DEFAULT_CLASS}\n      aria-label={label}\n      placeholder={placeholder}\n      autoFocus={autoFocus}\n      disabled={disabled}\n    />\n  );\n}\n"]}