@asagiri-design/labels-config 0.2.2

package/dist/index.d.mts

@@ -0,0 +1,309 @@
+import { L as LabelConfig, H as HexColor, a as LabelRegistry } from './types-CkwsO1Iu.mjs';
+export { b as LabelCategory, f as flattenLabels, i as isCategorized } from './types-CkwsO1Iu.mjs';
+import { z } from 'zod';
+
+/**
+ * Label Validation Schema
+ * Uses Zod for runtime validation with TypeScript type safety
+ */
+
+/**
+ * Label configuration schema
+ */
+declare const labelConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    color: z.ZodType<HexColor, z.ZodTypeDef, HexColor>;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    color: string & {
+        readonly __brand: "HexColor";
+    };
+    description: string;
+}, {
+    name: string;
+    color: string & {
+        readonly __brand: "HexColor";
+    };
+    description: string;
+}>;
+/**
+ * Label category schema
+ */
+declare const labelCategorySchema: z.ZodObject<{
+    category: z.ZodString;
+    labels: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        color: z.ZodType<HexColor, z.ZodTypeDef, HexColor>;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        color: string & {
+            readonly __brand: "HexColor";
+        };
+        description: string;
+    }, {
+        name: string;
+        color: string & {
+            readonly __brand: "HexColor";
+        };
+        description: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    labels: {
+        name: string;
+        color: string & {
+            readonly __brand: "HexColor";
+        };
+        description: string;
+    }[];
+    category: string;
+}, {
+    labels: {
+        name: string;
+        color: string & {
+            readonly __brand: "HexColor";
+        };
+        description: string;
+    }[];
+    category: string;
+}>;
+/**
+ * Label registry schema
+ */
+declare const labelRegistrySchema: z.ZodObject<{
+    version: z.ZodString;
+    timestamp: z.ZodOptional<z.ZodString>;
+    labels: z.ZodUnion<[z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        color: z.ZodType<HexColor, z.ZodTypeDef, HexColor>;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        color: string & {
+            readonly __brand: "HexColor";
+        };
+        description: string;
+    }, {
+        name: string;
+        color: string & {
+            readonly __brand: "HexColor";
+        };
+        description: string;
+    }>, "many">, z.ZodArray<z.ZodObject<{
+        category: z.ZodString;
+        labels: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            color: z.ZodType<HexColor, z.ZodTypeDef, HexColor>;
+            description: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            color: string & {
+                readonly __brand: "HexColor";
+            };
+            description: string;
+        }, {
+            name: string;
+            color: string & {
+                readonly __brand: "HexColor";
+            };
+            description: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        labels: {
+            name: string;
+            color: string & {
+                readonly __brand: "HexColor";
+            };
+            description: string;
+        }[];
+        category: string;
+    }, {
+        labels: {
+            name: string;
+            color: string & {
+                readonly __brand: "HexColor";
+            };
+            description: string;
+        }[];
+        category: string;
+    }>, "many">]>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    labels: {
+        name: string;
+        color: string & {
+            readonly __brand: "HexColor";
+        };
+        description: string;
+    }[] | {
+        labels: {
+            name: string;
+            color: string & {
+                readonly __brand: "HexColor";
+            };
+            description: string;
+        }[];
+        category: string;
+    }[];
+    version: string;
+    timestamp?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    labels: {
+        name: string;
+        color: string & {
+            readonly __brand: "HexColor";
+        };
+        description: string;
+    }[] | {
+        labels: {
+            name: string;
+            color: string & {
+                readonly __brand: "HexColor";
+            };
+            description: string;
+        }[];
+        category: string;
+    }[];
+    version: string;
+    timestamp?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+/**
+ * Validates a single label configuration
+ */
+declare function validateLabel(label: unknown): LabelConfig;
+/**
+ * Validates multiple labels
+ */
+declare function validateLabels(labels: unknown): LabelConfig[];
+/**
+ * Validates a complete label registry
+ */
+declare function validateRegistry(registry: unknown): LabelRegistry;
+/**
+ * Checks for duplicate label names
+ */
+declare function checkDuplicateNames(labels: LabelConfig[]): string[];
+/**
+ * Checks for duplicate colors (case-insensitive)
+ * Normalizes colors before comparison to handle unparsed labels
+ */
+declare function checkDuplicateColors(labels: LabelConfig[]): string[];
+/**
+ * Comprehensive validation with detailed error reporting
+ */
+declare function validateWithDetails(labels: unknown): {
+    valid: boolean;
+    labels: LabelConfig[];
+    errors: {
+        duplicateNames: string[];
+        duplicateColors: string[];
+        validationErrors?: undefined;
+    };
+} | {
+    valid: boolean;
+    labels: never[];
+    errors: {
+        validationErrors: z.ZodIssue[];
+        duplicateNames?: undefined;
+        duplicateColors?: undefined;
+    };
+};
+
+/**
+ * Label Manager
+ * Main class for managing label configurations
+ */
+
+interface LabelManagerOptions {
+    /** Initial labels to load */
+    labels?: LabelConfig[];
+    /** Strict mode: fail on any validation error */
+    strict?: boolean;
+}
+declare class LabelManager {
+    private labels;
+    private strict;
+    constructor(options?: LabelManagerOptions);
+    /**
+     * Load labels from array
+     */
+    loadLabels(labels: LabelConfig[]): void;
+    /**
+     * Load labels from registry object
+     */
+    loadRegistry(registry: LabelRegistry): void;
+    /**
+     * Add a single label
+     */
+    addLabel(label: LabelConfig): void;
+    /**
+     * Update an existing label
+     */
+    updateLabel(name: string, updates: Partial<LabelConfig>): void;
+    /**
+     * Remove a label
+     */
+    removeLabel(name: string): void;
+    /**
+     * Get a label by name
+     */
+    getLabel(name: string): LabelConfig | undefined;
+    /**
+     * Check if label exists
+     */
+    hasLabel(name: string): boolean;
+    /**
+     * Get all labels
+     */
+    getAllLabels(): LabelConfig[];
+    /**
+     * Get labels count
+     */
+    count(): number;
+    /**
+     * Export labels as array
+     */
+    export(): LabelConfig[];
+    /**
+     * Export as registry object
+     */
+    exportRegistry(version?: string, metadata?: Record<string, unknown>): LabelRegistry;
+    /**
+     * Search labels by name or description
+     */
+    search(query: string): LabelConfig[];
+    /**
+     * Find labels by color
+     */
+    findByColor(color: string): LabelConfig[];
+    /**
+     * Clear all labels
+     */
+    clear(): void;
+    /**
+     * Validate current state
+     */
+    validate(): {
+        valid: boolean;
+        duplicates: string[];
+    };
+}
+
+declare const version = "0.2.2";
+
+/**
+ * @boxpistols/labels-config
+ * Comprehensive label management system for GitHub repositories
+ */
+
+declare const _default: {
+    LabelManager: typeof LabelManager;
+    validateLabels: typeof validateLabels;
+    validateWithDetails: typeof validateWithDetails;
+    version: string;
+};
+
+export { HexColor, LabelConfig, LabelManager, type LabelManagerOptions, LabelRegistry, checkDuplicateColors, checkDuplicateNames, _default as default, labelCategorySchema, labelConfigSchema, labelRegistrySchema, validateLabel, validateLabels, validateRegistry, validateWithDetails, version };

