@kaijudo/react-game-types 0.1.0

package/.storybook/main.ts

@@ -0,0 +1,43 @@
+import type { StorybookConfig } from "@storybook/react-vite";
+import path from "path";
+
+const config: StorybookConfig = {
+  stories: ["../src/**/*.stories.@(js|jsx|mjs|ts|tsx)"],
+  addons: [
+    "@storybook/addon-links",
+    "@storybook/addon-essentials",
+    "@storybook/addon-interactions",
+  ],
+  framework: {
+    name: "@storybook/react-vite",
+    options: {},
+  },
+  docs: {
+    autodocs: "tag",
+  },
+  async viteFinal(config) {
+    // Dynamic imports to avoid ESM/CommonJS conflicts
+    const { mergeConfig } = await import("vite");
+    const { default: tailwindcss } = await import("@tailwindcss/vite");
+    const viteTsConfigPaths = (await import("vite-tsconfig-paths")).default;
+
+    return mergeConfig(config, {
+      plugins: [
+        tailwindcss(),
+        viteTsConfigPaths({
+          projects: [path.resolve(__dirname, "../tsconfig.json")],
+        }),
+      ],
+      resolve: {
+        alias: {
+          "@kaijudo/creature-images": path.resolve(
+            __dirname,
+            "../../creature-images/src"
+          ),
+        },
+      },
+    });
+  },
+};
+
+export default config;

package/.storybook/preview.ts

@@ -0,0 +1,14 @@
+import type { Preview } from '@storybook/react';
+
+const preview: Preview = {
+  parameters: {
+    controls: {
+      matchers: {
+        color: /(background|color)$/i,
+        date: /Date$/i,
+      },
+    },
+  },
+};
+
+export default preview;

package/CHANGELOG.md

