@xelauvas/xela-cli 0.1.0

package/src/components/wizard/WizardNavigationFooter.tsx

@@ -0,0 +1,24 @@
+import React, { type ReactNode } from 'react';
+import { useExitOnCtrlCDWithKeybindings } from '../../hooks/useExitOnCtrlCDWithKeybindings.js';
+import { Box, Text } from '../../ink.js';
+import { ConfigurableShortcutHint } from '../ConfigurableShortcutHint.js';
+import { Byline } from '../design-system/Byline.js';
+import { KeyboardShortcutHint } from '../design-system/KeyboardShortcutHint.js';
+type Props = {
+  instructions?: ReactNode;
+};
+export function WizardNavigationFooter({
+  instructions = <Byline>
+      <KeyboardShortcutHint shortcut="↑↓" action="navigate" />
+      <KeyboardShortcutHint shortcut="Enter" action="select" />
+      <ConfigurableShortcutHint action="confirm:no" context="Confirmation" fallback="Esc" description="go back" />
+    </Byline>
+}: Props): ReactNode {
+  const exitState = useExitOnCtrlCDWithKeybindings();
+  return <Box marginLeft={3} marginTop={1}>
+      <Text dimColor>
+        {exitState.pending ? `Press ${exitState.keyName} again to exit` : instructions}
+      </Text>
+    </Box>;
+}
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJuYW1lcyI6WyJSZWFjdCIsIlJlYWN0Tm9kZSIsInVzZUV4aXRPbkN0cmxDRFdpdGhLZXliaW5kaW5ncyIsIkJveCIsIlRleHQiLCJDb25maWd1cmFibGVTaG9ydGN1dEhpbnQiLCJCeWxpbmUiLCJLZXlib2FyZFNob3J0Y3V0SGludCIsIlByb3BzIiwiaW5zdHJ1Y3Rpb25zIiwiV2l6YXJkTmF2aWdhdGlvbkZvb3RlciIsImV4aXRTdGF0ZSIsInBlbmRpbmciLCJrZXlOYW1lIl0sInNvdXJjZXMiOlsiV2l6YXJkTmF2aWdhdGlvbkZvb3Rlci50c3giXSwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IFJlYWN0LCB7IHR5cGUgUmVhY3ROb2RlIH0gZnJvbSAncmVhY3QnXG5pbXBvcnQgeyB1c2VFeGl0T25DdHJsQ0RXaXRoS2V5YmluZGluZ3MgfSBmcm9tICcuLi8uLi9ob29rcy91c2VFeGl0T25DdHJsQ0RXaXRoS2V5YmluZGluZ3MuanMnXG5pbXBvcnQgeyBCb3gsIFRleHQgfSBmcm9tICcuLi8uLi9pbmsuanMnXG5pbXBvcnQgeyBDb25maWd1cmFibGVTaG9ydGN1dEhpbnQgfSBmcm9tICcuLi9Db25maWd1cmFibGVTaG9ydGN1dEhpbnQuanMnXG5pbXBvcnQgeyBCeWxpbmUgfSBmcm9tICcuLi9kZXNpZ24tc3lzdGVtL0J5bGluZS5qcydcbmltcG9ydCB7IEtleWJvYXJkU2hvcnRjdXRIaW50IH0gZnJvbSAnLi4vZGVzaWduLXN5c3RlbS9LZXlib2FyZFNob3J0Y3V0SGludC5qcydcblxudHlwZSBQcm9wcyA9IHtcbiAgaW5zdHJ1Y3Rpb25zPzogUmVhY3ROb2RlXG59XG5cbmV4cG9ydCBmdW5jdGlvbiBXaXphcmROYXZpZ2F0aW9uRm9vdGVyKHtcbiAgaW5zdHJ1Y3Rpb25zID0gKFxuICAgIDxCeWxpbmU+XG4gICAgICA8S2V5Ym9hcmRTaG9ydGN1dEhpbnQgc2hvcnRjdXQ9XCLihpHihpNcIiBhY3Rpb249XCJuYXZpZ2F0ZVwiIC8+XG4gICAgICA8S2V5Ym9hcmRTaG9ydGN1dEhpbnQgc2hvcnRjdXQ9XCJFbnRlclwiIGFjdGlvbj1cInNlbGVjdFwiIC8+XG4gICAgICA8Q29uZmlndXJhYmxlU2hvcnRjdXRIaW50XG4gICAgICAgIGFjdGlvbj1cImNvbmZpcm06bm9cIlxuICAgICAgICBjb250ZXh0PVwiQ29uZmlybWF0aW9uXCJcbiAgICAgICAgZmFsbGJhY2s9XCJFc2NcIlxuICAgICAgICBkZXNjcmlwdGlvbj1cImdvIGJhY2tcIlxuICAgICAgLz5cbiAgICA8L0J5bGluZT5cbiAgKSxcbn06IFByb3BzKTogUmVhY3ROb2RlIHtcbiAgY29uc3QgZXhpdFN0YXRlID0gdXNlRXhpdE9uQ3RybENEV2l0aEtleWJpbmRpbmdzKClcblxuICByZXR1cm4gKFxuICAgIDxCb3ggbWFyZ2luTGVmdD17M30gbWFyZ2luVG9wPXsxfT5cbiAgICAgIDxUZXh0IGRpbUNvbG9yPlxuICAgICAgICB7ZXhpdFN0YXRlLnBlbmRpbmdcbiAgICAgICAgICA/IGBQcmVzcyAke2V4aXRTdGF0ZS5rZXlOYW1lfSBhZ2FpbiB0byBleGl0YFxuICAgICAgICAgIDogaW5zdHJ1Y3Rpb25zfVxuICAgICAgPC9UZXh0PlxuICAgIDwvQm94PlxuICApXG59XG4iXSwibWFwcGluZ3MiOiJBQUFBLE9BQU9BLEtBQUssSUFBSSxLQUFLQyxTQUFTLFFBQVEsT0FBTztBQUM3QyxTQUFTQyw4QkFBOEIsUUFBUSwrQ0FBK0M7QUFDOUYsU0FBU0MsR0FBRyxFQUFFQyxJQUFJLFFBQVEsY0FBYztBQUN4QyxTQUFTQyx3QkFBd0IsUUFBUSxnQ0FBZ0M7QUFDekUsU0FBU0MsTUFBTSxRQUFRLDRCQUE0QjtBQUNuRCxTQUFTQyxvQkFBb0IsUUFBUSwwQ0FBMEM7QUFFL0UsS0FBS0MsS0FBSyxHQUFHO0VBQ1hDLFlBQVksQ0FBQyxFQUFFUixTQUFTO0FBQzFCLENBQUM7QUFFRCxPQUFPLFNBQVNTLHNCQUFzQkEsQ0FBQztFQUNyQ0QsWUFBWSxHQUNWLENBQUMsTUFBTTtBQUNYLE1BQU0sQ0FBQyxvQkFBb0IsQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxVQUFVO0FBQzNELE1BQU0sQ0FBQyxvQkFBb0IsQ0FBQyxRQUFRLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxRQUFRO0FBQzVELE1BQU0sQ0FBQyx3QkFBd0IsQ0FDdkIsTUFBTSxDQUFDLFlBQVksQ0FDbkIsT0FBTyxDQUFDLGNBQWMsQ0FDdEIsUUFBUSxDQUFDLEtBQUssQ0FDZCxXQUFXLENBQUMsU0FBUztBQUU3QixJQUFJLEVBQUUsTUFBTTtBQUVMLENBQU4sRUFBRUQsS0FBSyxDQUFDLEVBQUVQLFNBQVMsQ0FBQztFQUNuQixNQUFNVSxTQUFTLEdBQUdULDhCQUE4QixDQUFDLENBQUM7RUFFbEQsT0FDRSxDQUFDLEdBQUcsQ0FBQyxVQUFVLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLENBQUM7QUFDckMsTUFBTSxDQUFDLElBQUksQ0FBQyxRQUFRO0FBQ3BCLFFBQVEsQ0FBQ1MsU0FBUyxDQUFDQyxPQUFPLEdBQ2QsU0FBU0QsU0FBUyxDQUFDRSxPQUFPLGdCQUFnQixHQUMxQ0osWUFBWTtBQUN4QixNQUFNLEVBQUUsSUFBSTtBQUNaLElBQUksRUFBRSxHQUFHLENBQUM7QUFFViIsImlnbm9yZUxpc3QiOltdfQ==

