@tai42/studio-sdk 16.0.0 → 17.0.0

package/dist/index.js

@@ -38,98 +38,85 @@
 import './components/tokens.css';
 import './components/fonts.css';
 import './components/components.css';
-export { STUDIO_PLUGIN_API_VERSION, checkPluginApiVersion } from './plugin/version';
-// -- Hooks -------------------------------------------------------------------
+export { checkPluginApiVersion, STUDIO_PLUGIN_API_VERSION } from './plugin/version';
 export { ApiProvider, useApi } from './hooks/useApi';
-export { UnauthorizedProvider, useOnUnauthorized } from './hooks/useUnauthorized';
 export { AuthProvider, useAuth } from './hooks/useAuth';
-export { CapabilityProvider, useCapabilities, useCanWrite, isFullProjection, coversAnyRoute, coversRoute, coversWrite, } from './hooks/useCapabilities';
-export { SystemKindsProvider, useSystemKinds, useFeatureOff, useFeatureOffMessage, } from './hooks/useSystemKinds';
-export { ToolDisplayNamesProvider, useToolDisplayNames, useReloadToolDisplayNames, toolDisplayLabel, } from './hooks/useToolDisplayNames';
-export { ThemeProvider, useTheme } from './hooks/useTheme';
 export { useBreakpoint } from './hooks/useBreakpoint';
+export { CapabilityProvider, coversAnyRoute, coversRoute, coversWrite, isFullProjection, useCanWrite, useCapabilities, } from './hooks/useCapabilities';
 export { useInteractionsStream } from './hooks/useSse';
-// -- Navigation (shell ⇄ feature route-token contract) -----------------------
-export { NavigationProvider, AppLink, useAppNavigate, useResolvePath, usePluginNavigation, usePluginEntryNavigation, useNavigationGuard, useNavigationGate, useSearchCommit, } from './navigation';
+export { SystemKindsProvider, useFeatureOff, useFeatureOffMessage, useSystemKinds, } from './hooks/useSystemKinds';
+export { ThemeProvider, useTheme } from './hooks/useTheme';
+export { toolDisplayLabel, ToolDisplayNamesProvider, useReloadToolDisplayNames, useToolDisplayNames, } from './hooks/useToolDisplayNames';
+export { UnauthorizedProvider, useOnUnauthorized } from './hooks/useUnauthorized';
+export { AppLink, NavigationProvider, useAppNavigate, useNavigationGate, useNavigationGuard, usePluginEntryNavigation, usePluginNavigation, useResolvePath, useSearchCommit, } from './navigation';
 // -- Utilities ---------------------------------------------------------------
-export { errorMessage } from './errors';
 export { downloadBlob } from './download';
-// -- Disabled-feature idiom (one helper + component, every consumer) ----------
-export { isFeatureDisabled, featureDisabledMessage, FeatureDisabled } from './feature-disabled';
+export { errorMessage } from './errors';
+export { FeatureDisabled, featureDisabledMessage, isFeatureDisabled } from './feature-disabled';
 // -- Cross-feature query keys ------------------------------------------------
-export { toolsListKey, extensionsQueryKey, subMcpKey, tokensPayloadKey, statesListKey, stateTemplatesKey, } from './query-keys';
+export { extensionsQueryKey, statesListKey, stateTemplatesKey, subMcpKey, tokensPayloadKey, toolsListKey, } from './query-keys';
 // -- Extension-combo editing helpers -----------------------------------------
 export { comboElementNames, extensionElementName } from './extension-combos';
 // -- Tool-visibility tri-state -----------------------------------------------
 export { effectiveHidden, hiddenToolNames } from './tool-visibility';
 // -- Tool declared-badge merge (native ∪ overlay) ----------------------------
 export { mergeToolBadges, toolBadgesByName } from './tool-badges';
-// -- Design system -----------------------------------------------------------
-export { Button, Card, Skeleton, EmptyState, ErrorState, Spinner } from './components/primitives';
-export { PageHeader, Page, Stack } from './components/page-header';
-export { PageFillProvider, useFillViewport, usePageFillActive } from './components/page-fill';
-export { ErrorBoundary } from './components/error-boundary';
-export { Field, useFieldControl } from './components/field';
-export { TextInput, Textarea, NumberInput } from './components/inputs';
-export { Select } from './components/select';
-export { Checkbox } from './components/checkbox';
-export { RadioGroup } from './components/radio-group';
-export { TemplatedTextField, templatedTextSummary } from './components/templated-text-field';
 export { Badge } from './components/badge';
-export { Tabs } from './components/tabs';
-export { Dialog } from './components/dialog';
+export { Checkbox } from './components/checkbox';
 export { ConfirmDialog } from './components/confirm-dialog';