@@ -0,0 +1,92 @@
+## 0.4.0 (2025-12-25)
+
+### 🚀 Features
+
+- Package rename and deployment preparation. ([ee2e8fd](https://github.com/vreddi/kaijudo/commit/ee2e8fd))
+
+  ## Changes
+
+  - Renamed package from `@kaijudo/types` to `@kaijudo/react-game-types`
+  - Updated package name and all internal references
+  - Maintains all existing functionality and type definitions
+  - Ready for initial public release under new package name
+
+  ## Package Contents
+
+  - Type definitions for core game entities:
+    - `Era` - Game era enumeration
+    - `Rarity` - Card rarity types
+    - `Race` - Creature race definitions
+    - `Civilization` - Civilization types
+  - Full TypeScript support with type exports
+  - ESM and CommonJS module support
+
+  ## Publishing
+
+  - Configured for npm publishing with public access
+  - GitHub Actions workflow ready for automated publishing
+  - Project-level changelog enabled
+
+### ❤️ Thank You
+
+- Vishrut Reddi @vreddi
+
+# Changelog
+
+This file contains all notable changes to the `@kaijudo/types` package.
+
+## 0.2.0 (2025-12-25)
+
+### 🚀 Features
+
+- Initial release of @kaijudo/types package. ([73bc579](https://github.com/vreddi/kaijudo/commit/73bc579))
+
+  This is the first public release of the types package, providing core type definitions for the Kaijudo project.
+
+  ## Features
+
+  - Type definitions for core game entities:
+    - `Era` - Game era enumeration
+    - `Rarity` - Card rarity types
+    - `Race` - Creature race definitions
+  - Full TypeScript support with type exports
+  - ESM and CommonJS module support
+  - Comprehensive type definitions for game mechanics
+
+  ## Package Setup
+
+  - Configured for publishing to npm
+  - Version plans workflow enabled
+  - GitHub Actions publishing pipeline ready
+
+### ❤️ Thank You
+
+- Vishrut Reddi @vreddi
+
+## 0.1.0 (2025-12-25)
+
+### 🚀 Features
+
+- Initial release of @kaijudo/types package. ([73bc579](https://github.com/vreddi/kaijudo/commit/73bc579))
+
+  This is the first public release of the types package, providing core type definitions for the Kaijudo project.
+
+  ## Features
+
+  - Type definitions for core game entities:
+    - `Era` - Game era enumeration
+    - `Rarity` - Card rarity types
+    - `Race` - Creature race definitions
+  - Full TypeScript support with type exports
+  - ESM and CommonJS module support
+  - Comprehensive type definitions for game mechanics
+
+  ## Package Setup
+
+  - Configured for publishing to npm
+  - Version plans workflow enabled
+  - GitHub Actions publishing pipeline ready
+
+### ❤️ Thank You
+
+- Vishrut Reddi @vreddi

package/README.md

@@ -0,0 +1,42 @@
+# @kaijudo/create-types
+
+A React component package.
+
+## Installation
+
+```bash
+pnpm add @kaijudo/create-types
+```
+
+## Usage
+
+```tsx
+import { CreateTypes } from '@kaijudo/create-types';
+
+function App() {
+  return <CreateTypes>Hello World</CreateTypes>;
+}
+```
+
+## Development
+
+### Build
+
+```bash
+pnpm build
+```
+
+### Storybook
+
+Run Storybook to view and test the component:
+
+```bash
+pnpm storybook
+```
+
+Build static Storybook:
+
+```bash
+pnpm build-storybook
+```
+

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@kaijudo/react-game-types",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^3.0.2",
+    "class-variance-authority": "^0.7.1",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "@kaijudo/react-storybook": "0.0.1"
+  },
+  "devDependencies": {
+    "@storybook/addon-essentials": "*",
+    "@storybook/addon-interactions": "*",
+    "@storybook/addon-links": "*",
+    "@storybook/blocks": "*",
+    "@storybook/react": "*",
+    "@storybook/react-vite": "*",
+    "@storybook/test": "*",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "storybook": "*",
+    "tsup": "^8.5.1",
+    "typescript": "~5.9.2",
+    "vite": "^7.1.7",
+    "vitest": "^3.0.5",
+    "@testing-library/react": "^16.2.0",
+    "@testing-library/jest-dom": "^6.6.3",
+    "jsdom": "^27.0.0"
+  },
+  "peerDependencies": {
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "tailwindcss": "^4.0.0",
+    "@tailwindcss/vite": "^4.0.0",
+    "motion": "^12.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vreddi/kaijudo.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build"
+  }
+}

package/project.json

@@ -0,0 +1,39 @@
+{
+  "name": "@kaijudo/react-game-types",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "projectType": "library",
+  "sourceRoot": "src",
+  "tags": ["publishable"],
+  "targets": {
+    "build": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "tsup",
+        "cwd": "{projectRoot}"
+      },
+      "outputs": ["{projectRoot}/dist"]
+    },
+    "storybook": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "storybook dev -p 6006 --config-dir .storybook",
+        "cwd": "{projectRoot}"
+      }
+    },
+    "build-storybook": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "storybook build --config-dir .storybook",
+        "cwd": "{projectRoot}"
+      },
+      "outputs": ["{workspaceRoot}/storybook-static"]
+    },
+    "test": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "vitest run",
+        "cwd": "."
+      }
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { Era } from "./types/era";
+export { Rarity } from "./types/rarity";
+export { Race } from "./types/race";

package/src/types/civilization/civilization.test.ts