package/src/components/wizard/WizardProvider.tsx

@@ -0,0 +1,213 @@
+import { c as _c } from "react/compiler-runtime";
+import React, { createContext, type ReactNode, useCallback, useEffect, useMemo, useState } from 'react';
+import { useExitOnCtrlCDWithKeybindings } from '../../hooks/useExitOnCtrlCDWithKeybindings.js';
+import type { WizardContextValue, WizardProviderProps } from './types.js';
+
+// Use any here for the context since it will be cast properly when used
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const WizardContext = createContext<WizardContextValue<any> | null>(null);
+export function WizardProvider(t0) {
+  const $ = _c(38);
+  const {
+    steps,
+    initialData: t1,
+    onComplete,
+    onCancel,
+    children,
+    title,
+    showStepCounter: t2
+  } = t0;
+  let t3;
+  if ($[0] !== t1) {
+    t3 = t1 === undefined ? {} as T : t1;
+    $[0] = t1;
+    $[1] = t3;
+  } else {
+    t3 = $[1];
+  }
+  const initialData = t3;
+  const showStepCounter = t2 === undefined ? true : t2;
+  const [currentStepIndex, setCurrentStepIndex] = useState(0);
+  const [wizardData, setWizardData] = useState(initialData);
+  const [isCompleted, setIsCompleted] = useState(false);
+  let t4;
+  if ($[2] === Symbol.for("react.memo_cache_sentinel")) {
+    t4 = [];
+    $[2] = t4;
+  } else {
+    t4 = $[2];
+  }
+  const [navigationHistory, setNavigationHistory] = useState(t4);
+  useExitOnCtrlCDWithKeybindings();
+  let t5;
+  let t6;
+  if ($[3] !== isCompleted || $[4] !== onComplete || $[5] !== wizardData) {
+    t5 = () => {
+      if (isCompleted) {
+        setNavigationHistory([]);
+        onComplete(wizardData);
+      }
+    };
+    t6 = [isCompleted, wizardData, onComplete];
+    $[3] = isCompleted;
+    $[4] = onComplete;
+    $[5] = wizardData;
+    $[6] = t5;
+    $[7] = t6;
+  } else {
+    t5 = $[6];
+    t6 = $[7];
+  }
+  useEffect(t5, t6);
+  let t7;
+  if ($[8] !== currentStepIndex || $[9] !== navigationHistory || $[10] !== steps.length) {
+    t7 = () => {
+      if (currentStepIndex < steps.length - 1) {
+        if (navigationHistory.length > 0) {
+          setNavigationHistory(prev => [...prev, currentStepIndex]);
+        }
+        setCurrentStepIndex(_temp);
+      } else {
+        setIsCompleted(true);
+      }
+    };
+    $[8] = currentStepIndex;
+    $[9] = navigationHistory;
+    $[10] = steps.length;
+    $[11] = t7;
+  } else {
+    t7 = $[11];
+  }
+  const goNext = t7;
+  let t8;
+  if ($[12] !== currentStepIndex || $[13] !== navigationHistory || $[14] !== onCancel) {
+    t8 = () => {
+      if (navigationHistory.length > 0) {
+        const previousStep = navigationHistory[navigationHistory.length - 1];
+        if (previousStep !== undefined) {
+          setNavigationHistory(_temp2);
+          setCurrentStepIndex(previousStep);
+        }
+      } else {
+        if (currentStepIndex > 0) {
+          setCurrentStepIndex(_temp3);
+        } else {
+          if (onCancel) {
+            onCancel();
+          }
+        }
+      }
+    };
+    $[12] = currentStepIndex;
+    $[13] = navigationHistory;
+    $[14] = onCancel;
+    $[15] = t8;
+  } else {
+    t8 = $[15];
+  }
+  const goBack = t8;
+  let t9;
+  if ($[16] !== currentStepIndex || $[17] !== steps.length) {
+    t9 = index => {
+      if (index >= 0 && index < steps.length) {
+        setNavigationHistory(prev_3 => [...prev_3, currentStepIndex]);
+        setCurrentStepIndex(index);
+      }
+    };
+    $[16] = currentStepIndex;
+    $[17] = steps.length;
+    $[18] = t9;
+  } else {
+    t9 = $[18];
+  }
+  const goToStep = t9;
+  let t10;
+  if ($[19] !== onCancel) {
+    t10 = () => {
+      setNavigationHistory([]);
+      if (onCancel) {
+        onCancel();
+      }
+    };
+    $[19] = onCancel;
+    $[20] = t10;
+  } else {
+    t10 = $[20];
+  }
+  const cancel = t10;
+  let t11;
+  if ($[21] === Symbol.for("react.memo_cache_sentinel")) {
+    t11 = updates => {
+      setWizardData(prev_4 => ({
+        ...prev_4,
+        ...updates
+      }));
+    };
+    $[21] = t11;
+  } else {
+    t11 = $[21];
+  }
+  const updateWizardData = t11;
+  let t12;
+  if ($[22] !== cancel || $[23] !== currentStepIndex || $[24] !== goBack || $[25] !== goNext || $[26] !== goToStep || $[27] !== showStepCounter || $[28] !== steps.length || $[29] !== title || $[30] !== wizardData) {
+    t12 = {
+      currentStepIndex,
+      totalSteps: steps.length,
+      wizardData,
+      setWizardData,
+      updateWizardData,
+      goNext,
+      goBack,
+      goToStep,
+      cancel,
+      title,
+      showStepCounter
+    };
+    $[22] = cancel;
+    $[23] = currentStepIndex;
+    $[24] = goBack;
+    $[25] = goNext;
+    $[26] = goToStep;
+    $[27] = showStepCounter;
+    $[28] = steps.length;
+    $[29] = title;
+    $[30] = wizardData;
+    $[31] = t12;
+  } else {
+    t12 = $[31];
+  }
+  const contextValue = t12;
+  const CurrentStepComponent = steps[currentStepIndex];
+  if (!CurrentStepComponent || isCompleted) {
+    return null;
+  }
+  let t13;
+  if ($[32] !== CurrentStepComponent || $[33] !== children) {
+    t13 = children || <CurrentStepComponent />;
+    $[32] = CurrentStepComponent;
+    $[33] = children;
+    $[34] = t13;
+  } else {
+    t13 = $[34];
+  }
+  let t14;
+  if ($[35] !== contextValue || $[36] !== t13) {
+    t14 = <WizardContext.Provider value={contextValue}>{t13}</WizardContext.Provider>;
+    $[35] = contextValue;
+    $[36] = t13;
+    $[37] = t14;
+  } else {
+    t14 = $[37];
+  }
+  return t14;
+}
+function _temp3(prev_2) {
+  return prev_2 - 1;
+}
+function _temp2(prev_1) {
+  return prev_1.slice(0, -1);
+}
+function _temp(prev_0) {
+  return prev_0 + 1;
+}
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJuYW1lcyI6WyJSZWFjdCIsImNyZWF0ZUNvbnRleHQiLCJSZWFjdE5vZGUiLCJ1c2VDYWxsYmFjayIsInVzZUVmZmVjdCIsInVzZU1lbW8iLCJ1c2VTdGF0ZSIsInVzZUV4aXRPbkN0cmxDRFdpdGhLZXliaW5kaW5ncyIsIldpemFyZENvbnRleHRWYWx1ZSIsIldpemFyZFByb3ZpZGVyUHJvcHMiLCJXaXphcmRDb250ZXh0IiwiV2l6YXJkUHJvdmlkZXIiLCJ0MCIsIiQiLCJfYyIsInN0ZXBzIiwiaW5pdGlhbERhdGEiLCJ0MSIsIm9uQ29tcGxldGUiLCJvbkNhbmNlbCIsImNoaWxkcmVuIiwidGl0bGUiLCJzaG93U3RlcENvdW50ZXIiLCJ0MiIsInQzIiwidW5kZWZpbmVkIiwiVCIsImN1cnJlbnRTdGVwSW5kZXgiLCJzZXRDdXJyZW50U3RlcEluZGV4Iiwid2l6YXJkRGF0YSIsInNldFdpemFyZERhdGEiLCJpc0NvbXBsZXRlZCIsInNldElzQ29tcGxldGVkIiwidDQiLCJTeW1ib2wiLCJmb3IiLCJuYXZpZ2F0aW9uSGlzdG9yeSIsInNldE5hdmlnYXRpb25IaXN0b3J5IiwidDUiLCJ0NiIsInQ3IiwibGVuZ3RoIiwicHJldiIsIl90ZW1wIiwiZ29OZXh0IiwidDgiLCJwcmV2aW91c1N0ZXAiLCJfdGVtcDIiLCJfdGVtcDMiLCJnb0JhY2siLCJ0OSIsImluZGV4IiwicHJldl8zIiwiZ29Ub1N0ZXAiLCJ0MTAiLCJjYW5jZWwiLCJ0MTEiLCJ1cGRhdGVzIiwicHJldl80IiwidXBkYXRlV2l6YXJkRGF0YSIsInQxMiIsInRvdGFsU3RlcHMiLCJjb250ZXh0VmFsdWUiLCJDdXJyZW50U3RlcENvbXBvbmVudCIsInQxMyIsInQxNCIsInByZXZfMiIsInByZXZfMSIsInNsaWNlIiwicHJldl8wIl0sInNvdXJjZXMiOlsiV2l6YXJkUHJvdmlkZXIudHN4Il0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCBSZWFjdCwge1xuICBjcmVhdGVDb250ZXh0LFxuICB0eXBlIFJlYWN0Tm9kZSxcbiAgdXNlQ2FsbGJhY2ssXG4gIHVzZUVmZmVjdCxcbiAgdXNlTWVtbyxcbiAgdXNlU3RhdGUsXG59IGZyb20gJ3JlYWN0J1xuaW1wb3J0IHsgdXNlRXhpdE9uQ3RybENEV2l0aEtleWJpbmRpbmdzIH0gZnJvbSAnLi4vLi4vaG9va3MvdXNlRXhpdE9uQ3RybENEV2l0aEtleWJpbmRpbmdzLmpzJ1xuaW1wb3J0IHR5cGUgeyBXaXphcmRDb250ZXh0VmFsdWUsIFdpemFyZFByb3ZpZGVyUHJvcHMgfSBmcm9tICcuL3R5cGVzLmpzJ1xuXG4vLyBVc2UgYW55IGhlcmUgZm9yIHRoZSBjb250ZXh0IHNpbmNlIGl0IHdpbGwgYmUgY2FzdCBwcm9wZXJseSB3aGVuIHVzZWRcbi8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBAdHlwZXNjcmlwdC1lc2xpbnQvbm8tZXhwbGljaXQtYW55XG5leHBvcnQgY29uc3QgV2l6YXJkQ29udGV4dCA9IGNyZWF0ZUNvbnRleHQ8V2l6YXJkQ29udGV4dFZhbHVlPGFueT4gfCBudWxsPihudWxsKVxuXG5leHBvcnQgZnVuY3Rpb24gV2l6YXJkUHJvdmlkZXI8VCBleHRlbmRzIFJlY29yZDxzdHJpbmcsIHVua25vd24+Pih7XG4gIHN0ZXBzLFxuICBpbml0aWFsRGF0YSA9IHt9IGFzIFQsXG4gIG9uQ29tcGxldGUsXG4gIG9uQ2FuY2VsLFxuICBjaGlsZHJlbixcbiAgdGl0bGUsXG4gIHNob3dTdGVwQ291bnRlciA9IHRydWUsXG59OiBXaXphcmRQcm92aWRlclByb3BzPFQ+KTogUmVhY3ROb2RlIHtcbiAgY29uc3QgW2N1cnJlbnRTdGVwSW5kZXgsIHNldEN1cnJlbnRTdGVwSW5kZXhdID0gdXNlU3RhdGUoMClcbiAgY29uc3QgW3dpemFyZERhdGEsIHNldFdpemFyZERhdGFdID0gdXNlU3RhdGU8VD4oaW5pdGlhbERhdGEpXG4gIGNvbnN0IFtpc0NvbXBsZXRlZCwgc2V0SXNDb21wbGV0ZWRdID0gdXNlU3RhdGUoZmFsc2UpXG4gIGNvbnN0IFtuYXZpZ2F0aW9uSGlzdG9yeSwgc2V0TmF2aWdhdGlvbkhpc3RvcnldID0gdXNlU3RhdGU8bnVtYmVyW10+KFtdKVxuXG4gIHVzZUV4aXRPbkN0cmxDRFdpdGhLZXliaW5kaW5ncygpXG5cbiAgLy8gSGFuZGxlIGNvbXBsZXRpb24gaW4gdXNlRWZmZWN0IHRvIGF2b2lkIHVwZGF0aW5nIHBhcmVudCBkdXJpbmcgcmVuZGVyXG4gIHVzZUVmZmVjdCgoKSA9PiB7XG4gICAgaWYgKGlzQ29tcGxldGVkKSB7XG4gICAgICBzZXROYXZpZ2F0aW9uSGlzdG9yeShbXSlcbiAgICAgIHZvaWQgb25Db21wbGV0ZSh3aXphcmREYXRhKVxuICAgIH1cbiAgfSwgW2lzQ29tcGxldGVkLCB3aXphcmREYXRhLCBvbkNvbXBsZXRlXSlcblxuICBjb25zdCBnb05leHQgPSB1c2VDYWxsYmFjaygoKSA9PiB7XG4gICAgaWYgKGN1cnJlbnRTdGVwSW5kZXggPCBzdGVwcy5sZW5ndGggLSAxKSB7XG4gICAgICAvLyBJZiB3ZSBoYXZlIGhpc3RvcnkgKG5vbi1saW5lYXIgZmxvdyksIGFkZCBjdXJyZW50IHN0ZXAgdG8gaXRcbiAgICAgIGlmIChuYXZpZ2F0aW9uSGlzdG9yeS5sZW5ndGggPiAwKSB7XG4gICAgICAgIHNldE5hdmlnYXRpb25IaXN0b3J5KHByZXYgPT4gWy4uLnByZXYsIGN1cnJlbnRTdGVwSW5kZXhdKVxuICAgICAgfVxuXG4gICAgICBzZXRDdXJyZW50U3RlcEluZGV4KHByZXYgPT4gcHJldiArIDEpXG4gICAgfSBlbHNlIHtcbiAgICAgIC8vIE1hcmsgYXMgY29tcGxldGVkLCB3aGljaCB3aWxsIHRyaWdnZXIgdXNlRWZmZWN0XG4gICAgICBzZXRJc0NvbXBsZXRlZCh0cnVlKVxuICAgIH1cbiAgfSwgW2N1cnJlbnRTdGVwSW5kZXgsIHN0ZXBzLmxlbmd0aCwgbmF2aWdhdGlvbkhpc3RvcnldKVxuXG4gIGNvbnN0IGdvQmFjayA9IHVzZUNhbGxiYWNrKCgpID0+IHtcbiAgICAvLyBDaGVjayBpZiB3ZSBoYXZlIG5hdmlnYXRpb24gaGlzdG9yeSB0byB1c2VcbiAgICBpZiAobmF2aWdhdGlvbkhpc3RvcnkubGVuZ3RoID4gMCkge1xuICAgICAgY29uc3QgcHJldmlvdXNTdGVwID0gbmF2aWdhdGlvbkhpc3RvcnlbbmF2aWdhdGlvbkhpc3RvcnkubGVuZ3RoIC0gMV1cbiAgICAgIGlmIChwcmV2aW91c1N0ZXAgIT09IHVuZGVmaW5lZCkge1xuICAgICAgICBzZXROYXZpZ2F0aW9uSGlzdG9yeShwcmV2ID0+IHByZXYuc2xpY2UoMCwgLTEpKVxuICAgICAgICBzZXRDdXJyZW50U3RlcEluZGV4KHByZXZpb3VzU3RlcClcbiAgICAgIH1cbiAgICB9IGVsc2UgaWYgKGN1cnJlbnRTdGVwSW5kZXggPiAwKSB7XG4gICAgICAvLyBGYWxsYmFjayB0byBzaW1wbGUgZGVjcmVtZW50IGlmIG5vIGhpc3RvcnlcbiAgICAgIHNldEN1cnJlbnRTdGVwSW5kZXgocHJldiA9PiBwcmV2IC0gMSlcbiAgICB9IGVsc2UgaWYgKG9uQ2FuY2VsKSB7XG4gICAgICBvbkNhbmNlbCgpXG4gICAgfVxuICB9LCBbY3VycmVudFN0ZXBJbmRleCwgbmF2aWdhdGlvbkhpc3RvcnksIG9uQ2FuY2VsXSlcblxuICBjb25zdCBnb1RvU3RlcCA9IHVzZUNhbGxiYWNrKFxuICAgIChpbmRleDogbnVtYmVyKSA9PiB7XG4gICAgICBpZiAoaW5kZXggPj0gMCAmJiBpbmRleCA8IHN0ZXBzLmxlbmd0aCkge1xuICAgICAgICAvLyBQdXNoIGN1cnJlbnQgc3RlcCB0byBoaXN0b3J5IGJlZm9yZSBqdW1waW5nXG4gICAgICAgIHNldE5hdmlnYXRpb25IaXN0b3J5KHByZXYgPT4gWy4uLnByZXYsIGN1cnJlbnRTdGVwSW5kZXhdKVxuICAgICAgICBzZXRDdXJyZW50U3RlcEluZGV4KGluZGV4KVxuICAgICAgfVxuICAgIH0sXG4gICAgW2N1cnJlbnRTdGVwSW5kZXgsIHN0ZXBzLmxlbmd0aF0sXG4gIClcblxuICBjb25zdCBjYW5jZWwgPSB1c2VDYWxsYmFjaygoKSA9PiB7XG4gICAgc2V0TmF2aWdhdGlvbkhpc3RvcnkoW10pXG4gICAgaWYgKG9uQ2FuY2VsKSB7XG4gICAgICBvbkNhbmNlbCgpXG4gICAgfVxuICB9LCBbb25DYW5jZWxdKVxuXG4gIGNvbnN0IHVwZGF0ZVdpemFyZERhdGEgPSB1c2VDYWxsYmFjaygodXBkYXRlczogUGFydGlhbDxUPikgPT4ge1xuICAgIHNldFdpemFyZERhdGEocHJldiA9PiAoeyAuLi5wcmV2LCAuLi51cGRhdGVzIH0pKVxuICB9LCBbXSlcblxuICBjb25zdCBjb250ZXh0VmFsdWUgPSB1c2VNZW1vPFdpemFyZENvbnRleHRWYWx1ZTxUPj4oXG4gICAgKCkgPT4gKHtcbiAgICAgIGN1cnJlbnRTdGVwSW5kZXgsXG4gICAgICB0b3RhbFN0ZXBzOiBzdGVwcy5sZW5ndGgsXG4gICAgICB3aXphcmREYXRhLFxuICAgICAgc2V0V2l6YXJkRGF0YSxcbiAgICAgIHVwZGF0ZVdpemFyZERhdGEsXG4gICAgICBnb05leHQsXG4gICAgICBnb0JhY2ssXG4gICAgICBnb1RvU3RlcCxcbiAgICAgIGNhbmNlbCxcbiAgICAgIHRpdGxlLFxuICAgICAgc2hvd1N0ZXBDb3VudGVyLFxuICAgIH0pLFxuICAgIFtcbiAgICAgIGN1cnJlbnRTdGVwSW5kZXgsXG4gICAgICBzdGVwcy5sZW5ndGgsXG4gICAgICB3aXphcmREYXRhLFxuICAgICAgdXBkYXRlV2l6YXJkRGF0YSxcbiAgICAgIGdvTmV4dCxcbiAgICAgIGdvQmFjayxcbiAgICAgIGdvVG9TdGVwLFxuICAgICAgY2FuY2VsLFxuICAgICAgdGl0bGUsXG4gICAgICBzaG93U3RlcENvdW50ZXIsXG4gICAgXSxcbiAgKVxuXG4gIGNvbnN0IEN1cnJlbnRTdGVwQ29tcG9uZW50ID0gc3RlcHNbY3VycmVudFN0ZXBJbmRleF1cblxuICBpZiAoIUN1cnJlbnRTdGVwQ29tcG9uZW50IHx8IGlzQ29tcGxldGVkKSB7XG4gICAgcmV0dXJuIG51bGxcbiAgfVxuXG4gIHJldHVybiAoXG4gICAgPFdpemFyZENvbnRleHQuUHJvdmlkZXIgdmFsdWU9e2NvbnRleHRWYWx1ZX0+XG4gICAgICB7Y2hpbGRyZW4gfHwgPEN1cnJlbnRTdGVwQ29tcG9uZW50IC8+fVxuICAgIDwvV2l6YXJkQ29udGV4dC5Qcm92aWRlcj5cbiAgKVxufVxuIl0sIm1hcHBpbmdzIjoiO0FBQUEsT0FBT0EsS0FBSyxJQUNWQyxhQUFhLEVBQ2IsS0FBS0MsU0FBUyxFQUNkQyxXQUFXLEVBQ1hDLFNBQVMsRUFDVEMsT0FBTyxFQUNQQyxRQUFRLFFBQ0gsT0FBTztBQUNkLFNBQVNDLDhCQUE4QixRQUFRLCtDQUErQztBQUM5RixjQUFjQyxrQkFBa0IsRUFBRUMsbUJBQW1CLFFBQVEsWUFBWTs7QUFFekU7QUFDQTtBQUNBLE9BQU8sTUFBTUMsYUFBYSxHQUFHVCxhQUFhLENBQUNPLGtCQUFrQixDQUFDLEdBQUcsQ0FBQyxHQUFHLElBQUksQ0FBQyxDQUFDLElBQUksQ0FBQztBQUVoRixPQUFPLFNBQUFHLGVBQUFDLEVBQUE7RUFBQSxNQUFBQyxDQUFBLEdBQUFDLEVBQUE7RUFBMkQ7SUFBQUMsS0FBQTtJQUFBQyxXQUFBLEVBQUFDLEVBQUE7SUFBQUMsVUFBQTtJQUFBQyxRQUFBO0lBQUFDLFFBQUE7SUFBQUMsS0FBQTtJQUFBQyxlQUFBLEVBQUFDO0VBQUEsSUFBQVgsRUFRekM7RUFBQSxJQUFBWSxFQUFBO0VBQUEsSUFBQVgsQ0FBQSxRQUFBSSxFQUFBO0lBTnZCTyxFQUFBLEdBQUFQLEVBQXFCLEtBQXJCUSxTQUFxQixHQUFQLENBQUMsQ0FBQyxJQUFJQyxDQUFDLEdBQXJCVCxFQUFxQjtJQUFBSixDQUFBLE1BQUFJLEVBQUE7SUFBQUosQ0FBQSxNQUFBVyxFQUFBO0VBQUE7SUFBQUEsRUFBQSxHQUFBWCxDQUFBO0VBQUE7RUFBckIsTUFBQUcsV0FBQSxHQUFBUSxFQUFxQjtFQUtyQixNQUFBRixlQUFBLEdBQUFDLEVBQXNCLEtBQXRCRSxTQUFzQixHQUF0QixJQUFzQixHQUF0QkYsRUFBc0I7RUFFdEIsT0FBQUksZ0JBQUEsRUFBQUMsbUJBQUEs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