-export { GuardedTabs, DirtyGuardBoundary, useRegisterDirty } from './components/dirty-guard';
-export { FormDialog } from './components/form-dialog';
+export { Dialog } from './components/dialog';
+export { DirtyGuardBoundary, GuardedTabs, useRegisterDirty } from './components/dirty-guard';
 export { Drawer } from './components/drawer';
-export { Tooltip } from './components/tooltip';
-export { Table, THead, TBody, TR, TH, TD } from './components/table';
-export { ScrollRegion, useOverflowRegion, useProseScrollRegions } from './components/scroll-region';
+export { EntityCardGrid } from './components/entity-card-grid';
+export { ErrorBoundary } from './components/error-boundary';
+export { buildTagVocabulary, ExplorerView, matchesSelectedTags, UNTAGGED_TOKEN, } from './components/explorer-view';
+export { Field, useFieldControl } from './components/field';
+export { FormDialog } from './components/form-dialog';
+export { NumberInput, Textarea, TextInput } from './components/inputs';
+export { diffJson, JsonDiff } from './components/json-diff';
 export { JsonTree } from './components/json-tree';
-export { JsonDiff, diffJson } from './components/json-diff';
-export { TagChips, TagsInput } from './components/tags';
 export { OverlayDetailsFields, overlayDetailsPatch } from './components/overlay-details-fields';
-export { ViewToggle, useViewMode } from './components/view-toggle';
-export { EntityCardGrid } from './components/entity-card-grid';
-export { ExplorerView, buildTagVocabulary, matchesSelectedTags, UNTAGGED_TOKEN, } from './components/explorer-view';
-// The canonical whole-row/whole-card "open" affordance: one helper every
-// navigable list surface spreads onto its entry (see the module doc).
-export { openTargetProps } from './components/open-target';
-export { FolderBreadcrumb, FolderRow, FolderPicker, childFolders, folderPathTo, } from './components/folder-nav';
+export { PageFillProvider, useFillViewport, usePageFillActive } from './components/page-fill';
+export { Page, PageHeader, Stack } from './components/page-header';
+export { Button, Card, EmptyState, ErrorState, Skeleton, Spinner } from './components/primitives';
+export { RadioGroup } from './components/radio-group';
+export { ScrollRegion, useOverflowRegion, useProseScrollRegions } from './components/scroll-region';
+export { Select } from './components/select';
+export { Table, TBody, TD, TH, THead, TR } from './components/table';
+export { Tabs } from './components/tabs';
+export { TagChips, TagsInput } from './components/tags';
+export { TemplatedTextField, templatedTextSummary } from './components/templated-text-field';
+export { Tooltip } from './components/tooltip';
+export { useViewMode, ViewToggle } from './components/view-toggle';
 export { CodeBlock } from './components/code-block';
-export { Markdown, parseMarkdown } from './components/markdown';
-export { DateRangePicker, formatRangeLabel, normalizeCustomRange, DEFAULT_DATE_RANGE_PRESETS, } from './components/date-range-picker';
-export { FleetReport } from './components/fleet-report';
+export { DateRangePicker, DEFAULT_DATE_RANGE_PRESETS, formatRangeLabel, normalizeCustomRange, } from './components/date-range-picker';
 export { ExternalLinkButton, isSafeHttpUrl } from './components/external-link';
-// The URL half of the link-safety pair: `isSafeHttpUrl` answers yes/no, this one
-// hands back the parsed URL, so a caller that needs the URL does not re-parse it.
-export { safeHttpUrl } from './components/primitives';
-export { ToolPicker, BADGES_NOTE } from './components/tool-picker';
-export { ExtensionPicker } from './components/extension-picker';
+export { FleetReport } from './components/fleet-report';
+export { childFolders, FolderBreadcrumb, folderPathTo, FolderPicker, FolderRow, } from './components/folder-nav';
+export { Markdown, parseMarkdown } from './components/markdown';
+export { openTargetProps } from './components/open-target';
+export { CopyField } from './components/copy-field';
 export { ExtensionComboBuilder } from './components/extension-combo-builder';
-export { baseNameOf, groupIntoFamilies, groupByKind, kindVariant, NON_STACKABLE_KIND, } from './components/extension-grouping';
-export { VersionHistoryPanel } from './components/version-history-panel';
+export { baseNameOf, groupByKind, groupIntoFamilies, kindVariant, NON_STACKABLE_KIND, } from './components/extension-grouping';
+export { ExtensionPicker } from './components/extension-picker';
+export { safeHttpUrl } from './components/primitives';
 export { RevealInput } from './components/reveal-input';
-export { CopyField } from './components/copy-field';
 export { TOKEN_NAMES } from './components/tokens';