@@ -0,0 +1,114 @@
+import { describe, it, expect } from "vitest";
+import { Civilization } from "./civilization";
+
+describe("Civilization", () => {
+  describe("enum values", () => {
+    it("should have all expected civilization values", () => {
+      expect(Civilization.Light).toBe("light");
+      expect(Civilization.Water).toBe("water");
+      expect(Civilization.Darkness).toBe("darkness");
+      expect(Civilization.Fire).toBe("fire");
+      expect(Civilization.Nature).toBe("nature");
+    });
+
+    it("should have exactly 5 civilizations", () => {
+      const values = Object.values(Civilization);
+      expect(values).toHaveLength(5);
+    });
+
+    it("should have unique values", () => {
+      const values = Object.values(Civilization);
+      const uniqueValues = new Set(values);
+      expect(uniqueValues.size).toBe(values.length);
+    });
+
+    it("should have all values as strings", () => {
+      const values = Object.values(Civilization);
+      values.forEach((value) => {
+        expect(typeof value).toBe("string");
+      });
+    });
+  });
+
+  describe("enum keys", () => {
+    it("should have correct key names", () => {
+      expect(Civilization.Light).toBeDefined();
+      expect(Civilization.Water).toBeDefined();
+      expect(Civilization.Darkness).toBeDefined();
+      expect(Civilization.Fire).toBeDefined();
+      expect(Civilization.Nature).toBeDefined();
+    });
+
+    it("should have all keys as expected", () => {
+      const keys = Object.keys(Civilization);
+      const expectedKeys = ["Light", "Water", "Darkness", "Fire", "Nature"];
+      expect(keys.sort()).toEqual(expectedKeys.sort());
+    });
+  });
+
+  describe("enum usage", () => {
+    it("should be usable in comparisons", () => {
+      expect(Civilization.Light === "light").toBe(true);
+      expect(Civilization.Water === "water").toBe(true);
+      expect(Civilization.Darkness === "darkness").toBe(true);
+      expect(Civilization.Fire === "fire").toBe(true);
+      expect(Civilization.Nature === "nature").toBe(true);
+    });
+
+    it("should be iterable", () => {
+      const values = Object.values(Civilization);
+      expect(values).toContain("light");
+      expect(values).toContain("water");
+      expect(values).toContain("darkness");
+      expect(values).toContain("fire");
+      expect(values).toContain("nature");
+    });
+
+    it("should be usable in switch statements", () => {
+      const getCivilizationType = (civilization: Civilization): string => {
+        switch (civilization) {
+          case Civilization.Light:
+            return "defensive";
+          case Civilization.Water:
+            return "control";
+          case Civilization.Darkness:
+            return "aggressive";
+          case Civilization.Fire:
+            return "rush";
+          case Civilization.Nature:
+            return "ramp";
+          default:
+            return "unknown";
+        }
+      };
+
+      expect(getCivilizationType(Civilization.Light)).toBe("defensive");
+      expect(getCivilizationType(Civilization.Water)).toBe("control");
+      expect(getCivilizationType(Civilization.Darkness)).toBe("aggressive");
+      expect(getCivilizationType(Civilization.Fire)).toBe("rush");
+      expect(getCivilizationType(Civilization.Nature)).toBe("ramp");
+    });
+  });
+
+  describe("specific civilization values", () => {
+    it("should have Light civilization with correct value", () => {
+      expect(Civilization.Light).toBe("light");
+    });
+
+    it("should have Water civilization with correct value", () => {
+      expect(Civilization.Water).toBe("water");
+    });
+
+    it("should have Darkness civilization with correct value", () => {
+      expect(Civilization.Darkness).toBe("darkness");
+    });
+
+    it("should have Fire civilization with correct value", () => {
+      expect(Civilization.Fire).toBe("fire");
+    });
+
+    it("should have Nature civilization with correct value", () => {
+      expect(Civilization.Nature).toBe("nature");
+    });
+  });
+});

package/src/types/civilization/civilization.ts

@@ -0,0 +1,50 @@
+/**
+ * Civilization is a gameplay characteristic
+ * indicating the powers.
+ */
+export enum Civilization {
+  /**
+   * Defense, control, and order -
+   * blockers, shields, tapping/stun effects,
+   * and defensive utility; stabilizes the
+   * game and wins through inevitability.
+   * @docs https://duelmasters.fandom.com/wiki/Light_Civilization
+   */
+  Light = "light",
+
+  /**
+   * Card advantage and tempo - draws cards,
+   * bounces threats, manipulates hand/board,
+   * and wins by out-resourcing and out-positioning
+   * opponents.
+   * @docs https://duelmasters.fandom.com/wiki/Water_Civilization
+   */
+  Water = "water",
+
+  /**
+   * Discard and sacrifice - graveyard synergy,
+   * removal via destruction, hand disruption,
+   * and risky power plays; trades life/board
+   * for brutal advantage.
+   * @docs https://duelmasters.fandom.com/wiki/Darkness_Civilization
+   */
+  Darkness = "darkness",
+
+  /**
+   * Fast, aggressive, and explosive -
+   * rush creatures, speed attacker, power
+   * spikes, and burn-style removal; wins
+   * by pressuring early and finishing hard.
+   * @docs https://duelmasters.fandom.com/wiki/Fire_Civilization
+   */
+  Fire = "fire",
+
+  /**
+   * Mana acceleration and big bodies - ramps
+   * resources quickly, cheats out large creatures,
+   * and overwhelms with efficient stats and
+   * board presence.
+   * @docs https://duelmasters.fandom.com/wiki/Nature_Civilization
+   */
+  Nature = "nature",
+}

