carpenter_older library

Legacy Carpenter APIs bundled for incremental application migration.

Replaces package:carpenter_older/carpenter.dart without changing the legacy contracts. This library is intentionally separate from carpenter.dart: matching names in the two APIs refer to independent types and theme scopes. Use import prefixes when consuming both APIs in the same Dart library.

The legacy implementation remains part of Carpenter for gradual integration; this entrypoint does not deprecate or remove its APIs.

Classes

ActiveRouteController
Read and control the currently active route at the current level.
BaseStateManager
Base class for navigation state managers.
ByRouteEquality
Equality that compares RouteNodes by RouteNode.route only.
Carpenter
Visual runtime Carpenter.
CarpenterActionBar
Responsive container for page and collection actions.
CarpenterAdaptiveSplitLayout
Adaptive two/three-region layout with optional persisted split ratio.
CarpenterApp
Корневой виджет приложения Carpenter.
CarpenterAppFrame
Кроссплатформенный каркас приложения Carpenter.
CarpenterAsyncSearchField<T>
Complete searchable suggestion field.
CarpenterAttentionBlock
CarpenterAvatar
Avatar Carpenter.
CarpenterBlockGroup
Standard vertical composition for a group of structural or domain blocks.
CarpenterBlockingCommandEffect
CarpenterBlockList<T>
Standard vertically spaced list for structural and related page regions.
CarpenterBreadcrumb
Interactive item for page breadcrumbs.
CarpenterButton
Универсальная кнопка Carpenter.
CarpenterCard
Поверхность-контейнер Carpenter.
CarpenterCheckbox
Checkbox Carpenter.
CarpenterCollectionCancellation
Cancellation signal owned by a collection controller.
CarpenterCollectionControllerHost<T, TFilter, TSort, C extends CarpenterDataCollectionControllerBase<T, TFilter, TSort>>
Owns a collection controller lifecycle outside the domain page widget.
CarpenterCollectionDialog<T, TFilter, TSort>
Complete collection picker dialog with standard query, state, scrolling, empty/error presentation and actions.
CarpenterCollectionEmpty<T>
CarpenterCollectionFailure<T>
CarpenterCollectionGroupHeader
Adaptive header for one group inside a collection.
CarpenterCollectionInitialLoading<T>
CarpenterCollectionLoadingNext<T>
CarpenterCollectionLoadRequest
CarpenterCollectionPage<T, TFilter, TSort>
Standard page composition for collection scenarios.
CarpenterCollectionPartialFailure<T>
CarpenterCollectionQuery<TFilter, TSort>
CarpenterCollectionReady<T>
CarpenterCollectionSearchField<T, TFilter, TSort>
Search input whose debounce and query mutation are controller-owned.
CarpenterCollectionState<T>
CarpenterCollectionToolbar
Query/filter region pinned above the collection's own scrollable viewport.
CarpenterColor
Dynamic semantic colors visual runtime.
CarpenterColorConfig
Настройка color runtime.
CarpenterColorPicker
Непрозрачный RGB color picker с визуальной HSV-палитрой и HEX/RGB вводом.
CarpenterColorScale
Dynamic цветовая шкала с произвольными шагами.
CarpenterColorScaleConfig
Настройка одной цветовой шкалы.
CarpenterCommand<I>
CarpenterCommandBinding<I>
CarpenterCommandButton<I>
Renders one command as a button without creating a second action model.
CarpenterCommandController<I>
CarpenterCommandEffect
CarpenterCommandInputButton<I>
Renders a command whose input is collected from a dialog or another surface.
CarpenterCommandResult
CarpenterCommandScope
Exposes the commands available in the current page or block.
CarpenterCommandShortcutScope
Binds shortcut metadata of the same commands used by buttons and menus.
CarpenterCommandState
CarpenterConfig
Декларация входных параметров визуального runtime Carpenter.
CarpenterControl
Поведенческий primitive для интерактивных компонентов Carpenter.
CarpenterControllerHost<C extends ChangeNotifier>
Owns a small presentation/application controller outside a domain widget.
CarpenterControlState
Состояние интерактивного primitive CarpenterControl.
CarpenterCoreRuntime
Core capability Carpenter-приложения.
CarpenterDataCollection<T, TFilter, TSort>
Functional collection block with state, selection and pagination behavior.
CarpenterDataCollectionController<T, TFilter, TSort>
CarpenterDataCollectionControllerBase<T, TFilter, TSort>
A reusable controller adapter for domain-owned collection loading.
CarpenterDataGroup<T>
CarpenterDatePicker
Поле выбора календарной даты в визуальном языке Carpenter.
CarpenterDialog
CarpenterDialogCollectionBody
Standard body for async dialogs that contain one scrollable collection.
CarpenterDimension
Dynamic dimension visual runtime.
CarpenterDimensionConfig
Настройка размерного runtime.
CarpenterDomainWorkflowStage<TState, TContext>
Escape hatch for a genuinely domain-specific block, not a page layout.
CarpenterDropCapability<T>
CarpenterEditorConflict
CarpenterEditorController<TRecord>
CarpenterEditorControllerBase<TRecord>
CarpenterEditorForbidden
CarpenterEditorInitialLoading
CarpenterEditorPage<TRecord>
CarpenterEditorReady
CarpenterEditorSaved
CarpenterEditorSaveFailure
CarpenterEditorSaving
CarpenterEditorSection
CarpenterEditorState
CarpenterEditorValidating
CarpenterEditorValidationFailure
CarpenterEmptyState
CarpenterEmptyStateDescriptor
CarpenterEntityHeader
Semantic header for one domain entity.
CarpenterEntityLayout
CarpenterExpander
CarpenterExplorerPage
CarpenterFace
Публичное лицо visual runtime для компонентов.
CarpenterFieldBinding<T>
CarpenterFieldContext
CarpenterFieldDescriptor<TValue>
CarpenterFieldGroup
CarpenterFieldLabel
CarpenterFilterBar
Responsive region for query and filter controls.
CarpenterFilterControl
Standard width constraint for one query/filter control.
CarpenterFormField
Standard label, required marker, help and validation presentation.
CarpenterFormWorkflowStage<TState, TContext>
A workflow stage composed from fields. Carpenter owns the card, labels, vertical rhythm, scrolling and keyboard submission.
CarpenterFrameRuntime
Runtime capability app-frame shell-а.
CarpenterFrameShell
Shell, который подключает CarpenterAppFrame.
CarpenterHost
Независимый от app/router host визуального runtime и shell pipeline.
CarpenterHotkeyController
Контроллер состояния клавиатуры.
CarpenterHotkeyDisplay
Debug/help-панель hotkey-состояния.
CarpenterHotkeyFormatter
Форматтер hotkey-комбинаций под платформу.
CarpenterHotkeyIntent
Intent, который прокидывает выбранную Carpenter-команду в Actions.
CarpenterHotkeyRuntime
Runtime capability hotkey shell-а.
CarpenterHotkeyScope
Scope hotkey-системы Carpenter.
CarpenterHotkeyShell
Shell, который подключает CarpenterHotkeyScope и capability hotkeys.
CarpenterHotkeySnapshot
Снимок текущего состояния клавиатуры внутри Carpenter.
CarpenterIcon
Иконочный primitive Carpenter.
CarpenterIconButton
CarpenterIcons
Минимальный нейтральный набор glyph ids. Приложение может заменить его собственным icon font через отдельный компонентный adapter.
CarpenterIndeterminateProgress
CarpenterInput
Текстовое поле Carpenter.
CarpenterInspector
Recursive readable presentation for map/list payloads.
CarpenterInteractionOverlay
Standard full-surface interaction overlay with optional error notice.
CarpenterLayoutTab<T>
Текстовая ссылка Carpenter.
CarpenterListTile
CarpenterListTileDetails
Vertically composed subtitle and tags for collection rows.
CarpenterLoader
Круговой индикатор загрузки Carpenter.
CarpenterMemoryRestorationStore
Useful for tests, session restoration and storage adapters.
CarpenterModule
Независимый feature module Carpenter.
CarpenterModuleBase
Удобная база для модулей.
CarpenterMotion
Motion-токены visual runtime.
CarpenterNotice
CarpenterPage
Infrastructure host shared by every Carpenter page pattern.
CarpenterPageBlocking
CarpenterPageCapability
CarpenterPageController
Coordinates page infrastructure while domain state stays in domain code.
CarpenterPageControllerBase
Small controller suitable for pages that do not need a custom adapter.
CarpenterPageDescriptor
Compact, immutable metadata shared by the page infrastructure.
CarpenterPageEmpty
CarpenterPageFailure
CarpenterPageForbidden
CarpenterPageHeader
CarpenterPageInitialLoading
CarpenterPageLoadingBar
CarpenterPageReady
CarpenterPageRefreshing
A non-destructive refresh: the existing page body remains visible.
CarpenterPageRestorationController
Namespaced access to a replaceable restoration store.
CarpenterPageScope
Infrastructure available to every block inside a page.
CarpenterPageSection
Standard page section with optional collapse and section commands.
CarpenterPageState
CarpenterPageStateBoundary
Standard rendering of page-level infrastructure states.
CarpenterPageUnavailable
CarpenterPaginationBar
Standard page navigation and contextual selection message.
CarpenterPalette
Dynamic primitive palette visual runtime.
CarpenterPaletteConfig
Настройка primitive palette.
CarpenterPermissionRequirement
A resolved permission requirement.
CarpenterProgress
Линейный индикатор прогресса Carpenter.
CarpenterRadio<T>
Radio Carpenter.
CarpenterRecordDetail
CarpenterRecordDetails
CarpenterRecordMetric
One primary value in a record summary.
CarpenterRecordPage<T>
Standard page composition for viewing one domain record.
CarpenterRecordSection
CarpenterRecordSummary
Responsive summary of the most important record facts.
CarpenterRecordTab<T>
CarpenterRecordTabs<T>
A complete tabbed record region with standard spacing and content layout.
CarpenterRefreshCapability
CarpenterRefreshCommandEffect
CarpenterRelatedCollection
CarpenterResourceCancellation
CarpenterResourceController<T>
Owns the complete lifecycle of one asynchronously loaded record/resource.
CarpenterResourceControllerHost<T, C extends CarpenterResourceController<T>>
CarpenterResourceLoadRequest
CarpenterRestorationCapability
CarpenterRestorationKey<T>
A typed key within a page restoration namespace.
CarpenterRestorationPolicy
Describes how view state of a page should be restored.
CarpenterRestorationStore
CarpenterRoute
Декларация маршрута Carpenter.
CarpenterRouteContext
Контекст route builder-ов Carpenter.
CarpenterRouteInformationSync
CarpenterRouteMatch
Match одного yx node с Carpenter route declaration.
CarpenterRouteRenderer
Renderer, который превращает active route tree в Scope/Shell/Page widgets.
CarpenterRouterRuntime
Runtime capability router-а Carpenter.
CarpenterRouterShell
Shell, который подключает yx_navigation к runtime Carpenter.
CarpenterRuntime
Typed runtime registry Carpenter.
CarpenterRuntimeScope
Inherited scope для typed runtime registry.
CarpenterScope
InheritedWidget, который помещает visual runtime Carpenter в дерево Flutter.
CarpenterSearchCancellation
Cancellation owned by an asynchronous suggestion field.
CarpenterSectionLayout
CarpenterSegmentedOption<T>
Одна опция segmented radio.
CarpenterSegmentedRadio<T>
SegmentedRadio Carpenter.
CarpenterSelect<T>
CarpenterSelectableCollection<T>
Scrollable selectable records used by resolution/reconciliation dialogs.
CarpenterSelectionBar<T>
Standard actions shown while collection items are selected.
CarpenterSelectionController<T>
Selection behavior shared by collections and selection-aware page blocks.
CarpenterSelectionWorkflowStage<TState, TContext, TItem>
A workflow stage for choosing exactly one domain item.
CarpenterSelectItem<T>
CarpenterShell
Middleware-like shell Carpenter.
CarpenterShellBase
Удобная база для shell-ов без обязательного наследования в публичном API.
CarpenterShellBuildContext
Контекст shell на этапе widget wrapping.
CarpenterShellConfigureContext
Контекст shell на этапе конфигурации.
CarpenterSurfaceCloseScope
CarpenterSurfaceController
CarpenterSurfaceHost
Hosts transient application surfaces without taking ownership of routing. Side panels become full-page overlays below sidePanelBreakpoint.
CarpenterSurfaceScope
CarpenterSwitch
Switch Carpenter.
CarpenterTab<T>
CarpenterTable<T>
A declarative, client-side data table with configurable columns, search, per-column value filters and stable sorting.
CarpenterTableColumn<T>
CarpenterTabs<T>
CarpenterTabsLayout<T>
Local or externally navigated tabs. It never owns a router.
CarpenterTag
Компактная статусная метка Carpenter.
CarpenterText
Текстовый primitive Carpenter.
CarpenterTextFieldDescriptor
CarpenterTextFieldsDialog
Complete multi-text-field dialog with controller ownership in Carpenter.
CarpenterTextPromptDialog
Complete single-text-value dialog for notes, reasons and simple edits.
CarpenterTimeline
CarpenterTimelineItem
CarpenterToggleButton
CarpenterTopPanel
Верхняя панель приложения Carpenter.
CarpenterTopPanelContext
Контекст сборки верхней панели app-frame.
CarpenterTrailingActions
Compact trailing action cluster for collection rows.
CarpenterType
Dynamic typography visual runtime.
CarpenterTypeConfig
Настройка typography runtime.
CarpenterValidationResult
CarpenterValidationSummary
CarpenterWorkflowController<TState, TContext>
CarpenterWorkflowControllerBase<TState, TContext>
CarpenterWorkflowDelegateController<TState, TContext>
Bridges a domain-owned state machine into the Carpenter workflow renderer.
CarpenterWorkflowPage<TState, TContext>
CarpenterWorkflowStage<TState, TContext>
CarpenterWorkflowTransition<TState, TContext>
CompositeDeeplinkHandler
Composite handler that combines multiple DeeplinkHandlers.
DeeplinkHandler
Interface for deeplink handling.
DeeplinkHandlerHandledResult
Result indicating that the deeplink was handled without navigation.
DeeplinkHandlerNavigateResult
Result indicating that navigation is required.
DeeplinkHandlerResult
Result of processing a deeplink.
DeeplinkHandlerStrategy
Strategy for iterating through multiple deeplink handlers.
DeepRouteNodeEquality
Equality that recursively compares RouteNodes including their RouteNode.children.
FifoDeeplinkHandlerStrategy
FIFO strategy: handlers are called in registration order.
FullRouteNodeResolver
Resolves a RouteNode by matching both YxRoute identity and RouteNode.arguments.
GuardConfiguration
A composite RouteNodeGuard that runs a pipeline of guards in order.
GuardContext
A shared scratch space passed through the guard pipeline.
GuardObserver
Hooks into the lifecycle of the RouteNodeGuard pipeline.
GuardResult
The outcome of a RouteNodeGuard invocation.
GuardResultCancel
Signals that the mutation should be cancelled.
GuardResultNext
Signals that the mutation should continue to the next guard.
GuardResultRedirect
Signals that the mutation should be redirected to a different target.
GuardSync
A broadcast sink used to re-trigger the guard pipeline on demand.
GuardSyncReason
Describes why guards should re-evaluate the current navigation state.
InitializeSchemaNodeGuard
LateInitGuardConfiguration
A GuardConfiguration that accepts additional guards after construction.
LateInitRouteNodeGuard
A RouteNodeGuard whose contributing guards are registered after construction.
LifoDeeplinkHandlerStrategy
LIFO strategy: handlers are called in reverse registration order.
MutableRouteNode
Mutable flavour of RouteNode.
Mutation
Describes a single transition of the navigation tree.
Keeps an IndexedStack parent node aligned with a fixed set of tab routes: every declared route appears exactly once as a child, order may change (for example when ActiveRouteController reorders tabs), and arguments, extra, and nested child state on existing nodes are kept when nodes are added or removed.
The main entry point for reading and changing the navigation tree.
PlatformStateSerialization
A way to transform platform route state (URL from browser, deeplink, etc) into a RouteNode and back.
PrettyUriStateSerialization
Converts the given RouteNode into a Uri string and back.
RedirectRouteNodeGuard
A guard that detects and breaks infinite redirect loops.
RouteAndArgumentsAndExtraEquality
Equality that compares RouteNodes by RouteNode.route, RouteNode.arguments and RouteNode.extra.
RouteAndArgumentsEquality
Equality that compares RouteNodes by both RouteNode.route and RouteNode.arguments.
RouteIDNodeResolver
Resolves a RouteNode by matching YxRoute identity only.
RouteMutator
Low level interface for applying arbitrary mutations to the route tree.
RouteNavigator
High level navigation operations over the current route tree.
RouteNode
A node in the navigation tree.
RouteNodeComparator
Comparison helpers for RouteNode instances.
RouteNodeDiffResult
Describes the difference between two RouteNode trees.
RouteNodeEquality
Strategy for comparing two RouteNode instances for equality.
RouteNodeGuard
A guard that is invoked on every mutation of the navigation tree.
RouteNodeReadable
Read-only access to the current RouteNode and its updates.
RouteNodeResolver
Locates a RouteNode inside a tree rooted at another node.
RouteNodeStateManager
The primary state manager that holds the current navigation tree and coordinates every mutation.
RouteObserverAdapter
SquidFragmentBasedSerializer
Fragment-based serializer for navigation state.
SquidPathBasedSerializer
Path-based serializer for navigation state.
StateManagerDiffObserver
A StateManagerObserver that forwards each mutation to a list of YxRouteObservers along with the computed diff between the original and target trees.
StateManagerObserver
Hooks into the lifecycle of a BaseStateManager.
StrictHierarchyGuard
Validates that children of a given parent route stay within an explicit allow-list of child routes.
UriStringStateSerialization
Converts the given RouteNode into a Uri string and back.
YxRoute
Stable identity of a route within the navigation tree.
YxRouteObserver
Observes push, pop and update operations that affect a specific route.