-// -- Iconography (the only sanctioned marks; Unicode glyphs are banned) -------
-export { NAV_ICONS, DashboardIcon, ToolsIcon, AgentsIcon, PresetsIcon, DatabaseIcon, ExtensionsIcon, TemplatesIcon, ConnectorsIcon, ServedEndpointsIcon, PluginIcon, HooksIcon, StorageIcon, SchedulingIcon, InteractionsIcon, NotificationsIcon, ConversationsIcon, MarketplaceIcon, ManifestIcon, SettingsIcon, SystemIcon, SearchIcon, SignOutIcon, MenuIcon, CloseIcon, FolderIcon, GridIcon, FilterIcon, ArrowLeftIcon, ArrowUpIcon, ArrowDownIcon, ChevronDownIcon, ChevronRightIcon, CheckIcon, MinusIcon, PlusIcon, EditIcon, UnplugIcon, CopyIcon, ExternalLinkIcon, EyeIcon, EyeOffIcon, SortAscIcon, SortDescIcon, SunIcon, MoonIcon, MonitorIcon, CheckCircleIcon, AlertTriangleIcon, XCircleIcon, PendingIcon, } from './components/icons';
-// -- Schema-driven forms -----------------------------------------------------
-export { SchemaForm, RecordEntryRendererContext, 
+export { BADGES_NOTE, ToolPicker } from './components/tool-picker';
+export { VersionHistoryPanel } from './components/version-history-panel';
+export { AgentsIcon, AlertTriangleIcon, ArrowDownIcon, ArrowLeftIcon, ArrowUpIcon, CheckCircleIcon, CheckIcon, ChevronDownIcon, ChevronRightIcon, CloseIcon, ConnectorsIcon, ConversationsIcon, CopyIcon, DashboardIcon, DatabaseIcon, EditIcon, ExtensionsIcon, ExternalLinkIcon, EyeIcon, EyeOffIcon, FilterIcon, FolderIcon, GridIcon, HooksIcon, InteractionsIcon, ManifestIcon, MarketplaceIcon, MenuIcon, MinusIcon, MonitorIcon, MoonIcon, NAV_ICONS, NotificationsIcon, PendingIcon, PluginIcon, PlusIcon, PresetsIcon, SchedulingIcon, SearchIcon, ServedEndpointsIcon, SettingsIcon, SignOutIcon, SortAscIcon, SortDescIcon, StorageIcon, SunIcon, SystemIcon, TemplatesIcon, ToolsIcon, UnplugIcon, XCircleIcon, } from './components/icons';
+export { defaultValueForSchema, 
 // The expression-door injection point: a host that wants `x-tai42-expression`
 // fields to author through the visual editor imports `JqField` from
 // `@tai42/jq-studio` and hands it to a form (the `expressionField` prop) or
 // mounts this context above its tree. A form with no door renders those fields
 // as plain string inputs and stays free of the jq subgraph — the editor, its
 // worker, and its wasm — entirely.
-ExpressionFieldContext, SecretRefField, defaultValueForSchema, validateAgainstSchema, resolveRef, } from './schema-form';
-// -- Schema-editor (validated JSON-Schema authoring control) -----------------
-export { SchemaEditor, lintSchemaText } from './schema-editor';
-// -- State-binding editor (the one binding shape every door + flow node authors) --
-export { StateBindingEditor, StateBindingSection, StateAttachRow, InjectionList, UpdateList, AdapterMapping, SubjectScopeFields, BindingJqField, BindingTemplatedJqField, appendTjq, resolveTemplateJq, findByRef, resolveCallName, templatesCatalogFromList, statesCatalogFromList, fieldPathsFromSchema, compileAdapter, rowValueJq, fieldPathToJq, jqKey, defaultRowsForInput, parseAdapter, parseFieldPath, generateTemplateCall, parseTemplateCall, encodeTemplateSegment, templatedTextCatalog, } from './state-binding';
-// -- MCP context widgets (elicitation / progress / completions / output) -----
-export { ProgressBar } from './components/progress-bar';
+ExpressionFieldContext, RecordEntryRendererContext, resolveRef, SchemaForm, SecretRefField, validateAgainstSchema, } from './schema-form';
+export { lintSchemaText, SchemaEditor } from './schema-editor';
+export { AdapterMapping, appendTjq, BindingJqField, BindingTemplatedJqField, compileAdapter, defaultRowsForInput, encodeTemplateSegment, fieldPathsFromSchema, fieldPathToJq, findByRef, generateTemplateCall, InjectionList, jqKey, parseAdapter, parseFieldPath, parseTemplateCall, resolveCallName, resolveTemplateJq, rowValueJq, StateAttachRow, StateBindingEditor, StateBindingSection, statesCatalogFromList, SubjectScopeFields, templatedTextCatalog, templatesCatalogFromList, UpdateList, } from './state-binding';
 export { CompletionInput } from './components/completion-input';