package/dist/index.d.ts

@@ -0,0 +1,309 @@
+import { L as LabelConfig, H as HexColor, a as LabelRegistry } from './types-CkwsO1Iu.js';
+export { b as LabelCategory, f as flattenLabels, i as isCategorized } from './types-CkwsO1Iu.js';
+import { z } from 'zod';
+
+/**
+ * Label Validation Schema
+ * Uses Zod for runtime validation with TypeScript type safety
+ */
+
+/**
+ * Label configuration schema
+ */
+declare const labelConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    color: z.ZodType<HexColor, z.ZodTypeDef, HexColor>;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    color: string & {
+        readonly __brand: "HexColor";
+    };
+    description: string;
+}, {
+    name: string;
+    color: string & {
+        readonly __brand: "HexColor";
+    };
+    description: string;
+}>;
+/**
+ * Label category schema
+ */
+declare const labelCategorySchema: z.ZodObject<{
+    category: z.ZodString;
+    labels: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        color: z.ZodType<HexColor, z.ZodTypeDef, HexColor>;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        color: string & {
+            readonly __brand: "HexColor";
+        };
+        description: string;
+    }, {
+        name: string;
+        color: string & {
+            readonly __brand: "HexColor";
+        };
+        description: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    labels: {
+        name: string;
+        color: string & {
+            readonly __brand: "HexColor";
+        };
+        description: string;
+    }[];
+    category: string;
+}, {
+    labels: {
+        name: string;
+        color: string & {
+            readonly __brand: "HexColor";
+        };
+        description: string;
+    }[];
+    category: string;
+}>;
+/**
+ * Label registry schema
+ */
+declare const labelRegistrySchema: z.ZodObject<{
+    version: z.ZodString;
+    timestamp: z.ZodOptional<z.ZodString>;
+    labels: z.ZodUnion<[z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        color: z.ZodType<HexColor, z.ZodTypeDef, HexColor>;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        color: string & {
+            readonly __brand: "HexColor";
+        };
+        description: string;
+    }, {
+        name: string;
+        color: string & {
+            readonly __brand: "HexColor";
+        };
+        description: string;
+    }>, "many">, z.ZodArray<z.ZodObject<{
+        category: z.ZodString;
+        labels: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            color: z.ZodType<HexColor, z.ZodTypeDef, HexColor>;
+            description: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            color: string & {
+                readonly __brand: "HexColor";
+            };
+            description: string;
+        }, {
+            name: string;
+            color: string & {
+                readonly __brand: "HexColor";
+            };
+            description: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        labels: {
+            name: string;
+            color: string & {
+                readonly __brand: "HexColor";
+            };
+            description: string;
+        }[];
+        category: string;
+    }, {
+        labels: {
+            name: string;
+            color: string & {
+                readonly __brand: "HexColor";
+            };
+            description: string;
+        }[];
+        category: string;
+    }>, "many">]>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    labels: {
+        name: string;
+        color: string & {
+            readonly __brand: "HexColor";
+        };
+        description: string;
+    }[] | {
+        labels: {
+            name: string;
+            color: string & {
+                readonly __brand: "HexColor";
+            };
+            description: string;
+        }[];
+        category: string;
+    }[];
+    version: string;
+    timestamp?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    labels: {
+        name: string;
+        color: string & {
+            readonly __brand: "HexColor";
+        };
+        description: string;
+    }[] | {
+        labels: {
+            name: string;
+            color: string & {
+                readonly __brand: "HexColor";
+            };
+            description: string;
+        }[];
+        category: string;
+    }[];
+    version: string;
+    timestamp?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+/**
+ * Validates a single label configuration
+ */
+declare function validateLabel(label: unknown): LabelConfig;
+/**
+ * Validates multiple labels
+ */
+declare function validateLabels(labels: unknown): LabelConfig[];
+/**
+ * Validates a complete label registry
+ */
+declare function validateRegistry(registry: unknown): LabelRegistry;
+/**
+ * Checks for duplicate label names
+ */
+declare function checkDuplicateNames(labels: LabelConfig[]): string[];
+/**
+ * Checks for duplicate colors (case-insensitive)
+ * Normalizes colors before comparison to handle unparsed labels
+ */
+declare function checkDuplicateColors(labels: LabelConfig[]): string[];
+/**
+ * Comprehensive validation with detailed error reporting
+ */
+declare function validateWithDetails(labels: unknown): {
+    valid: boolean;
+    labels: LabelConfig[];
+    errors: {
+        duplicateNames: string[];
+        duplicateColors: string[];
+        validationErrors?: undefined;
+    };
+} | {
+    valid: boolean;
+    labels: never[];
+    errors: {
+        validationErrors: z.ZodIssue[];
+        duplicateNames?: undefined;
+        duplicateColors?: undefined;
+    };
+};
+
+/**
+ * Label Manager
+ * Main class for managing label configurations
+ */
+
+interface LabelManagerOptions {
+    /** Initial labels to load */
+    labels?: LabelConfig[];
+    /** Strict mode: fail on any validation error */
+    strict?: boolean;
+}
+declare class LabelManager {
+    private labels;
+    private strict;
+    constructor(options?: LabelManagerOptions);
+    /**
+     * Load labels from array
+     */
+    loadLabels(labels: LabelConfig[]): void;
+    /**
+     * Load labels from registry object
+     */
+    loadRegistry(registry: LabelRegistry): void;
+    /**
+     * Add a single label
+     */
+    addLabel(label: LabelConfig): void;
+    /**
+     * Update an existing label
+     */
+    updateLabel(name: string, updates: Partial<LabelConfig>): void;
+    /**
+     * Remove a label
+     */
+    removeLabel(name: string): void;
+    /**
+     * Get a label by name
+     */
+    getLabel(name: string): LabelConfig | undefined;
+    /**
+     * Check if label exists
+     */
+    hasLabel(name: string): boolean;
+    /**
+     * Get all labels
+     */
+    getAllLabels(): LabelConfig[];
+    /**
+     * Get labels count
+     */
+    count(): number;
+    /**
+     * Export labels as array
+     */
+    export(): LabelConfig[];
+    /**
+     * Export as registry object
+     */
+    exportRegistry(version?: string, metadata?: Record<string, unknown>): LabelRegistry;
+    /**
+     * Search labels by name or description
+     */
+    search(query: string): LabelConfig[];
+    /**
+     * Find labels by color
+     */
+    findByColor(color: string): LabelConfig[];
+    /**
+     * Clear all labels
+     */
+    clear(): void;
+    /**
+     * Validate current state
+     */
+    validate(): {
+        valid: boolean;
+        duplicates: string[];
+    };
+}
+
+declare const version = "0.2.2";
+
+/**
+ * @boxpistols/labels-config
+ * Comprehensive label management system for GitHub repositories
+ */
+
+declare const _default: {
+    LabelManager: typeof LabelManager;
+    validateLabels: typeof validateLabels;
+    validateWithDetails: typeof validateWithDetails;
+    version: string;
+};
+
+export { HexColor, LabelConfig, LabelManager, type LabelManagerOptions, LabelRegistry, checkDuplicateColors, checkDuplicateNames, _default as default, labelCategorySchema, labelConfigSchema, labelRegistrySchema, validateLabel, validateLabels, validateRegistry, validateWithDetails, version };