Enums

CarpenterButtonColor
Semantic color family кнопки.
CarpenterButtonSize
Размер кнопки.
CarpenterButtonType
Визуальный тип кнопки.
CarpenterCollectionLoadReason
CarpenterCommandExecution
CarpenterCommandPresentation
CarpenterCommandVisibility
CarpenterEditorMode
CarpenterEmptyStateKind
CarpenterFramePlatform
Класс платформы для app-frame Carpenter.
CarpenterHotkeyPhase
Фаза последнего события клавиатуры.
CarpenterIconTone
Семантический цвет иконки Carpenter.
CarpenterLoadingPresentation
CarpenterNoticeTone
CarpenterPageKind
The user scenario represented by a page.
CarpenterPageLoadingPresentation
Legacy loading presentation used by the compatibility API.
CarpenterResourceLoadReason
CarpenterRestorationLifetime
Persistence lifetime for page view state.
CarpenterSelectionMode
CarpenterSplitNarrowRegion
CarpenterSurfaceKind
CarpenterTabsOrientation
CarpenterTagTone
Семантический тон tag-компонента.
CarpenterTextTone
Семантический цвет текста Carpenter.
CarpenterTextVariant
Роль текста в визуальном языке Carpenter.
UriStrategy
Strategy for placing serialized navigation state in URL.

