@goliapkg/gds 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present GOLIA
+
+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,101 @@
+# @goliapkg/gds
+
+**GOLIA Design System** — enterprise-grade React UI component library built by [GOLIA](https://github.com/goliajp).
+
+Powering all GOLIA React web applications with a unified, AI-friendly component system.
+
+## Features
+
+- **370+ components** across 8 architectural layers (tokens → patterns)
+- **AI-native** — semantic `data-*` attributes, typed props, machine-readable documentation. AI agents can learn the system from types and playground demos alone
+- **Contextual depth** — components auto-scale spacing, radius, shadow, and typography based on nesting depth. Zero configuration
+- **Glass material** — frosted translucency as a first-class material system with `glass` prop
+- **Motion system** — spring physics animation vocabulary with `motion` prop
+- **Dark-native** — designed for dark mode first, light mode derived
+- **Keyboard-first** — every action reachable by keyboard, visible focus indicators everywhere
+- **5-axis theming** — density, elevation, glass, motion, shape — all controllable at runtime via Jotai atoms
+- **Gesture support** — drag, swipe, pinch-zoom, long-press, pull-to-refresh built into the token layer
+
+## Architecture
+
+```
+src/
+├── l0-tokens/      design tokens: color math, sizing, radius, shadow, glass, motion, gestures
+├── l1-systems/     theme engine (Jotai), 5-axis dimensional state
+├── l2-primitives/  ~30 stateless visual blocks (Button, Input, Badge...)
+├── l3-atoms/       ~60 simple composed elements (Avatar, Checkbox, Tooltip...)
+├── l4-molecules/   ~70 multi-part components (Card, Dialog, Tabs, Select...)
+├── l5-organisms/   ~60 complex features (DataTable, Calendar, Kanban...)
+├── l6-charts/      31 Recharts-based visualizations (Bar, Line, Heatmap, Sankey...)
+├── l7-patterns/    ~55 page-level layouts (Dashboard, Admin, Settings...)
+└── utils/          anti-corruption layer (cx, a11y, dom, types)
+```
+
+Each layer has **strict dependency constraints** enforced by ESLint — higher layers import from lower layers, never the reverse.
+
+## Quick Start
+
+```bash
+bun add @goliapkg/gds
+```
+
+```tsx
+import { Button, Card, CardHeader, CardContent } from '@goliapkg/gds'
+import '@goliapkg/gds/tokens.css'
+
+function App() {
+  return (
+    <Card glass>
+      <CardHeader title="Hello GDS" />
+      <CardContent>
+        <Button variant="primary" motion="scale">
+          Get Started
+        </Button>
+      </CardContent>
+    </Card>
+  )
+}
+```
+
+## Development
+
+```bash
+git clone git@github.com:goliajp/gds.git
+cd gds
+bun install
+bun dev              # dev-center at localhost:5175
+bun test             # run tests
+bun run test:coverage # coverage report (80% threshold)
+bun run check        # test + typecheck + lint
+```
+
+## For AI Agents
+
+GDS is designed to be learned and applied by AI. Key entry points:
+
+| What you need | Where to look |
+|---------------|---------------|
+| All exported components & types | `src/index.ts` |
+| Component API patterns | `src/l3-atoms/button/button.tsx` (canonical example) |
+| Design tokens & CSS variables | `src/l0-tokens/` |
+| Layer dependency rules | `src/l0-tokens/deps.ts` |
+| Design principles | `.claude/rules/gds-philosophy.md` |
+| Coding standards | `.claude/rules/gds-lib.md` |
+| Live examples | `dev-center/src/items/` (150+ demos) |
+
+Every component follows the same pattern: **CVA variants → typed Props → forwardRef → cx() class merging**. Learn one, apply to all.
+
+## Tech Stack
+
+- **React 19** + **TypeScript 5** (strict mode)
+- **Tailwind CSS 4** with semantic design tokens
+- **CVA** (class-variance-authority) for variant management
+- **Jotai** for theme state
+- **Recharts 3** for data visualization
+- **Lucide** for icons
+- **Vite 8** for dev server and build
+- **Vitest 4** for testing (happy-dom, 80% coverage threshold)
+
+## License
+
+[MIT](LICENSE) — GOLIA

package/dist/fonts.css

@@ -0,0 +1,36 @@
+/* L0 — Font Definitions
+ * Latin fonts: self-hosted woff2 (~1.3MB total)
+ * CJK fonts: Google Fonts CDN with unicode-range subsetting (on-demand)
+ * strategy: latin loads immediately, CJK loads only when characters are needed
+ */
+
+/* === Inter (latin — body text) === */
+@font-face { font-family: 'Inter'; font-style: normal; font-weight: 300; font-display: swap; src: url('./fonts/Inter-Light.woff2') format('woff2'); }
+@font-face { font-family: 'Inter'; font-style: normal; font-weight: 400; font-display: swap; src: url('./fonts/Inter-Regular.woff2') format('woff2'); }
+@font-face { font-family: 'Inter'; font-style: normal; font-weight: 500; font-display: swap; src: url('./fonts/Inter-Medium.woff2') format('woff2'); }
+@font-face { font-family: 'Inter'; font-style: normal; font-weight: 600; font-display: swap; src: url('./fonts/Inter-SemiBold.woff2') format('woff2'); }
+@font-face { font-family: 'Inter'; font-style: normal; font-weight: 700; font-display: swap; src: url('./fonts/Inter-Bold.woff2') format('woff2'); }
+@font-face { font-family: 'Inter'; font-style: italic; font-weight: 400; font-display: swap; src: url('./fonts/Inter-Italic.woff2') format('woff2'); }
+@font-face { font-family: 'Inter'; font-style: italic; font-weight: 500; font-display: swap; src: url('./fonts/Inter-MediumItalic.woff2') format('woff2'); }
+
+/* === JetBrains Mono (latin — code/mono) === */
+@font-face { font-family: 'JetBrains Mono'; font-style: normal; font-weight: 400; font-display: swap; src: url('./fonts/JetBrainsMono-Regular.woff2') format('woff2'); }
+@font-face { font-family: 'JetBrains Mono'; font-style: normal; font-weight: 500; font-display: swap; src: url('./fonts/JetBrainsMono-Medium.woff2') format('woff2'); }
+@font-face { font-family: 'JetBrains Mono'; font-style: normal; font-weight: 700; font-display: swap; src: url('./fonts/JetBrainsMono-Bold.woff2') format('woff2'); }
+
+/* === Roboto Flex (latin — variable, MONO axis for equal-width UI text) === */
+@font-face { font-family: 'Roboto Flex'; font-style: normal; font-weight: 300 700; font-display: swap; src: url('./fonts/RobotoFlex-Variable.ttf') format('truetype'); }
+
+/* === CJK — Google Fonts CDN with unicode-range subsetting ===
+ * These are loaded on-demand: only the character subsets actually used on the page
+ * are downloaded. Each subset is ~50-150KB instead of 16MB per language.
+ *
+ * To enable CJK support, add this to your HTML <head>:
+ *
+ *   <link rel="preconnect" href="https://fonts.googleapis.com" />
+ *   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+ *   <link href="https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@300;400;500;600;700&family=Noto+Sans+JP:wght@300;400;500;600;700&family=Noto+Sans+KR:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
+ *
+ * This is intentionally NOT @import-ed here to avoid blocking the critical path.
+ * Latin fonts load from self-hosted woff2 (fast), CJK loads async from CDN.
+ */

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export type { DepInfo } from './l0-tokens/deps';
+export { GDS_DEPS, GDS_INFRA, GDS_INTERNAL_UTILS, LAYER_DEP_CONSTRAINTS } from './l0-tokens/deps';
+export * from './l0-tokens';
+export type { ThemeColorOverrides, ThemeMode, ThemeState } from './l1-systems/theme';
+export { DEFAULT_THEME, resolvedModeAtom, resolveThemeCssVars, themeAtom } from './l1-systems/theme';
+export { configureTheme, useResetTheme, useResolvedMode, useSetThemeColors, useSetThemeDensity, useSetThemeElevation, useSetThemeGlass, useSetThemeMode, useSetThemeMotion, useSetThemePreset, useSetThemeShape, useTheme, useThemeEffect, } from './l1-systems/use-theme';
+export * from './l2-primitives';
+export * from './l3-atoms';
+export * from './l4-molecules';
+export * from './l5-organisms';
+export * from './l6-charts';
+export * from './l7-patterns';
+export { focusCls, srOnly } from './utils/a11y';
+export { cx } from './utils/cx';
+export { clamp, isActivationKey, mergeRefs, uid } from './utils/dom';
+export type { AsProps, DataRecord, MergeProps, PartialExcept, RequireKeys, VariantProps, } from './utils/types';
+//# 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":"AAIA,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAEjG,cAAc,aAAa,CAAA;AAG3B,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpF,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACpG,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACR,cAAc,GACf,MAAM,wBAAwB,CAAA;AAG/B,cAAc,iBAAiB,CAAA;AAG/B,cAAc,YAAY,CAAA;AAG1B,cAAc,gBAAgB,CAAA;AAG9B,cAAc,gBAAgB,CAAA;AAG9B,cAAc,aAAa,CAAA;AAG3B,cAAc,eAAe,CAAA;AAG7B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAC/B,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACpE,YAAY,EACV,OAAO,EACP,UAAU,EACV,UAAU,EACV,aAAa,EACb,WAAW,EACX,YAAY,GACb,MAAM,eAAe,CAAA"}