@splenddev/kreativ-core 0.1.1 → 0.1.2

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.
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/utils/createComponent.tsx","../../src/utils/composeRefs.ts","../../src/utils/createFromProps.ts","../../src/utils/responsive.ts","../../src/utils/deepMerge.ts","../../src/utils/resolveTokenReference.ts","../../src/utils/resolveTypography.ts"],"names":["value"],"mappings":"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","file":"index.js","sourcesContent":["import * as React from \"react\";\n\nexport interface KuiSupports {\n disabled?: boolean;\n invalid?: boolean;\n required?: boolean;\n [key: string]: boolean | undefined;\n}\nexport type KuiSkeletonHint =\n | \"text\"\n | \"rect\"\n | \"circle\"\n | \"input-shaped\"\n | \"preserve\"\n | (string & {});\nexport type KuiRole =\n | \"action\"\n | \"formControl\"\n | \"overlay\"\n | \"layout\"\n | \"display\"\n | \"disclosure\"\n | \"navigation\"\n | (string & {});\n\nexport interface KuiMeta {\n formControl?: \"single\" | \"compound\";\n supports?: KuiSupports;\n skeleton?: KuiSkeletonHint;\n role?: KuiRole;\n groupSlot?: string;\n}\n\nexport type KuiComponent<P, E> = React.ForwardRefExoticComponent<\n React.PropsWithoutRef<P> & React.RefAttributes<E>\n> & { __kui: KuiMeta };\n\nexport interface CreateComponentConfig<P, E> {\n __kui: KuiMeta;\n render: (props: P, ref: React.ForwardedRef<E>) => React.ReactElement | null;\n displayName?: string;\n}\n\nexport function createComponent<P extends object, E = unknown>(\n config: CreateComponentConfig<P, E>,\n): KuiComponent<P, E> {\n const C = React.forwardRef(\n config.render as unknown as React.ForwardRefRenderFunction<E, any>,\n ) as unknown as KuiComponent<P, E>;\n if (config.displayName) C.displayName = config.displayName;\n C.__kui = config.__kui;\n return C;\n}\n\nexport function hasKuiMeta(value: unknown): value is { __kui: KuiMeta } {\n return (\n (typeof value === \"function\" ||\n (typeof value === \"object\" && value !== null)) &&\n \"__kui\" in (value as object) &&\n typeof (value as { __kui: unknown }).__kui === \"object\" &&\n (value as { __kui: unknown }).__kui !== null\n );\n}\n","import type * as React from \"react\";\ntype PossibleRef<T> = React.Ref<T> | undefined;\n\nexport function composeRefs<T>(...refs: PossibleRef<T>[]): React.RefCallback<T> {\n return (node) => {\n for (const ref of refs) {\n if (typeof ref === \"function\") ref(node);\n else if (ref) (ref as React.MutableRefObject<T | null>).current = node;\n }\n };\n}\n","export interface CreateFromPropsInput<T extends object> {\n providerDefaults?: Partial<T>;\n defaultProps?: Partial<T>;\n generatedProps?: Partial<T>;\n consumerProps?: Partial<T>;\n}\nexport function createFromProps<T extends object>(input: CreateFromPropsInput<T>): T {\n return {\n ...input.providerDefaults,\n ...input.defaultProps,\n ...input.generatedProps,\n ...input.consumerProps,\n } as T;\n}\n","import type { BaseBreakpoint, ResponsiveValue } from \"@/types\";\n\nexport function isResponsiveValue<T>(\n value: ResponsiveValue<T>,\n): value is Partial<Record<\"base\" | BaseBreakpoint, T>> {\n return typeof value === \"object\" && value !== null;\n}\n\nexport interface ResolvedResponsiveValue<T> {\n base?: T;\n responsive: Record<string, T>;\n}\n\nexport function resolveResponsiveValue<T, B extends string = string>(\n value: ResponsiveValue<T, B>,\n): ResolvedResponsiveValue<T> {\n if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n return {\n base: value,\n responsive: {},\n };\n }\n\n const responsiveValue = value as Partial<Record<\"base\" | B, T>>;\n\n const { base, ...responsive } = responsiveValue;\n\n return {\n base,\n responsive: Object.fromEntries(\n Object.entries(responsive).filter(([, value]) => value !== undefined),\n ) as Record<string, T>,\n };\n}\n\nexport function toResponsiveClasses<T>(\n value: ResolvedResponsiveValue<T>,\n resolve: (value: T) => string,\n): string {\n const classes: string[] = [];\n\n if (value.base !== undefined) {\n classes.push(resolve(value.base));\n }\n\n for (const [breakpoint, item] of Object.entries(value.responsive)) {\n classes.push(\n item\n ? item\n .toString()\n .split(\" \")\n .map((className) => `${breakpoint}:${className}`)\n .join(\" \")\n : \"\",\n );\n }\n\n return classes.filter(Boolean).join(\" \");\n}\n\nexport function mergeResponsiveValue<T, B extends string = string>(\n defaults: ResponsiveValue<T, B>,\n value?: ResponsiveValue<T, B>,\n): ResolvedResponsiveValue<T> {\n const defaultValue = resolveResponsiveValue(defaults);\n\n if (value === undefined) {\n return defaultValue;\n }\n\n const overrideValue = resolveResponsiveValue(value);\n\n return {\n base: overrideValue.base ?? defaultValue.base,\n responsive: {\n ...defaultValue.responsive,\n ...overrideValue.responsive,\n },\n };\n}\n","function isPlainObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport function deepMerge<T>(base: T, override?: unknown): T {\n if (override === undefined) {\n return base;\n }\n\n if (!isPlainObject(base) || !isPlainObject(override)) {\n return override as T;\n }\n\n const result: Record<string, unknown> = {\n ...base,\n };\n\n for (const [key, value] of Object.entries(override)) {\n const existing = result[key];\n\n if (isPlainObject(existing) && isPlainObject(value)) {\n result[key] = deepMerge(existing, value);\n } else {\n result[key] = value;\n }\n }\n\n return result as T;\n}\n","import type { DesignTokens } from \"@/types\";\r\n\r\nexport function resolveTokenReference(\r\n value: unknown,\r\n tokens: DesignTokens,\r\n): string | number {\r\n if (typeof value !== \"string\") {\r\n return typeof value === \"number\" ? value : \"\";\r\n }\r\n\r\n const match = value.match(/^\\{(.+)\\}$/);\r\n\r\n if (!match || match[1] === undefined) {\r\n return value;\r\n }\r\n\r\n const path = match[1].split(\".\");\r\n\r\n let current: unknown = tokens;\r\n\r\n for (const key of path) {\r\n if (typeof current !== \"object\" || current === null || !(key in current)) {\r\n return \"\";\r\n }\r\n\r\n current = (current as Record<string, unknown>)[key];\r\n }\r\n\r\n if (typeof current === \"object\" && current !== null && \"value\" in current) {\r\n const tokenValue = (current as { value: unknown }).value;\r\n\r\n if (typeof tokenValue === \"string\" || typeof tokenValue === \"number\") {\r\n return tokenValue;\r\n }\r\n\r\n return \"\";\r\n }\r\n\r\n return typeof current === \"string\" || typeof current === \"number\"\r\n ? current\r\n : \"\";\r\n}\r\n","import type { CSSProperties } from \"react\";\r\nimport type { DesignTokens, TypographyStyle } from \"@/types\";\r\nimport { resolveTokenReference } from \"./resolveTokenReference\";\r\n\r\nexport function resolveTypography(\r\n typography: TypographyStyle | undefined,\r\n tokens: DesignTokens,\r\n): CSSProperties {\r\n if (!typography) return {};\r\n\r\n return {\r\n fontFamily: resolveTokenReference(typography.fontFamily, tokens) as string,\r\n fontSize: resolveTokenReference(typography.fontSize, tokens) as string,\r\n fontWeight: resolveTokenReference(typography.fontWeight, tokens),\r\n lineHeight: resolveTokenReference(typography.lineHeight, tokens),\r\n letterSpacing: resolveTokenReference(\r\n typography.letterSpacing,\r\n tokens,\r\n ) as string,\r\n };\r\n}\r\n"]}
1
+ {"version":3,"sources":["../../src/utils/createComponent.tsx","../../src/utils/composeRefs.ts","../../src/utils/createFromProps.ts","../../src/utils/responsive.ts","../../src/utils/deepMerge.ts","../../src/utils/resolveTokenReference.ts","../../src/utils/resolveTypography.ts","../../src/utils/cssVariables.ts"],"names":["value","resolveValue"],"mappings":"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","file":"index.js","sourcesContent":["import * as React from \"react\";\n\nexport interface KuiSupports {\n disabled?: boolean;\n invalid?: boolean;\n required?: boolean;\n [key: string]: boolean | undefined;\n}\nexport type KuiSkeletonHint =\n | \"text\"\n | \"rect\"\n | \"circle\"\n | \"input-shaped\"\n | \"preserve\"\n | (string & {});\nexport type KuiRole =\n | \"action\"\n | \"formControl\"\n | \"overlay\"\n | \"layout\"\n | \"display\"\n | \"disclosure\"\n | \"navigation\"\n | (string & {});\n\nexport interface KuiMeta {\n formControl?: \"single\" | \"compound\";\n supports?: KuiSupports;\n skeleton?: KuiSkeletonHint;\n role?: KuiRole;\n groupSlot?: string;\n}\n\nexport type KuiComponent<P, E> = React.ForwardRefExoticComponent<\n React.PropsWithoutRef<P> & React.RefAttributes<E>\n> & { __kui: KuiMeta };\n\nexport interface CreateComponentConfig<P, E> {\n __kui: KuiMeta;\n render: (props: P, ref: React.ForwardedRef<E>) => React.ReactElement | null;\n displayName?: string;\n}\n\nexport function createComponent<P extends object, E = unknown>(\n config: CreateComponentConfig<P, E>,\n): KuiComponent<P, E> {\n const C = React.forwardRef(\n config.render as unknown as React.ForwardRefRenderFunction<E, any>,\n ) as unknown as KuiComponent<P, E>;\n if (config.displayName) C.displayName = config.displayName;\n C.__kui = config.__kui;\n return C;\n}\n\nexport function hasKuiMeta(value: unknown): value is { __kui: KuiMeta } {\n return (\n (typeof value === \"function\" ||\n (typeof value === \"object\" && value !== null)) &&\n \"__kui\" in (value as object) &&\n typeof (value as { __kui: unknown }).__kui === \"object\" &&\n (value as { __kui: unknown }).__kui !== null\n );\n}\n","import type * as React from \"react\";\ntype PossibleRef<T> = React.Ref<T> | undefined;\n\nexport function composeRefs<T>(...refs: PossibleRef<T>[]): React.RefCallback<T> {\n return (node) => {\n for (const ref of refs) {\n if (typeof ref === \"function\") ref(node);\n else if (ref) (ref as React.MutableRefObject<T | null>).current = node;\n }\n };\n}\n","export interface CreateFromPropsInput<T extends object> {\n providerDefaults?: Partial<T>;\n defaultProps?: Partial<T>;\n generatedProps?: Partial<T>;\n consumerProps?: Partial<T>;\n}\nexport function createFromProps<T extends object>(input: CreateFromPropsInput<T>): T {\n return {\n ...input.providerDefaults,\n ...input.defaultProps,\n ...input.generatedProps,\n ...input.consumerProps,\n } as T;\n}\n","import type { BaseBreakpoint, ResponsiveValue } from \"@/types\";\n\nexport function isResponsiveValue<T>(\n value: ResponsiveValue<T>,\n): value is Partial<Record<\"base\" | BaseBreakpoint, T>> {\n return typeof value === \"object\" && value !== null;\n}\n\nexport interface ResolvedResponsiveValue<T> {\n base?: T;\n responsive: Record<string, T>;\n}\n\nexport function resolveResponsiveValue<T, B extends string = string>(\n value: ResponsiveValue<T, B>,\n): ResolvedResponsiveValue<T> {\n if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n return {\n base: value,\n responsive: {},\n };\n }\n\n const responsiveValue = value as Partial<Record<\"base\" | B, T>>;\n\n const { base, ...responsive } = responsiveValue;\n\n return {\n base,\n responsive: Object.fromEntries(\n Object.entries(responsive).filter(([, value]) => value !== undefined),\n ) as Record<string, T>,\n };\n}\n\nexport function toResponsiveClasses<T>(\n value: ResolvedResponsiveValue<T>,\n resolve: (value: T) => string,\n): string {\n const classes: string[] = [];\n\n if (value.base !== undefined) {\n classes.push(resolve(value.base));\n }\n\n for (const [breakpoint, item] of Object.entries(value.responsive)) {\n classes.push(\n item\n ? item\n .toString()\n .split(\" \")\n .map((className) => `${breakpoint}:${className}`)\n .join(\" \")\n : \"\",\n );\n }\n\n return classes.filter(Boolean).join(\" \");\n}\n\nexport function mergeResponsiveValue<T, B extends string = string>(\n defaults: ResponsiveValue<T, B>,\n value?: ResponsiveValue<T, B>,\n): ResolvedResponsiveValue<T> {\n const defaultValue = resolveResponsiveValue(defaults);\n\n if (value === undefined) {\n return defaultValue;\n }\n\n const overrideValue = resolveResponsiveValue(value);\n\n return {\n base: overrideValue.base ?? defaultValue.base,\n responsive: {\n ...defaultValue.responsive,\n ...overrideValue.responsive,\n },\n };\n}\n","function isPlainObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport function deepMerge<T>(base: T, override?: unknown): T {\n if (override === undefined) {\n return base;\n }\n\n if (!isPlainObject(base) || !isPlainObject(override)) {\n return override as T;\n }\n\n const result: Record<string, unknown> = {\n ...base,\n };\n\n for (const [key, value] of Object.entries(override)) {\n const existing = result[key];\n\n if (isPlainObject(existing) && isPlainObject(value)) {\n result[key] = deepMerge(existing, value);\n } else {\n result[key] = value;\n }\n }\n\n return result as T;\n}\n","import type { DesignTokens } from \"@/types\";\r\n\r\nexport function resolveTokenReference(\r\n value: unknown,\r\n tokens: DesignTokens,\r\n): string | number {\r\n if (typeof value !== \"string\") {\r\n return typeof value === \"number\" ? value : \"\";\r\n }\r\n\r\n const match = value.match(/^\\{(.+)\\}$/);\r\n\r\n if (!match || match[1] === undefined) {\r\n return value;\r\n }\r\n\r\n const path = match[1].split(\".\");\r\n\r\n let current: unknown = tokens;\r\n\r\n for (const key of path) {\r\n if (typeof current !== \"object\" || current === null || !(key in current)) {\r\n return \"\";\r\n }\r\n\r\n current = (current as Record<string, unknown>)[key];\r\n }\r\n\r\n if (typeof current === \"object\" && current !== null && \"value\" in current) {\r\n const tokenValue = (current as { value: unknown }).value;\r\n\r\n if (typeof tokenValue === \"string\" || typeof tokenValue === \"number\") {\r\n return tokenValue;\r\n }\r\n\r\n return \"\";\r\n }\r\n\r\n return typeof current === \"string\" || typeof current === \"number\"\r\n ? current\r\n : \"\";\r\n}\r\n","import type { CSSProperties } from \"react\";\r\nimport type { DesignTokens, TypographyStyle } from \"@/types\";\r\nimport { resolveTokenReference } from \"./resolveTokenReference\";\r\n\r\nexport function resolveTypography(\r\n typography: TypographyStyle | undefined,\r\n tokens: DesignTokens,\r\n): CSSProperties {\r\n if (!typography) return {};\r\n\r\n return {\r\n fontFamily: resolveTokenReference(typography.fontFamily, tokens) as string,\r\n fontSize: resolveTokenReference(typography.fontSize, tokens) as string,\r\n fontWeight: resolveTokenReference(typography.fontWeight, tokens),\r\n lineHeight: resolveTokenReference(typography.lineHeight, tokens),\r\n letterSpacing: resolveTokenReference(\r\n typography.letterSpacing,\r\n tokens,\r\n ) as string,\r\n };\r\n}\r\n","import type {\r\n DesignTokens,\r\n ResolvedTokens,\r\n SemanticTokens,\r\n TokenDefinition,\r\n} from \"@/types\";\r\n\r\nexport function toKebabCase(str: string): string {\r\n return str.replace(/([a-z0-9])([A-Z])/g, \"$1-$2\").toLowerCase();\r\n}\r\nfunction colorToRgbChannels(value: string): string {\r\n const trimmed = value.trim();\r\n\r\n const rgbMatch = trimmed.match(\r\n /^rgba?\\(\\s*(\\d+(?:\\.\\d+)?)\\s*[,\\s]\\s*(\\d+(?:\\.\\d+)?)\\s*[,\\s]\\s*(\\d+(?:\\.\\d+)?)(?:\\s*[/,]\\s*[\\d.]+%?)?\\s*\\)$/i,\r\n );\r\n\r\n if (rgbMatch) {\r\n return `${rgbMatch[1]} ${rgbMatch[2]} ${rgbMatch[3]}`;\r\n }\r\n\r\n if (trimmed.startsWith(\"#\")) {\r\n const hex = trimmed.slice(1);\r\n\r\n if (hex.length === 3) {\r\n const r = parseInt(hex.slice(0, 1).repeat(2), 16);\r\n const g = parseInt(hex.slice(1, 2).repeat(2), 16);\r\n const b = parseInt(hex.slice(2, 3).repeat(2), 16);\r\n\r\n return `${r} ${g} ${b}`;\r\n }\r\n\r\n if (hex.length === 6) {\r\n const r = parseInt(hex.slice(0, 2), 16);\r\n const g = parseInt(hex.slice(2, 4), 16);\r\n const b = parseInt(hex.slice(4, 6), 16);\r\n\r\n return `${r} ${g} ${b}`;\r\n }\r\n }\r\n\r\n if (/^\\d+(?:\\.\\d+)?\\s+\\d+(?:\\.\\d+)?\\s+\\d+(?:\\.\\d+)?$/.test(trimmed)) {\r\n return trimmed;\r\n }\r\n\r\n return value;\r\n}\r\n\r\nfunction getTokenValue(\r\n reference: string,\r\n tokens: DesignTokens,\r\n): string | number | undefined {\r\n const path = reference.replace(/^\\{/, \"\").replace(/\\}$/, \"\").split(\".\");\r\n\r\n let current: unknown = tokens;\r\n\r\n for (const segment of path) {\r\n if (\r\n typeof current !== \"object\" ||\r\n current === null ||\r\n !(segment in current)\r\n ) {\r\n return undefined;\r\n }\r\n\r\n current = (current as Record<string, unknown>)[segment];\r\n }\r\n\r\n if (typeof current === \"object\" && current !== null && \"value\" in current) {\r\n const value = (current as TokenDefinition).value;\r\n\r\n if (typeof value === \"string\" || typeof value === \"number\") {\r\n return value;\r\n }\r\n }\r\n\r\n return undefined;\r\n}\r\n\r\nfunction resolveReference(\r\n reference: string,\r\n tokens: DesignTokens,\r\n seen = new Set<string>(),\r\n): string | undefined {\r\n if (seen.has(reference)) {\r\n console.error(\r\n `[kreativ-core] Circular token reference detected: ${reference}`,\r\n );\r\n\r\n return undefined;\r\n }\r\n\r\n const nextSeen = new Set(seen);\r\n nextSeen.add(reference);\r\n\r\n const value = getTokenValue(reference, tokens);\r\n\r\n if (value === undefined) {\r\n console.warn(\r\n `[kreativ-core] Unable to resolve token reference: ${reference}`,\r\n );\r\n\r\n return undefined;\r\n }\r\n\r\n if (typeof value === \"number\") {\r\n return String(value);\r\n }\r\n\r\n if (value.startsWith(\"{\") && value.endsWith(\"}\")) {\r\n return resolveReference(value, tokens, nextSeen);\r\n }\r\n\r\n return value;\r\n}\r\n\r\nfunction resolveValue(\r\n value: unknown,\r\n tokens: DesignTokens,\r\n): string | undefined {\r\n if (typeof value === \"number\") {\r\n return String(value);\r\n }\r\n\r\n if (typeof value !== \"string\") {\r\n return undefined;\r\n }\r\n\r\n if (value.startsWith(\"{\") && value.endsWith(\"}\")) {\r\n return resolveReference(value, tokens);\r\n }\r\n\r\n return value;\r\n}\r\n\r\nfunction flattenTokens(\r\n value: unknown,\r\n path: string[],\r\n result: ResolvedTokens,\r\n tokens: DesignTokens,\r\n): void {\r\n if (typeof value !== \"object\" || value === null) {\r\n return;\r\n }\r\n\r\n if (\"value\" in value) {\r\n const tokenValue = (value as TokenDefinition).value;\r\n\r\n const resolved = resolveValue(tokenValue, tokens);\r\n\r\n if (resolved !== undefined) {\r\n result[path.join(\".\")] = resolved;\r\n }\r\n\r\n return;\r\n }\r\n\r\n for (const [key, child] of Object.entries(value as Record<string, unknown>)) {\r\n flattenTokens(child, [...path, key], result, tokens);\r\n }\r\n}\r\n\r\nfunction resolveSemanticValue(\r\n value: unknown,\r\n mode: \"light\" | \"dark\",\r\n tokens: DesignTokens,\r\n): string | undefined {\r\n if (\r\n typeof value === \"object\" &&\r\n value !== null &&\r\n \"light\" in value &&\r\n \"dark\" in value\r\n ) {\r\n const modeValue = (\r\n value as {\r\n light: unknown;\r\n dark: unknown;\r\n }\r\n )[mode];\r\n\r\n return resolveValue(modeValue, tokens);\r\n }\r\n\r\n return resolveValue(value, tokens);\r\n}\r\n\r\nfunction resolveSemanticTokens(\r\n semanticTokens: SemanticTokens,\r\n tokens: DesignTokens,\r\n mode: \"light\" | \"dark\",\r\n): ResolvedTokens {\r\n const result: ResolvedTokens = {};\r\n\r\n function walk(value: unknown, path: string[]): void {\r\n if (typeof value !== \"object\" || value === null) {\r\n return;\r\n }\r\n\r\n if (\"value\" in value) {\r\n const semanticValue = (value as TokenDefinition).value;\r\n\r\n const resolved = resolveSemanticValue(semanticValue, mode, tokens);\r\n\r\n if (resolved !== undefined) {\r\n result[path.join(\".\")] = resolved;\r\n }\r\n\r\n return;\r\n }\r\n\r\n for (const [key, child] of Object.entries(\r\n value as Record<string, unknown>,\r\n )) {\r\n walk(child, [...path, key]);\r\n }\r\n }\r\n\r\n walk(semanticTokens, []);\r\n\r\n return result;\r\n}\r\n\r\nexport function resolveTokens(\r\n tokens: DesignTokens,\r\n semanticTokens: SemanticTokens,\r\n mode: \"light\" | \"dark\",\r\n): ResolvedTokens {\r\n const primitiveTokens: ResolvedTokens = {};\r\n\r\n flattenTokens(tokens, [], primitiveTokens, tokens);\r\n\r\n const resolvedSemanticTokens = resolveSemanticTokens(\r\n semanticTokens,\r\n tokens,\r\n mode,\r\n );\r\n\r\n return {\r\n ...primitiveTokens,\r\n ...resolvedSemanticTokens,\r\n };\r\n}\r\n\r\nexport function resolveSemanticTokenReferences(\r\n tokens: DesignTokens,\r\n semanticTokens: SemanticTokens,\r\n): SemanticTokens {\r\n function resolveValue(value: unknown, seen = new Set<string>()): unknown {\r\n if (typeof value === \"string\") {\r\n if (!value.startsWith(\"{\") || !value.endsWith(\"}\")) {\r\n return value;\r\n }\r\n\r\n if (seen.has(value)) {\r\n console.error(\r\n `[kreativ-core] Circular token reference detected: ${value}`,\r\n );\r\n\r\n return value;\r\n }\r\n\r\n const resolved = getTokenValue(value, tokens);\r\n\r\n if (resolved === undefined) {\r\n console.warn(\r\n `[kreativ-core] Unable to resolve token reference: ${value}`,\r\n );\r\n\r\n return value;\r\n }\r\n\r\n const nextSeen = new Set(seen);\r\n nextSeen.add(value);\r\n\r\n return resolveValue(resolved, nextSeen);\r\n }\r\n\r\n if (Array.isArray(value)) {\r\n return value.map((item) => resolveValue(item, seen));\r\n }\r\n\r\n if (typeof value === \"object\" && value !== null) {\r\n return Object.fromEntries(\r\n Object.entries(value).map(([key, child]) => [\r\n key,\r\n resolveValue(child, seen),\r\n ]),\r\n );\r\n }\r\n\r\n return value;\r\n }\r\n\r\n return resolveValue(semanticTokens) as SemanticTokens;\r\n}\r\n\r\nexport function tokensToCssVars(\r\n tokens: ResolvedTokens,\r\n mode: \"light\" | \"dark\",\r\n intensity: number,\r\n prefix = \"kui\",\r\n): Record<string, string> {\r\n const cssVars: Record<string, string> = {};\r\n\r\n for (const [path, value] of Object.entries(tokens)) {\r\n const parts = path.split(\".\");\r\n const [_first = \"\", second = \"\"] = parts;\r\n\r\n const isSemanticColor = parts.length === 2 && parts[0] === \"colors\";\r\n\r\n const isPrimitiveColor = parts.length >= 3 && parts[0] === \"colors\";\r\n\r\n const varName = isSemanticColor\r\n ? `--${prefix}-${toKebabCase(second)}`\r\n : `--${prefix}-${parts.map(toKebabCase).join(\"-\")}`;\r\n\r\n const outputValue =\r\n isSemanticColor || isPrimitiveColor ? colorToRgbChannels(value) : value;\r\n\r\n cssVars[varName] = outputValue;\r\n }\r\n\r\n return {\r\n ...cssVars,\r\n\r\n [`--${prefix}-mode`]: mode,\r\n [`--${prefix}-intensity`]: String(intensity),\r\n };\r\n}\r\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@splenddev/kreativ-core",
3
- "version": "0.1.1",
3
+ "version": "0.1.2",
4
4
  "description": "Design-system foundation for Kreativ UI — tokens, theming, recipes, and component primitives.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",
@@ -1,557 +0,0 @@
1
- import { CSSProperties, ReactNode } from 'react';
2
-
3
- type TokenValue = string | number;
4
- interface TokenDefinition<T extends TokenValue = TokenValue> {
5
- value: T;
6
- }
7
- interface TokenGroup {
8
- [key: string]: TokenDefinition | TokenGroup;
9
- }
10
- interface ColorScale {
11
- [key: string]: TokenDefinition<string>;
12
- }
13
- interface ColorTokens {
14
- [key: string]: ColorScale | TokenDefinition<string>;
15
- }
16
- interface SpacingTokens {
17
- [key: string]: TokenDefinition<string>;
18
- }
19
- interface RadiusTokens {
20
- [key: string]: TokenDefinition<string>;
21
- }
22
- interface FontTokens {
23
- [key: string]: TokenDefinition<string>;
24
- }
25
- interface FontSizeTokens {
26
- [key: string]: TokenDefinition<string>;
27
- }
28
- interface FontWeightTokens {
29
- [key: string]: TokenDefinition<string>;
30
- }
31
- interface LineHeightTokens {
32
- [key: string]: TokenDefinition<string>;
33
- }
34
- interface LetterSpacingTokens {
35
- [key: string]: TokenDefinition<string>;
36
- }
37
- interface ShadowTokens {
38
- [key: string]: TokenDefinition<string>;
39
- }
40
- interface AnimationTokens {
41
- [key: string]: TokenDefinition<string>;
42
- }
43
- interface BreakpointTokens {
44
- [key: string]: TokenDefinition<string>;
45
- }
46
- interface DesignTokens {
47
- colors?: ColorTokens;
48
- spacing?: SpacingTokens;
49
- radii?: RadiusTokens;
50
- fonts?: FontTokens;
51
- fontSizes?: FontSizeTokens;
52
- fontWeights?: FontWeightTokens;
53
- lineHeights?: LineHeightTokens;
54
- letterSpacings?: LetterSpacingTokens;
55
- shadows?: ShadowTokens;
56
- animations?: AnimationTokens;
57
- breakpoints?: BreakpointTokens;
58
- [key: string]: unknown;
59
- }
60
- /**
61
- * A value that can differ between light and dark color modes.
62
- *
63
- * Locked shape (Sep 2026): explicit discriminated union, not shape
64
- * inference. `sameForBothModes: true` is a stated author decision,
65
- * not something inferred from a bare value.
66
- */
67
- type ColorModeValue<T = string> = {
68
- sameForBothModes: true;
69
- value: T;
70
- } | {
71
- sameForBothModes?: false;
72
- light: T;
73
- dark: T;
74
- };
75
- /**
76
- * A semantic token — represents a role (e.g. "background", "text")
77
- * rather than a raw value. Always routes through ColorModeValue,
78
- * even when mode-invariant (via the sameForBothModes branch).
79
- */
80
- interface SemanticToken<T extends TokenValue = string> {
81
- value: ColorModeValue<T>;
82
- }
83
- interface SemanticColorTokens {
84
- [key: string]: SemanticToken<string>;
85
- }
86
- interface SemanticTokens {
87
- colors?: SemanticColorTokens;
88
- [key: string]: unknown;
89
- }
90
-
91
- interface TypographyStyle {
92
- fontFamily?: string | TokenReferenceString;
93
- fontSize?: string | TokenReferenceString;
94
- fontWeight?: string | number | TokenReferenceString;
95
- lineHeight?: string | TokenReferenceString;
96
- letterSpacing?: string | TokenReferenceString;
97
- }
98
- type Typography = Record<string, TypographyStyle>;
99
-
100
- /**
101
- * Represents a value that adapts responsively to different screen sizes.
102
- * It can be provided as:
103
- * - A single value of type `T` (applies to all breakpoints), or
104
- * - An object mapping breakpoint names to values, where each key is optional.
105
- *
106
- * The object supports:
107
- * - `base`: the default value applied when no specific breakpoint matches.
108
- * - Any breakpoint defined by `BaseBreakpoint` (e.g., `"sm"`, `"md"`, `"lg"`, `"xl"`, `"2xl"`).
109
- *
110
- * When an object is provided, the component will resolve the most appropriate value
111
- * based on the current viewport width, falling back to `base` or the next larger breakpoint.
112
- *
113
- * @template T - The type of the value (e.g., `string`, `number`, `CSSProperties`).
114
- *
115
- * @example
116
- * // Single value for all screens
117
- * const padding: ResponsiveValue<number> = 16;
118
- *
119
- * @example
120
- * // Responsive object with breakpoint-specific values
121
- * const padding: ResponsiveValue<number> = {
122
- * base: 8,
123
- * sm: 12,
124
- * md: 16,
125
- * lg: 24,
126
- * };
127
- */
128
- type ResponsiveValue<T, B extends string = BaseBreakpoint> = T | Partial<Record<"base" | B, T>>;
129
- type ResponsiveStyles = Record<string, CSSProperties>;
130
-
131
- type FormFieldStatus = "none" | "error" | "success" | "warning";
132
- type TokenReferenceString = `{${string}}`;
133
- type Easing = "linear" | "easeIn" | "easeOut" | "easeInOut" | "circIn" | "circOut" | "circInOut" | "backIn" | "backOut" | "backInOut" | "anticipate";
134
- /**
135
- * Predefined size keys for components. `"xs"` is the smallest, `"xl"` the largest.
136
- * Custom string sizes can also be used via `SizeValue`.
137
- */
138
- type Size = "xs" | "sm" | "md" | "lg" | "xl";
139
- /**
140
- * Layout orientation of a group or container.
141
- */
142
- type Orientation = "horizontal" | "vertical";
143
- /**
144
- * A size value that can be either a predefined `Size` or any custom string.
145
- * This allows theme extensions with additional size tokens.
146
- */
147
- type SizeValue = ResponsiveValue<Size | (string & {})>;
148
- /**
149
- * Base visual variants supported by most components.
150
- * - `"solid"`: filled background with high contrast.
151
- * - `"outline"`: bordered with transparent background.
152
- * - `"ghost"`: minimal, often transparent with subtle hover.
153
- * - `"soft"`: subtle background with less contrast than `solid`.
154
- */
155
- type BaseVariant = "solid" | "outline" | "ghost" | "soft";
156
- /**
157
- * Default responsive breakpoints supported by the design system.
158
- * These breakpoints are used to define responsive behavior across different screen sizes.
159
- * The order from smallest to largest is: `"sm"`, `"md"`, `"lg"`, `"xl"`, `"2xl"`.
160
- *
161
- * - `"sm"`: small screens (e.g., mobile phones)
162
- * - `"md"`: medium screens (e.g., tablets)
163
- * - `"lg"`: large screens (e.g., desktops)
164
- * - `"xl"`: extra large screens (e.g., large desktops)
165
- * - `"2xl"`: 2x extra large screens (e.g., ultra-wide displays)
166
- */
167
- type BaseBreakpoint = "sm" | "md" | "lg" | "xl" | "2xl";
168
- /**
169
- * Base color palette keys. These map to theme-defined colors.
170
- * - `"brand"`: primary brand color.
171
- * - `"destructive"`: for errors or dangerous actions.
172
- * - `"success"`: for positive outcomes.
173
- * - `"warning"`: for cautionary states.
174
- * - `"info"`: for informational highlights.
175
- * - `"neutral"`: default or muted color.
176
- * - `"white"`: white color (useful on dark backgrounds).
177
- * - `"inherit"`: inherits the parent's color.
178
- */
179
- type BaseColor = "brand" | "destructive" | "success" | "warning" | "info" | "neutral" | "white" | "inherit";
180
- /**
181
- * Generic variant type; currently aliased to `BaseVariant`.
182
- * Can be extended in the future.
183
- */
184
- type Variant = BaseVariant;
185
- /**
186
- * Interface for components that accept a CSS class name for styling customisation.
187
- */
188
- interface Styleable {
189
- /** Additional CSS class names to apply. */
190
- className?: string;
191
- }
192
- /**
193
- * Animation types for theme-based transitions.
194
- * - `"none"`: no animation.
195
- * - `"fade"`: opacity transition.
196
- * - `"rotate"`: rotation animation.
197
- * - `"slide"`: sliding motion.
198
- * - `"scale"`: scaling effect.
199
- */
200
- type ThemeAnimation = "none" | "fade" | "rotate" | "slide" | "scale";
201
- /**
202
- * Recursively makes all properties of `T` optional.
203
- * Useful for partial theme overrides or deep configuration objects.
204
- */
205
- type DeepPartial<T> = {
206
- [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
207
- };
208
- /**
209
- * Extends `CSSProperties` to allow custom CSS variables (e.g., `--my-var`).
210
- */
211
- type CSSPropertiesWithVars = CSSProperties & {
212
- [key: `--${string}`]: string | number | undefined;
213
- };
214
- /**
215
- * Represents the result of a validity check.
216
- * - `invalid`: `true` if the value is invalid.
217
- * - `message`: optional error message to display.
218
- */
219
- type ReportedValidity = {
220
- invalid: boolean;
221
- message?: string;
222
- };
223
- /**
224
- * Base properties shared by most components.
225
- * Includes styling, children, and unstyled mode.
226
- */
227
- interface BaseProps {
228
- /**
229
- * Additional CSS classes to merge with the component's default styles.
230
- */
231
- className?: string;
232
- /**
233
- * Inline styles to apply to the root element.
234
- * These take precedence over className styles.
235
- */
236
- style?: CSSProperties;
237
- /**
238
- * The content to render inside the component.
239
- */
240
- children?: ReactNode;
241
- /**
242
- * When `true`, removes all default styling (useful for custom styling from scratch).
243
- * @default false
244
- */
245
- unstyled?: boolean;
246
- }
247
- /**
248
- * Props for components that support a `size` property.
249
- */
250
- interface SizeProps {
251
- /**
252
- * The size of the component. Can be a predefined size or a custom string.
253
- * @default "md"
254
- */
255
- size?: SizeValue;
256
- }
257
- /**
258
- * Props for components that support a `color` property.
259
- * @template Color - The color type (defaults to `string`).
260
- */
261
- interface ColorProps<Color extends string = string> {
262
- /**
263
- * The color of the component. Typically matches the theme's color palette.
264
- */
265
- color?: Color;
266
- }
267
- /**
268
- * Props for components that support a `variant` property.
269
- * @template Variant - The variant type (defaults to `string`).
270
- */
271
- interface VariantProps<Variant extends string = string> {
272
- /**
273
- * The visual style variant of the component.
274
- * Common variants: `"solid"`, `"outline"`, `"ghost"`, `"soft"`.
275
- */
276
- variant?: Variant;
277
- }
278
- /**
279
- * Props for components that apply typography styles from the theme.
280
- */
281
- interface TypographyProps {
282
- /**
283
- * The typography style to apply, matching a key defined in the theme's typography configuration.
284
- * For example, `"heading1"`, `"bodyLarge"`, etc.
285
- */
286
- typography?: string;
287
- }
288
- /**
289
- * Props for components that can be disabled.
290
- */
291
- interface DisabledProps {
292
- /**
293
- * When `true`, the component is non-interactive and visually dimmed.
294
- * @default false
295
- */
296
- disabled?: boolean;
297
- }
298
- /**
299
- * Props for components that can display a loading state.
300
- */
301
- interface LoadingProps {
302
- /**
303
- * When `true`, shows a loading indicator and blocks user interaction.
304
- * @default false
305
- */
306
- isLoading?: boolean;
307
- }
308
- /**
309
- * Props for components that can expand to full width.
310
- */
311
- interface FullWidthProps {
312
- /**
313
- * When `true`, the component spans the full available width of its container.
314
- * @default false
315
- */
316
- fullWidth?: boolean;
317
- }
318
- /**
319
- * Props for components that support clearing their current value.
320
- */
321
- interface ClearableProps {
322
- /**
323
- * When `true`, a clear button or action is shown to reset the value.
324
- * @default false
325
- */
326
- clearable?: boolean;
327
- /**
328
- * Callback invoked when the value is cleared (e.g., click on clear button).
329
- */
330
- onClear?: () => void;
331
- }
332
- /**
333
- * Props for enabling undo/redo functionality on the input value.
334
- */
335
- interface UndoRedoProps {
336
- /**
337
- * Callback invoked when an undo action is performed.
338
- * The new value is passed to allow external state synchronisation.
339
- */
340
- onUndo?: (value: string | number | undefined) => void;
341
- /**
342
- * Callback invoked when a redo action is performed.
343
- * The new value is passed to allow external state synchronisation.
344
- */
345
- onRedo?: (value: string | number | undefined) => void;
346
- }
347
- /**
348
- * Props for components that can display visual feedback states.
349
- * Typically used for form fields or interactive elements.
350
- */
351
- interface StateProps {
352
- /**
353
- * When `true`, applies an error style (e.g., red border, error icon).
354
- * @default false
355
- */
356
- error?: boolean;
357
- /**
358
- * When `true`, applies a success style (e.g., green border, checkmark).
359
- * @default false
360
- */
361
- success?: boolean;
362
- /**
363
- * When `true`, applies a warning style (e.g., yellow/orange border, warning icon).
364
- * @default false
365
- */
366
- warning?: boolean;
367
- /**
368
- * When `true`, automatically scrolls the input into view when it
369
- * transitions into an error state.
370
- * @default false
371
- */
372
- scrollIntoViewOnError?: boolean;
373
- }
374
- /**
375
- * Props for components that support a status indicator.
376
- * Typically used with `FormFieldStatus` from the design system.
377
- */
378
- interface StatusProps {
379
- /**
380
- * The status of the component. Can be `"success"`, `"error"`, `"warning"`, or `"none"`.
381
- * This influences the visual appearance (color, icon, etc.).
382
- */
383
- status?: FormFieldStatus;
384
- }
385
- /**
386
- * Props for components that arrange children in a group with a specific layout direction.
387
- */
388
- interface OrientationProps {
389
- /**
390
- * The layout direction of the group.
391
- * - `"horizontal"`: children are placed side by side.
392
- * - `"vertical"`: children are stacked vertically.
393
- * @default "horizontal"
394
- */
395
- orientation?: Orientation;
396
- }
397
- /**
398
- * Generic props for controlling a value with both controlled and uncontrolled modes.
399
- * Allows customising the property names for value, default value, and onChange.
400
- *
401
- * @template T - The type of the value.
402
- * @template TValueProp - The name of the controlled value property (default: `"value"`).
403
- * @template TDefaultProp - The name of the uncontrolled default property (default: `"defaultValue"`).
404
- * @template TOnChangeProp - The name of the change callback property (default: `"onValueChange"`).
405
- */
406
- type ControlledProps<T, TValueProp extends string = "value", TDefaultProp extends string = "defaultValue", TOnChangeProp extends string = "onValueChange", TIsRequired extends boolean = false> = TIsRequired extends true ? {
407
- [K in TValueProp]: T;
408
- } & {
409
- [K in TDefaultProp]: T;
410
- } & {
411
- [K in TOnChangeProp]: (value: T) => void;
412
- } : {
413
- [K in TValueProp]?: T;
414
- } & {
415
- [K in TDefaultProp]?: T;
416
- } & {
417
- [K in TOnChangeProp]?: (value: T) => void;
418
- };
419
- /**
420
- * Props for a controlled or uncontrolled stateful component.
421
- *
422
- * @typeParam T - The state value type.
423
- * @typeParam TStateProp - The controlled state prop name.
424
- * @typeParam TSetStateProp - The state change callback prop name.
425
- */
426
- /**
427
- * Defines optional state control props for a component: a state value and its setter.
428
- *
429
- * This is useful for components that can be used in both controlled and uncontrolled modes,
430
- * where the caller may provide state and setter optionally.
431
- *
432
- * @template T - The type of the state value (default: `boolean`).
433
- * @template TStateProp - The name of the state prop (default: `"state"`).
434
- * @template TSetStateProp - The name of the setter prop (default: `"setState"` based on `TStateProp`).
435
- *
436
- * @example
437
- * ```ts
438
- * interface MyComponentProps extends StateControlProps<string, "value", "onValueChange"> {
439
- * label: string;
440
- * }
441
- * // Result:
442
- * // {
443
- * // label: string;
444
- * // value?: string;
445
- * // onValueChange?: (value: string) => void;
446
- * // }
447
- * ```
448
- *
449
- * @example
450
- * ```ts
451
- * // Default prop names: "state" and "setState"
452
- * type Props = StateControlProps<number>;
453
- * // => { state?: number; setState?: (value: number) => void }
454
- * ```
455
- */
456
- type StateControlProps<T = boolean, TStateProp extends string = "state", TSetStateProp extends string = `set${Capitalize<TStateProp>}`> = {
457
- [K in TStateProp]?: T;
458
- } & {
459
- [K in TSetStateProp]?: (value: T) => void;
460
- };
461
- /**
462
- * Defines **required** state control props for a component: a mandatory state value and its setter.
463
- *
464
- * Use this when your component **must** be controlled externally – the caller is forced to provide
465
- * the state and the setter function.
466
- *
467
- * @template T - The type of the state value (default: `boolean`).
468
- * @template TStateProp - The name of the state prop (default: `"state"`).
469
- * @template TSetStateProp - The name of the setter prop (default: `"setState"` based on `TStateProp`).
470
- *
471
- * @example
472
- * ```ts
473
- * interface ControlledInputProps extends RequiredStateControlProps<string, "value", "onChange"> {
474
- * placeholder?: string;
475
- * }
476
- * // Result:
477
- * // {
478
- * // placeholder?: string;
479
- * // value: string;
480
- * // onChange: (value: string) => void;
481
- * // }
482
- * ```
483
- *
484
- * @example
485
- * ```ts
486
- * // Default prop names: "state" and "setState"
487
- * type Props = RequiredStateControlProps<number>;
488
- * // => { state: number; setState: (value: number) => void }
489
- * ```
490
- */
491
- type RequiredStateControlProps<T = boolean, TStateProp extends string = "state", TSetStateProp extends string = `set${Capitalize<TStateProp>}`> = {
492
- [K in TStateProp]: T;
493
- } & {
494
- [K in TSetStateProp]: (value: T) => void;
495
- };
496
- /**
497
- * Props for a string-based value component (e.g., input, select, textarea).
498
- * Uses `value`, `defaultValue`, and `onValueChange` as the controlled props.
499
- * @template T - The value type (defaults to `string`).
500
- */
501
- type ValueProps<T = string, TIsRequired extends boolean = false> = TIsRequired extends true ? ControlledProps<T, "value", "defaultValue", "onValueChange", true> : ControlledProps<T, "value", "defaultValue", "onValueChange">;
502
- /**
503
- * Props for components that can trim whitespace from the value.
504
- */
505
- interface TrimProps {
506
- /**
507
- * When `true`, removes leading and trailing whitespace from the value
508
- * when the value is committed (e.g., on blur or form submit).
509
- * @default false
510
- */
511
- trim?: boolean;
512
- }
513
- /**
514
- * Props for components that can be embedded inside a parent container.
515
- * When `embedded`, the component drops its own container styling (borders, radius, focus ring)
516
- * to blend seamlessly into the parent.
517
- */
518
- interface EmbeddedProps {
519
- /**
520
- * When `true`, renders the component without its standalone container styling.
521
- * Useful for components placed inside a parent that already provides a visual container.
522
- * @default false
523
- */
524
- embedded?: boolean;
525
- }
526
- /**
527
- * A validation result: either `true` (valid), `false` (invalid with default message),
528
- * or a `string` (invalid with custom message).
529
- */
530
- type ValidationResult = boolean | string;
531
- /**
532
- * Determines when validation should be triggered.
533
- * - `"change"`: on every value change.
534
- * - `"blur"`: when the element loses focus.
535
- * - `"both"`: on both change and blur.
536
- */
537
- type ValidateOn = "change" | "blur" | "both";
538
- /**
539
- * Props for components that support validation of their value.
540
- * @template T - The type of the value being validated.
541
- */
542
- interface ValidateProps<T = string> {
543
- /**
544
- * A validation function that receives the current value and returns:
545
- * - `true` if valid,
546
- * - `false` if invalid (default error message),
547
- * - a `string` if invalid (custom error message).
548
- */
549
- validate?: (value: T) => ValidationResult;
550
- /**
551
- * When to run the validation.
552
- * @default "blur"
553
- */
554
- validateOn?: ValidateOn;
555
- }
556
-
557
- export type { TypographyStyle as $, AnimationTokens as A, BaseBreakpoint as B, CSSPropertiesWithVars as C, DesignTokens as D, Easing as E, FontSizeTokens as F, RadiusTokens as G, ReportedValidity as H, RequiredStateControlProps as I, SemanticColorTokens as J, ShadowTokens as K, LetterSpacingTokens as L, SizeProps as M, SizeValue as N, Orientation as O, SpacingTokens as P, StateControlProps as Q, ResponsiveValue as R, Size as S, TokenValue as T, StateProps as U, StatusProps as V, Styleable as W, ThemeAnimation as X, TokenGroup as Y, TrimProps as Z, TypographyProps as _, ResponsiveStyles as a, UndoRedoProps as a0, ValidateOn as a1, ValidateProps as a2, ValidationResult as a3, ValueProps as a4, Variant as a5, VariantProps as a6, SemanticToken as b, Typography as c, TokenDefinition as d, TokenReferenceString as e, SemanticTokens as f, BaseColor as g, BaseProps as h, BaseVariant as i, BreakpointTokens as j, ClearableProps as k, ColorModeValue as l, ColorProps as m, ColorScale as n, ColorTokens as o, ControlledProps as p, DeepPartial as q, DisabledProps as r, EmbeddedProps as s, FontTokens as t, FontWeightTokens as u, FormFieldStatus as v, FullWidthProps as w, LineHeightTokens as x, LoadingProps as y, OrientationProps as z };