@qeetrix/icons 0.1.1

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+import type * as React from "react";
+/**
+ * Props accepted by every Qeetrix icon component.
+ *
+ * Deliberately a thin extension of `React.SVGProps<SVGSVGElement>` — anything
+ * valid on an `<svg>` element is valid here, including every `aria-*`
+ * attribute, `className`, `style`, `strokeWidth` and event handlers. The only
+ * addition is `size`, which sets `width` and `height` together.
+ *
+ * Named `QeetrixIconProps` rather than `IconProps` because `@qeetrix/ui`
+ * already exports an `IconProps` (the props of its `<Icon icon={…}>` wrapper).
+ * Distinct names let a consumer re-export both packages from one barrel.
+ */
+export type QeetrixIconProps = React.SVGProps<SVGSVGElement> & {
+    /** Rendered width and height. Defaults to `24`. */
+    size?: number | string;
+};
+/**
+ * Search and discovery metadata for a single icon.
+ *
+ * Generated into `@qeetrix/icons/metadata` from the `icons/` tree plus the
+ * hand-authored `icon-metadata.json`. Importable without pulling in any icon
+ * component, so an icon picker or docs search can read the catalogue cheaply.
+ *
+ * `tags`, `aliases` and `mirror` are required rather than optional: generated
+ * output with no conditionally-omitted keys produces far cleaner diffs, and an
+ * absent tag list and an empty one mean the same thing here.
+ */
+export interface IconMetadata {
+    /** Canonical kebab-case name, matching the source filename. */
+    name: string;
+    /** PascalCase name of the exported React component. */
+    component: string;
+    /** Category, always derived from the `icons/` subdirectory. */
+    category: string;
+    /** Free-form search keywords. */
+    tags: string[];
+    /** Alternative names that should resolve to this icon in a search. */
+    aliases: string[];
+    /** Whether the glyph must be mirrored horizontally under `dir="rtl"`. */
+    mirror: boolean;
+    /**
+     * Present only on icons scheduled for removal.
+     *
+     * An icon component is public API, so it is never deleted in a minor release.
+     * Marking it deprecated keeps it working and exporting while telling pickers,
+     * docs and codemods to stop offering it. Absent on every supported icon, so a
+     * consumer can treat `deprecated` as the whole signal.
+     */
+    deprecated?: IconDeprecation;
+}
+/** Why an icon is deprecated and what to use instead. */
+export interface IconDeprecation {
+    /** Version in which the icon was deprecated, e.g. `"0.2.0"`. */
+    since: string;
+    /** Canonical name of the icon to use instead, or `null` if there is none. */
+    replacement: string | null;
+    /** One sentence a developer can act on. */
+    reason: string;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@qeetrix/icons",
+  "version": "0.1.1",
+  "private": false,
+  "description": "Qeetrix Icons — the Qeet Group icon library. Outline icons on a 24×24 grid, generated from canonical SVG.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qeetgroup/qeetrix-icons.git"
+  },
+  "bugs": {
+    "url": "https://github.com/qeetgroup/qeetrix-icons/issues"
+  },
+  "homepage": "https://github.com/qeetgroup/qeetrix-icons#readme",
+  "keywords": [
+    "icons",
+    "svg",
+    "react",
+    "qeet",
+    "qeetrix",
+    "design-system"
+  ],
+  "type": "module",
+  "packageManager": "bun@1.3.14",
+  "engines": {
+    "node": ">=20",
+    "bun": ">=1.3.14"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./metadata": {
+      "types": "./dist/metadata.d.ts",
+      "import": "./dist/metadata.js",
+      "default": "./dist/metadata.js"
+    },
+    "./icons/*": {
+      "types": "./dist/icons/*.d.ts",
+      "import": "./dist/icons/*.js",
+      "default": "./dist/icons/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "clean": "node scripts/clean.mjs",
+    "validate": "node scripts/validate.mjs",
+    "generate": "node scripts/generate.mjs",
+    "generate:check": "node scripts/generate.mjs --check",
+    "explorer": "node scripts/explorer.mjs",
+    "doctor": "node scripts/doctor.mjs",
+    "catalog": "node scripts/catalog.mjs",
+    "catalog:check": "node scripts/catalog.mjs --check",
+    "api": "node scripts/api-docs.mjs",
+    "api:check": "node scripts/api-docs.mjs --check",
+    "verify:package": "node scripts/verify-package.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "biome check .",
+    "format": "biome check --write .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "build": "bun run clean && node scripts/generate.mjs && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "bun run build && changeset publish",
+    "prepack": "bun run build"
+  },
+  "peerDependencies": {
+    "react": ">=19"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.0.0",
+    "@changesets/cli": "^2.31.0",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/jsdom": "^30.0.0",
+    "@types/node": "^22.19.19",
+    "@types/react": "^19.2.15",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.2",
+    "axe-core": "^4.12.1",
+    "jsdom": "^29.1.1",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "svgson": "^5.3.1",
+    "tsc-alias": "^1.8.17",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9",
+    "vitest-axe": "^0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}