@nikkory/vibe-engine 4.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/PUBLISH-GUIDE.md +250 -0
- package/README.md +1267 -0
- package/bin/vibe.js +22 -0
- package/dist/adapters/index.d.ts +19 -0
- package/dist/browser.d.ts +25 -0
- package/dist/browser.js +15083 -0
- package/dist/browser.mjs +15000 -0
- package/dist/cli/batch-command.d.ts +142 -0
- package/dist/cli/generate-command.d.ts +119 -0
- package/dist/cli/index.d.ts +34 -0
- package/dist/constants/ComponentTypes.d.ts +65 -0
- package/dist/constants/DesignSystems.d.ts +64 -0
- package/dist/constants/Frameworks.d.ts +71 -0
- package/dist/constants/Tiers.d.ts +72 -0
- package/dist/constants/index.d.ts +10 -0
- package/dist/converters/index.d.ts +12 -0
- package/dist/converters/section-converter.d.ts +176 -0
- package/dist/index.d.ts +58 -0
- package/dist/index.js +19819 -0
- package/dist/index.mjs +19496 -0
- package/dist/resolution/basic/groups-basic.d.ts +80 -0
- package/dist/resolution/basic/index.d.ts +21 -0
- package/dist/resolution/basic/intents-basic.d.ts +195 -0
- package/dist/resolution/basic/presets-basic.d.ts +96 -0
- package/dist/resolution/basic/resolver-basic.d.ts +127 -0
- package/dist/resolution/basic/shorthands-basic.d.ts +88 -0
- package/dist/resolution/core/groups-core.d.ts +160 -0
- package/dist/resolution/core/index.d.ts +21 -0
- package/dist/resolution/core/intents-core.d.ts +355 -0
- package/dist/resolution/core/presets-core.d.ts +160 -0
- package/dist/resolution/core/resolver-core.d.ts +207 -0
- package/dist/resolution/core/shorthands-core.d.ts +144 -0
- package/dist/resolution/core/types-core.d.ts +167 -0
- package/dist/resolution/debugger.d.ts +183 -0
- package/dist/resolution/demo.d.ts +57 -0
- package/dist/resolution/enterprise/index.d.ts +22 -0
- package/dist/resolution/enterprise/metrics.d.ts +152 -0
- package/dist/resolution/enterprise/resolver-enterprise.d.ts +108 -0
- package/dist/resolution/examples.d.ts +486 -0
- package/dist/resolution/groups/experience-group.d.ts +197 -0
- package/dist/resolution/groups/index.d.ts +196 -0
- package/dist/resolution/groups/layout-group.d.ts +192 -0
- package/dist/resolution/groups/motion-group.d.ts +127 -0
- package/dist/resolution/groups/visual-group.d.ts +146 -0
- package/dist/resolution/index.d.ts +41 -0
- package/dist/resolution/intents/button-intents.d.ts +231 -0
- package/dist/resolution/intents/card-intents.d.ts +177 -0
- package/dist/resolution/intents/feedback-intents.d.ts +222 -0
- package/dist/resolution/intents/index.d.ts +189 -0
- package/dist/resolution/intents/input-intents.d.ts +231 -0
- package/dist/resolution/intents/mood-modifiers.d.ts +154 -0
- package/dist/resolution/performance.d.ts +264 -0
- package/dist/resolution/presets/button-presets.d.ts +243 -0
- package/dist/resolution/presets/card-presets.d.ts +216 -0
- package/dist/resolution/presets/data-display-presets.d.ts +290 -0
- package/dist/resolution/presets/feedback-presets.d.ts +335 -0
- package/dist/resolution/presets/form-presets.d.ts +308 -0
- package/dist/resolution/presets/index.d.ts +22 -0
- package/dist/resolution/presets/input-presets.d.ts +207 -0
- package/dist/resolution/presets/nav-presets.d.ts +235 -0
- package/dist/resolution/presets/overlay-presets.d.ts +216 -0
- package/dist/resolution/presets/preset-registry.d.ts +212 -0
- package/dist/resolution/resolveProps.d.ts +235 -0
- package/dist/resolution/shorthand/feel-mappings.d.ts +140 -0
- package/dist/resolution/shorthand/index.d.ts +172 -0
- package/dist/resolution/shorthand/look-mappings.d.ts +107 -0
- package/dist/resolution/shorthand/spacing-mappings.d.ts +164 -0
- package/dist/resolution/shorthand/surface-mappings.d.ts +139 -0
- package/dist/resolution/standard/groups-standard.d.ts +98 -0
- package/dist/resolution/standard/index.d.ts +28 -0
- package/dist/resolution/standard/intents-standard.d.ts +232 -0
- package/dist/resolution/standard/presets-standard.d.ts +123 -0
- package/dist/resolution/standard/resolver-standard.d.ts +204 -0
- package/dist/resolution/standard/shorthands-standard.d.ts +98 -0
- package/dist/resolution/standard/validators.d.ts +141 -0
- package/dist/resolution/types.d.ts +461 -0
- package/dist/resolution/validators/factor24-validator.d.ts +418 -0
- package/dist/resolution/validators/index.d.ts +14 -0
- package/dist/scripts/generate-react-library.d.ts +15 -0
- package/dist/scripts/write-react-library.d.ts +18 -0
- package/dist/storage/cloud-sync.d.ts +182 -0
- package/dist/storage/index.d.ts +69 -0
- package/dist/storage/local-storage.d.ts +131 -0
- package/dist/storage/section-storage.d.ts +191 -0
- package/dist/styling/StyleGenerator.d.ts +76 -0
- package/dist/styling/TokenStyleResolver.d.ts +163 -0
- package/dist/styling/factor-migration.d.ts +192 -0
- package/dist/styling/factor-validators.d.ts +327 -0
- package/dist/styling/factors-1-6.d.ts +674 -0
- package/dist/styling/factors-12-16.d.ts +700 -0
- package/dist/styling/factors-17-24.d.ts +668 -0
- package/dist/styling/factors-all.d.ts +348 -0
- package/dist/styling/factors.d.ts +291 -0
- package/dist/styling/index.d.ts +31 -0
- package/dist/styling/types.d.ts +400 -0
- package/dist/tokens/schema.d.ts +486 -0
- package/dist/types/Option.d.ts +178 -0
- package/dist/types/Result.d.ts +148 -0
- package/dist/types/algorithm-engine.types.d.ts +298 -0
- package/dist/types/granularity/base.types.d.ts +268 -0
- package/dist/types/granularity/config.types.d.ts +177 -0
- package/dist/types/granularity/factors.types.d.ts +194 -0
- package/dist/types/granularity/index.d.ts +57 -0
- package/dist/types/granularity/slot.types.d.ts +128 -0
- package/dist/types/granularity/template.types.d.ts +179 -0
- package/dist/types/granularity-levels/atom.config.d.ts +151 -0
- package/dist/types/granularity-levels/component.config.d.ts +175 -0
- package/dist/types/granularity-levels/index.d.ts +47 -0
- package/dist/types/granularity-levels/layout.config.d.ts +278 -0
- package/dist/types/granularity-levels/page.config.d.ts +210 -0
- package/dist/types/granularity-levels/section.config.d.ts +188 -0
- package/dist/types/granularity-levels/template.config.d.ts +340 -0
- package/dist/types/index.d.ts +152 -0
- package/dist/types/section-slot.types.d.ts +169 -0
- package/dist/types/section-storage.types.d.ts +298 -0
- package/dist/types/section-template.types.d.ts +170 -0
- package/dist/types/section.types.d.ts +326 -0
- package/dist/ui-studio/ComponentGenerator.d.ts +219 -0
- package/dist/ui-studio/composition/FactorPropagator.d.ts +268 -0
- package/dist/ui-studio/composition/PageGenerator.d.ts +176 -0
- package/dist/ui-studio/composition/SectionGenerator.d.ts +312 -0
- package/dist/ui-studio/composition/SlotResolver.d.ts +295 -0
- package/dist/ui-studio/composition/section-orchestrator.d.ts +306 -0
- package/dist/ui-studio/granularity/FactorCascade.d.ts +328 -0
- package/dist/ui-studio/granularity/GranularityGenerator.d.ts +266 -0
- package/dist/ui-studio/granularity/RecursiveGenerator.d.ts +328 -0
- package/dist/ui-studio/index.d.ts +94 -0
- package/dist/ui-studio/matrix/ClassMapper.d.ts +128 -0
- package/dist/ui-studio/matrix/MatrixResolver.d.ts +203 -0
- package/dist/ui-studio/matrix/types.d.ts +96 -0
- package/dist/ui-studio/presets/IndustryDetector.d.ts +183 -0
- package/dist/ui-studio/presets/component-registry.d.ts +213 -0
- package/dist/ui-studio/presets/factor-registry.d.ts +364 -0
- package/dist/ui-studio/presets/granularity-registry.d.ts +252 -0
- package/dist/ui-studio/presets/index.d.ts +32 -0
- package/dist/ui-studio/presets/industries.d.ts +143 -0
- package/dist/ui-studio/presets/layout-registry.d.ts +21 -0
- package/dist/ui-studio/presets/matrix-groups.d.ts +195 -0
- package/dist/ui-studio/presets/page-registry.d.ts +24 -0
- package/dist/ui-studio/presets/registry.constants.d.ts +69 -0
- package/dist/ui-studio/presets/registry.types.d.ts +166 -0
- package/dist/ui-studio/presets/section-defaults.d.ts +175 -0
- package/dist/ui-studio/presets/section-registry.d.ts +83 -0
- package/dist/ui-studio/presets/section-registry.defaults.d.ts +106 -0
- package/dist/ui-studio/presets/section-registry.helpers.d.ts +112 -0
- package/dist/ui-studio/presets/section-registry.types.d.ts +181 -0
- package/dist/ui-studio/presets/template-registry.d.ts +23 -0
- package/dist/ui-studio/presets/variants.d.ts +1038 -0
- package/dist/ui-studio/registries/components-registry.d.ts +193 -0
- package/dist/ui-studio/registries/design-systems-registry.d.ts +153 -0
- package/dist/ui-studio/registries/factors-registry.d.ts +145 -0
- package/dist/ui-studio/registries/tiers-registry.d.ts +150 -0
- package/dist/ui-studio/resolution/FactorResolver.d.ts +201 -0
- package/dist/ui-studio/templates/TestGenerator.d.ts +55 -0
- package/dist/ui-studio/templates/TierGenerator.d.ts +153 -0
- package/dist/ui-studio/templates/TypesGenerator.d.ts +51 -0
- package/dist/ui-studio/types/granularity/base.types.d.ts +268 -0
- package/dist/ui-studio/types/granularity/config.types.d.ts +177 -0
- package/dist/ui-studio/types/granularity/factors.types.d.ts +194 -0
- package/dist/ui-studio/types/granularity/index.d.ts +57 -0
- package/dist/ui-studio/types/granularity/slot.types.d.ts +128 -0
- package/dist/ui-studio/types/granularity/template.types.d.ts +179 -0
- package/dist/ui-studio/types/granularity-levels/atom.config.d.ts +151 -0
- package/dist/ui-studio/types/granularity-levels/component.config.d.ts +175 -0
- package/dist/ui-studio/types/granularity-levels/index.d.ts +47 -0
- package/dist/ui-studio/types/granularity-levels/layout.config.d.ts +278 -0
- package/dist/ui-studio/types/granularity-levels/page.config.d.ts +210 -0
- package/dist/ui-studio/types/granularity-levels/section.config.d.ts +188 -0
- package/dist/ui-studio/types/granularity-levels/template.config.d.ts +340 -0
- package/dist/ui-studio/types.d.ts +323 -0
- package/dist/utils/CodeUtils.d.ts +103 -0
- package/dist/utils/GenerateComponentValidator.d.ts +35 -0
- package/dist/utils/Logger.d.ts +101 -0
- package/dist/utils/StringUtils.d.ts +120 -0
- package/dist/utils/ValidationUtils.d.ts +71 -0
- package/dist/utils/errors/BaseError.d.ts +23 -0
- package/dist/utils/errors/GenerationError.d.ts +14 -0
- package/dist/utils/errors/TemplateNotFoundError.d.ts +13 -0
- package/dist/utils/errors/ValidationError.d.ts +13 -0
- package/dist/utils/errors/index.d.ts +12 -0
- package/dist/utils/factor-resolver.d.ts +294 -0
- package/dist/utils/granularity-helpers.d.ts +359 -0
- package/dist/utils/index.d.ts +20 -0
- package/dist/utils/performance.d.ts +26 -0
- package/dist/utils/stringify.d.ts +28 -0
- package/dist/validators/component-validator.d.ts +86 -0
- package/dist/validators/design-system-validator.d.ts +95 -0
- package/dist/validators/factor-validator.d.ts +101 -0
- package/dist/validators/index.d.ts +263 -0
- package/dist/validators/section-validator.d.ts +120 -0
- package/dist/validators/slot-validator.d.ts +161 -0
- package/dist/validators/tier-validator.d.ts +102 -0
- package/package.json +67 -0
- package/tests/16-factor-integration.test.d.ts +14 -0
- package/tests/16-factor-visual.test.d.ts +14 -0
- package/tests/5-level-integration.test.d.ts +14 -0
- package/tests/CodeUtils.test.d.ts +7 -0
- package/tests/DesignSystems.test.d.ts +7 -0
- package/tests/GenerateComponentValidator.test.d.ts +7 -0
- package/tests/Logger.test.d.ts +7 -0
- package/tests/StringUtils.test.d.ts +7 -0
- package/tests/StyleGenerator.test.d.ts +13 -0
- package/tests/Tiers.test.d.ts +7 -0
- package/tests/TokenRegistry.test.d.ts +14 -0
- package/tests/TokenStyleResolver.test.d.ts +13 -0
- package/tests/ValidationUtils.test.d.ts +7 -0
- package/tests/_pending_fix/Accordion.test.d.ts +13 -0
- package/tests/_pending_fix/Alert.test.d.ts +13 -0
- package/tests/_pending_fix/AlertDialog.test.d.ts +13 -0
- package/tests/_pending_fix/AspectRatio.test.d.ts +13 -0
- package/tests/_pending_fix/Autocomplete.test.d.ts +13 -0
- package/tests/_pending_fix/Avatar.test.d.ts +13 -0
- package/tests/_pending_fix/Badge.test.d.ts +13 -0
- package/tests/_pending_fix/Banner.test.d.ts +13 -0
- package/tests/_pending_fix/Box.test.d.ts +13 -0
- package/tests/_pending_fix/Breadcrumb.test.d.ts +13 -0
- package/tests/_pending_fix/Callout.test.d.ts +13 -0
- package/tests/_pending_fix/Card.test.d.ts +13 -0
- package/tests/_pending_fix/Center.test.d.ts +13 -0
- package/tests/_pending_fix/Checkbox.test.d.ts +13 -0
- package/tests/_pending_fix/Chip.test.d.ts +13 -0
- package/tests/_pending_fix/ColorPicker.test.d.ts +13 -0
- package/tests/_pending_fix/Combobox.test.d.ts +13 -0
- package/tests/_pending_fix/CommandPalette.test.d.ts +13 -0
- package/tests/_pending_fix/ConfirmationModal.test.d.ts +13 -0
- package/tests/_pending_fix/Container.test.d.ts +13 -0
- package/tests/_pending_fix/DataTable.test.d.ts +13 -0
- package/tests/_pending_fix/DatePicker.test.d.ts +13 -0
- package/tests/_pending_fix/DateRangePicker.test.d.ts +13 -0
- package/tests/_pending_fix/DateTimePicker.test.d.ts +13 -0
- package/tests/_pending_fix/Divider.test.d.ts +13 -0
- package/tests/_pending_fix/Drawer.test.d.ts +13 -0
- package/tests/_pending_fix/Dropdown.test.d.ts +13 -0
- package/tests/_pending_fix/EmptyState.test.d.ts +13 -0
- package/tests/_pending_fix/ErrorState.test.d.ts +13 -0
- package/tests/_pending_fix/FileDropzone.test.d.ts +13 -0
- package/tests/_pending_fix/FileUpload.test.d.ts +13 -0
- package/tests/_pending_fix/Flex.test.d.ts +13 -0
- package/tests/_pending_fix/Grid.test.d.ts +13 -0
- package/tests/_pending_fix/GridItem.test.d.ts +13 -0
- package/tests/_pending_fix/HStack.test.d.ts +13 -0
- package/tests/_pending_fix/Input.test.d.ts +13 -0
- package/tests/_pending_fix/InputCurrency.test.d.ts +13 -0
- package/tests/_pending_fix/InputGroup.test.d.ts +13 -0
- package/tests/_pending_fix/InputOTP.test.d.ts +13 -0
- package/tests/_pending_fix/InputPassword.test.d.ts +13 -0
- package/tests/_pending_fix/InputPhone.test.d.ts +13 -0
- package/tests/_pending_fix/InputSearch.test.d.ts +13 -0
- package/tests/_pending_fix/Link.test.d.ts +13 -0
- package/tests/_pending_fix/List.test.d.ts +13 -0
- package/tests/_pending_fix/LoadingOverlay.test.d.ts +13 -0
- package/tests/_pending_fix/Menu.test.d.ts +13 -0
- package/tests/_pending_fix/Modal.test.d.ts +13 -0
- package/tests/_pending_fix/MultiSelect.test.d.ts +13 -0
- package/tests/_pending_fix/NavGroup.test.d.ts +13 -0
- package/tests/_pending_fix/NavItem.test.d.ts +13 -0
- package/tests/_pending_fix/NavLink.test.d.ts +13 -0
- package/tests/_pending_fix/Navbar.test.d.ts +13 -0
- package/tests/_pending_fix/Notification.test.d.ts +13 -0
- package/tests/_pending_fix/NotificationBadge.test.d.ts +13 -0
- package/tests/_pending_fix/NumberInput.test.d.ts +13 -0
- package/tests/_pending_fix/Pagination.test.d.ts +13 -0
- package/tests/_pending_fix/Popover.test.d.ts +13 -0
- package/tests/_pending_fix/Progress.test.d.ts +13 -0
- package/tests/_pending_fix/ProgressCircle.test.d.ts +13 -0
- package/tests/_pending_fix/ProgressSteps.test.d.ts +13 -0
- package/tests/_pending_fix/Radio.test.d.ts +13 -0
- package/tests/_pending_fix/RangeSlider.test.d.ts +13 -0
- package/tests/_pending_fix/ResizablePanel.test.d.ts +13 -0
- package/tests/_pending_fix/ResultState.test.d.ts +13 -0
- package/tests/_pending_fix/ScrollArea.test.d.ts +13 -0
- package/tests/_pending_fix/Select.test.d.ts +14 -0
- package/tests/_pending_fix/Sheet.test.d.ts +13 -0
- package/tests/_pending_fix/Sidebar.test.d.ts +13 -0
- package/tests/_pending_fix/SimpleGrid.test.d.ts +13 -0
- package/tests/_pending_fix/Skeleton.test.d.ts +13 -0
- package/tests/_pending_fix/Slider.test.d.ts +13 -0
- package/tests/_pending_fix/Spacer.test.d.ts +13 -0
- package/tests/_pending_fix/Spinner.test.d.ts +13 -0
- package/tests/_pending_fix/Stack.test.d.ts +13 -0
- package/tests/_pending_fix/Stat.test.d.ts +13 -0
- package/tests/_pending_fix/Stepper.test.d.ts +14 -0
- package/tests/_pending_fix/Switch.test.d.ts +13 -0
- package/tests/_pending_fix/Table.test.d.ts +13 -0
- package/tests/_pending_fix/Tabs.test.d.ts +13 -0
- package/tests/_pending_fix/Textarea.test.d.ts +13 -0
- package/tests/_pending_fix/Timeline.test.d.ts +13 -0
- package/tests/_pending_fix/Toast.test.d.ts +14 -0
- package/tests/_pending_fix/Tooltip.test.d.ts +14 -0
- package/tests/_pending_fix/VStack.test.d.ts +13 -0
- package/tests/alert.test.d.ts +13 -0
- package/tests/badge.test.d.ts +13 -0
- package/tests/benchmarks/factor-resolution.bench.d.ts +41 -0
- package/tests/button.test.d.ts +16 -0
- package/tests/card.test.d.ts +19 -0
- package/tests/checkbox.test.d.ts +13 -0
- package/tests/component-16-factor-types.test.d.ts +13 -0
- package/tests/component-5level-integration.test.d.ts +14 -0
- package/tests/component-registry-ui.test.d.ts +13 -0
- package/tests/e2e/16-factor-visual.test.d.ts +14 -0
- package/tests/edge-cases.test.d.ts +14 -0
- package/tests/factor-17-24-integration.test.d.ts +14 -0
- package/tests/factor-17-24-performance.test.d.ts +14 -0
- package/tests/factor-validators.test.d.ts +13 -0
- package/tests/factors-1-6.test.d.ts +13 -0
- package/tests/factors-12-16.test.d.ts +13 -0
- package/tests/factors-17-24.test.d.ts +21 -0
- package/tests/factors-all.test.d.ts +13 -0
- package/tests/factors-registry.test.d.ts +11 -0
- package/tests/factors.test.d.ts +13 -0
- package/tests/granularity-types.test.d.ts +18 -0
- package/tests/groups.test.d.ts +14 -0
- package/tests/input.test.d.ts +16 -0
- package/tests/intents.test.d.ts +14 -0
- package/tests/memory-leak.test.d.ts +14 -0
- package/tests/modal.test.d.ts +19 -0
- package/tests/presets.test.d.ts +14 -0
- package/tests/radio.test.d.ts +13 -0
- package/tests/resolution-intents.test.d.ts +13 -0
- package/tests/resolution-presets.test.d.ts +13 -0
- package/tests/resolveProps.test.d.ts +14 -0
- package/tests/section-integration.test.d.ts +16 -0
- package/tests/section-types.test.d.ts +11 -0
- package/tests/setup.d.ts +13 -0
- package/tests/shorthands.test.d.ts +14 -0
- package/tests/switch.test.d.ts +13 -0
- package/tests/tabs.test.d.ts +13 -0
- package/tests/tiers-registry.test.d.ts +11 -0
- package/tests/useComponentStyles.test.d.ts +11 -0
- package/tests/useFactors.test.d.ts +13 -0
- package/tests/validators-invalid-input.test.d.ts +13 -0
- package/tsup.config.d.ts +11 -0
- package/vitest.config.d.ts +3 -0
|
@@ -0,0 +1,348 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Complete 24-Factor System
|
|
3
|
+
*
|
|
4
|
+
* Unified interface and utilities for all 24 customization factors.
|
|
5
|
+
* This module combines Factors 1-6, 7-11, 12-16, and 17-24 into a single API.
|
|
6
|
+
*
|
|
7
|
+
* @packageDocumentation
|
|
8
|
+
* @module generator/factors-all
|
|
9
|
+
* @since 2.0.0
|
|
10
|
+
* @updated 2.1.0 - Extended to 24 factors
|
|
11
|
+
*
|
|
12
|
+
* Powered by Nikkory
|
|
13
|
+
*/
|
|
14
|
+
import type { SpacingVariantKey } from './factors-17-24';
|
|
15
|
+
import type { ColorScheme, ComponentSize, FactorA11y, FactorAlignment, FactorAnimation, FactorDensity, FactorElevation, FactorIconPosition, FactorLoadingState, FactorOrientation, FactorPosition, FactorResponsiveConfig, FactorShape, FactorState, FactorTheme, FactorSpacing, FactorTypography, FactorBorder, FactorOpacity, FactorOverflow, FactorCursor, FactorZIndex, FactorTransition } from './types';
|
|
16
|
+
/**
|
|
17
|
+
* Complete 16-Factor configuration interface (legacy).
|
|
18
|
+
* ALL components should accept these props for full customization.
|
|
19
|
+
*
|
|
20
|
+
* @since 2.0.0
|
|
21
|
+
*/
|
|
22
|
+
export interface Complete16FactorConfig {
|
|
23
|
+
/** Factor 1: Color scheme */
|
|
24
|
+
colorScheme?: ColorScheme;
|
|
25
|
+
/** Factor 2: Component size */
|
|
26
|
+
size?: ComponentSize;
|
|
27
|
+
/** Factor 3: Visual variant (component-specific) */
|
|
28
|
+
variant?: string;
|
|
29
|
+
/** Factor 4: Shape/border radius */
|
|
30
|
+
shape?: FactorShape;
|
|
31
|
+
/** Factor 5: Position in layout */
|
|
32
|
+
position?: FactorPosition;
|
|
33
|
+
/** Factor 6: Icon position relative to content */
|
|
34
|
+
iconPosition?: FactorIconPosition;
|
|
35
|
+
/** Factor 7: Interaction state */
|
|
36
|
+
state?: FactorState;
|
|
37
|
+
/** Factor 8: Animation preset */
|
|
38
|
+
animation?: FactorAnimation;
|
|
39
|
+
/** Factor 9: Elevation/shadow level */
|
|
40
|
+
elevation?: FactorElevation;
|
|
41
|
+
/** Factor 10: Accessibility level */
|
|
42
|
+
a11y?: FactorA11y;
|
|
43
|
+
/** Factor 11: Main axis alignment (justify-content) */
|
|
44
|
+
justifyContent?: FactorAlignment;
|
|
45
|
+
/** Factor 11: Cross axis alignment (align-items) */
|
|
46
|
+
alignItems?: FactorAlignment;
|
|
47
|
+
/** Factor 11: Text alignment */
|
|
48
|
+
textAlign?: 'start' | 'center' | 'end';
|
|
49
|
+
/** Factor 12: Layout orientation */
|
|
50
|
+
orientation?: FactorOrientation;
|
|
51
|
+
/** Factor 13: Density/spacing */
|
|
52
|
+
density?: FactorDensity;
|
|
53
|
+
/** Factor 14: Loading state */
|
|
54
|
+
loadingState?: FactorLoadingState;
|
|
55
|
+
/** Factor 15: Responsive configuration */
|
|
56
|
+
responsive?: FactorResponsiveConfig;
|
|
57
|
+
/** Factor 16: Theme mode */
|
|
58
|
+
theme?: FactorTheme;
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* Complete 24-Factor configuration interface.
|
|
62
|
+
* Extends 16-Factor with additional styling factors.
|
|
63
|
+
*
|
|
64
|
+
* @since 2.1.0
|
|
65
|
+
*/
|
|
66
|
+
export interface Complete24FactorConfig extends Complete16FactorConfig {
|
|
67
|
+
/** Factor 17: Spacing preset */
|
|
68
|
+
spacing?: FactorSpacing;
|
|
69
|
+
/** Factor 18: Typography preset */
|
|
70
|
+
typography?: FactorTypography;
|
|
71
|
+
/** Factor 19: Border style */
|
|
72
|
+
border?: FactorBorder;
|
|
73
|
+
/** Factor 20: Opacity level */
|
|
74
|
+
opacity?: FactorOpacity;
|
|
75
|
+
/** Factor 21: Overflow behavior */
|
|
76
|
+
overflow?: FactorOverflow;
|
|
77
|
+
/** Factor 22: Cursor style */
|
|
78
|
+
cursor?: FactorCursor;
|
|
79
|
+
/** Factor 23: Z-Index layer */
|
|
80
|
+
zIndex?: FactorZIndex;
|
|
81
|
+
/** Factor 24: Transition timing */
|
|
82
|
+
transition?: FactorTransition;
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* Props interface for components with 16-Factor support.
|
|
86
|
+
* Extends Complete16FactorConfig with common component props.
|
|
87
|
+
*
|
|
88
|
+
* @since 2.0.0
|
|
89
|
+
*/
|
|
90
|
+
export interface Factor16Props extends Complete16FactorConfig {
|
|
91
|
+
/** Custom class names to merge */
|
|
92
|
+
className?: string;
|
|
93
|
+
/** Disabled state (maps to Factor 7: State) */
|
|
94
|
+
disabled?: boolean;
|
|
95
|
+
/** Loading state (maps to Factor 14: LoadingState) */
|
|
96
|
+
loading?: boolean;
|
|
97
|
+
}
|
|
98
|
+
/**
|
|
99
|
+
* Props interface for components with 24-Factor support.
|
|
100
|
+
* Extends Complete24FactorConfig with common component props.
|
|
101
|
+
*
|
|
102
|
+
* @since 2.1.0
|
|
103
|
+
*/
|
|
104
|
+
export interface Factor24Props extends Complete24FactorConfig {
|
|
105
|
+
/** Custom class names to merge */
|
|
106
|
+
className?: string;
|
|
107
|
+
/** Disabled state (maps to Factor 7: State) */
|
|
108
|
+
disabled?: boolean;
|
|
109
|
+
/** Loading state (maps to Factor 14: LoadingState) */
|
|
110
|
+
loading?: boolean;
|
|
111
|
+
}
|
|
112
|
+
/**
|
|
113
|
+
* Apply all 16 factors to generate final class string.
|
|
114
|
+
*
|
|
115
|
+
* @param componentType - Component type for context-aware styling
|
|
116
|
+
* @param config - Complete 16-factor configuration
|
|
117
|
+
* @returns Combined Tailwind class string
|
|
118
|
+
*
|
|
119
|
+
* @example
|
|
120
|
+
* ```typescript
|
|
121
|
+
* const classes = applyAllFactors('button', {
|
|
122
|
+
* colorScheme: 'primary',
|
|
123
|
+
* size: 'md',
|
|
124
|
+
* variant: 'filled',
|
|
125
|
+
* shape: 'pill',
|
|
126
|
+
* animation: 'bounce',
|
|
127
|
+
* elevation: 'md',
|
|
128
|
+
* density: 'comfortable',
|
|
129
|
+
* theme: 'system'
|
|
130
|
+
* });
|
|
131
|
+
* ```
|
|
132
|
+
*
|
|
133
|
+
* @since 2.0.0
|
|
134
|
+
*/
|
|
135
|
+
export declare function applyAllFactors(componentType: string, config: Complete16FactorConfig): string;
|
|
136
|
+
/**
|
|
137
|
+
* Apply all 24 factors to generate final class string.
|
|
138
|
+
*
|
|
139
|
+
* @param componentType - Component type for context-aware styling
|
|
140
|
+
* @param config - Complete 24-factor configuration
|
|
141
|
+
* @param spacingContext - Context for spacing factor (padding, margin, gap)
|
|
142
|
+
* @returns Combined Tailwind class string
|
|
143
|
+
*
|
|
144
|
+
* @example
|
|
145
|
+
* ```typescript
|
|
146
|
+
* const classes = applyAll24Factors('card', {
|
|
147
|
+
* colorScheme: 'primary',
|
|
148
|
+
* shape: 'lg',
|
|
149
|
+
* elevation: 'md',
|
|
150
|
+
* spacing: 'lg',
|
|
151
|
+
* typography: 'body',
|
|
152
|
+
* border: 'subtle',
|
|
153
|
+
* transition: 'smooth'
|
|
154
|
+
* });
|
|
155
|
+
* ```
|
|
156
|
+
*
|
|
157
|
+
* @since 2.1.0
|
|
158
|
+
*/
|
|
159
|
+
export declare function applyAll24Factors(componentType: string, config: Complete24FactorConfig, spacingContext?: SpacingVariantKey): string;
|
|
160
|
+
/**
|
|
161
|
+
* Convert Factor16Props to StyleConfig format for generateStyles().
|
|
162
|
+
*
|
|
163
|
+
* @param props - Component props with 16-factor support
|
|
164
|
+
* @returns StyleConfig-compatible object
|
|
165
|
+
*
|
|
166
|
+
* @example
|
|
167
|
+
* ```typescript
|
|
168
|
+
* const styleConfig = propsToStyleConfig({
|
|
169
|
+
* shape: 'pill',
|
|
170
|
+
* animation: 'bounce',
|
|
171
|
+
* disabled: true
|
|
172
|
+
* });
|
|
173
|
+
* // Use with generateStyles()
|
|
174
|
+
* const styles = generateStyles('button', tokens, styleConfig);
|
|
175
|
+
* ```
|
|
176
|
+
*
|
|
177
|
+
* @since 2.0.0
|
|
178
|
+
*/
|
|
179
|
+
export declare function propsToStyleConfig(props: Factor16Props): Record<string, unknown>;
|
|
180
|
+
/**
|
|
181
|
+
* Convert Factor24Props to StyleConfig format for generateStyles().
|
|
182
|
+
*
|
|
183
|
+
* @param props - Component props with 24-factor support
|
|
184
|
+
* @returns StyleConfig-compatible object
|
|
185
|
+
*
|
|
186
|
+
* @example
|
|
187
|
+
* ```typescript
|
|
188
|
+
* const styleConfig = props24ToStyleConfig({
|
|
189
|
+
* shape: 'pill',
|
|
190
|
+
* spacing: 'lg',
|
|
191
|
+
* typography: 'heading',
|
|
192
|
+
* transition: 'spring'
|
|
193
|
+
* });
|
|
194
|
+
* ```
|
|
195
|
+
*
|
|
196
|
+
* @since 2.1.0
|
|
197
|
+
*/
|
|
198
|
+
export declare function props24ToStyleConfig(props: Factor24Props): Record<string, unknown>;
|
|
199
|
+
/**
|
|
200
|
+
* Extract factor props from a larger props object (16-Factor).
|
|
201
|
+
* Useful for separating factor props from other component props.
|
|
202
|
+
*
|
|
203
|
+
* @param props - Props object potentially containing factor props
|
|
204
|
+
* @returns Object with extracted factor props and remaining props
|
|
205
|
+
*
|
|
206
|
+
* @example
|
|
207
|
+
* ```typescript
|
|
208
|
+
* const { factorProps, restProps } = extractFactorProps({
|
|
209
|
+
* shape: 'pill',
|
|
210
|
+
* onClick: handleClick,
|
|
211
|
+
* children: 'Click me'
|
|
212
|
+
* });
|
|
213
|
+
* // factorProps = { shape: 'pill' }
|
|
214
|
+
* // restProps = { onClick: handleClick, children: 'Click me' }
|
|
215
|
+
* ```
|
|
216
|
+
*
|
|
217
|
+
* @since 2.0.0
|
|
218
|
+
*/
|
|
219
|
+
export declare function extractFactorProps<T extends Record<string, unknown>>(props: T): {
|
|
220
|
+
factorProps: Partial<Complete16FactorConfig>;
|
|
221
|
+
restProps: Omit<T, keyof Complete16FactorConfig>;
|
|
222
|
+
};
|
|
223
|
+
/**
|
|
224
|
+
* Extract factor props from a larger props object (24-Factor).
|
|
225
|
+
* Useful for separating all 24 factor props from other component props.
|
|
226
|
+
*
|
|
227
|
+
* @param props - Props object potentially containing factor props
|
|
228
|
+
* @returns Object with extracted factor props and remaining props
|
|
229
|
+
*
|
|
230
|
+
* @example
|
|
231
|
+
* ```typescript
|
|
232
|
+
* const { factorProps, restProps } = extract24FactorProps({
|
|
233
|
+
* shape: 'pill',
|
|
234
|
+
* spacing: 'lg',
|
|
235
|
+
* typography: 'heading',
|
|
236
|
+
* onClick: handleClick,
|
|
237
|
+
* children: 'Click me'
|
|
238
|
+
* });
|
|
239
|
+
* // factorProps = { shape: 'pill', spacing: 'lg', typography: 'heading' }
|
|
240
|
+
* // restProps = { onClick: handleClick, children: 'Click me' }
|
|
241
|
+
* ```
|
|
242
|
+
*
|
|
243
|
+
* @since 2.1.0
|
|
244
|
+
*/
|
|
245
|
+
export declare function extract24FactorProps<T extends Record<string, unknown>>(props: T): {
|
|
246
|
+
factorProps: Partial<Complete24FactorConfig>;
|
|
247
|
+
restProps: Omit<T, keyof Complete24FactorConfig>;
|
|
248
|
+
};
|
|
249
|
+
/**
|
|
250
|
+
* Default values for all 16 factors.
|
|
251
|
+
* Components can merge these with their specific defaults.
|
|
252
|
+
*
|
|
253
|
+
* @since 2.0.0
|
|
254
|
+
*/
|
|
255
|
+
export declare const FACTOR_DEFAULTS: Required<Complete16FactorConfig>;
|
|
256
|
+
/**
|
|
257
|
+
* Get default value for a specific factor.
|
|
258
|
+
*
|
|
259
|
+
* @param factor - Factor name
|
|
260
|
+
* @returns Default value for the factor
|
|
261
|
+
*
|
|
262
|
+
* @since 2.0.0
|
|
263
|
+
*/
|
|
264
|
+
export declare function getFactorDefault<K extends keyof Complete16FactorConfig>(factor: K): Complete16FactorConfig[K];
|
|
265
|
+
/**
|
|
266
|
+
* Merge factor config with defaults.
|
|
267
|
+
*
|
|
268
|
+
* @param config - Partial factor configuration
|
|
269
|
+
* @returns Complete configuration with defaults applied
|
|
270
|
+
*
|
|
271
|
+
* @since 2.0.0
|
|
272
|
+
*/
|
|
273
|
+
export declare function withFactorDefaults(config: Partial<Complete16FactorConfig>): Complete16FactorConfig;
|
|
274
|
+
/**
|
|
275
|
+
* Default values for all 24 factors.
|
|
276
|
+
* Extends 16-factor defaults with Factor 17-24 defaults.
|
|
277
|
+
*
|
|
278
|
+
* @since 2.1.0
|
|
279
|
+
*/
|
|
280
|
+
export declare const FACTOR_24_DEFAULTS: Required<Complete24FactorConfig>;
|
|
281
|
+
/**
|
|
282
|
+
* Get default value for a specific 24-factor.
|
|
283
|
+
*
|
|
284
|
+
* @param factor - Factor name (1-24)
|
|
285
|
+
* @returns Default value for the factor
|
|
286
|
+
*
|
|
287
|
+
* @example
|
|
288
|
+
* ```typescript
|
|
289
|
+
* const defaultSpacing = get24FactorDefault('spacing'); // 'md'
|
|
290
|
+
* const defaultTransition = get24FactorDefault('transition'); // 'default'
|
|
291
|
+
* ```
|
|
292
|
+
*
|
|
293
|
+
* @since 2.1.0
|
|
294
|
+
*/
|
|
295
|
+
export declare function get24FactorDefault<K extends keyof Complete24FactorConfig>(factor: K): Complete24FactorConfig[K];
|
|
296
|
+
/**
|
|
297
|
+
* Merge 24-factor config with defaults.
|
|
298
|
+
*
|
|
299
|
+
* @param config - Partial 24-factor configuration
|
|
300
|
+
* @returns Complete configuration with all 24 factor defaults applied
|
|
301
|
+
*
|
|
302
|
+
* @example
|
|
303
|
+
* ```typescript
|
|
304
|
+
* const fullConfig = with24FactorDefaults({
|
|
305
|
+
* colorScheme: 'secondary',
|
|
306
|
+
* spacing: 'lg',
|
|
307
|
+
* transition: 'spring'
|
|
308
|
+
* });
|
|
309
|
+
* // fullConfig now has all 24 factors with defaults
|
|
310
|
+
* ```
|
|
311
|
+
*
|
|
312
|
+
* @since 2.1.0
|
|
313
|
+
*/
|
|
314
|
+
export declare function with24FactorDefaults(config: Partial<Complete24FactorConfig>): Complete24FactorConfig;
|
|
315
|
+
/**
|
|
316
|
+
* Combined 16-Factor utilities namespace (legacy).
|
|
317
|
+
*
|
|
318
|
+
* @since 2.0.0
|
|
319
|
+
*/
|
|
320
|
+
export declare const FactorsAll: {
|
|
321
|
+
applyAllFactors: typeof applyAllFactors;
|
|
322
|
+
propsToStyleConfig: typeof propsToStyleConfig;
|
|
323
|
+
extractFactorProps: typeof extractFactorProps;
|
|
324
|
+
FACTOR_DEFAULTS: Required<Complete16FactorConfig>;
|
|
325
|
+
getFactorDefault: typeof getFactorDefault;
|
|
326
|
+
withFactorDefaults: typeof withFactorDefaults;
|
|
327
|
+
};
|
|
328
|
+
/**
|
|
329
|
+
* Combined 24-Factor utilities namespace.
|
|
330
|
+
*
|
|
331
|
+
* @since 2.1.0
|
|
332
|
+
*/
|
|
333
|
+
export declare const Factors24All: {
|
|
334
|
+
applyAllFactors: typeof applyAllFactors;
|
|
335
|
+
propsToStyleConfig: typeof propsToStyleConfig;
|
|
336
|
+
extractFactorProps: typeof extractFactorProps;
|
|
337
|
+
FACTOR_DEFAULTS: Required<Complete16FactorConfig>;
|
|
338
|
+
getFactorDefault: typeof getFactorDefault;
|
|
339
|
+
withFactorDefaults: typeof withFactorDefaults;
|
|
340
|
+
applyAll24Factors: typeof applyAll24Factors;
|
|
341
|
+
props24ToStyleConfig: typeof props24ToStyleConfig;
|
|
342
|
+
extract24FactorProps: typeof extract24FactorProps;
|
|
343
|
+
FACTOR_24_DEFAULTS: Required<Complete24FactorConfig>;
|
|
344
|
+
get24FactorDefault: typeof get24FactorDefault;
|
|
345
|
+
with24FactorDefaults: typeof with24FactorDefaults;
|
|
346
|
+
};
|
|
347
|
+
export default FactorsAll;
|
|
348
|
+
//# sourceMappingURL=factors-all.d.ts.map
|
|
@@ -0,0 +1,291 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 16-Factor Variant System - Factors 7-11
|
|
3
|
+
*
|
|
4
|
+
* Factor 7: State - Component interaction states
|
|
5
|
+
* Factor 8: Animation - Transition and animation effects
|
|
6
|
+
* Factor 9: Elevation - Shadow and depth levels
|
|
7
|
+
* Factor 10: A11y - Accessibility enhancement levels
|
|
8
|
+
* Factor 11: Alignment - Layout alignment options
|
|
9
|
+
*
|
|
10
|
+
* @packageDocumentation
|
|
11
|
+
* @module generator/factors
|
|
12
|
+
* @since 2.0.0
|
|
13
|
+
*
|
|
14
|
+
* Powered by Nikkory
|
|
15
|
+
*/
|
|
16
|
+
/**
|
|
17
|
+
* Component interaction states.
|
|
18
|
+
* Defines visual feedback for different component states.
|
|
19
|
+
*/
|
|
20
|
+
export declare const STATES: {
|
|
21
|
+
readonly default: "default";
|
|
22
|
+
readonly hover: "hover";
|
|
23
|
+
readonly focus: "focus";
|
|
24
|
+
readonly active: "active";
|
|
25
|
+
readonly disabled: "disabled";
|
|
26
|
+
readonly loading: "loading";
|
|
27
|
+
readonly error: "error";
|
|
28
|
+
readonly success: "success";
|
|
29
|
+
};
|
|
30
|
+
export type State = keyof typeof STATES;
|
|
31
|
+
/**
|
|
32
|
+
* State-specific Tailwind classes.
|
|
33
|
+
*/
|
|
34
|
+
export declare const stateVariants: {
|
|
35
|
+
readonly default: "";
|
|
36
|
+
readonly hover: "hover:brightness-95";
|
|
37
|
+
readonly focus: "focus-within:ring-2 focus-within:ring-offset-1";
|
|
38
|
+
readonly active: "active:scale-[0.98]";
|
|
39
|
+
readonly disabled: "opacity-50 cursor-not-allowed pointer-events-none";
|
|
40
|
+
readonly loading: "cursor-wait relative";
|
|
41
|
+
readonly error: "border-error-500 focus:ring-error-500 text-error-600";
|
|
42
|
+
readonly success: "border-success-500 focus:ring-success-500 text-success-600";
|
|
43
|
+
};
|
|
44
|
+
/**
|
|
45
|
+
* Animation and transition presets.
|
|
46
|
+
*/
|
|
47
|
+
export declare const ANIMATIONS: {
|
|
48
|
+
readonly none: "none";
|
|
49
|
+
readonly subtle: "subtle";
|
|
50
|
+
readonly standard: "standard";
|
|
51
|
+
readonly smooth: "smooth";
|
|
52
|
+
readonly bounce: "bounce";
|
|
53
|
+
readonly pulse: "pulse";
|
|
54
|
+
readonly spin: "spin";
|
|
55
|
+
readonly ping: "ping";
|
|
56
|
+
};
|
|
57
|
+
export type Animation = keyof typeof ANIMATIONS;
|
|
58
|
+
/**
|
|
59
|
+
* Animation-specific Tailwind classes.
|
|
60
|
+
*/
|
|
61
|
+
export declare const animationVariants: {
|
|
62
|
+
readonly none: "";
|
|
63
|
+
readonly subtle: "transition-all duration-150 ease-out";
|
|
64
|
+
readonly standard: "transition-all duration-200 ease-in-out";
|
|
65
|
+
readonly smooth: "transition-all duration-300 ease-out";
|
|
66
|
+
readonly bounce: "transition-all duration-200 ease-out hover:scale-105 active:scale-95";
|
|
67
|
+
readonly pulse: "animate-pulse";
|
|
68
|
+
readonly spin: "animate-spin";
|
|
69
|
+
readonly ping: "animate-ping";
|
|
70
|
+
};
|
|
71
|
+
/**
|
|
72
|
+
* Enter/exit animation pairs for modals, sheets, etc.
|
|
73
|
+
*/
|
|
74
|
+
export declare const enterAnimations: {
|
|
75
|
+
readonly fade: {
|
|
76
|
+
readonly initial: "opacity-0";
|
|
77
|
+
readonly animate: "opacity-100";
|
|
78
|
+
readonly exit: "opacity-0";
|
|
79
|
+
};
|
|
80
|
+
readonly scale: {
|
|
81
|
+
readonly initial: "opacity-0 scale-95";
|
|
82
|
+
readonly animate: "opacity-100 scale-100";
|
|
83
|
+
readonly exit: "opacity-0 scale-95";
|
|
84
|
+
};
|
|
85
|
+
readonly slideUp: {
|
|
86
|
+
readonly initial: "opacity-0 translate-y-4";
|
|
87
|
+
readonly animate: "opacity-100 translate-y-0";
|
|
88
|
+
readonly exit: "opacity-0 translate-y-4";
|
|
89
|
+
};
|
|
90
|
+
readonly slideDown: {
|
|
91
|
+
readonly initial: "opacity-0 -translate-y-4";
|
|
92
|
+
readonly animate: "opacity-100 translate-y-0";
|
|
93
|
+
readonly exit: "opacity-0 -translate-y-4";
|
|
94
|
+
};
|
|
95
|
+
readonly slideLeft: {
|
|
96
|
+
readonly initial: "opacity-0 translate-x-4";
|
|
97
|
+
readonly animate: "opacity-100 translate-x-0";
|
|
98
|
+
readonly exit: "opacity-0 translate-x-4";
|
|
99
|
+
};
|
|
100
|
+
readonly slideRight: {
|
|
101
|
+
readonly initial: "opacity-0 -translate-x-4";
|
|
102
|
+
readonly animate: "opacity-100 translate-x-0";
|
|
103
|
+
readonly exit: "opacity-0 -translate-x-4";
|
|
104
|
+
};
|
|
105
|
+
};
|
|
106
|
+
export type EnterAnimation = keyof typeof enterAnimations;
|
|
107
|
+
/**
|
|
108
|
+
* Shadow/elevation levels for depth effect.
|
|
109
|
+
*/
|
|
110
|
+
export declare const ELEVATIONS: {
|
|
111
|
+
readonly none: "none";
|
|
112
|
+
readonly xs: "xs";
|
|
113
|
+
readonly sm: "sm";
|
|
114
|
+
readonly md: "md";
|
|
115
|
+
readonly lg: "lg";
|
|
116
|
+
readonly xl: "xl";
|
|
117
|
+
readonly '2xl': "2xl";
|
|
118
|
+
readonly inner: "inner";
|
|
119
|
+
readonly neumorphic: "neumorphic";
|
|
120
|
+
};
|
|
121
|
+
export type Elevation = keyof typeof ELEVATIONS;
|
|
122
|
+
/**
|
|
123
|
+
* Elevation-specific Tailwind shadow classes.
|
|
124
|
+
*/
|
|
125
|
+
export declare const elevationVariants: {
|
|
126
|
+
readonly none: "";
|
|
127
|
+
readonly xs: "shadow-xs";
|
|
128
|
+
readonly sm: "shadow-sm";
|
|
129
|
+
readonly md: "shadow-md";
|
|
130
|
+
readonly lg: "shadow-lg";
|
|
131
|
+
readonly xl: "shadow-xl";
|
|
132
|
+
readonly '2xl': "shadow-2xl";
|
|
133
|
+
readonly inner: "shadow-inner";
|
|
134
|
+
readonly neumorphic: "shadow-[8px_8px_16px_#d1d5db,-8px_-8px_16px_#ffffff]";
|
|
135
|
+
};
|
|
136
|
+
/**
|
|
137
|
+
* Generate glow effect shadow for a color.
|
|
138
|
+
*
|
|
139
|
+
* @param color - Color name for glow effect
|
|
140
|
+
* @returns Tailwind classes for colored glow
|
|
141
|
+
*/
|
|
142
|
+
export declare function getGlowElevation(color: string): string;
|
|
143
|
+
/**
|
|
144
|
+
* Accessibility enhancement levels.
|
|
145
|
+
* - standard: WCAG AA compliance
|
|
146
|
+
* - enhanced: Better visibility and focus indicators
|
|
147
|
+
* - maximum: WCAG AAA, high contrast, reduced motion
|
|
148
|
+
*/
|
|
149
|
+
export declare const A11Y_LEVELS: {
|
|
150
|
+
readonly standard: "standard";
|
|
151
|
+
readonly enhanced: "enhanced";
|
|
152
|
+
readonly maximum: "maximum";
|
|
153
|
+
};
|
|
154
|
+
export type A11yLevel = keyof typeof A11Y_LEVELS;
|
|
155
|
+
/**
|
|
156
|
+
* Accessibility-specific Tailwind classes.
|
|
157
|
+
*/
|
|
158
|
+
export declare const a11yVariants: {
|
|
159
|
+
/** Focus ring visibility */
|
|
160
|
+
readonly focusRing: {
|
|
161
|
+
readonly standard: "focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-primary-500";
|
|
162
|
+
readonly enhanced: "focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-primary-500 focus-visible:ring-4";
|
|
163
|
+
readonly maximum: "focus:outline-none focus:ring-4 focus:ring-offset-4 focus:ring-primary-500";
|
|
164
|
+
};
|
|
165
|
+
/** High contrast mode support */
|
|
166
|
+
readonly contrast: {
|
|
167
|
+
readonly standard: "";
|
|
168
|
+
readonly enhanced: "contrast-more:border";
|
|
169
|
+
readonly maximum: "contrast-more:border-2 contrast-more:border-current";
|
|
170
|
+
};
|
|
171
|
+
/** Reduced motion preferences */
|
|
172
|
+
readonly motion: {
|
|
173
|
+
readonly standard: "";
|
|
174
|
+
readonly enhanced: "motion-reduce:transition-none";
|
|
175
|
+
readonly maximum: "motion-reduce:transition-none motion-reduce:animate-none";
|
|
176
|
+
};
|
|
177
|
+
/** Screen reader enhancements */
|
|
178
|
+
readonly screenReader: {
|
|
179
|
+
readonly standard: "";
|
|
180
|
+
readonly enhanced: "";
|
|
181
|
+
readonly maximum: "";
|
|
182
|
+
};
|
|
183
|
+
};
|
|
184
|
+
/**
|
|
185
|
+
* Alignment values for flex/grid layouts.
|
|
186
|
+
*/
|
|
187
|
+
export declare const ALIGNMENTS: {
|
|
188
|
+
readonly start: "start";
|
|
189
|
+
readonly center: "center";
|
|
190
|
+
readonly end: "end";
|
|
191
|
+
readonly between: "between";
|
|
192
|
+
readonly around: "around";
|
|
193
|
+
readonly evenly: "evenly";
|
|
194
|
+
readonly stretch: "stretch";
|
|
195
|
+
readonly baseline: "baseline";
|
|
196
|
+
};
|
|
197
|
+
export type Alignment = keyof typeof ALIGNMENTS;
|
|
198
|
+
/**
|
|
199
|
+
* Alignment-specific Tailwind classes for different contexts.
|
|
200
|
+
*/
|
|
201
|
+
export declare const alignmentVariants: {
|
|
202
|
+
/** Flex justify-content */
|
|
203
|
+
readonly justify: {
|
|
204
|
+
readonly start: "justify-start";
|
|
205
|
+
readonly center: "justify-center";
|
|
206
|
+
readonly end: "justify-end";
|
|
207
|
+
readonly between: "justify-between";
|
|
208
|
+
readonly around: "justify-around";
|
|
209
|
+
readonly evenly: "justify-evenly";
|
|
210
|
+
};
|
|
211
|
+
/** Flex align-items */
|
|
212
|
+
readonly items: {
|
|
213
|
+
readonly start: "items-start";
|
|
214
|
+
readonly center: "items-center";
|
|
215
|
+
readonly end: "items-end";
|
|
216
|
+
readonly stretch: "items-stretch";
|
|
217
|
+
readonly baseline: "items-baseline";
|
|
218
|
+
};
|
|
219
|
+
/** Text alignment */
|
|
220
|
+
readonly text: {
|
|
221
|
+
readonly start: "text-left";
|
|
222
|
+
readonly center: "text-center";
|
|
223
|
+
readonly end: "text-right";
|
|
224
|
+
};
|
|
225
|
+
/** Self alignment */
|
|
226
|
+
readonly self: {
|
|
227
|
+
readonly start: "self-start";
|
|
228
|
+
readonly center: "self-center";
|
|
229
|
+
readonly end: "self-end";
|
|
230
|
+
readonly stretch: "self-stretch";
|
|
231
|
+
};
|
|
232
|
+
/** Content alignment for multi-line flex */
|
|
233
|
+
readonly content: {
|
|
234
|
+
readonly start: "content-start";
|
|
235
|
+
readonly center: "content-center";
|
|
236
|
+
readonly end: "content-end";
|
|
237
|
+
readonly between: "content-between";
|
|
238
|
+
readonly around: "content-around";
|
|
239
|
+
readonly evenly: "content-evenly";
|
|
240
|
+
readonly stretch: "content-stretch";
|
|
241
|
+
};
|
|
242
|
+
/** Place alignment (combined) */
|
|
243
|
+
readonly place: {
|
|
244
|
+
readonly start: "place-items-start";
|
|
245
|
+
readonly center: "place-items-center";
|
|
246
|
+
readonly end: "place-items-end";
|
|
247
|
+
readonly stretch: "place-items-stretch";
|
|
248
|
+
};
|
|
249
|
+
};
|
|
250
|
+
/**
|
|
251
|
+
* Build alignment classes for flex/grid layouts.
|
|
252
|
+
*
|
|
253
|
+
* @param justify - Main axis alignment
|
|
254
|
+
* @param items - Cross axis alignment
|
|
255
|
+
* @returns Combined Tailwind classes
|
|
256
|
+
*
|
|
257
|
+
* @example
|
|
258
|
+
* buildAlignmentClasses('center', 'center')
|
|
259
|
+
* // => "justify-center items-center"
|
|
260
|
+
*/
|
|
261
|
+
export declare function buildAlignmentClasses(justify?: Alignment, items?: Alignment): string;
|
|
262
|
+
/**
|
|
263
|
+
* Extended style config with 16-factor support.
|
|
264
|
+
*/
|
|
265
|
+
export interface FactorConfig {
|
|
266
|
+
/** Factor 7: Component state */
|
|
267
|
+
state?: State;
|
|
268
|
+
/** Factor 8: Animation preset */
|
|
269
|
+
animation?: Animation;
|
|
270
|
+
/** Factor 8b: Enter animation for overlays */
|
|
271
|
+
enterAnimation?: EnterAnimation;
|
|
272
|
+
/** Factor 9: Elevation/shadow level */
|
|
273
|
+
elevation?: Elevation;
|
|
274
|
+
/** Factor 10: Accessibility level */
|
|
275
|
+
a11y?: A11yLevel;
|
|
276
|
+
/** Factor 11: Main axis alignment */
|
|
277
|
+
justifyContent?: Alignment;
|
|
278
|
+
/** Factor 11: Cross axis alignment */
|
|
279
|
+
alignItems?: Alignment;
|
|
280
|
+
/** Factor 11: Text alignment */
|
|
281
|
+
textAlign?: 'start' | 'center' | 'end';
|
|
282
|
+
}
|
|
283
|
+
/**
|
|
284
|
+
* Apply factor-based styles to a base class string.
|
|
285
|
+
*
|
|
286
|
+
* @param baseClasses - Existing classes to extend
|
|
287
|
+
* @param config - Factor configuration
|
|
288
|
+
* @returns Combined Tailwind classes
|
|
289
|
+
*/
|
|
290
|
+
export declare function applyFactors(baseClasses: string, config: FactorConfig): string;
|
|
291
|
+
//# sourceMappingURL=factors.d.ts.map
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Style Generator Module
|
|
3
|
+
*
|
|
4
|
+
* Core style generation engine for Dynamic Matrix Architecture.
|
|
5
|
+
* Generates component styles from design tokens at runtime.
|
|
6
|
+
*
|
|
7
|
+
* @packageDocumentation
|
|
8
|
+
* @module generator
|
|
9
|
+
* @since 2.0.0
|
|
10
|
+
*
|
|
11
|
+
* Powered by Nikkory
|
|
12
|
+
*/
|
|
13
|
+
export { StyleGenerator, generateStyles, cn, isComponentSupported, getSupportedComponents, } from './StyleGenerator';
|
|
14
|
+
export { TokenStyleResolver, resolveTokenStyles, buildClassName, clearStyleCache, applyResponsivePrefix, buildResponsiveClasses, buildResponsiveSizeClasses, } from './TokenStyleResolver';
|
|
15
|
+
export type { TokenResolveOptions, ResolvedTokenValues, ResponsiveBreakpoint, ResponsiveValue, } from './TokenStyleResolver';
|
|
16
|
+
export { COLORS, colorVariants, buildColorClass, SIZES, sizeVariants, buildSizeClasses, VARIANTS, variantClasses, buildVariantClasses, SHAPES, shapeVariants, getShapeClass, POSITIONS, positionVariants, layoutPositionVariants, getPositionClass, ICON_POSITIONS, iconPositionVariants, buildIconPositionClasses, Factors1to6, applyFactors1to6, } from './factors-1-6';
|
|
17
|
+
export type { Color, Size, Variant, Shape, Position, IconPosition, Factors1to6Config, } from './factors-1-6';
|
|
18
|
+
export { STATES, stateVariants, ANIMATIONS, animationVariants, enterAnimations, ELEVATIONS, elevationVariants, getGlowElevation, A11Y_LEVELS, a11yVariants, ALIGNMENTS, alignmentVariants, buildAlignmentClasses, applyFactors, } from './factors';
|
|
19
|
+
export type { State, Animation, EnterAnimation, Elevation, A11yLevel, Alignment, FactorConfig, } from './factors';
|
|
20
|
+
export { ORIENTATIONS, orientationVariants, buildOrientationClasses, DENSITIES, densityVariants, buildDensityClasses, LOADING_STATES, loadingStateVariants, buildLoadingStateClasses, RESPONSIVE_BREAKPOINTS, BREAKPOINT_VALUES, responsiveVisibility, applyResponsivePrefix as applyFactorResponsivePrefix, buildResponsiveClasses as buildFactorResponsiveClasses, THEMES, themeVariants, buildThemeClasses, getThemeClasses, Factors12to16, applyFactors12to16, } from './factors-12-16';
|
|
21
|
+
export type { OrientationVariantKey, DensityVariantKey, LoadingStateVariantKey, ThemeVariantKey, Factors12to16Config, } from './factors-12-16';
|
|
22
|
+
export { FactorsAll, applyAllFactors, propsToStyleConfig, extractFactorProps, FACTOR_DEFAULTS, getFactorDefault, withFactorDefaults, Factors24All, applyAll24Factors, props24ToStyleConfig, extract24FactorProps, FACTOR_24_DEFAULTS, get24FactorDefault, with24FactorDefaults, } from './factors-all';
|
|
23
|
+
export type { Complete16FactorConfig, Factor16Props, Complete24FactorConfig, Factor24Props, } from './factors-all';
|
|
24
|
+
export { SPACINGS, spacingVariants, buildSpacingClasses, TYPOGRAPHIES, typographyVariants, getTypographyClasses, BORDERS, borderVariants, getBorderClasses, OPACITIES, opacityVariants, getOpacityClasses, OVERFLOWS, overflowVariants, getOverflowClasses, CURSORS, cursorVariants, getCursorClasses, Z_INDICES, zIndexValues, zIndexVariants, getZIndexClasses, getZIndexValue, TRANSITIONS, transitionVariants, getTransitionClasses, Factors17to24, FACTOR_17_24_DEFAULTS, getFactor17to24Default, applyFactors17to24, clearFactorCache, getFactorCacheStats, } from './factors-17-24';
|
|
25
|
+
export type { SpacingVariantKey, Factors17to24Config } from './factors-17-24';
|
|
26
|
+
export { VALID_COLOR_SCHEMES, VALID_SIZES, VALID_SHAPES, VALID_POSITIONS, VALID_ICON_POSITIONS, VALID_STATES, VALID_ANIMATIONS, VALID_ELEVATIONS, VALID_A11Y_LEVELS, VALID_ALIGNMENTS, VALID_ORIENTATIONS, VALID_DENSITIES, VALID_LOADING_STATES, VALID_BREAKPOINTS, VALID_THEMES, VALID_SPACINGS, VALID_TYPOGRAPHIES, VALID_BORDERS, VALID_OPACITIES, VALID_OVERFLOWS, VALID_CURSORS, VALID_Z_INDICES, VALID_TRANSITIONS, isValidColorScheme, isValidSize, isValidShape, isValidPosition, isValidIconPosition, isValidState, isValidAnimation, isValidElevation, isValidA11yLevel, isValidAlignment, isValidOrientation, isValidDensity, isValidLoadingState, isValidBreakpoint, isValidResponsiveConfig, isValidTheme, isValidSpacing, isValidTypography, isValidBorder, isValidOpacity, isValidOverflow, isValidCursor, isValidZIndex, isValidTransition, FactorValidators, validateFactor, validateFactors, assertValidFactor, coerceFactorValue, } from './factor-validators';
|
|
27
|
+
export type { FactorValidationResult } from './factor-validators';
|
|
28
|
+
export { is16FactorConfig, is24FactorConfig, getMissingFactor17to24, migrate16to24, batchMigrate16to24, validateFactor24Completeness, completeFactorConfig, generateMigrationReport, FactorMigration, COMPONENT_DEFAULTS, } from './factor-migration';
|
|
29
|
+
export type { Factor16Config, Factor24Config as MigrationFactor24Config, MigrationResult, MigrationOptions, } from './factor-migration';
|
|
30
|
+
export type { ComponentType, ComponentSize, ColorScheme, StyleConfig, GeneratedStyles, StyleGeneratorFn, StyleGeneratorRegistry, FactorShape, FactorPosition, FactorIconPosition, FactorState, FactorAnimation, FactorElevation, FactorA11y, FactorAlignment, FactorOrientation, FactorDensity, FactorLoadingState, FactorResponsiveBreakpoint, FactorResponsiveConfig, FactorTheme, FactorSpacing, FactorTypography, FactorBorder, FactorOpacity, FactorOverflow, FactorCursor, FactorZIndex, FactorTransition, ButtonVariant, InputVariant, CardVariant, AlertVariant, BadgeVariant, ButtonStyleConfig, InputStyleConfig, CardStyleConfig, AlertStyleConfig, BadgeStyleConfig, ModalStyleConfig, TabsStyleConfig, ProgressStyleConfig, } from './types';
|
|
31
|
+
//# sourceMappingURL=index.d.ts.map
|