package/src/types/civilization/index.ts

@@ -0,0 +1 @@
+export { Civilization } from "./civilization";

package/src/types/era/era.ts

@@ -0,0 +1,33 @@
+export enum Era {
+  /**
+   * Shobu Era is a period of time in the production and
+   * media development of the Duel Masters franchise where
+   * Shobu Kirifuda was the lead character.
+   * @docs https://duelmasters.fandom.com/wiki/Shobu_Era
+   */
+  Shobu = "shobu",
+
+  /**
+   * Katta Era is a period of time in the production and
+   * media development of the Duel Masters franchise where
+   * Katta was the lead character.
+   * @docs https://duelmasters.fandom.com/wiki/Katta_Era
+   */
+  Katta = "katta",
+
+  /**
+   * The Joe Era is a period of time in the production and
+   * media development of the Duel Masters franchise where
+   * Joe Kirifuda is the lead character.
+   * @docs https://duelmasters.fandom.com/wiki/Joe_Era
+   */
+  Joe = "joe",
+
+  /**
+   * Win Era is a period of time in the production and
+   * media development of the Duel Masters franchise where
+   * Win Kirifuda was the lead character.
+   * @docs https://duelmasters.fandom.com/wiki/Win_Era
+   */
+  Win = "win",
+}

package/src/types/era/index.ts

@@ -0,0 +1 @@
+export { Era } from "./era";

package/src/types/race/index.ts

@@ -0,0 +1 @@
+export { Race } from "./race";

package/src/types/race/race.ts

@@ -0,0 +1,17 @@
+export enum Race {
+  AngelCommand = "angelCommand",
+  ApolloniaDragon = "apolloniaDragon",
+  ArcSeraphim = "arcSeraphim",
+  ArmoredDragon = "armoredDragon",
+  ArmoredWyvern = "armoredWyvern",
+  Armorloid = "armorloid",
+  BalloonMushroom = "balloonMushroom",
+  BeastFolk = "beastFolk",
+  Berserker = "berserker",
+  BigMuscle = "bigMuscle",
+  BlueMonster = "blueMonster",
+  BrainJacker = "brainJacker",
+  BraveSpirit = "braveSpirit",
+  LiquidPeople = "liquidPeople",
+  LightBringer = "lightBringer",
+}

package/src/types/rarity/index.ts

@@ -0,0 +1 @@
+export { Rarity } from "./rarity";

package/src/types/rarity/rarity.ts

@@ -0,0 +1,8 @@
+export enum Rarity {
+  None = "none",
+  Uncommon = "uncommon",
+  Common = "common",
+  Rare = "rare",
+  VeryRare = "veryRare",
+  SuperRare = "superRare",
+}

package/stories/index.stories.tsx