+export { ProgressBar } from './components/progress-bar';
 export { ElicitationForm } from './elicitation/ElicitationForm';
 export { StructuredOutput } from './structured-output/StructuredOutput';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,kFAAkF;AAClF,+EAA+E;AAC/E,4EAA4E;AAC5E,iFAAiF;AACjF,iFAAiF;AACjF,+EAA+E;AAC/E,qEAAqE;AACrE,OAAO,yBAAyB,CAAC;AACjC,OAAO,wBAAwB,CAAC;AAChC,OAAO,6BAA6B,CAAC;AAqBrC,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGpF,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,WAAW,GACZ,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAKrC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAOvD,+EAA+E;AAC/E,OAAO,EACL,kBAAkB,EAClB,OAAO,EACP,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GAChB,MAAM,cAAc,CAAC;AAetB,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGhG,+EAA+E;AAC/E,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,+EAA+E;AAC/E,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,+EAA+E;AAC/E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAErE,+EAA+E;AAC/E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAElE,+EAA+E;AAC/E,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAWlG,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAO7C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAM7F,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AASrE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAMpG,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAKhG,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,4BAA4B,CAAC;AAUpC,yEAAyE;AACzE,sEAAsE;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,yBAAyB,CAAC;AAOjC,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AAMxC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC/E,iFAAiF;AACjF,kFAAkF;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAKzE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,gFAAgF;AAChF,OAAO,EACL,SAAS,EACT,aAAa,EACb,SAAS,EACT,UAAU,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACd,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,SAAS,EACT,UAAU,EACV,QAAQ,EACR,UAAU,EACV,aAAa,EACb,WAAW,EACX,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,OAAO,EACP,UAAU,EACV,WAAW,EACX,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAG5B,+EAA+E;AAC/E,OAAO,EACL,UAAU,EACV,0BAA0B;AAC1B,8EAA8E;AAC9E,oEAAoE;AACpE,4EAA4E;AAC5E,+EAA+E;AAC/E,6EAA6E;AAC7E,mCAAmC;AACnC,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,UAAU,GACX,MAAM,eAAe,CAAC;AAkBvB,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAG/D,oFAAoF;AACpF,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,aAAa,EACb,KAAK,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAgCzB,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/navigation/app-link.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `AppLink` — the SDK's route-token anchor: a real `<a>` whose plain left-click is
+ * intercepted for a client-side transition.
+ */
+import { type AriaAttributes, type CSSProperties, type ReactNode } from 'react';
+import type { RouteSearch, RouteToken } from './types';
+export interface AppLinkProps<T extends RouteToken> {
+    to: T;
+    search?: RouteSearch<T>;
+    children: ReactNode;
+    className?: string;
+    'aria-label'?: string;
+    'aria-current'?: AriaAttributes['aria-current'];
+    /** Native tooltip text (also a sensible non-AT hover hint). */
+    title?: string;
+    /** Inline styles for the anchor. */
+    style?: CSSProperties;
+}
+/**
+ * A real anchor (so middle-click / open-in-new-tab keep working) that drives a
+ * client-side transition on plain left-click. Modified clicks (new tab/window,
+ * download) fall through to the browser's default handling.
+ */
+export declare function AppLink<T extends RouteToken>({ to, search, children, className, 'aria-label': ariaLabel, 'aria-current': ariaCurrent, title, style, }: AppLinkProps<T>): ReactNode;
+//# sourceMappingURL=app-link.d.ts.map

package/dist/navigation/app-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-link.d.ts","sourceRoot":"","sources":["../../src/navigation/app-link.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,aAAa,EAElB,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAGf,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEvD,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,UAAU;IAChD,EAAE,EAAE,CAAC,CAAC;IACN,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IAChD,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,UAAU,EAAE,EAC5C,EAAE,EACF,MAAM,EACN,QAAQ,EACR,SAAS,EACT,YAAY,EAAE,SAAS,EACvB,cAAc,EAAE,WAAW,EAC3B,KAAK,EACL,KAAK,GACN,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CA0B7B"}

package/dist/navigation/app-link.js

@@ -0,0 +1,33 @@
+/**
+ * `AppLink` — the SDK's route-token anchor: a real `<a>` whose plain left-click is
+ * intercepted for a client-side transition.
+ */
+import { createElement, useCallback, } from 'react';
+import { useNavigation } from './context';
+/**
+ * A real anchor (so middle-click / open-in-new-tab keep working) that drives a
+ * client-side transition on plain left-click. Modified clicks (new tab/window,
+ * download) fall through to the browser's default handling.
+ */
+export function AppLink({ to, search, children, className, 'aria-label': ariaLabel, 'aria-current': ariaCurrent, title, style, }) {
+    const { navigate, resolvePath } = useNavigation();
+    const href = resolvePath(to, search);
+    const onClick = useCallback((event) => {
+        if (event.defaultPrevented)
+            return;
+        if (event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey)
+            return;
+        event.preventDefault();
+        navigate(to, search);
+    }, [navigate, to, search]);
+    return createElement('a', {
+        href,
+        className,
+        'aria-label': ariaLabel,
+        'aria-current': ariaCurrent,
+        title,
+        style,
+        onClick,
+    }, children);
+}
+//# sourceMappingURL=app-link.js.map