Extensions

CarpenterCommandPlatformShortcuts on CarpenterCommand
CarpenterContext on BuildContext
Доступ к visual runtime Carpenter из BuildContext.
CarpenterCoreRuntimeAccess on CarpenterRuntime
Typed access к core capability.
CarpenterFrameRuntimeAccess on CarpenterRuntime
Typed access к frame capability.
CarpenterHotkeyRuntimeAccess on CarpenterRuntime
Typed access к hotkey capability.
CarpenterPageBuildContext on BuildContext
CarpenterRouterRuntimeAccess on CarpenterRuntime
Typed access к router capability.
CarpenterRuntimeBuildContext on BuildContext
Доступ к Carpenter runtime registry из Flutter context.
CarpenterSurfaceBuildContext on BuildContext
RouteExtension on YxRoute
Convenience helpers for turning a YxRoute into a RouteNode.

Constants

carpenterDefaultColorSteps → const List<String>
Дефолтные шаги generated palette.

Functions

carpenterFormatRgbHex(Color color) String
carpenterParseRgbColor(String source) Color?
Разбирает #RGB, RGB, #RRGGBB или RRGGBB в непрозрачный цвет.
showCarpenterDialog<T>({required BuildContext context, required WidgetBuilder builder, bool barrierDismissible = true}) Future<T?>

