@totakit/icons 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to `@totakit/icons` will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- Initial package structure with exports map for 6 styles
+- React component contract: `forwardRef`, `SVGProps`, `size`/`color`/`strokeWidth` props
+- SVG subpath exports for raw SVG access
+- Metadata subpath exports for `icons.json`, `categories.json`, `aliases.json`
+- CSS subpath exports for CSS-only usage
+- MIT license

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 totakit
+
+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,160 @@
+<h1 align="center">@totakit/icons</h1>
+
+<p align="center">
+  <strong>Open-source icons with optical precision — 6 styles, one definition.</strong><br/>
+  <em>Stroke-compensated. Weight-normalized. Pixel-hinted.</em>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@totakit/icons"><img src="https://img.shields.io/npm/v/@totakit/icons?style=flat-square&label=npm" alt="npm"></a>
+  <a href="https://github.com/totakit/icons/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/totakit/icons/ci.yml?style=flat-square&label=CI" alt="CI"></a>
+  <a href="https://github.com/totakit/icons/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=flat-square" alt="License"></a>
+  <a href="https://icons.totakit.com"><img src="https://img.shields.io/badge/Browse-icons.totakit.com-6366f1?style=flat-square" alt="Browse"></a>
+</p>
+
+---
+
+## Installation
+
+```bash
+npm install @totakit/icons
+```
+
+```bash
+pnpm add @totakit/icons
+```
+
+```bash
+yarn add @totakit/icons
+```
+
+## Usage
+
+```tsx
+import { ArrowRight, Check, Plus, X, Minus } from '@totakit/icons'
+
+function App() {
+  return (
+    <nav>
+      <ArrowRight size={20} />
+      <Check size={20} color="green" />
+      <X size={20} color="red" />
+      <Plus />
+      <Minus />
+    </nav>
+  )
+}
+```
+
+Every icon is a React component with `forwardRef`, full TypeScript types, and all standard `SVGProps<SVGSVGElement>`.
+
+## Styles
+
+Each icon ships in 6 styles. Import from the style subpath — tree-shaking ensures you only bundle what you use.
+
+```tsx
+import { ArrowRight } from '@totakit/icons'           // outline (default)
+import { ArrowRight } from '@totakit/icons/solid'
+import { ArrowRight } from '@totakit/icons/duotone'
+import { ArrowRight } from '@totakit/icons/thin'
+import { ArrowRight } from '@totakit/icons/bold'
+import { ArrowRight } from '@totakit/icons/micro'
+```
+
+| Style | Stroke | Use case |
+|-------|--------|----------|
+| Outline | 1.5px | Default UI, navigation, toolbars |
+| Solid | Filled | Buttons, active states, emphasis |
+| Duotone | Two-tone | Dashboards, illustrations |
+| Thin | 1.0px | Elegant interfaces, large sizes |
+| Bold | 2.0px | Small sizes, dark backgrounds |
+| Micro | 2.0px simplified | 12–16px rendering, favicons, badges |
+
+## Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `size` | `number` | `24` | Width and height in pixels |
+| `color` | `string` | `'currentColor'` | Stroke/fill color |
+| `strokeWidth` | `number` | Style-dependent | Override stroke width |
+
+All `SVGProps<SVGSVGElement>` are also accepted — `className`, `style`, `onClick`, `aria-label`, etc.
+
+## Raw SVG
+
+For non-React usage, import SVG strings directly:
+
+```js
+import svg from '@totakit/icons/svg/outline/arrow-right.svg?raw'
+```
+
+## Metadata
+
+Icon metadata is available as JSON for tooling and search:
+
+```js
+import icons from '@totakit/icons/meta/icons.json'
+import categories from '@totakit/icons/meta/categories.json'
+```
+
+## CDN
+
+Use icons without a build step:
+
+```html
+<img src="https://icons.totakit.com/svg/arrow-right.svg" alt="" />
+<img src="https://icons.totakit.com/svg/check.svg?style=solid&size=32" alt="" />
+```
+
+Served from Cloudflare edge. Cached immutably.
+
+## Package Structure
+
+```
+@totakit/icons/
+├── dist/
+│   ├── index.js              ← Barrel (re-exports outline/*)
+│   ├── outline/              ← Default style
+│   ├── solid/
+│   ├── duotone/
+│   ├── thin/
+│   ├── bold/
+│   ├── micro/
+│   ├── svg/                  ← Raw SVG files
+│   │   ├── outline/
+│   │   ├── solid/
+│   │   └── ...
+│   └── meta/                 ← Metadata JSON
+│       ├── icons.json
+│       ├── categories.json
+│       └── aliases.json
+├── package.json
+├── README.md
+├── CHANGELOG.md
+└── LICENSE
+```
+
+## Related
+
+| Repository | Description |
+|------------|-------------|
+| [icons.totakit.com](https://icons.totakit.com) | Browse, search, and preview icons |
+| [`@totakit/cli`](https://github.com/totakit/cli) | Command-line interface |
+| [`@totakit/mcp-server`](https://github.com/totakit/mcp-server) | AI agent tool layer (MCP) |
+| [`@totakit/sdk`](https://github.com/totakit/sdk) | JavaScript/TypeScript SDK |
+
+## Contributing
+
+We welcome contributions. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+Icon requests: [icons.totakit.com/request](https://icons.totakit.com/request)
+
+## License
+
+MIT © [totakit](https://totakit.com)
+
+---
+
+<p align="center">
+  <sub>© 2026 totakit · <a href="https://totakit.com">totakit.com</a></sub>
+</p>

package/package.json

@@ -0,0 +1,139 @@
+{
+  "name": "@totakit/icons",
+  "version": "1.0.0",
+  "description": "Open-source icons with optical precision — 6 styles, one definition",
+  "author": "totakit <hello@totakit.com>",
+  "license": "MIT",
+  "homepage": "https://icons.totakit.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/totakit/icons.git"
+  },
+  "bugs": {
+    "url": "https://github.com/totakit/icons/issues"
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/nkr-ops"
+    },
+    {
+      "type": "custom",
+      "url": "https://totakit.com/pricing"
+    }
+  ],
+  "keywords": [
+    "icons",
+    "svg",
+    "react",
+    "react-icons",
+    "icon-library",
+    "icon-set",
+    "svg-icons",
+    "duotone",
+    "outline",
+    "solid",
+    "thin",
+    "bold",
+    "micro",
+    "totakit",
+    "design-system",
+    "ui-components",
+    "pixel-hinting",
+    "optical-precision",
+    "tree-shakeable",
+    "typescript"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./outline": {
+      "types": "./dist/outline/index.d.ts",
+      "import": "./dist/outline/index.js"
+    },
+    "./outline/*": {
+      "types": "./dist/outline/*.d.ts",
+      "import": "./dist/outline/*.js"
+    },
+    "./solid": {
+      "types": "./dist/solid/index.d.ts",
+      "import": "./dist/solid/index.js"
+    },
+    "./solid/*": {
+      "types": "./dist/solid/*.d.ts",
+      "import": "./dist/solid/*.js"
+    },
+    "./duotone": {
+      "types": "./dist/duotone/index.d.ts",
+      "import": "./dist/duotone/index.js"
+    },
+    "./duotone/*": {
+      "types": "./dist/duotone/*.d.ts",
+      "import": "./dist/duotone/*.js"
+    },
+    "./thin": {
+      "types": "./dist/thin/index.d.ts",
+      "import": "./dist/thin/index.js"
+    },
+    "./thin/*": {
+      "types": "./dist/thin/*.d.ts",
+      "import": "./dist/thin/*.js"
+    },
+    "./bold": {
+      "types": "./dist/bold/index.d.ts",
+      "import": "./dist/bold/index.js"
+    },
+    "./bold/*": {
+      "types": "./dist/bold/*.d.ts",
+      "import": "./dist/bold/*.js"
+    },
+    "./micro": {
+      "types": "./dist/micro/index.d.ts",
+      "import": "./dist/micro/index.js"
+    },
+    "./micro/*": {
+      "types": "./dist/micro/*.d.ts",
+      "import": "./dist/micro/*.js"
+    },
+    "./svg/*": "./dist/svg/*",
+    "./meta/*": "./dist/meta/*",
+    "./css/*": "./dist/css/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run clean"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.8.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}