package/src/components/wizard/index.ts

@@ -0,0 +1,9 @@
+export type {
+  WizardContextValue,
+  WizardProviderProps,
+  WizardStepComponent,
+} from './types.js'
+export { useWizard } from './useWizard.js'
+export { WizardDialogLayout } from './WizardDialogLayout.js'
+export { WizardNavigationFooter } from './WizardNavigationFooter.js'
+export { WizardProvider } from './WizardProvider.js'

package/src/components/wizard/useWizard.ts

@@ -0,0 +1,13 @@
+import { useContext } from 'react'
+import type { WizardContextValue } from './types.js'
+import { WizardContext } from './WizardProvider.js'
+
+export function useWizard<
+  T extends Record<string, unknown> = Record<string, unknown>,
+>(): WizardContextValue<T> {
+  const context = useContext(WizardContext) as WizardContextValue<T> | null
+  if (!context) {
+    throw new Error('useWizard must be used within a WizardProvider')
+  }
+  return context
+}

package/src/constants/apiLimits.ts

@@ -0,0 +1,94 @@
+/**
+ * Anthropic API Limits
+ *
+ * These constants define server-side limits enforced by the Anthropic API.
+ * Keep this file dependency-free to prevent circular imports.
+ *
+ * Last verified: 2025-12-22
+ * Source: api/api/schemas/messages/blocks/ and api/api/config.py
+ *
+ * Future: See issue #13240 for dynamic limits fetching from server.
+ */
+
+// =============================================================================
+// IMAGE LIMITS
+// =============================================================================
+
+/**
+ * Maximum base64-encoded image size (API enforced).
+ * The API rejects images where the base64 string length exceeds this value.
+ * Note: This is the base64 length, NOT raw bytes. Base64 increases size by ~33%.
+ */
+export const API_IMAGE_MAX_BASE64_SIZE = 5 * 1024 * 1024 // 5 MB
+
+/**
+ * Target raw image size to stay under base64 limit after encoding.
+ * Base64 encoding increases size by 4/3, so we derive the max raw size:
+ * raw_size * 4/3 = base64_size → raw_size = base64_size * 3/4
+ */
+export const IMAGE_TARGET_RAW_SIZE = (API_IMAGE_MAX_BASE64_SIZE * 3) / 4 // 3.75 MB
+
+/**
+ * Client-side maximum dimensions for image resizing.
+ *
+ * Note: The API internally resizes images larger than 1568px (source:
+ * encoding/full_encoding.py), but this is handled server-side and doesn't
+ * cause errors. These client-side limits (2000px) are slightly larger to
+ * preserve quality when beneficial.
+ *
+ * The API_IMAGE_MAX_BASE64_SIZE (5MB) is the actual hard limit that causes
+ * API errors if exceeded.
+ */
+export const IMAGE_MAX_WIDTH = 2000
+export const IMAGE_MAX_HEIGHT = 2000
+
+// =============================================================================
+// PDF LIMITS
+// =============================================================================
+
+/**
+ * Maximum raw PDF file size that fits within the API request limit after encoding.
+ * The API has a 32MB total request size limit. Base64 encoding increases size by
+ * ~33% (4/3), so 20MB raw → ~27MB base64, leaving room for conversation context.
+ */
+export const PDF_TARGET_RAW_SIZE = 20 * 1024 * 1024 // 20 MB
+
+/**
+ * Maximum number of pages in a PDF accepted by the API.
+ */
+export const API_PDF_MAX_PAGES = 100
+
+/**
+ * Size threshold above which PDFs are extracted into page images
+ * instead of being sent as base64 document blocks. This applies to
+ * first-party API only; non-first-party always uses extraction.
+ */
+export const PDF_EXTRACT_SIZE_THRESHOLD = 3 * 1024 * 1024 // 3 MB
+
+/**
+ * Maximum PDF file size for the page extraction path. PDFs larger than
+ * this are rejected to avoid processing extremely large files.
+ */
+export const PDF_MAX_EXTRACT_SIZE = 100 * 1024 * 1024 // 100 MB
+
+/**
+ * Max pages the Read tool will extract in a single call with the pages parameter.
+ */
+export const PDF_MAX_PAGES_PER_READ = 20
+
+/**
+ * PDFs with more pages than this get the reference treatment on @ mention
+ * instead of being inlined into context.
+ */
+export const PDF_AT_MENTION_INLINE_THRESHOLD = 10
+
+// =============================================================================
+// MEDIA LIMITS
+// =============================================================================
+
+/**
+ * Maximum number of media items (images + PDFs) allowed per API request.
+ * The API rejects requests exceeding this limit with a confusing error.
+ * We validate client-side to provide a clear error message.
+ */
+export const API_MAX_MEDIA_PER_REQUEST = 100

