@reverso/core 0.1.0

package/dist/types/schema.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Schema type definitions for pages and sections.
+ * Represents the hierarchical structure: Page > Section > Field
+ */
+import type { FieldSchema, FieldType } from './fields.js';
+/**
+ * Path components extracted from a field path like "home.hero.title"
+ */
+export interface ParsedPath {
+    /** Page slug (e.g., "home") */
+    page: string;
+    /** Section slug (e.g., "hero") */
+    section: string;
+    /** Field name (e.g., "title") */
+    field: string;
+    /** Whether this is a repeater item (contains $) */
+    isRepeater: boolean;
+    /** Repeater item field (if applicable) */
+    repeaterField?: string;
+    /** Full original path */
+    full: string;
+}
+/**
+ * Schema for a section within a page.
+ */
+export interface SectionSchema {
+    /** Section slug (e.g., "hero") */
+    slug: string;
+    /** Human-readable name (e.g., "Hero Section") */
+    name: string;
+    /** Fields within this section */
+    fields: FieldSchema[];
+    /** Whether this section contains a repeater */
+    isRepeater: boolean;
+    /** Repeater configuration if applicable */
+    repeaterConfig?: {
+        min?: number;
+        max?: number;
+        itemLabel?: string;
+    };
+    /** Order of this section (for sorting) */
+    order: number;
+}
+/**
+ * Schema for a page.
+ */
+export interface PageSchema {
+    /** Page slug (e.g., "home") */
+    slug: string;
+    /** Human-readable name (e.g., "Home Page") */
+    name: string;
+    /** Sections within this page */
+    sections: SectionSchema[];
+    /** Total field count across all sections */
+    fieldCount: number;
+    /** Source files containing this page's fields */
+    sourceFiles: string[];
+}
+/**
+ * Complete schema for the entire project.
+ */
+export interface ProjectSchema {
+    /** Schema version for compatibility checks */
+    version: string;
+    /** When the schema was generated */
+    generatedAt: string;
+    /** All pages in the project */
+    pages: PageSchema[];
+    /** Total page count */
+    pageCount: number;
+    /** Total field count */
+    totalFields: number;
+    /** Metadata about the scan */
+    meta: {
+        /** Source directory that was scanned */
+        srcDir: string;
+        /** Files that were scanned */
+        filesScanned: number;
+        /** Files that contained markers */
+        filesWithMarkers: number;
+        /** Scan duration in milliseconds */
+        scanDuration: number;
+    };
+}
+/**
+ * Result of a schema diff operation.
+ */
+export interface SchemaDiff {
+    /** Fields that were added */
+    added: FieldSchema[];
+    /** Fields that were removed */
+    removed: FieldSchema[];
+    /** Fields that were modified */
+    modified: Array<{
+        path: string;
+        before: FieldSchema;
+        after: FieldSchema;
+        changes: string[];
+    }>;
+    /** Whether there are any changes */
+    hasChanges: boolean;
+}
+/**
+ * Options for schema generation.
+ */
+export interface SchemaGeneratorOptions {
+    /** Include source file information */
+    includeSourceInfo?: boolean;
+    /** Include default content from JSX */
+    includeDefaults?: boolean;
+    /** Sort pages/sections/fields alphabetically */
+    sort?: boolean;
+    /** Default field type when not specified */
+    defaultFieldType?: FieldType;
+}
+/**
+ * A raw field detection before full schema generation.
+ */
+export interface DetectedField {
+    /** The data-reverso attribute value */
+    path: string;
+    /** All data-reverso-* attributes */
+    attributes: Record<string, string | undefined>;
+    /** Source file path */
+    file: string;
+    /** Line number */
+    line: number;
+    /** Column number */
+    column: number;
+    /** JSX element tag name */
+    element: string;
+    /** Text content of the element */
+    textContent?: string;
+}
+/**
+ * Result of scanning a single file.
+ */
+export interface FileScanResult {
+    /** File path */
+    file: string;
+    /** Detected fields */
+    fields: DetectedField[];
+    /** Any errors encountered */
+    errors: ScanError[];
+    /** Scan duration for this file in milliseconds */
+    duration: number;
+}
+/**
+ * Error encountered during scanning.
+ */
+export interface ScanError {
+    /** Error type */
+    type: 'parse' | 'validation' | 'io';
+    /** Error message */
+    message: string;
+    /** File path (if applicable) */
+    file?: string;
+    /** Line number (if applicable) */
+    line?: number;
+    /** Column number (if applicable) */
+    column?: number;
+}
+/**
+ * Options for the scan operation.
+ */
+export interface ScanOptions {
+    /** Directory to scan */
+    srcDir: string;
+    /** Glob patterns to include */
+    include?: string[];
+    /** Glob patterns to exclude */
+    exclude?: string[];
+    /** Watch for changes */
+    watch?: boolean;
+    /** Verbose logging */
+    verbose?: boolean;
+    /** Fail on errors instead of continuing */
+    strict?: boolean;
+}
+/**
+ * Result of a complete scan operation.
+ */
+export interface ScanResult {
+    /** Generated schema */
+    schema: ProjectSchema;
+    /** Individual file results */
+    files: FileScanResult[];
+    /** All errors encountered */
+    errors: ScanError[];
+    /** Whether the scan was successful */
+    success: boolean;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/types/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/types/schema.ts"],"names":[],"mappings":"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"}

package/dist/types/schema.js

@@ -0,0 +1,6 @@
+/**
+ * Schema type definitions for pages and sections.
+ * Represents the hierarchical structure: Page > Section > Field
+ */
+export {};
+//# sourceMappingURL=schema.js.map

package/dist/types/schema.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utility exports for @reverso/core
+ */
+export { parsePath, buildPath, getPageFromPath, getSectionFromPath, getFieldFromPath, isRepeaterPath, getParentPath, getPageSectionPath, matchPath, sortPaths, groupPathsByPage, groupPathsBySection, } from './path.js';
+export { formatLabel, slugify, camelCase, pascalCase, snakeCase, constantCase, kebabCase, pluralize, singularize, truncate, toIdentifier, } from './naming.js';
+export { FIELD_TYPES, fieldTypeSchema, fieldPathSchema, fieldAttributesSchema, fieldSchema, isValidFieldType, isValidFieldPath, validateFieldAttributes, validateFieldSchema, isValidAttribute, extractAttributeName, parseOptions, parseCondition, } from './validation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,SAAS,EACT,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,WAAW,EACX,OAAO,EACP,SAAS,EACT,UAAU,EACV,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EACT,WAAW,EACX,QAAQ,EACR,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,WAAW,EACX,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,10 @@
+/**
+ * Utility exports for @reverso/core
+ */
+// Path utilities
+export { parsePath, buildPath, getPageFromPath, getSectionFromPath, getFieldFromPath, isRepeaterPath, getParentPath, getPageSectionPath, matchPath, sortPaths, groupPathsByPage, groupPathsBySection, } from './path.js';
+// Naming utilities
+export { formatLabel, slugify, camelCase, pascalCase, snakeCase, constantCase, kebabCase, pluralize, singularize, truncate, toIdentifier, } from './naming.js';
+// Validation utilities
+export { FIELD_TYPES, fieldTypeSchema, fieldPathSchema, fieldAttributesSchema, fieldSchema, isValidFieldType, isValidFieldPath, validateFieldAttributes, validateFieldSchema, isValidAttribute, extractAttributeName, parseOptions, parseCondition, } from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iBAAiB;AACjB,OAAO,EACL,SAAS,EACT,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB,mBAAmB;AACnB,OAAO,EACL,WAAW,EACX,OAAO,EACP,SAAS,EACT,UAAU,EACV,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EACT,WAAW,EACX,QAAQ,EACR,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,uBAAuB;AACvB,OAAO,EACL,WAAW,EACX,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/utils/naming.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Naming utilities for converting between different naming conventions.
+ */
+/**
+ * Convert a slug or identifier to a human-readable label.
+ *
+ * @example
+ * ```ts
+ * formatLabel('hero_title') // 'Hero Title'
+ * formatLabel('heroTitle') // 'Hero Title'
+ * formatLabel('hero-title') // 'Hero Title'
+ * formatLabel('HeroTitle') // 'Hero Title'
+ * ```
+ */
+export declare function formatLabel(input: string): string;
+/**
+ * Convert a string to a URL-safe slug.
+ *
+ * @example
+ * ```ts
+ * slugify('Hero Title') // 'hero-title'
+ * slugify('Hello World!') // 'hello-world'
+ * slugify('café') // 'cafe'
+ * ```
+ */
+export declare function slugify(input: string): string;
+/**
+ * Convert a string to camelCase.
+ *
+ * @example
+ * ```ts
+ * camelCase('hero-title') // 'heroTitle'
+ * camelCase('Hero Title') // 'heroTitle'
+ * camelCase('HERO_TITLE') // 'heroTitle'
+ * ```
+ */
+export declare function camelCase(input: string): string;
+/**
+ * Convert a string to PascalCase.
+ *
+ * @example
+ * ```ts
+ * pascalCase('hero-title') // 'HeroTitle'
+ * pascalCase('hero title') // 'HeroTitle'
+ * pascalCase('heroTitle') // 'HeroTitle'
+ * ```
+ */
+export declare function pascalCase(input: string): string;
+/**
+ * Convert a string to snake_case.
+ *
+ * @example
+ * ```ts
+ * snakeCase('heroTitle') // 'hero_title'
+ * snakeCase('Hero Title') // 'hero_title'
+ * snakeCase('hero-title') // 'hero_title'
+ * ```
+ */
+export declare function snakeCase(input: string): string;
+/**
+ * Convert a string to CONSTANT_CASE.
+ *
+ * @example
+ * ```ts
+ * constantCase('heroTitle') // 'HERO_TITLE'
+ * constantCase('hero-title') // 'HERO_TITLE'
+ * ```
+ */
+export declare function constantCase(input: string): string;
+/**
+ * Convert a string to kebab-case.
+ *
+ * @example
+ * ```ts
+ * kebabCase('heroTitle') // 'hero-title'
+ * kebabCase('Hero Title') // 'hero-title'
+ * ```
+ */
+export declare function kebabCase(input: string): string;
+/**
+ * Pluralize a word (simple English rules).
+ *
+ * @example
+ * ```ts
+ * pluralize('item') // 'items'
+ * pluralize('category') // 'categories'
+ * pluralize('status') // 'statuses'
+ * ```
+ */
+export declare function pluralize(word: string): string;
+/**
+ * Singularize a word (simple English rules).
+ *
+ * @example
+ * ```ts
+ * singularize('items') // 'item'
+ * singularize('categories') // 'category'
+ * ```
+ */
+export declare function singularize(word: string): string;
+/**
+ * Truncate a string to a maximum length.
+ *
+ * @example
+ * ```ts
+ * truncate('Hello World', 8) // 'Hello...'
+ * truncate('Hello', 10) // 'Hello'
+ * ```
+ */
+export declare function truncate(input: string, maxLength: number, suffix?: string): string;
+/**
+ * Generate a safe TypeScript identifier from a string.
+ *
+ * @example
+ * ```ts
+ * toIdentifier('hero-title') // 'heroTitle'
+ * toIdentifier('123start') // '_123start'
+ * toIdentifier('class') // '_class'
+ * ```
+ */
+export declare function toIdentifier(input: string): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/utils/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../src/utils/naming.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAajD;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAe7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAa/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyC9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA4ChD;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAQ,GAAG,MAAM,CAKjF;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA+DlD"}

package/dist/utils/naming.js

@@ -0,0 +1,302 @@
+/**
+ * Naming utilities for converting between different naming conventions.
+ */
+/**
+ * Convert a slug or identifier to a human-readable label.
+ *
+ * @example
+ * ```ts
+ * formatLabel('hero_title') // 'Hero Title'
+ * formatLabel('heroTitle') // 'Hero Title'
+ * formatLabel('hero-title') // 'Hero Title'
+ * formatLabel('HeroTitle') // 'Hero Title'
+ * ```
+ */
+export function formatLabel(input) {
+    return (input
+        // Insert space before uppercase letters in camelCase/PascalCase
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        // Replace underscores and hyphens with spaces
+        .replace(/[_-]/g, ' ')
+        // Capitalize first letter of each word
+        .replace(/\b\w/g, (char) => char.toUpperCase())
+        // Clean up multiple spaces
+        .replace(/\s+/g, ' ')
+        .trim());
+}
+/**
+ * Convert a string to a URL-safe slug.
+ *
+ * @example
+ * ```ts
+ * slugify('Hero Title') // 'hero-title'
+ * slugify('Hello World!') // 'hello-world'
+ * slugify('café') // 'cafe'
+ * ```
+ */
+export function slugify(input) {
+    return (input
+        .toLowerCase()
+        // Normalize unicode characters and remove diacritical marks
+        .normalize('NFD')
+        // biome-ignore lint/suspicious/noMisleadingCharacterClass: Valid pattern for combining diacritical marks
+        .replace(/[\u0300-\u036f]/g, '')
+        // Replace non-alphanumeric with hyphens
+        .replace(/[^a-z0-9]+/g, '-')
+        // Remove leading/trailing hyphens
+        .replace(/^-+|-+$/g, '')
+        // Remove duplicate hyphens
+        .replace(/-+/g, '-'));
+}
+/**
+ * Convert a string to camelCase.
+ *
+ * @example
+ * ```ts
+ * camelCase('hero-title') // 'heroTitle'
+ * camelCase('Hero Title') // 'heroTitle'
+ * camelCase('HERO_TITLE') // 'heroTitle'
+ * ```
+ */
+export function camelCase(input) {
+    return input.toLowerCase().replace(/[^a-z0-9]+(.)/g, (_, char) => char.toUpperCase());
+}
+/**
+ * Convert a string to PascalCase.
+ *
+ * @example
+ * ```ts
+ * pascalCase('hero-title') // 'HeroTitle'
+ * pascalCase('hero title') // 'HeroTitle'
+ * pascalCase('heroTitle') // 'HeroTitle'
+ * ```
+ */
+export function pascalCase(input) {
+    const camel = camelCase(input);
+    return camel.charAt(0).toUpperCase() + camel.slice(1);
+}
+/**
+ * Convert a string to snake_case.
+ *
+ * @example
+ * ```ts
+ * snakeCase('heroTitle') // 'hero_title'
+ * snakeCase('Hero Title') // 'hero_title'
+ * snakeCase('hero-title') // 'hero_title'
+ * ```
+ */
+export function snakeCase(input) {
+    return (input
+        // Insert underscore before uppercase letters
+        .replace(/([a-z])([A-Z])/g, '$1_$2')
+        .toLowerCase()
+        // Replace non-alphanumeric with underscores
+        .replace(/[^a-z0-9]+/g, '_')
+        // Remove leading/trailing underscores
+        .replace(/^_+|_+$/g, '')
+        // Remove duplicate underscores
+        .replace(/_+/g, '_'));
+}
+/**
+ * Convert a string to CONSTANT_CASE.
+ *
+ * @example
+ * ```ts
+ * constantCase('heroTitle') // 'HERO_TITLE'
+ * constantCase('hero-title') // 'HERO_TITLE'
+ * ```
+ */
+export function constantCase(input) {
+    return snakeCase(input).toUpperCase();
+}
+/**
+ * Convert a string to kebab-case.
+ *
+ * @example
+ * ```ts
+ * kebabCase('heroTitle') // 'hero-title'
+ * kebabCase('Hero Title') // 'hero-title'
+ * ```
+ */
+export function kebabCase(input) {
+    return snakeCase(input).replace(/_/g, '-');
+}
+/**
+ * Pluralize a word (simple English rules).
+ *
+ * @example
+ * ```ts
+ * pluralize('item') // 'items'
+ * pluralize('category') // 'categories'
+ * pluralize('status') // 'statuses'
+ * ```
+ */
+export function pluralize(word) {
+    const lower = word.toLowerCase();
+    // Irregular plurals
+    const irregulars = {
+        child: 'children',
+        person: 'people',
+        man: 'men',
+        woman: 'women',
+        foot: 'feet',
+        tooth: 'teeth',
+        goose: 'geese',
+        mouse: 'mice',
+    };
+    if (irregulars[lower]) {
+        // Preserve original case
+        if (word[0] === word[0]?.toUpperCase()) {
+            const plural = irregulars[lower];
+            return (plural?.[0]?.toUpperCase() ?? '') + (plural?.slice(1) ?? '');
+        }
+        return irregulars[lower] ?? word;
+    }
+    // Words ending in -s, -x, -z, -ch, -sh
+    if (/(?:s|x|z|ch|sh)$/i.test(word)) {
+        return `${word}es`;
+    }
+    // Words ending in consonant + y
+    if (/[^aeiou]y$/i.test(word)) {
+        return `${word.slice(0, -1)}ies`;
+    }
+    // Words ending in -f or -fe
+    if (/(?:f|fe)$/i.test(word)) {
+        return word.replace(/(?:f|fe)$/i, 'ves');
+    }
+    // Default: add -s
+    return `${word}s`;
+}
+/**
+ * Singularize a word (simple English rules).
+ *
+ * @example
+ * ```ts
+ * singularize('items') // 'item'
+ * singularize('categories') // 'category'
+ * ```
+ */
+export function singularize(word) {
+    const lower = word.toLowerCase();
+    // Irregular singulars
+    const irregulars = {
+        children: 'child',
+        people: 'person',
+        men: 'man',
+        women: 'woman',
+        feet: 'foot',
+        teeth: 'tooth',
+        geese: 'goose',
+        mice: 'mouse',
+    };
+    if (irregulars[lower]) {
+        if (word[0] === word[0]?.toUpperCase()) {
+            const singular = irregulars[lower];
+            return (singular?.[0]?.toUpperCase() ?? '') + (singular?.slice(1) ?? '');
+        }
+        return irregulars[lower] ?? word;
+    }
+    // Words ending in -ies
+    if (/ies$/i.test(word)) {
+        return `${word.slice(0, -3)}y`;
+    }
+    // Words ending in -ves
+    if (/ves$/i.test(word)) {
+        return `${word.slice(0, -3)}f`;
+    }
+    // Words ending in -es (for -s, -x, -z, -ch, -sh)
+    if (/(?:s|x|z|ch|sh)es$/i.test(word)) {
+        return word.slice(0, -2);
+    }
+    // Words ending in -s
+    if (/s$/i.test(word) && !/ss$/i.test(word)) {
+        return word.slice(0, -1);
+    }
+    return word;
+}
+/**
+ * Truncate a string to a maximum length.
+ *
+ * @example
+ * ```ts
+ * truncate('Hello World', 8) // 'Hello...'
+ * truncate('Hello', 10) // 'Hello'
+ * ```
+ */
+export function truncate(input, maxLength, suffix = '...') {
+    if (input.length <= maxLength) {
+        return input;
+    }
+    return input.slice(0, maxLength - suffix.length) + suffix;
+}
+/**
+ * Generate a safe TypeScript identifier from a string.
+ *
+ * @example
+ * ```ts
+ * toIdentifier('hero-title') // 'heroTitle'
+ * toIdentifier('123start') // '_123start'
+ * toIdentifier('class') // '_class'
+ * ```
+ */
+export function toIdentifier(input) {
+    // Reserved words that cannot be used as identifiers
+    const reserved = new Set([
+        'break',
+        'case',
+        'catch',
+        'class',
+        'const',
+        'continue',
+        'debugger',
+        'default',
+        'delete',
+        'do',
+        'else',
+        'enum',
+        'export',
+        'extends',
+        'false',
+        'finally',
+        'for',
+        'function',
+        'if',
+        'import',
+        'in',
+        'instanceof',
+        'new',
+        'null',
+        'return',
+        'super',
+        'switch',
+        'this',
+        'throw',
+        'true',
+        'try',
+        'typeof',
+        'var',
+        'void',
+        'while',
+        'with',
+        'yield',
+        'let',
+        'static',
+        'implements',
+        'interface',
+        'package',
+        'private',
+        'protected',
+        'public',
+    ]);
+    let identifier = camelCase(input);
+    // Prefix with underscore if starts with number
+    if (/^\d/.test(identifier)) {
+        identifier = `_${identifier}`;
+    }
+    // Prefix with underscore if reserved word
+    if (reserved.has(identifier)) {
+        identifier = `_${identifier}`;
+    }
+    return identifier;
+}
+//# sourceMappingURL=naming.js.map

package/dist/utils/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../src/utils/naming.ts"],"names":[],"mappings":"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"}