@xivdyetools/types 1.0.0

package/dist/auth/jwt.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @xivdyetools/types - JWT Types
+ *
+ * JWT payload and related types.
+ *
+ * @module auth/jwt
+ */
+import type { AuthProvider } from './provider.js';
+/**
+ * Primary FFXIV character info (for XIVAuth users)
+ *
+ * Included in JWT for users who authenticated via XIVAuth
+ * and have a verified character.
+ */
+export interface PrimaryCharacter {
+    /** Character name */
+    name: string;
+    /** Server/World name */
+    server: string;
+    /** True if character is verified on XIVAuth */
+    verified: boolean;
+}
+/**
+ * JWT payload structure
+ *
+ * Contains both standard JWT claims and custom claims
+ * for user identification.
+ */
+export interface JWTPayload {
+    /** Subject - Internal user ID */
+    sub: string;
+    /** Issued at timestamp */
+    iat: number;
+    /** Expiration timestamp */
+    exp: number;
+    /** Issuer (worker URL) */
+    iss: string;
+    /** JWT ID for revocation (optional for backward compat) */
+    jti?: string;
+    /** Display username */
+    username: string;
+    /** Discord global display name (if available) */
+    global_name: string | null;
+    /** Avatar hash or URL */
+    avatar: string | null;
+    /** Which provider was used to authenticate */
+    auth_provider: AuthProvider;
+    /** Discord snowflake ID (if Discord auth or linked) */
+    discord_id?: string;
+    /** XIVAuth UUID (if XIVAuth auth) */
+    xivauth_id?: string;
+    /** Primary FFXIV character info (if XIVAuth user) */
+    primary_character?: PrimaryCharacter;
+}
+/**
+ * OAuth state stored during authentication flow
+ *
+ * Stored temporarily while user is redirected to OAuth provider.
+ */
+export interface OAuthState {
+    /** PKCE code verifier */
+    code_verifier: string;
+    /** Redirect URI used in the flow */
+    redirect_uri: string;
+    /** Path to redirect to after auth completes */
+    return_path?: string;
+}
+//# sourceMappingURL=jwt.d.ts.map

package/dist/auth/jwt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.d.ts","sourceRoot":"","sources":["../../src/auth/jwt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IAEf,+CAA+C;IAC/C,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IAEzB,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IAEZ,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;IAEZ,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IAEZ,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;IAEZ,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IAGb,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IAEjB,iDAAiD;IACjD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,yBAAyB;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAGtB,8CAA8C;IAC9C,aAAa,EAAE,YAAY,CAAC;IAE5B,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,yBAAyB;IACzB,aAAa,EAAE,MAAM,CAAC;IAEtB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IAErB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/auth/jwt.js

@@ -0,0 +1,9 @@
+/**
+ * @xivdyetools/types - JWT Types
+ *
+ * JWT payload and related types.
+ *
+ * @module auth/jwt
+ */
+export {};
+//# sourceMappingURL=jwt.js.map