package/src/constants/betas.ts

@@ -0,0 +1,52 @@
+import { feature } from 'bun:bundle'
+
+export const CLAUDE_CODE_20250219_BETA_HEADER = 'claude-code-20250219'
+export const INTERLEAVED_THINKING_BETA_HEADER =
+  'interleaved-thinking-2025-05-14'
+export const CONTEXT_1M_BETA_HEADER = 'context-1m-2025-08-07'
+export const CONTEXT_MANAGEMENT_BETA_HEADER = 'context-management-2025-06-27'
+export const STRUCTURED_OUTPUTS_BETA_HEADER = 'structured-outputs-2025-12-15'
+export const WEB_SEARCH_BETA_HEADER = 'web-search-2025-03-05'
+// Tool search beta headers differ by provider:
+// - Claude API / Foundry: advanced-tool-use-2025-11-20
+// - Vertex AI / Bedrock: tool-search-tool-2025-10-19
+export const TOOL_SEARCH_BETA_HEADER_1P = 'advanced-tool-use-2025-11-20'
+export const TOOL_SEARCH_BETA_HEADER_3P = 'tool-search-tool-2025-10-19'
+export const EFFORT_BETA_HEADER = 'effort-2025-11-24'
+export const TASK_BUDGETS_BETA_HEADER = 'task-budgets-2026-03-13'
+export const PROMPT_CACHING_SCOPE_BETA_HEADER =
+  'prompt-caching-scope-2026-01-05'
+export const FAST_MODE_BETA_HEADER = 'fast-mode-2026-02-01'
+export const REDACT_THINKING_BETA_HEADER = 'redact-thinking-2026-02-12'
+export const TOKEN_EFFICIENT_TOOLS_BETA_HEADER =
+  'token-efficient-tools-2026-03-28'
+export const SUMMARIZE_CONNECTOR_TEXT_BETA_HEADER = feature('CONNECTOR_TEXT')
+  ? 'summarize-connector-text-2026-03-13'
+  : ''
+export const AFK_MODE_BETA_HEADER = feature('TRANSCRIPT_CLASSIFIER')
+  ? 'afk-mode-2026-01-31'
+  : ''
+export const CLI_INTERNAL_BETA_HEADER =
+  process.env.USER_TYPE === 'ant' ? 'cli-internal-2026-02-09' : ''
+export const ADVISOR_BETA_HEADER = 'advisor-tool-2026-03-01'
+
+/**
+ * Bedrock only supports a limited number of beta headers and only through
+ * extraBodyParams. This set maintains the beta strings that should be in
+ * Bedrock extraBodyParams *and not* in Bedrock headers.
+ */
+export const BEDROCK_EXTRA_PARAMS_HEADERS = new Set([
+  INTERLEAVED_THINKING_BETA_HEADER,
+  CONTEXT_1M_BETA_HEADER,
+  TOOL_SEARCH_BETA_HEADER_3P,
+])
+
+/**
+ * Betas allowed on Vertex countTokens API.
+ * Other betas will cause 400 errors.
+ */
+export const VERTEX_COUNT_TOKENS_ALLOWED_BETAS = new Set([
+  CLAUDE_CODE_20250219_BETA_HEADER,
+  INTERLEAVED_THINKING_BETA_HEADER,
+  CONTEXT_MANAGEMENT_BETA_HEADER,
+])

