@goliapkg/gds 0.1.0

package/llms.txt

@@ -0,0 +1,49 @@
+# @goliapkg/gds
+
+> GOLIA Design System — enterprise-grade React UI component library with 370+ components, contextual depth, glass materials, and AI-native structure. Built by GOLIA for all company React web applications.
+
+## Quick Reference
+
+- [Full AI Reference](llms-full.txt): complete component API, patterns, and usage examples
+- [Component Index](src/index.ts): all public exports
+- [Design Tokens](src/l0-tokens/): CSS variables, color math, sizing, motion, glass, gestures
+- [Theme System](src/l1-systems/): Jotai-based 5-axis theme engine
+- [Dependency Manifest](src/l0-tokens/deps.ts): all external deps with layer constraints
+- [Design Principles](/.claude/rules/gds-philosophy.md): 10 governing principles
+- [Library Standards](/.claude/rules/gds-lib.md): coding standards for components
+
+## Architecture
+
+8-layer system with strict upward-only dependency flow:
+
+- L0 Tokens: CSS variables, color derivation, scales, motion, glass, gestures
+- L1 Systems: Theme engine (Jotai atoms), hooks, state management
+- L2 Primitives (~30): Stateless visual blocks — Button, Input, Badge, Spinner...
+- L3 Atoms (~60): Simple composed — Avatar, Checkbox, Tooltip, Switch, Rating...
+- L4 Molecules (~70): Multi-part — Card, Dialog, Tabs, Select, Dropdown, Sheet...
+- L5 Organisms (~60): Complex — DataTable, Calendar, Kanban, FileBrowser, Tree...
+- L6 Charts (31): Recharts-based — Bar, Line, Heatmap, Sankey, Treemap, Gauge...
+- L7 Patterns (~55): Page layouts — Dashboard, Admin, Settings, Login, Sidebar...
+- Utils: Anti-corruption layer — cx(), focusCls, VariantProps, dom, glass, motion
+
+## Component Pattern
+
+Every component follows: CVA variants → typed Props → forwardRef → cx() merging → data-* attributes
+
+## Key Props (available on most components)
+
+- glass?: boolean — frosted translucency material
+- motion?: string — animation preset (fade, scale, slide, spring)
+- variant — visual style variant (via CVA)
+- size — size variant (sm, default, lg)
+- className — consumer override (merged via cx)
+
+## Styling System
+
+- Semantic tokens only (never raw Tailwind colors)
+- Contextual depth: gds-ctx class auto-scales spacing/radius/shadow/text per nesting level
+- Depth utilities: gds-pad, gds-gap, gds-radius, gds-shadow, gds-text, gds-heading
+
+## Tech Stack
+
+React 19, TypeScript 5 (strict), Tailwind CSS 4, CVA, Jotai, Recharts 3, Lucide, Vite 8

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "@goliapkg/gds",
+  "version": "0.1.0",
+  "description": "GOLIA Design System — enterprise-grade UI component library with contextual depth, glass materials, AI-native structure, and 10 design principles",
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "GOLIA <dev@golia.jp> (https://golia.jp)",
+  "homepage": "https://github.com/goliajp/gds#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/goliajp/gds.git"
+  },
+  "bugs": {
+    "url": "https://github.com/goliajp/gds/issues"
+  },
+  "keywords": [
+    "react",
+    "design-system",
+    "component-library",
+    "ui",
+    "tailwindcss",
+    "typescript",
+    "ai-native",
+    "glass-ui",
+    "dark-mode",
+    "enterprise"
+  ],
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./tokens.css": "./dist/tokens.css",
+    "./fonts.css": "./dist/fonts.css",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "llms.txt",
+    "llms-full.txt"
+  ],
+  "sideEffects": [
+    "*.css"
+  ],
+  "scripts": {
+    "dev": "vite --config dev-center/vite.config.ts --port 5175",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/",
+    "lint:fix": "eslint --fix src/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "build": "bun run clean && bun run build:lib && bun run build:types && bun run build:css",
+    "build:lib": "vite build --config vite.config.lib.ts",
+    "build:types": "tsc -p tsconfig.build.json",
+    "build:css": "cp src/l0-tokens/tokens.css dist/tokens.css && cp src/l0-tokens/fonts.css dist/fonts.css && cp -r src/l0-tokens/fonts dist/fonts",
+    "prepublishOnly": "bun run check && bun run build",
+    "release": "bun run prepublishOnly && npm publish",
+    "check": "bun run test && bun run typecheck && bun run lint",
+    "precommit": "bun run check"
+  },
+  "peerDependencies": {
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
+  },
+  "dependencies": {
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "jotai": "^2.18.1",
+    "lucide-react": "^0.577.0",
+    "react-router": "^7.13.2",
+    "recharts": "^3.8.0",
+    "shiki": "^4.0.2",
+    "tailwind-merge": "^3.5.0",
+    "tailwindcss": "^4.2.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@tailwindcss/vite": "^4.2.2",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.1",
+    "@vitest/coverage-v8": "^4.1.1",
+    "eslint": "^10.1.0",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "happy-dom": "^20.8.7",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.57.2",
+    "vite": "^8.0.2",
+    "vitest": "^4.1.1"
+  }
+}