@fgv/ts-app-shell 5.1.0-4 → 5.1.0-40

package/lib/packlets/ai-assist/useAiAssist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAiAssist.js","sourceRoot":"","sources":["../../../src/packlets/ai-assist/useAiAssist.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 * Generic AI assist hook — parameterized by settings and keystore, no app-specific context.\n *\n * Provides a list of available AI assist actions and functions for copy-paste\n * and direct API generation flows.\n *\n * @packageDocumentation\n */\n\nimport { useCallback, useMemo, useState } from 'react';\n\nimport { AiAssist } from '@fgv/ts-extras';\nimport { fail, type Logging, Result, succeed } from '@fgv/ts-utils';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Parameters for the generic useAiAssist hook.\n * @public\n */\nexport interface IUseAiAssistParams {\n  /** Resolved AI assist settings (provider list + default). */\n  readonly settings: AiAssist.IAiAssistSettings | undefined;\n  /** Keystore for API key resolution (or undefined if no keystore). */\n  readonly keyStore: AiAssist.IAiAssistKeyStore | undefined;\n  /** Optional logger for request/response observability. */\n  readonly logger?: Logging.ILogger;\n}\n\n/**\n * A single available AI assist action.\n * @public\n */\nexport interface IAiAssistAction {\n  /** The provider identifier */\n  readonly provider: AiAssist.AiProviderId;\n  /** Display label (e.g. \"AI Assist | Copy\", \"AI Assist | Grok\") */\n  readonly label: string;\n  /** Whether this is the default (first) action */\n  readonly isDefault: boolean;\n  /** Whether the provider is currently available (keystore unlocked, secret present) */\n  readonly isAvailable: boolean;\n  /** Reason the provider is unavailable, if any */\n  readonly unavailableReason?: string;\n}\n\n/**\n * Result of executing an AI assist action.\n * @public\n */\nexport interface IAiAssistResult<TEntity> {\n  /** The generated entity */\n  readonly entity: TEntity;\n  /** Source indicator */\n  readonly source: 'ai';\n}\n\n/**\n * Return type of the useAiAssist hook.\n * @public\n */\nexport interface IUseAiAssistResult {\n  /** Available actions based on settings + keystore state */\n  readonly actions: ReadonlyArray<IAiAssistAction>;\n  /** Whether a direct assist call is in progress */\n  readonly isWorking: boolean;\n  /**\n   * Execute a copy-paste action: copies the combined prompt to clipboard.\n   * @returns Success with `'copied'`, or failure.\n   */\n  readonly copyPrompt: (prompt: AiAssist.AiPrompt) => Promise<Result<'copied'>>;\n  /**\n   * Execute a direct API action: calls the provider, validates the response, returns the entity.\n   * @returns Success with the validated entity, or failure.\n   */\n  readonly generateDirect: <TEntity>(\n    provider: AiAssist.AiProviderId,\n    prompt: AiAssist.AiPrompt,\n    convert: (from: unknown) => Result<TEntity>,\n    tools?: ReadonlyArray<AiAssist.AiServerToolConfig>\n  ) => Promise<Result<IAiAssistResult<TEntity>>>;\n  /**\n   * Execute an image-generation action: calls the provider's image API and\n   * returns the generated images.\n   * @returns Success with the image generation response, or failure.\n   */\n  readonly generateImages: (\n    provider: AiAssist.AiProviderId,\n    params: AiAssist.IAiImageGenerationParams,\n    signal?: AbortSignal\n  ) => Promise<Result<AiAssist.IAiImageGenerationResponse>>;\n  /**\n   * List the models available from a provider, optionally filtered by capability.\n   * @returns Success with the resolved model list, or failure (no silent fallback).\n   */\n  readonly listModels: (\n    provider: AiAssist.AiProviderId,\n    capability?: AiAssist.AiModelCapability,\n    signal?: AbortSignal\n  ) => Promise<Result<ReadonlyArray<AiAssist.IAiModelInfo>>>;\n  /**\n   * Stream a chat completion from the provider. The `onEvent` callback fires\n   * for every event (text deltas, tool progress, errors); the returned\n   * promise resolves with the aggregated final text and truncation flag on\n   * success, or with `Result.fail` when the stream couldn't be started or\n   * ended in a terminal error event.\n   */\n  readonly streamDirect: (\n    provider: AiAssist.AiProviderId,\n    prompt: AiAssist.AiPrompt,\n    onEvent: (event: AiAssist.IAiStreamEvent) => void,\n    options?: {\n      readonly tools?: ReadonlyArray<AiAssist.AiServerToolConfig>;\n      readonly messagesBefore?: ReadonlyArray<AiAssist.IChatMessage>;\n      readonly signal?: AbortSignal;\n    }\n  ) => Promise<Result<{ readonly fullText: string; readonly truncated: boolean }>>;\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/**\n * Resolves the API key for a dispatcher call, honoring `descriptor.needsSecret`.\n *\n * - When `descriptor.needsSecret === false` (e.g. ollama, openai-compat),\n *   returns the configured key if one happens to be set in the keystore, or\n *   an empty string otherwise. ts-extras omits the `Authorization` header\n *   entirely for empty keys, which self-hosted servers expect.\n * - When `descriptor.needsSecret !== false`, requires `secretName`, an\n *   unlocked keystore, and a successful key fetch.\n *\n * @internal\n */\nfunction resolveApiKey(\n  descriptor: AiAssist.IAiProviderDescriptor,\n  providerConfig: AiAssist.IAiAssistProviderConfig,\n  keyStore: AiAssist.IAiAssistKeyStore | undefined\n): Result<string> {\n  const { provider, secretName } = providerConfig;\n  if (descriptor.needsSecret === false) {\n    if (!secretName || !keyStore?.isUnlocked) {\n      return succeed('');\n    }\n    return succeed(keyStore.getApiKey(secretName).orDefault('') ?? '');\n  }\n  if (!secretName) {\n    return fail(`Provider \"${provider}\" has no secret name configured`);\n  }\n  if (!keyStore) {\n    return fail('No keystore available');\n  }\n  return keyStore.getApiKey(secretName).withErrorFormat((m) => `Failed to get API key: ${m}`);\n}\n\n/**\n * Checks whether a parsed AI response is an error object (with an \"error\" field)\n * rather than a valid entity. AI prompts instruct the model to return\n * `{ \"error\": \"...\", \"term\": \"...\" }` when it cannot confidently generate the entity.\n *\n * @param parsed - The parsed JSON from the AI response\n * @returns A failure Result with the error message if it's an error object, or undefined if not\n */\nexport function checkForAiErrorObject(parsed: unknown): Result<never> | undefined {\n  if (\n    typeof parsed === 'object' &&\n    parsed !== null &&\n    'error' in parsed &&\n    typeof (parsed as Record<string, unknown>).error === 'string'\n  ) {\n    const errorObj = parsed as Record<string, unknown>;\n    const term = typeof errorObj.term === 'string' ? ` (term: \"${errorObj.term}\")` : '';\n    return fail(`AI declined to generate${term}: ${errorObj.error}`);\n  }\n  return undefined;\n}\n\n// ============================================================================\n// Hook\n// ============================================================================\n\n/**\n * Generic hook providing AI assist actions based on supplied settings and keystore.\n * @param params - Settings and keystore to use (typically from a workspace or app context)\n * @returns Available actions and execution functions\n * @public\n */\nexport function useAiAssist(params: IUseAiAssistParams): IUseAiAssistResult {\n  const { settings, keyStore, logger } = params;\n  const [isWorking, setIsWorking] = useState(false);\n\n  const actions = useMemo((): ReadonlyArray<IAiAssistAction> => {\n    const providers = settings?.providers ?? [{ provider: 'copy-paste' as AiAssist.AiProviderId }];\n    const enabledSet = new Set(providers.map((p) => p.provider));\n    const defaultProvider: AiAssist.AiProviderId =\n      settings?.defaultProvider && enabledSet.has(settings.defaultProvider)\n        ? settings.defaultProvider\n        : providers[0]?.provider ?? ('copy-paste' as AiAssist.AiProviderId);\n\n    return providers.map((config) => {\n      let isAvailable = true;\n      let unavailableReason: string | undefined;\n\n      const descriptor = AiAssist.getProviderDescriptor(config.provider).orDefault();\n\n      // Self-hosted / no-secret providers (e.g. ollama, openai-compat) skip\n      // the keystore check entirely — they're available as long as the\n      // descriptor exists. Providers with `needsSecret: true` still require\n      // a configured secretName and an unlocked keystore.\n      if (config.provider !== 'copy-paste' && descriptor?.needsSecret !== false) {\n        if (!config.secretName) {\n          isAvailable = false;\n          unavailableReason = 'No API key secret configured';\n        } else if (!keyStore) {\n          isAvailable = false;\n          unavailableReason = 'No keystore available';\n        } else if (!keyStore.isUnlocked) {\n          isAvailable = false;\n          unavailableReason = 'Keystore is locked';\n        } else {\n          const hasSecret = keyStore.hasSecret(config.secretName);\n          if (hasSecret.isFailure() || !hasSecret.value) {\n            isAvailable = false;\n            unavailableReason = `API key \"${config.secretName}\" not found in keystore`;\n          }\n        }\n      }\n\n      const label = descriptor?.buttonLabel ?? config.provider;\n      return {\n        provider: config.provider,\n        label,\n        isDefault: config.provider === defaultProvider,\n        isAvailable,\n        unavailableReason\n      };\n    });\n  }, [settings, keyStore]);\n\n  const copyPrompt = useCallback(async (prompt: AiAssist.AiPrompt): Promise<Result<'copied'>> => {\n    try {\n      await navigator.clipboard.writeText(prompt.combined);\n      return succeed('copied' as const);\n    } catch {\n      return fail('Failed to copy prompt to clipboard');\n    }\n  }, []);\n\n  const generateDirect = useCallback(\n    async <TEntity>(\n      provider: AiAssist.AiProviderId,\n      prompt: AiAssist.AiPrompt,\n      convert: (from: unknown) => Result<TEntity>,\n      tools?: ReadonlyArray<AiAssist.AiServerToolConfig>\n    ): Promise<Result<IAiAssistResult<TEntity>>> => {\n      // Find the provider config and descriptor\n      const providerConfig = settings?.providers.find((p) => p.provider === provider);\n\n      if (!providerConfig) {\n        return fail(`Provider \"${provider}\" not configured`);\n      }\n\n      const descriptorResult = AiAssist.getProviderDescriptor(provider);\n      if (descriptorResult.isFailure()) {\n        return fail(descriptorResult.message);\n      }\n      const descriptor = descriptorResult.value;\n\n      const apiKeyResult = resolveApiKey(descriptor, providerConfig, keyStore);\n      if (apiKeyResult.isFailure()) {\n        return fail(apiKeyResult.message);\n      }\n\n      setIsWorking(true);\n      try {\n        const maxAttempts = 3;\n        const correctionMessages: Array<AiAssist.IChatMessage> = [];\n\n        for (let attempt = 0; attempt < maxAttempts; attempt++) {\n          // Resolve effective tools: per-call override > settings defaults > none\n          const effectiveTools = AiAssist.resolveEffectiveTools(descriptor, providerConfig.tools, tools);\n\n          // Call the API — through proxy if configured, otherwise direct.\n          // The unified request orders history before the current turn; the\n          // correction-retry turns naturally append after the current user turn.\n          const base = prompt.toRequest();\n          const completionParams: AiAssist.IProviderCompletionParams = {\n            descriptor,\n            apiKey: apiKeyResult.value,\n            system: base.system,\n            messages: [...base.messages, ...correctionMessages],\n            modelOverride: providerConfig.model,\n            endpoint: providerConfig.endpoint,\n            logger,\n            tools: effectiveTools.length > 0 ? effectiveTools : undefined\n          };\n          const useProxy: boolean =\n            !!settings?.proxyUrl && (settings.proxyAllProviders === true || descriptor.corsRestricted);\n          const responseResult = useProxy\n            ? await AiAssist.callProxiedCompletion(settings!.proxyUrl!, completionParams)\n            : await AiAssist.callProviderCompletion(completionParams);\n          if (responseResult.isFailure()) {\n            logger?.error(`AI completion failed: ${responseResult.message}`);\n            return fail(responseResult.message);\n          }\n\n          const { content: rawResponse, truncated } = responseResult.value;\n          logger?.detail(`AI response received (${rawResponse.length} chars, truncated=${truncated})`);\n\n          // Truncated responses are almost certainly malformed JSON — fail early\n          if (truncated) {\n            logger?.warn('AI response truncated due to token limits');\n            return fail('AI response was truncated due to token limits — try a shorter prompt');\n          }\n\n          // Strip markdown code fences and parse JSON\n          const stripped = rawResponse\n            .trim()\n            .replace(/^```(?:\\w+)?\\s*\\n?([\\s\\S]*?)\\n?\\s*```$/, '$1')\n            .trim();\n\n          let parsed: unknown;\n          try {\n            parsed = JSON.parse(stripped);\n          } catch (err: unknown) {\n            const detail = err instanceof Error ? err.message : String(err);\n            // JSON parse failures are not retryable — the model isn't producing valid JSON at all\n            return fail(`AI returned invalid JSON: ${detail}`);\n          }\n\n          // Check for AI error object (model declined to generate)\n          const aiError = checkForAiErrorObject(parsed);\n          if (aiError !== undefined) {\n            return aiError;\n          }\n\n          // Validate with the provided converter\n          const entityResult = convert(parsed);\n          if (entityResult.isSuccess()) {\n            return succeed({ entity: entityResult.value, source: 'ai' as const });\n          }\n\n          // Validation failed — if we have retries left, send a correction\n          logger?.warn(\n            `AI response validation failed (attempt ${attempt + 1}/${maxAttempts}): ${entityResult.message}`\n          );\n          if (attempt < maxAttempts - 1) {\n            correctionMessages.push(\n              { role: 'assistant', content: rawResponse },\n              {\n                role: 'user',\n                content: `The JSON you returned failed validation with the following error:\\n\\n${entityResult.message}\\n\\nPlease fix the JSON and return ONLY the corrected JSON object, nothing else.`\n              }\n            );\n          } else {\n            // Out of retries\n            return fail(\n              `AI response validation failed after ${maxAttempts} attempts: ${entityResult.message}`\n            );\n          }\n        }\n\n        /* c8 ignore next 2 - unreachable: every loop iteration returns; TypeScript needs the trailing return */\n        return fail('AI generation failed');\n      } finally {\n        setIsWorking(false);\n      }\n    },\n    [settings, keyStore, logger]\n  );\n\n  const generateImages = useCallback(\n    async (\n      provider: AiAssist.AiProviderId,\n      params: AiAssist.IAiImageGenerationParams,\n      signal?: AbortSignal\n    ): Promise<Result<AiAssist.IAiImageGenerationResponse>> => {\n      const providerConfig = settings?.providers.find((p) => p.provider === provider);\n      if (!providerConfig) {\n        return fail(`Provider \"${provider}\" not configured`);\n      }\n\n      const descriptorResult = AiAssist.getProviderDescriptor(provider);\n      if (descriptorResult.isFailure()) {\n        return fail(descriptorResult.message);\n      }\n      const descriptor = descriptorResult.value;\n\n      if (!AiAssist.supportsImageGeneration(descriptor)) {\n        return fail(`Provider \"${provider}\" does not support image generation`);\n      }\n\n      const apiKeyResult = resolveApiKey(descriptor, providerConfig, keyStore);\n      if (apiKeyResult.isFailure()) {\n        return fail(apiKeyResult.message);\n      }\n\n      setIsWorking(true);\n      try {\n        const requestParams: AiAssist.IProviderImageGenerationParams = {\n          descriptor,\n          apiKey: apiKeyResult.value,\n          params,\n          modelOverride: providerConfig.model,\n          endpoint: providerConfig.endpoint,\n          logger,\n          signal\n        };\n        const useProxy: boolean =\n          !!settings?.proxyUrl && (settings.proxyAllProviders === true || descriptor.corsRestricted);\n        const result = useProxy\n          ? await AiAssist.callProxiedImageGeneration(settings!.proxyUrl!, requestParams)\n          : await AiAssist.callProviderImageGeneration(requestParams);\n        if (result.isFailure()) {\n          logger?.error(`AI image generation failed: ${result.message}`);\n        }\n        return result;\n      } finally {\n        setIsWorking(false);\n      }\n    },\n    [settings, keyStore, logger]\n  );\n\n  const listModels = useCallback(\n    async (\n      provider: AiAssist.AiProviderId,\n      capability?: AiAssist.AiModelCapability,\n      signal?: AbortSignal\n    ): Promise<Result<ReadonlyArray<AiAssist.IAiModelInfo>>> => {\n      const providerConfig = settings?.providers.find((p) => p.provider === provider);\n      if (!providerConfig) {\n        return fail(`Provider \"${provider}\" not configured`);\n      }\n\n      const descriptorResult = AiAssist.getProviderDescriptor(provider);\n      if (descriptorResult.isFailure()) {\n        return fail(descriptorResult.message);\n      }\n      const descriptor = descriptorResult.value;\n\n      const apiKeyResult = resolveApiKey(descriptor, providerConfig, keyStore);\n      if (apiKeyResult.isFailure()) {\n        return fail(apiKeyResult.message);\n      }\n\n      const requestParams: AiAssist.IProviderListModelsParams = {\n        descriptor,\n        apiKey: apiKeyResult.value,\n        ...(capability !== undefined ? { capability } : {}),\n        endpoint: providerConfig.endpoint,\n        logger,\n        signal\n      };\n      const useProxy: boolean =\n        !!settings?.proxyUrl && (settings.proxyAllProviders === true || descriptor.corsRestricted);\n      const result = useProxy\n        ? await AiAssist.callProxiedListModels(settings!.proxyUrl!, requestParams)\n        : await AiAssist.callProviderListModels(requestParams);\n      if (result.isFailure()) {\n        logger?.error(`AI list-models failed: ${result.message}`);\n      }\n      return result;\n    },\n    [settings, keyStore, logger]\n  );\n\n  const streamDirect = useCallback(\n    async (\n      provider: AiAssist.AiProviderId,\n      prompt: AiAssist.AiPrompt,\n      onEvent: (event: AiAssist.IAiStreamEvent) => void,\n      options?: {\n        readonly tools?: ReadonlyArray<AiAssist.AiServerToolConfig>;\n        readonly messagesBefore?: ReadonlyArray<AiAssist.IChatMessage>;\n        readonly signal?: AbortSignal;\n      }\n    ): Promise<Result<{ readonly fullText: string; readonly truncated: boolean }>> => {\n      const providerConfig = settings?.providers.find((p) => p.provider === provider);\n      if (!providerConfig) {\n        return fail(`Provider \"${provider}\" not configured`);\n      }\n\n      const descriptorResult = AiAssist.getProviderDescriptor(provider);\n      if (descriptorResult.isFailure()) {\n        return fail(descriptorResult.message);\n      }\n      const descriptor = descriptorResult.value;\n\n      const apiKeyResult = resolveApiKey(descriptor, providerConfig, keyStore);\n      if (apiKeyResult.isFailure()) {\n        return fail(apiKeyResult.message);\n      }\n\n      const effectiveTools = AiAssist.resolveEffectiveTools(descriptor, providerConfig.tools, options?.tools);\n      // Order prior history before the current user turn (the unified request shape).\n      const base = prompt.toRequest();\n      const requestParams: AiAssist.IProviderCompletionStreamParams = {\n        descriptor,\n        apiKey: apiKeyResult.value,\n        system: base.system,\n        messages: [...(options?.messagesBefore ?? []), ...base.messages],\n        modelOverride: providerConfig.model,\n        endpoint: providerConfig.endpoint,\n        logger,\n        tools: effectiveTools.length > 0 ? effectiveTools : undefined,\n        signal: options?.signal\n      };\n      const useProxy: boolean =\n        !!settings?.proxyUrl && (settings.proxyAllProviders === true || descriptor.streamingCorsRestricted);\n      const openResult = useProxy\n        ? await AiAssist.callProxiedCompletionStream(settings!.proxyUrl!, requestParams)\n        : await AiAssist.callProviderCompletionStream(requestParams);\n      if (openResult.isFailure()) {\n        logger?.error(`AI streaming failed to start: ${openResult.message}`);\n        return fail(openResult.message);\n      }\n\n      setIsWorking(true);\n      let fullText = '';\n      let truncated = false;\n      let terminalError: string | undefined;\n      let receivedTerminalEvent = false;\n      try {\n        for await (const event of openResult.value) {\n          try {\n            onEvent(event);\n          } catch (err: unknown) {\n            // Consumer callback threw (e.g. setState-after-unmount). Convert\n            // into a terminal failure so streamDirect always resolves to a\n            // Result instead of rejecting and breaking its contract.\n            terminalError = `AI stream event handler failed: ${\n              err instanceof Error ? err.message : String(err)\n            }`;\n            receivedTerminalEvent = true;\n            break;\n          }\n          if (event.type === 'text-delta') {\n            fullText += event.delta;\n          } else if (event.type === 'done') {\n            fullText = event.fullText;\n            truncated = event.truncated;\n            receivedTerminalEvent = true;\n          } else if (event.type === 'error') {\n            terminalError = event.message;\n            receivedTerminalEvent = true;\n          }\n        }\n      } finally {\n        setIsWorking(false);\n      }\n      if (terminalError !== undefined) {\n        logger?.error(`AI streaming ended in error: ${terminalError}`);\n        return fail(terminalError);\n      }\n      if (!receivedTerminalEvent) {\n        const message = 'AI stream ended without a terminal done or error event';\n        logger?.error(message);\n        return fail(message);\n      }\n      return succeed({ fullText, truncated });\n    },\n    [settings, keyStore, logger]\n  );\n\n  return {\n    actions,\n    isWorking,\n    copyPrompt,\n    generateDirect,\n    generateImages,\n    listModels,\n    streamDirect\n  };\n}\n"]}

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

@@ -0,0 +1,2 @@
+export { renderStatusBadge } from './renderStatusBadge';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/badge/index.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

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));
 }
 /**