package/src/constants/common.ts

@@ -0,0 +1,33 @@
+import memoize from 'lodash-es/memoize.js'
+
+// This ensures you get the LOCAL date in ISO format
+export function getLocalISODate(): string {
+  // Check for ant-only date override
+  if (process.env.CLAUDE_CODE_OVERRIDE_DATE) {
+    return process.env.CLAUDE_CODE_OVERRIDE_DATE
+  }
+
+  const now = new Date()
+  const year = now.getFullYear()
+  const month = String(now.getMonth() + 1).padStart(2, '0')
+  const day = String(now.getDate()).padStart(2, '0')
+  return `${year}-${month}-${day}`
+}
+
+// Memoized for prompt-cache stability — captures the date once at session start.
+// The main interactive path gets this behavior via memoize(getUserContext) in
+// context.ts; simple mode (--bare) calls getSystemPrompt per-request and needs
+// an explicit memoized date to avoid busting the cached prefix at midnight.
+// When midnight rolls over, getDateChangeAttachments appends the new date at
+// the tail (though simple mode disables attachments, so the trade-off there is:
+// stale date after midnight vs. ~entire-conversation cache bust — stale wins).
+export const getSessionStartDate = memoize(getLocalISODate)
+
+// Returns "Month YYYY" (e.g. "February 2026") in the user's local timezone.
+// Changes monthly, not daily — used in tool prompts to minimize cache busting.
+export function getLocalMonthYear(): string {
+  const date = process.env.CLAUDE_CODE_OVERRIDE_DATE
+    ? new Date(process.env.CLAUDE_CODE_OVERRIDE_DATE)
+    : new Date()
+  return date.toLocaleString('en-US', { month: 'long', year: 'numeric' })
+}