package/dist/navigation/app-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-link.js","sourceRoot":"","sources":["../../src/navigation/app-link.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAEL,aAAa,EAIb,WAAW,GACZ,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAgB1C;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAuB,EAC5C,EAAE,EACF,MAAM,EACN,QAAQ,EACR,SAAS,EACT,YAAY,EAAE,SAAS,EACvB,cAAc,EAAE,WAAW,EAC3B,KAAK,EACL,KAAK,GACW;IAChB,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,aAAa,EAAE,CAAC;IAClD,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,WAAW,CACzB,CAAC,KAAoC,EAAE,EAAE;QACvC,IAAI,KAAK,CAAC,gBAAgB;YAAE,OAAO;QACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM;YACxF,OAAO;QACT,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACvB,CAAC,EACD,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,CACvB,CAAC;IACF,OAAO,aAAa,CAClB,GAAG,EACH;QACE,IAAI;QACJ,SAAS;QACT,YAAY,EAAE,SAAS;QACvB,cAAc,EAAE,WAAW;QAC3B,KAAK;QACL,KAAK;QACL,OAAO;KACR,EACD,QAAQ,CACT,CAAC;AACJ,CAAC"}

package/dist/navigation/context.d.ts

@@ -1,9 +1,10 @@
-import { type AriaAttributes, type CSSProperties, type ReactNode } from 'react';
-import type { NavigationContextValue, NavigationGuardHandler, RouteSearch, RouteToken } from './types';
+import { type ReactNode } from 'react';
+import type { NavigationContextValue, NavigationGuardHandler } from './types';
 export declare function NavigationProvider({ value, children, }: {
     value: NavigationContextValue;
     children: ReactNode;
 }): ReactNode;
+export declare function useNavigation(): NavigationContextValue;
 /** Imperative navigation to a shell route token with its typed search params. */
 export declare function useAppNavigate(): NavigationContextValue['navigate'];
 /** Resolve a token + search to the href the shell would route to. */
@@ -50,22 +51,4 @@ export declare function usePluginEntryNavigation(): {
     navigatePluginWithOptions: NonNullable<NavigationContextValue['navigatePluginWithOptions']>;
     updatePluginEntryState: NonNullable<NavigationContextValue['updatePluginEntryState']>;
 };
-export interface AppLinkProps<T extends RouteToken> {
-    to: T;
-    search?: RouteSearch<T>;
-    children: ReactNode;
-    className?: string;
-    'aria-label'?: string;
-    'aria-current'?: AriaAttributes['aria-current'];
-    /** Native tooltip text (also a sensible non-AT hover hint). */
-    title?: string;
-    /** Inline styles for the anchor. */
-    style?: CSSProperties;
-}
-/**
- * A real anchor (so middle-click / open-in-new-tab keep working) that drives a
- * client-side transition on plain left-click. Modified clicks (new tab/window,
- * download) fall through to the browser's default handling.
- */
-export declare function AppLink<T extends RouteToken>({ to, search, children, className, 'aria-label': ariaLabel, 'aria-current': ariaCurrent, title, style, }: AppLinkProps<T>): ReactNode;
 //# sourceMappingURL=context.d.ts.map