Typedefs

CarpenterAppBuilder = Widget Function(BuildContext context, Widget child)
Builder содержимого CarpenterApp.
CarpenterCollectionControllerFactory<T, TFilter, TSort, C extends CarpenterDataCollectionControllerBase<T, TFilter, TSort>> = C Function(BuildContext context)
CarpenterCommandInputBuilder<I> = Future<I?> Function(BuildContext context)
CarpenterControlBuilder = Widget Function(BuildContext context, CarpenterControlState state)
Builder интерактивного primitive.
CarpenterControllerFactory<C extends ChangeNotifier> = C Function(BuildContext context)
CarpenterDataCollectionItemBuilder<T> = Widget Function(BuildContext context, T item, bool selected)
CarpenterHostBuilder = Widget Function(BuildContext context, Widget child)
Builder содержимого, уже помещенного в Carpenter scope/runtime.
CarpenterHotkeyCommand = CarpenterCommandController<void>
Transitional source-compatible name for the unified command model.
CarpenterHotkeyCommandCallback = void Function(CarpenterCommand<void> command)
Callback выполнения hotkey-команды.
CarpenterInspectorFieldFilter = bool Function(String key, Object? value)
CarpenterInspectorLabelBuilder = String Function(String key)
CarpenterInspectorScalarBuilder = String Function(Object? value)
CarpenterPageSurfaceOpener = Future<Object?> Function(Object destination)
CarpenterRadius = CarpenterDimension
Старое имя радиусной шкалы.
CarpenterResourceControllerFactory<T, C extends CarpenterResourceController<T>> = C Function(BuildContext context)
CarpenterResourceLoader<T> = Future<T> Function(CarpenterResourceLoadRequest request)
CarpenterRoutePageBuilder = Widget Function(CarpenterRouteContext context)
Page builder terminal route.
CarpenterRouteScopeBuilder = Widget Function(CarpenterRouteContext context, Widget child)
Scope builder route-уровня.
CarpenterRouteShellBuilder = Widget Function(CarpenterRouteContext context, Widget child)
Shell builder route-уровня.
CarpenterRouteTreeParser = RouteNode Function(Uri uri)
CarpenterRouteTreeSerializer = Uri Function(RouteNode? node)
CarpenterRuntimeHotkeyCommandCallback = void Function(CarpenterRuntime runtime, CarpenterCommand<void> command)
Callback команды hotkey с доступом к typed runtime.
CarpenterSemanticColorResolver = Map<String, Color> Function(CarpenterPalette palette, Brightness brightness)
Resolver semantic color registry из primitive palette.
CarpenterSuggestionLoader<T> = Future<List<T>> Function(String query, CarpenterSearchCancellation cancellation)
CarpenterTableCellBuilder<T> = Widget Function(BuildContext context, T item)
CarpenterTableValue<T> = Object? Function(T item)
CarpenterTopPanelBuilder = Widget Function(BuildContext context, CarpenterTopPanelContext panel)
Builder верхней панели app-frame.
InitialRouteNodeBuilder = RouteNode Function(MutableRouteNode node)
MutateNodeCallback = RouteNode Function(MutableRouteNode routeNode)
Callback that applies a mutation to a MutableRouteNode and returns the resulting node.
PopRouteMutationCallback = void Function(RouteNode origin, RouteNode target)
Signature for a callback invoked when a route is popped off the tree.
PushRouteMutationCallback = void Function(RouteNode origin, RouteNode target)
Signature for a callback invoked when a route is pushed onto the tree.
RouteNodeAction<N extends RouteNode> = bool Function(N routeNode)
Signature for callbacks invoked during RouteNode traversal.
RouteNodePredicate<N extends RouteNode> = bool Function(N routeNode)
Signature used to filter RouteNode instances during traversal and lookup operations.
SquidSerializer = SquidFragmentBasedSerializer
Deprecated: Use SquidFragmentBasedSerializer instead.
UpdateRouteMutationCallback = void Function(RouteNode origin, RouteNode target)
Signature for a callback invoked when an existing route is updated.