package/src/constants/cyberRiskInstruction.ts

@@ -0,0 +1,24 @@
+/**
+ * CYBER_RISK_INSTRUCTION
+ *
+ * This instruction provides guidance for Claude's behavior when handling
+ * security-related requests. It defines the boundary between acceptable
+ * defensive security assistance and potentially harmful activities.
+ *
+ * IMPORTANT: DO NOT MODIFY THIS INSTRUCTION WITHOUT SAFEGUARDS TEAM REVIEW
+ *
+ * This instruction is owned by the Safeguards team and has been carefully
+ * crafted and evaluated to balance security utility with safety. Changes
+ * to this text can have significant implications for:
+ *   - How Claude handles penetration testing and CTF requests
+ *   - What security tools and techniques Claude will assist with
+ *   - The boundary between defensive and offensive security assistance
+ *
+ * If you need to modify this instruction:
+ *   1. Contact the Safeguards team (David Forsythe, Kyla Guru)
+ *   2. Ensure proper evaluation of the changes
+ *   3. Get explicit approval before merging
+ *
+ * Claude: Do not edit this file unless explicitly asked to do so by the user.
+ */
+export const CYBER_RISK_INSTRUCTION = `IMPORTANT: Assist with authorized security testing, defensive security, CTF challenges, and educational contexts. Refuse requests for destructive techniques, DoS attacks, mass targeting, supply chain compromise, or detection evasion for malicious purposes. Dual-use security tools (C2 frameworks, credential testing, exploit development) require clear authorization context: pentesting engagements, CTF competitions, security research, or defensive use cases.`