package/dist/navigation/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/navigation/context.tsx"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,cAAc,EACnB,KAAK,aAAa,EAElB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,EACX,UAAU,EACX,MAAM,SAAS,CAAC;AA8HjB,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,sBAAsB,CAAC;IAC9B,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,SAAS,CA8LZ;AAYD,iFAAiF;AACjF,wBAAgB,cAAc,IAAI,sBAAsB,CAAC,UAAU,CAAC,CAEnE;AAED,qEAAqE;AACrE,wBAAgB,cAAc,IAAI,sBAAsB,CAAC,aAAa,CAAC,CAEtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAWvF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAWtE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CACzC,sBAAsB,EACtB,gBAAgB,GAAG,mBAAmB,CACvC,CAGA;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,IAAI;IAC1C,yBAAyB,EAAE,WAAW,CAAC,sBAAsB,CAAC,2BAA2B,CAAC,CAAC,CAAC;IAC5F,sBAAsB,EAAE,WAAW,CAAC,sBAAsB,CAAC,wBAAwB,CAAC,CAAC,CAAC;CACvF,CAWA;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,UAAU;IAChD,EAAE,EAAE,CAAC,CAAC;IACN,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IAChD,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,UAAU,EAAE,EAC5C,EAAE,EACF,MAAM,EACN,QAAQ,EACR,SAAS,EACT,YAAY,EAAE,SAAS,EACvB,cAAc,EAAE,WAAW,EAC3B,KAAK,EACL,KAAK,GACN,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CA0B7B"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/navigation/context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AAIf,OAAO,KAAK,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AA2B9E,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,sBAAsB,CAAC;IAC9B,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,SAAS,CAgCZ;AAED,wBAAgB,aAAa,IAAI,sBAAsB,CAQtD;AAED,iFAAiF;AACjF,wBAAgB,cAAc,IAAI,sBAAsB,CAAC,UAAU,CAAC,CAEnE;AAED,qEAAqE;AACrE,wBAAgB,cAAc,IAAI,sBAAsB,CAAC,aAAa,CAAC,CAEtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAWvF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAWtE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CACzC,sBAAsB,EACtB,gBAAgB,GAAG,mBAAmB,CACvC,CAGA;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,IAAI;IAC1C,yBAAyB,EAAE,WAAW,CAAC,sBAAsB,CAAC,2BAA2B,CAAC,CAAC,CAAC;IAC5F,sBAAsB,EAAE,WAAW,CAAC,sBAAsB,CAAC,wBAAwB,CAAC,CAAC,CAAC;CACvF,CAWA"}

package/dist/navigation/context.js