@@ -0,0 +1,114 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import { UtilityPage } from "@kaijudo/react-storybook";
+import { Era, Rarity, Race } from "../src/index.js";
+
+const meta = {
+  title: "Utilities/Game Types",
+  component: UtilityPage,
+  parameters: {
+    layout: "fullscreen",
+  },
+  tags: ["autodocs"],
+} satisfies Meta<typeof UtilityPage>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const TypesDocumentation: Story = {
+  render: () => (
+    <UtilityPage
+      name="Game Types"
+      description="TypeScript type definitions for Kaijudo game entities including eras, rarities, and races."
+    >
+      <div className="min-h-screen bg-white">
+        <div className="max-w-7xl mx-auto px-8 py-8">
+          <div className="space-y-12">
+            {/* Era Section */}
+            <section>
+              <h2 className="text-3xl font-bold mb-4">Era</h2>
+              <p className="text-gray-600 mb-6">
+                Represents different periods in the Duel Masters franchise
+                timeline.
+              </p>
+              <div className="bg-gray-50 rounded-lg p-6">
+                <div className="space-y-4">
+                  {Object.entries(Era).map(([key, value]) => (
+                    <div
+                      key={key}
+                      className="border-b border-gray-200 pb-4 last:border-0"
+                    >
+                      <div className="flex items-center gap-4">
+                        <code className="text-sm font-mono bg-white px-3 py-1 rounded border">
+                          {key}
+                        </code>
+                        <span className="text-gray-500">=</span>
+                        <code className="text-sm font-mono bg-white px-3 py-1 rounded border text-blue-600">
+                          "{String(value)}"
+                        </code>
+                      </div>
+                    </div>
+                  ))}
+                </div>
+              </div>
+            </section>
+
+            {/* Rarity Section */}
+            <section>
+              <h2 className="text-3xl font-bold mb-4">Rarity</h2>
+              <p className="text-gray-600 mb-6">
+                Card rarity levels in the game.
+              </p>
+              <div className="bg-gray-50 rounded-lg p-6">
+                <div className="space-y-4">
+                  {Object.entries(Rarity).map(([key, value]) => (
+                    <div
+                      key={key}
+                      className="border-b border-gray-200 pb-4 last:border-0"
+                    >
+                      <div className="flex items-center gap-4">
+                        <code className="text-sm font-mono bg-white px-3 py-1 rounded border">
+                          {key}
+                        </code>
+                        <span className="text-gray-500">=</span>
+                        <code className="text-sm font-mono bg-white px-3 py-1 rounded border text-blue-600">
+                          "{String(value)}"
+                        </code>
+                      </div>
+                    </div>
+                  ))}
+                </div>
+              </div>
+            </section>
+
+            {/* Race Section */}
+            <section>
+              <h2 className="text-3xl font-bold mb-4">Race</h2>
+              <p className="text-gray-600 mb-6">
+                Creature race types in the game.
+              </p>
+              <div className="bg-gray-50 rounded-lg p-6">
+                <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
+                  {Object.entries(Race).map(([key, value]) => (
+                    <div
+                      key={key}
+                      className="border border-gray-200 rounded p-4 bg-white"
+                    >
+                      <div className="flex flex-col gap-2">
+                        <code className="text-sm font-mono font-semibold">
+                          {key}
+                        </code>
+                        <code className="text-xs font-mono text-blue-600">
+                          "{String(value)}"
+                        </code>
+                      </div>
+                    </div>
+                  ))}
+                </div>
+              </div>
+            </section>
+          </div>
+        </div>
+      </div>
+    </UtilityPage>
+  ),
+};

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "lib": ["es2022", "dom", "dom.iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "noEmit": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*", "*.config.ts", ".storybook/**/*"],
+  "exclude": ["node_modules", "dist", "storybook-static"]
+}

package/tsconfig.lib.json

@@ -0,0 +1,13 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "declaration": true,
+    "declarationMap": true,
+    "emitDeclarationOnly": false,
+    "noEmit": false
+  },
+  "include": ["src/**/*"],
+  "exclude": ["**/*.spec.ts", "**/*.test.ts", "**/*.stories.ts", ".storybook"]
+}
+

package/tsup.config.ts

@@ -0,0 +1,21 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm', 'cjs'],
+  dts: {
+    resolve: true,
+  },
+  splitting: false,
+  sourcemap: true,
+  clean: true,
+  external: ['react', 'react-dom', 'tailwindcss'],
+  // Copy CSS files to dist
+  loader: {
+    '.css': 'copy',
+  },
+  // Include CSS in the bundle output
+  publicDir: false,
+  tsconfig: './tsconfig.lib.json',
+});
+

package/vitest.config.ts

@@ -0,0 +1,24 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'jsdom',
+    include: ['src/**/*.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}'],
+    exclude: ['node_modules', 'dist', 'storybook-static'],
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html'],
+      exclude: [
+        'node_modules',
+        'dist',
+        'storybook-static',
+        '**/*.config.{js,ts}',
+        '**/*.spec.{js,ts}',
+        '**/*.test.{js,ts}',
+        '**/*.stories.{js,ts,tsx}',
+      ],
+    },
+  },
+});
+