package/dist/auth/jwt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.js","sourceRoot":"","sources":["../../src/auth/jwt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/auth/provider.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @xivdyetools/types - Auth Provider Types
+ *
+ * Authentication provider and context types.
+ *
+ * @module auth/provider
+ */
+/**
+ * Supported authentication providers
+ */
+export type AuthProvider = 'discord' | 'xivauth';
+/**
+ * Source of authentication in API requests
+ *
+ * - `none`: Unauthenticated request
+ * - `bot`: Request from Discord bot (via service binding or API key)
+ * - `web`: Request from web app (via JWT)
+ */
+export type AuthSource = 'none' | 'bot' | 'web';
+/**
+ * Authentication context for API requests
+ *
+ * Attached to requests after authentication middleware runs.
+ */
+export interface AuthContext {
+    /** True if the request is authenticated */
+    isAuthenticated: boolean;
+    /** True if the user has moderator privileges */
+    isModerator: boolean;
+    /** Discord user ID (if authenticated) */
+    userDiscordId?: string;
+    /** Display name (if authenticated) */
+    userName?: string;
+    /** How the user authenticated */
+    authSource: AuthSource;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/auth/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/auth/provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,eAAe,EAAE,OAAO,CAAC;IAEzB,gDAAgD;IAChD,WAAW,EAAE,OAAO,CAAC;IAErB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,iCAAiC;IACjC,UAAU,EAAE,UAAU,CAAC;CACxB"}

package/dist/auth/provider.js

@@ -0,0 +1,9 @@
+/**
+ * @xivdyetools/types - Auth Provider Types
+ *
+ * Authentication provider and context types.
+ *
+ * @module auth/provider
+ */
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/auth/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/auth/provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/auth/response.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @xivdyetools/types - Auth Response Types
+ *
+ * API response types for authentication endpoints.
+ *
+ * @module auth/response
+ */
+import type { AuthProvider } from './provider.js';
+import type { PrimaryCharacter } from './jwt.js';
+/**
+ * User info included in auth responses
+ */
+export interface AuthUser {
+    /** Internal user ID */
+    id: string;
+    /** Display username */
+    username: string;
+    /** Discord global display name */
+    global_name: string | null;
+    /** Avatar hash */
+    avatar: string | null;
+    /** Full avatar URL */
+    avatar_url: string | null;
+    /** Which provider was used to authenticate */
+    auth_provider?: AuthProvider;
+    /** Primary FFXIV character (if XIVAuth user) */
+    primary_character?: PrimaryCharacter;
+}
+/**
+ * Response from authentication endpoints
+ */
+export interface AuthResponse {
+    /** Whether authentication succeeded */
+    success: boolean;
+    /** JWT token (if successful) */
+    token?: string;
+    /** User information (if successful) */
+    user?: AuthUser;
+    /** Token expiration timestamp (ms since epoch) */
+    expires_at?: number;
+    /** Error message (if unsuccessful) */
+    error?: string;
+}
+/**
+ * Response from token refresh endpoint
+ */
+export interface RefreshResponse {
+    /** Whether refresh succeeded */
+    success: boolean;
+    /** New JWT token (if successful) */
+    token?: string;
+    /** New token expiration timestamp */
+    expires_at?: number;
+    /** Error message (if unsuccessful) */
+    error?: string;
+}
+/**
+ * Response from user info endpoint
+ */
+export interface UserInfoResponse {
+    /** Whether request succeeded */
+    success: boolean;
+    /** User information (if successful) */
+    user?: {
+        id: string;
+        username: string;
+        global_name: string | null;
+        avatar: string | null;
+        avatar_url: string | null;
+    };
+    /** Error message (if unsuccessful) */
+    error?: string;
+}
+//# sourceMappingURL=response.d.ts.map

package/dist/auth/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/auth/response.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IAEX,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,kBAAkB;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB,sBAAsB;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,YAAY,CAAC;IAE7B,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IAEjB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAEhB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IAEjB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IAEjB,uCAAuC;IACvC,IAAI,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC;IAEF,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/auth/response.js

@@ -0,0 +1,9 @@
+/**
+ * @xivdyetools/types - Auth Response Types
+ *
+ * API response types for authentication endpoints.
+ *
+ * @module auth/response
+ */
+export {};
+//# sourceMappingURL=response.js.map

package/dist/auth/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../src/auth/response.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/auth/xivauth.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @xivdyetools/types - XIVAuth OAuth Types
+ *
+ * XIVAuth OAuth and user types.
+ *
+ * @module auth/xivauth
+ */
+/**
+ * XIVAuth OAuth token response
+ */
+export interface XIVAuthTokenResponse {
+    /** OAuth access token */
+    access_token: string;
+    /** Token type (usually "Bearer") */
+    token_type: string;
+    /** Token lifetime in seconds */
+    expires_in: number;
+    /** Refresh token for obtaining new access tokens */
+    refresh_token: string;
+    /** Granted scopes (space-separated) */
+    scope: string;
+}
+/**
+ * XIVAuth character object from /api/v1/characters
+ */
+export interface XIVAuthCharacter {
+    /** Lodestone character ID */
+    id: number;
+    /** Character name */
+    name: string;
+    /** Home world/server name */
+    home_world: string;
+    /** True if character is verified */
+    verified: boolean;
+}
+/**
+ * XIVAuth character registration (full response)
+ */
+export interface XIVAuthCharacterRegistration {
+    /** Lodestone character ID */
+    lodestone_id: number;
+    /** Character name */
+    name: string;
+    /** Home world/server name */
+    home_world: string;
+    /** Data center name */
+    data_center: string;
+    /** True if character is verified */
+    verified: boolean;
+}
+/**
+ * XIVAuth social identity from /api/v1/user
+ *
+ * Represents a linked external account (Discord, etc.)
+ */
+export interface XIVAuthSocialIdentity {
+    /** Provider name (e.g., 'discord') */
+    provider: string;
+    /** External ID (e.g., Discord snowflake) */
+    external_id: string;
+    /** Display name on the external service */
+    name: string | null;
+    /** Nickname on the external service */
+    nickname: string | null;
+    /** When the link was created */
+    created_at: string;
+    /** When the link was last updated */
+    updated_at: string;
+}
+/**
+ * XIVAuth user object from /api/v1/user
+ *
+ * NOTE: This is the ACTUAL response structure from XIVAuth.
+ * XIVAuth does NOT return username or avatar_url in user endpoint.
+ */
+export interface XIVAuthUser {
+    /** XIVAuth UUID */
+    id: string;
+    /** Array of linked accounts (Discord, etc.) */
+    social_identities?: XIVAuthSocialIdentity[];
+    /** True if user has MFA enabled */
+    mfa_enabled: boolean;
+    /** True if user has any verified characters */
+    verified_characters: boolean;
+    /** Account creation timestamp */
+    created_at: string;
+    /** Last update timestamp */
+    updated_at: string;
+}
+//# sourceMappingURL=xivauth.d.ts.map

package/dist/auth/xivauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xivauth.d.ts","sourceRoot":"","sources":["../../src/auth/xivauth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IAErB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IAEnB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IAEnB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;IAEtB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IAEX,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IAEnB,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;IAErB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IAEnB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IAEpB,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IAEjB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IAEpB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IAEnB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IAEX,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAE5C,mCAAmC;IACnC,WAAW,EAAE,OAAO,CAAC;IAErB,+CAA+C;IAC/C,mBAAmB,EAAE,OAAO,CAAC;IAE7B,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IAEnB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/auth/xivauth.js

@@ -0,0 +1,9 @@
+/**
+ * @xivdyetools/types - XIVAuth OAuth Types
+ *
+ * XIVAuth OAuth and user types.
+ *
+ * @module auth/xivauth
+ */
+export {};
+//# sourceMappingURL=xivauth.js.map

package/dist/auth/xivauth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xivauth.js","sourceRoot":"","sources":["../../src/auth/xivauth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/color/branded.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @xivdyetools/types - Branded Color Types
+ *
+ * Branded types prevent accidental type confusion between similar types.
+ * For example, a DyeId cannot be accidentally used where a plain number is expected.
+ *
+ * @module color/branded
+ */
+/**
+ * Hexadecimal color string (branded type for type safety)
+ *
+ * Prevents accidental use of arbitrary strings as hex colors.
+ * Use `createHexColor()` to create validated instances.
+ *
+ * @example "#FF0000"
+ */
+export type HexColor = string & {
+    readonly __brand: 'HexColor';
+};
+/**
+ * Helper to create branded HexColor type with validation
+ *
+ * Validates hex format and normalizes to uppercase #RRGGBB format.
+ *
+ * @param hex - Input hex string (#RGB or #RRGGBB format)
+ * @returns Normalized HexColor in #RRGGBB format
+ * @throws {Error} If hex format is invalid
+ *
+ * @example
+ * ```typescript
+ * const red = createHexColor('#f00');      // Returns "#FF0000"
+ * const blue = createHexColor('#0000ff');  // Returns "#0000FF"
+ * createHexColor('invalid');               // Throws Error
+ * ```
+ */
+export declare function createHexColor(hex: string): HexColor;
+/**
+ * Dye ID (branded type for type safety)
+ *
+ * Prevents accidental mixing of dye IDs with other numeric values.
+ * Valid dye IDs range from 1 to 200 in FFXIV.
+ */
+export type DyeId = number & {
+    readonly __brand: 'DyeId';
+};
+/**
+ * Helper to create branded DyeId type with validation
+ *
+ * @param id - Numeric dye ID (must be 1-200)
+ * @returns Branded DyeId or null if invalid
+ *
+ * @example
+ * ```typescript
+ * const dyeId = createDyeId(1);    // Returns 1 as DyeId
+ * const invalid = createDyeId(0); // Returns null
+ * const bad = createDyeId(999);   // Returns null
+ * ```
+ */
+export declare function createDyeId(id: number): DyeId | null;
+/**
+ * Hue value (0-360 degrees, branded type)
+ *
+ * Prevents mixing with other angle or degree values.
+ */
+export type Hue = number & {
+    readonly __brand: 'Hue';
+};
+/**
+ * Helper to create branded Hue type with normalization
+ *
+ * Normalizes hue to 0-360 range (wraps around).
+ *
+ * @param hue - Input hue value (any number, will be normalized)
+ * @returns Normalized Hue in 0-360 range
+ *
+ * @example
+ * ```typescript
+ * createHue(45);    // Returns 45
+ * createHue(400);   // Returns 40 (wrapped)
+ * createHue(-30);   // Returns 330 (wrapped)
+ * ```
+ */
+export declare function createHue(hue: number): Hue;
+/**
+ * Saturation value (0-100 percent, branded type)
+ *
+ * Prevents mixing with other percentage values.
+ */
+export type Saturation = number & {
+    readonly __brand: 'Saturation';
+};
+/**
+ * Helper to create branded Saturation type with clamping
+ *
+ * Clamps saturation to 0-100 range.
+ *
+ * @param saturation - Input saturation value
+ * @returns Clamped Saturation in 0-100 range
+ *
+ * @example
+ * ```typescript
+ * createSaturation(50);   // Returns 50
+ * createSaturation(150);  // Returns 100 (clamped)
+ * createSaturation(-10);  // Returns 0 (clamped)
+ * ```
+ */
+export declare function createSaturation(saturation: number): Saturation;
+//# sourceMappingURL=branded.d.ts.map

package/dist/color/branded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branded.d.ts","sourceRoot":"","sources":["../../src/color/branded.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AAEjE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAWpD;AAED;;;;;GAKG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAE3D;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAKpD;AAED;;;;GAIG;AACH,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAI1C;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC;AAErE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAG/D"}

package/dist/color/branded.js

@@ -0,0 +1,94 @@
+/**
+ * @xivdyetools/types - Branded Color Types
+ *
+ * Branded types prevent accidental type confusion between similar types.
+ * For example, a DyeId cannot be accidentally used where a plain number is expected.
+ *
+ * @module color/branded
+ */
+/**
+ * Helper to create branded HexColor type with validation
+ *
+ * Validates hex format and normalizes to uppercase #RRGGBB format.
+ *
+ * @param hex - Input hex string (#RGB or #RRGGBB format)
+ * @returns Normalized HexColor in #RRGGBB format
+ * @throws {Error} If hex format is invalid
+ *
+ * @example
+ * ```typescript
+ * const red = createHexColor('#f00');      // Returns "#FF0000"
+ * const blue = createHexColor('#0000ff');  // Returns "#0000FF"
+ * createHexColor('invalid');               // Throws Error
+ * ```
+ */
+export function createHexColor(hex) {
+    // Validate format: must be #RGB or #RRGGBB
+    if (!/^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/.test(hex)) {
+        throw new Error(`Invalid hex color format: ${hex}. Expected #RRGGBB or #RGB format.`);
+    }
+    // Normalize short hex (#RGB) to long hex (#RRGGBB) and uppercase
+    const normalized = hex.length === 4
+        ? `#${hex[1]}${hex[1]}${hex[2]}${hex[2]}${hex[3]}${hex[3]}`.toUpperCase()
+        : hex.toUpperCase();
+    return normalized;
+}
+/**
+ * Helper to create branded DyeId type with validation
+ *
+ * @param id - Numeric dye ID (must be 1-200)
+ * @returns Branded DyeId or null if invalid
+ *
+ * @example
+ * ```typescript
+ * const dyeId = createDyeId(1);    // Returns 1 as DyeId
+ * const invalid = createDyeId(0); // Returns null
+ * const bad = createDyeId(999);   // Returns null
+ * ```
+ */
+export function createDyeId(id) {
+    if (!Number.isInteger(id) || id < 1 || id > 200) {
+        return null;
+    }
+    return id;
+}
+/**
+ * Helper to create branded Hue type with normalization
+ *
+ * Normalizes hue to 0-360 range (wraps around).
+ *
+ * @param hue - Input hue value (any number, will be normalized)
+ * @returns Normalized Hue in 0-360 range
+ *
+ * @example
+ * ```typescript
+ * createHue(45);    // Returns 45
+ * createHue(400);   // Returns 40 (wrapped)
+ * createHue(-30);   // Returns 330 (wrapped)
+ * ```
+ */
+export function createHue(hue) {
+    // Normalize to 0-360 range
+    const normalized = ((hue % 360) + 360) % 360;
+    return normalized;
+}
+/**
+ * Helper to create branded Saturation type with clamping
+ *
+ * Clamps saturation to 0-100 range.
+ *
+ * @param saturation - Input saturation value
+ * @returns Clamped Saturation in 0-100 range
+ *
+ * @example
+ * ```typescript
+ * createSaturation(50);   // Returns 50
+ * createSaturation(150);  // Returns 100 (clamped)
+ * createSaturation(-10);  // Returns 0 (clamped)
+ * ```
+ */
+export function createSaturation(saturation) {
+    const clamped = Math.max(0, Math.min(100, saturation));
+    return clamped;
+}
+//# sourceMappingURL=branded.js.map

package/dist/color/branded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branded.js","sourceRoot":"","sources":["../../src/color/branded.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,2CAA2C;IAC3C,IAAI,CAAC,oCAAoC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,oCAAoC,CAAC,CAAC;IACxF,CAAC;IACD,iEAAiE;IACjE,MAAM,UAAU,GACd,GAAG,CAAC,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE;QACzE,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;IACxB,OAAO,UAAsB,CAAC;AAChC,CAAC;AAUD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,GAAG,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAW,CAAC;AACrB,CAAC;AASD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,2BAA2B;IAC3B,MAAM,UAAU,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAC7C,OAAO,UAAiB,CAAC;AAC3B,CAAC;AASD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;IACvD,OAAO,OAAqB,CAAC;AAC/B,CAAC"}

package/dist/color/colorblind.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @xivdyetools/types - Colorblindness Types
+ *
+ * Types for colorblindness simulation and accessibility checking.
+ *
+ * @module color/colorblind
+ */
+/**
+ * Vision types supported by accessibility checker
+ *
+ * - `normal`: Standard color vision
+ * - `deuteranopia`: Red-green colorblindness (green cone deficiency)
+ * - `protanopia`: Red-green colorblindness (red cone deficiency)
+ * - `tritanopia`: Blue-yellow colorblindness (blue cone deficiency)
+ * - `achromatopsia`: Complete colorblindness (monochromacy)
+ */
+export type VisionType = 'normal' | 'deuteranopia' | 'protanopia' | 'tritanopia' | 'achromatopsia';
+/**
+ * 3x3 transformation matrix for colorblindness simulation
+ *
+ * Used for RGB to RGB transformation using matrix multiplication.
+ * [row][column] indexing: result[r] = matrix[0] * input, etc.
+ */
+export type Matrix3x3 = [
+    [
+        number,
+        number,
+        number
+    ],
+    [
+        number,
+        number,
+        number
+    ],
+    [
+        number,
+        number,
+        number
+    ]
+];
+/**
+ * Colorblindness transformation matrices (Brettel 1997)
+ *
+ * These matrices simulate how colors appear to people with different
+ * types of color vision deficiency.
+ */
+export interface ColorblindMatrices {
+    /** Matrix for deuteranopia simulation */
+    deuteranopia: Matrix3x3;
+    /** Matrix for protanopia simulation */
+    protanopia: Matrix3x3;
+    /** Matrix for tritanopia simulation */
+    tritanopia: Matrix3x3;
+    /** Matrix for achromatopsia simulation */
+    achromatopsia: Matrix3x3;
+}
+//# sourceMappingURL=colorblind.d.ts.map

package/dist/color/colorblind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorblind.d.ts","sourceRoot":"","sources":["../../src/color/colorblind.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,YAAY,GACZ,eAAe,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB;QAAC,MAAM;QAAE,MAAM;QAAE,MAAM;KAAC;IACxB;QAAC,MAAM;QAAE,MAAM;QAAE,MAAM;KAAC;IACxB;QAAC,MAAM;QAAE,MAAM;QAAE,MAAM;KAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,YAAY,EAAE,SAAS,CAAC;IACxB,uCAAuC;IACvC,UAAU,EAAE,SAAS,CAAC;IACtB,uCAAuC;IACvC,UAAU,EAAE,SAAS,CAAC;IACtB,0CAA0C;IAC1C,aAAa,EAAE,SAAS,CAAC;CAC1B"}

package/dist/color/colorblind.js

@@ -0,0 +1,9 @@
+/**
+ * @xivdyetools/types - Colorblindness Types
+ *
+ * Types for colorblindness simulation and accessibility checking.
+ *
+ * @module color/colorblind
+ */
+export {};
+//# sourceMappingURL=colorblind.js.map

package/dist/color/colorblind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorblind.js","sourceRoot":"","sources":["../../src/color/colorblind.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/color/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @xivdyetools/types - Color Module
+ *
+ * Color type definitions including RGB/HSV, branded types, and colorblindness.
+ *
+ * @module color
+ */
+export type { RGB, HSV } from './rgb.js';
+export type { HexColor, DyeId, Hue, Saturation } from './branded.js';
+export { createHexColor, createDyeId, createHue, createSaturation } from './branded.js';
+export type { VisionType, Matrix3x3, ColorblindMatrices } from './colorblind.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/color/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/color/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAGzC,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGxF,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/color/index.js

@@ -0,0 +1,9 @@
+/**
+ * @xivdyetools/types - Color Module
+ *
+ * Color type definitions including RGB/HSV, branded types, and colorblindness.
+ *
+ * @module color
+ */
+export { createHexColor, createDyeId, createHue, createSaturation } from './branded.js';
+//# sourceMappingURL=index.js.map

package/dist/color/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/color/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}