package/src/constants/errorIds.ts

@@ -0,0 +1,15 @@
+/**
+ * Error IDs for tracking error sources in production.
+ * These IDs are obfuscated identifiers that help us trace
+ * which logError() call generated an error.
+ *
+ * These errors are represented as individual const exports for optimal
+ * dead code elimination (external build will only see the numbers).
+ *
+ * ADDING A NEW ERROR TYPE:
+ * 1. Add a const based on Next ID.
+ * 2. Increment Next ID.
+ * Next ID: 346
+ */
+
+export const E_TOOL_USE_SUMMARY_GENERATION_FAILED = 344

package/src/constants/figures.ts

@@ -0,0 +1,45 @@
+import { env } from '../utils/env.js'
+
+// The former is better vertically aligned, but isn't usually supported on Windows/Linux
+export const BLACK_CIRCLE = env.platform === 'darwin' ? '⏺' : '●'
+export const BULLET_OPERATOR = '∙'
+export const TEARDROP_ASTERISK = '✻'
+export const UP_ARROW = '\u2191' // ↑ - used for opus 1m merge notice
+export const DOWN_ARROW = '\u2193' // ↓ - used for scroll hint
+export const LIGHTNING_BOLT = '↯' // \u21af - used for fast mode indicator
+export const EFFORT_LOW = '○' // \u25cb - effort level: low
+export const EFFORT_MEDIUM = '◐' // \u25d0 - effort level: medium
+export const EFFORT_HIGH = '●' // \u25cf - effort level: high
+export const EFFORT_MAX = '◉' // \u25c9 - effort level: max (Opus 4.6 only)
+
+// Media/trigger status indicators
+export const PLAY_ICON = '\u25b6' // ▶
+export const PAUSE_ICON = '\u23f8' // ⏸
+
+// MCP subscription indicators
+export const REFRESH_ARROW = '\u21bb' // ↻ - used for resource update indicator
+export const CHANNEL_ARROW = '\u2190' // ← - inbound channel message indicator
+export const INJECTED_ARROW = '\u2192' // → - cross-session injected message indicator
+export const FORK_GLYPH = '\u2442' // ⑂ - fork directive indicator
+
+// Review status indicators (ultrareview diamond states)
+export const DIAMOND_OPEN = '\u25c7' // ◇ - running
+export const DIAMOND_FILLED = '\u25c6' // ◆ - completed/failed
+export const REFERENCE_MARK = '\u203b' // ※ - komejirushi, away-summary recap marker
+
+// Issue flag indicator
+export const FLAG_ICON = '\u2691' // ⚑ - used for issue flag banner
+
+// Blockquote indicator
+export const BLOCKQUOTE_BAR = '\u258e' // ▎ - left one-quarter block, used as blockquote line prefix
+export const HEAVY_HORIZONTAL = '\u2501' // ━ - heavy box-drawing horizontal
+
+// Bridge status indicators
+export const BRIDGE_SPINNER_FRAMES = [
+  '\u00b7|\u00b7',
+  '\u00b7/\u00b7',
+  '\u00b7\u2014\u00b7',
+  '\u00b7\\\u00b7',
+]
+export const BRIDGE_READY_INDICATOR = '\u00b7\u2714\ufe0e\u00b7'
+export const BRIDGE_FAILED_INDICATOR = '\u00d7'