@@ -1,57 +1,9 @@
-import { createContext, createElement, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+import { createContext, createElement, useCallback, useContext, useEffect, useMemo, useRef, } from 'react';
+import { NavigationGuardRegistry } from './guard-registry';
+import { buildGuardedNavigation } from './guarded-navigation';
+import { useBackForwardGuard } from './use-back-forward-guard';
 /** Shell-provided navigation; no default, so use outside {@link NavigationProvider} throws. */
 const NavigationContext = createContext(null);
-/**
- * The guards active under one {@link NavigationProvider} — the single registry
- * every SDK-controlled navigation consults, so feature and plugin-page guards
- * compose against the same set. `run` stops at the first veto (at most one confirm
- * dialog); `subscribe` re-evaluates browser-level listeners when the armed set changes.
- */
-class NavigationGuardRegistry {
-    guards = new Set();
-    listeners = new Set();
-    /** Register a guard; returns the unregister function. */
-    add(entry) {
-        this.guards.add(entry);
-        this.emit();
-        return () => {
-            this.guards.delete(entry);
-            this.emit();
-        };
-    }
-    /** Notify subscribers that a guard's `when` may have changed. */
-    touch() {
-        this.emit();
-    }
-    subscribe(listener) {
-        this.listeners.add(listener);
-        return () => {
-            this.listeners.delete(listener);
-        };
-    }
-    hasArmedGuards() {
-        for (const entry of this.guards) {
-            if (entry.when)
-                return true;
-        }
-        return false;
-    }
-    /** Resolve `true` only if every armed guard allows the navigation. */
-    async run() {
-        for (const entry of this.guards) {
-            if (!entry.when)
-                continue;
-            const allowed = await entry.handler();
-            if (!allowed)
-                return false;
-        }
-        return true;
-    }
-    emit() {
-        for (const listener of this.listeners)
-            listener();
-    }
-}
 /**
  * Carries the provider's guard registry to {@link useNavigationGuard}. Separate from
  * {@link NavigationContext} so the shell-supplied value stays exactly the shell's
@@ -68,38 +20,6 @@ function useGuardRegistry() {
     }
     return registry;
 }
-/**
- * The `history.state` namespace under which the host stores per-history-entry plugin
- * state, keyed by pluginId. Shared, by literal contract, with the shell's
- * `createNavigation` (which WRITES the slot) and the plugin catch-all page (which
- * READS it) — this SDK layer only reconstructs it for the committed-entry mirror.
- */
-const ENTRY_STATE_KEY = 'studioPluginEntryState';
-/**
- * Reconstruct the `history.state` bag a guard-approved plugin navigation LANDS on, so
- * a subsequently vetoed Back restores the entry with the state it just wrote intact
- * rather than clobbering it with null. Mirrors the host's
- * `{ studioPluginEntryState: { [pluginId]: state } }` namespace. TanStack's own
- * `key`/`__TSR_*` keys are unobservable at this layer, so this is a best-effort bag —
- * no worse than the `null` it replaces for those keys, and correct for the plugin slot.
- */
-function reconstructEntryState(pluginId, state) {
-    return { [ENTRY_STATE_KEY]: { [pluginId]: state } };
-}
-/**
- * Merge one plugin's state slot into a prior `history.state` bag, preserving BOTH the
- * router's own keys and every other plugin's slot. Used to refresh the committed entry
- * after {@link NavigationContextValue.updatePluginEntryState}, so a later vetoed Back
- * restores the UPDATED slot instead of the pre-update one.
- */
-function mergeEntryState(prev, pluginId, state) {
-    const base = prev !== null && typeof prev === 'object' ? prev : {};
-    const priorSlot = base[ENTRY_STATE_KEY];
-    const priorBag = priorSlot !== null && typeof priorSlot === 'object'
-        ? priorSlot
-        : {};
-    return { ...base, [ENTRY_STATE_KEY]: { ...priorBag, [pluginId]: state } };
-}
 export function NavigationProvider({ value, children, }) {
     const registryRef = useRef(null);
     registryRef.current ??= new NavigationGuardRegistry();
@@ -108,171 +28,17 @@ export function NavigationProvider({ value, children, }) {
     // canceled back/forward restores to. URL changes made outside the SDK's navigate
     // entry points are unobservable by design at this layer.
     const committedRef = useRef(null);
-    // Mirror the registry's armed state into React so the browser listeners attach only
-    // while at least one guard is armed.
-    const [armed, setArmed] = useState(false);
-    useEffect(() => {
-        setArmed(registry.hasArmedGuards());
-        return registry.subscribe(() => {
-            setArmed(registry.hasArmedGuards());
-        });
-    }, [registry]);
-    useEffect(() => {
-        if (!armed)
-            return;
-        // The protected entry (URL + state); a back/forward landing elsewhere is first
-        // canceled back to here while the guard is consulted.
-        committedRef.current = { href: window.location.href, state: window.history.state };
-        // Set while replaying a guard-approved back/forward, so its `popstate` passes
-        // through instead of being re-intercepted.
-        let bypass = false;
-        // Latched while a decision is pending, so a second Back mid-decision keeps canceling
-        // without starting a concurrent `registry.run()` — one gesture, one dialog.
-        let pending = false;
-        // Restore pushes stacked for the pending decision, so an approved replay unwinds
-        // exactly that far in one `go(-depth)`. Reset per decision.
-        let restores = 0;
-        const onPopState = () => {
-            if (bypass) {
-                bypass = false;
-                committedRef.current = { href: window.location.href, state: window.history.state };
-                return;
-            }
-            if (!registry.hasArmedGuards()) {
-                committedRef.current = { href: window.location.href, state: window.history.state };
-                return;
-            }
-            const committed = committedRef.current;
-            if (committed === null)
-                return;
-            // Cancel the browser's move by pushing the committed entry on top of wherever it
-            // landed. popstate exposes no direction/distance and the router owns
-            // `history.state`, so restore can only push, not delete. A vetoed forward thus
-            // strands a stub entry — an accepted limit the next pushState truncates.
-            window.history.pushState(committed.state, '', committed.href);
-            restores += 1;
-            if (pending)
-                return;
-            pending = true;
-            void registry.run().then((allowed) => {
-                pending = false;
-                const depth = restores;
-                restores = 0;
-                if (!allowed)
-                    return;
-                bypass = true;
-                window.history.go(-depth);
-            });
-        };
-        const onBeforeUnload = (event) => {
-            event.preventDefault();
-            // Browsers below the floor (Chrome 108) gate the prompt on a set `returnValue`,
-            // not `preventDefault` alone; the string is ignored. Typed deprecated, still required.
-            // eslint-disable-next-line @typescript-eslint/no-deprecated -- required beforeunload trigger for the supported browser range.
-            event.returnValue = '';
-        };
-        window.addEventListener('popstate', onPopState);
-        window.addEventListener('beforeunload', onBeforeUnload);
-        return () => {
-            committedRef.current = null;
-            window.removeEventListener('popstate', onPopState);
-            window.removeEventListener('beforeunload', onBeforeUnload);
-        };
-    }, [armed, registry]);
+    useBackForwardGuard(registry, committedRef);
     // Wrap the shell's transitions so an armed guard is consulted before they commit.
     // With no guard armed the call stays synchronous — identical to the raw shell value.
-    const guarded = useMemo(() => {
-        // Forwarded as a REST tuple, so the shell's `navigate` is called with exactly
-        // the arguments the caller passed — a caller that wants the default history
-        // behaviour never turns into one that passed an explicit `undefined` for it.
-        const navigate = (...args) => {
-            const [token, search] = args;
-            if (!registry.hasArmedGuards()) {
-                value.navigate(...args);
-                return;
-            }
-            void registry.run().then((allowed) => {
-                if (!allowed)
-                    return;
-                value.navigate(...args);
-                // Advance the committed entry to the resolved destination (the router may commit
-                // async, so `window.location` would be stale). Its router state is unobservable
-                // here, hence `state: null`.
-                if (committedRef.current !== null) {
-                    committedRef.current = { href: value.resolvePath(token, search), state: null };
-                }
-            });
-        };
-        const navigatePlugin = (pluginId, pagePath, params, search) => {
-            if (!registry.hasArmedGuards()) {
-                value.navigatePlugin(pluginId, pagePath, params, search);
-                return;
-            }
-            void registry.run().then((allowed) => {
-                if (!allowed)
-                    return;
-                value.navigatePlugin(pluginId, pagePath, params, search);
-                if (committedRef.current !== null) {
-                    committedRef.current = {
-                        href: value.resolvePluginPath(pluginId, pagePath, params, search),
-                        state: null,
-                    };
-                }
-            });
-        };
-        const result = { ...value, navigate, navigatePlugin };
-        // navigatePluginWithOptions: guard-gated exactly like navigatePlugin (a veto never
-        // reaches the host member — no entry, no state). On approval, refresh the committed
-        // entry with the reconstructed state bag so a subsequent vetoed Back restores the
-        // slot this navigation just wrote, not null. Only wrapped when the host provides it;
-        // an older host leaves it undefined and the plugin-facing hook throws loudly.
-        const hostNavigateWithOptions = value.navigatePluginWithOptions;
-        if (hostNavigateWithOptions !== undefined) {
-            result.navigatePluginWithOptions = (pluginId, pagePath, params, search, options) => {
-                if (!registry.hasArmedGuards()) {
-                    hostNavigateWithOptions(pluginId, pagePath, params, search, options);
-                    return;
-                }
-                void registry.run().then((allowed) => {
-                    if (!allowed)
-                        return;
-                    hostNavigateWithOptions(pluginId, pagePath, params, search, options);
-                    if (committedRef.current !== null) {
-                        committedRef.current = {
-                            href: value.resolvePluginPath(pluginId, pagePath, params, search),
-                            state: options?.state !== undefined
-                                ? reconstructEntryState(pluginId, options.state)
-                                : null,
-                        };
-                    }
-                });
-            };
-        }
-        // updatePluginEntryState: guard-FREE — rewriting the current entry's state is not a
-        // navigation away, so no guard is consulted. But the SDK MUST wrap it to refresh the
-        // committed entry with the merged slot, so a later vetoed Back restores the UPDATED
-        // state rather than the pre-update one. URL is unchanged, so href is preserved.
-        const hostUpdateEntryState = value.updatePluginEntryState;
-        if (hostUpdateEntryState !== undefined) {
-            result.updatePluginEntryState = (pluginId, state) => {
-                hostUpdateEntryState(pluginId, state);
-                if (committedRef.current !== null) {
-                    committedRef.current = {
-                        href: committedRef.current.href,
-                        state: mergeEntryState(committedRef.current.state, pluginId, state),
-                    };
-                }
-            };
-        }
-        return result;
-    }, [value, registry]);
+    const guarded = useMemo(() => buildGuardedNavigation(value, registry, committedRef), [value, registry]);
     const commitHref = useCallback((href) => {
         if (committedRef.current !== null)
             committedRef.current = { href, state: null };
     }, []);
     return createElement(GuardRegistryContext.Provider, { value: registry }, createElement(CommitHrefContext.Provider, { value: commitHref }, createElement(NavigationContext.Provider, { value: guarded }, children)));
 }
-function useNavigation() {
+export function useNavigation() {
     const ctx = useContext(NavigationContext);
     if (ctx === null) {
         throw new Error('useNavigation must be used within a <NavigationProvider> (the shell provides it).');
@@ -357,30 +123,4 @@ export function usePluginEntryNavigation() {
     }
     return { navigatePluginWithOptions, updatePluginEntryState };
 }
-/**
- * A real anchor (so middle-click / open-in-new-tab keep working) that drives a
- * client-side transition on plain left-click. Modified clicks (new tab/window,
- * download) fall through to the browser's default handling.
- */
-export function AppLink({ to, search, children, className, 'aria-label': ariaLabel, 'aria-current': ariaCurrent, title, style, }) {
-    const { navigate, resolvePath } = useNavigation();
-    const href = resolvePath(to, search);
-    const onClick = useCallback((event) => {
-        if (event.defaultPrevented)
-            return;
-        if (event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey)
-            return;
-        event.preventDefault();
-        navigate(to, search);
-    }, [navigate, to, search]);
-    return createElement('a', {
-        href,
-        className,
-        'aria-label': ariaLabel,
-        'aria-current': ariaCurrent,
-        title,
-        style,
-        onClick,
-    }, children);
-}
 //# sourceMappingURL=context.js.map