@orion-ds/core 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Orion Design System
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,152 @@
+# @orion/core
+
+Core design tokens and utilities for the Orion Design System.
+
+## Installation
+
+```bash
+npm install @orion/core
+# or
+pnpm add @orion/core
+# or
+yarn add @orion/core
+```
+
+## Usage
+
+### Import CSS Variables
+
+```css
+@import '@orion/core/theme.css';
+```
+
+### Use TypeScript Tokens
+
+```typescript
+import { primitives, getToken, getSemanticToken } from '@orion/core';
+
+// Access primitive tokens
+const brandColor = primitives.color.brand.orion[500]; // "#1B5BFF"
+const spacing = primitives.spacing[4]; // "16px"
+
+// Get tokens by path
+const color = getToken('color.brand.orion.500'); // "#1B5BFF"
+
+// Get semantic tokens
+const surfaceBase = getSemanticToken('light', 'surface.base'); // "#ffffff"
+const textPrimary = getSemanticToken('dark', 'text.primary'); // "#ffffff"
+```
+
+### Type-Safe Token Paths
+
+```typescript
+import type { TokenPath, SemanticTokenPath } from '@orion/core';
+
+// TypeScript will autocomplete and validate token paths
+const path: TokenPath = 'color.brand.orion.500'; // ✅
+const invalid: TokenPath = 'color.brand.invalid.500'; // ❌ Type error
+
+const semantic: SemanticTokenPath = 'surface.base'; // ✅
+const invalidSemantic: SemanticTokenPath = 'invalid.token'; // ❌ Type error
+```
+
+### Brand and Theme Support
+
+```typescript
+import { brands, themes, getBrand, isValidTheme } from '@orion/core';
+
+// Access brand configuration
+const orionBrand = getBrand('orion');
+console.log(orionBrand.accentColor); // "#1B5BFF"
+console.log(orionBrand.radius); // "12px"
+
+// Check if theme is valid
+if (isValidTheme('dark')) {
+  // Load dark theme
+}
+
+// Access all themes
+console.log(themes.light);
+console.log(themes.dark);
+```
+
+## Features
+
+- **Type-Safe**: Full TypeScript support with autocomplete
+- **Chain of Truth**: Enforced token hierarchy (Primitives → Semantics → Components)
+- **Multi-Brand**: Support for Orion, UVM, Unitec, and Laureate brands
+- **Multi-Theme**: Light and dark theme support
+- **Zero Runtime**: Types are compile-time only, no runtime overhead
+- **Tree-Shakeable**: Import only what you need
+
+## Architecture
+
+### Primitives (Layer 1)
+Raw values that never change:
+- Colors (brand, neutral, status)
+- Typography (family, size, weight, line-height)
+- Spacing (0-32 scale)
+- Radius (sm, md, lg, xl, full)
+- Blur (sm, md, lg, xl)
+
+### Semantics (Layer 2)
+Intent-based aliases that describe purpose:
+- Surface (base, subtle, layer, glass, sunken)
+- Text (primary, secondary, tertiary, inverse, brand)
+- Interactive (primary, secondary, ghost)
+- Border (subtle, strong, interactive)
+- Status (error, success, warning, info)
+
+### CSS Variables (Layer 3)
+Browser-consumable variables:
+- `--surface-base`
+- `--text-primary`
+- `--interactive-primary`
+- `--spacing-4`
+- `--radius-control`
+
+## Token Path Types
+
+All token paths are type-checked:
+
+```typescript
+type ColorTokenPath =
+  | `color.brand.${Brand}.${keyof ColorShades}`
+  | `color.neutral.${keyof NeutralColors}`
+  | 'color.error.500'
+  | 'color.success.500'
+  | 'color.warning.500'
+  | 'color.info.500';
+
+type SemanticTokenPath =
+  | `surface.${keyof SurfaceSemantics}`
+  | `text.${keyof TextSemantics}`
+  | `interactive.primary.${keyof InteractivePrimarySemantics}`
+  // ...
+```
+
+## API Reference
+
+### Functions
+
+#### `getToken(path: TokenPath): string`
+Get a primitive token value by path.
+
+#### `getSemanticToken(theme: Theme, path: SemanticTokenPath): string`
+Get a semantic token value for a specific theme.
+
+#### `getBrand(brand: Brand): BrandConfig`
+Get brand configuration.
+
+#### `toCSSVariable(path: SemanticTokenPath): string`
+Convert semantic path to CSS variable name.
+
+#### `isValidTheme(value: string): value is Theme`
+Type guard for valid theme.
+
+#### `isValidBrand(value: string): value is Brand`
+Type guard for valid brand.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @orion/core - Orion Design System Core Package
+ *
+ * This package provides the foundational design tokens and utilities
+ * for the Orion Design System. It follows the "Chain of Truth" architecture:
+ *
+ * Layer 1: Primitives (raw values)
+ * Layer 2: Semantics (intent-based aliases)
+ * Layer 3: CSS Variables (browser-consumable)
+ * Layer 4: Components (blind consumers)
+ *
+ * @packageDocumentation
+ */
+export * from './tokens';
+export type { Theme, Brand, TokenPath, SemanticTokenPath, CSSVariableName, Primitives, SemanticTokens, } from './tokens/types';
+export { primitives, color, typography, spacing, radius, blur, icon, } from './tokens/primitives';
+export { lightTheme, darkTheme, themes, } from './tokens/themes';
+export { brands, defaultBrand, } from './tokens/brands';
+export { getToken, getSemanticToken, getBrand, toCSSVariable, isValidTheme, isValidBrand, } from './tokens/utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,cAAc,UAAU,CAAC;AAGzB,YAAY,EACV,KAAK,EACL,KAAK,EACL,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,UAAU,EACV,KAAK,EACL,UAAU,EACV,OAAO,EACP,MAAM,EACN,IAAI,EACJ,IAAI,GACL,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,SAAS,EACT,MAAM,GACP,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,MAAM,EACN,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @orion/core - Orion Design System Core Package
+ *
+ * This package provides the foundational design tokens and utilities
+ * for the Orion Design System. It follows the "Chain of Truth" architecture:
+ *
+ * Layer 1: Primitives (raw values)
+ * Layer 2: Semantics (intent-based aliases)
+ * Layer 3: CSS Variables (browser-consumable)
+ * Layer 4: Components (blind consumers)
+ *
+ * @packageDocumentation
+ */
+// Export all token types and values
+export * from './tokens';
+export { primitives, color, typography, spacing, radius, blur, icon, } from './tokens/primitives';
+export { lightTheme, darkTheme, themes, } from './tokens/themes';
+export { brands, defaultBrand, } from './tokens/brands';
+export { getToken, getSemanticToken, getBrand, toCSSVariable, isValidTheme, isValidBrand, } from './tokens/utils';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,oCAAoC;AACpC,cAAc,UAAU,CAAC;AAazB,OAAO,EACL,UAAU,EACV,KAAK,EACL,UAAU,EACV,OAAO,EACP,MAAM,EACN,IAAI,EACJ,IAAI,GACL,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,SAAS,EACT,MAAM,GACP,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,MAAM,EACN,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,gBAAgB,CAAC"}