@lokascript/semantic 1.2.1 → 2.0.0

package/dist/generators/profiles/marker-templates.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Marker Templates
+ *
+ * Shared role marker configurations for language families.
+ * These templates reduce duplication across language profiles.
+ *
+ * Usage:
+ *   import { SVO_PREPOSITION_MARKERS } from './marker-templates';
+ *   roleMarkers: { ...SVO_PREPOSITION_MARKERS, destination: { ...custom } }
+ */
+import type { RoleMarker, VerbConfig, PossessiveConfig, MarkingStrategy } from './types';
+import type { SemanticRole } from '../../types';
+/**
+ * Common role markers for SVO languages with prepositions.
+ * Used by: English, Spanish, French, German, Portuguese, Italian, Russian, Indonesian
+ */
+export declare const SVO_PREPOSITION_MARKERS: Partial<Record<SemanticRole, RoleMarker>>;
+/**
+ * Common role markers for SOV languages with particles/postpositions.
+ * Used by: Japanese, Korean, Turkish, Quechua
+ */
+export declare const SOV_PARTICLE_MARKERS: Partial<Record<SemanticRole, RoleMarker>>;
+/**
+ * Korean-specific role markers (vowel harmony variants).
+ */
+export declare const KOREAN_PARTICLE_MARKERS: Partial<Record<SemanticRole, RoleMarker>>;
+/**
+ * Turkish-specific role markers (vowel harmony).
+ */
+export declare const TURKISH_SUFFIX_MARKERS: Partial<Record<SemanticRole, RoleMarker>>;
+/**
+ * Arabic role markers (VSO, RTL).
+ */
+export declare const ARABIC_PREPOSITION_MARKERS: Partial<Record<SemanticRole, RoleMarker>>;
+/**
+ * SVO verb configuration (verb at start, optional subject drop).
+ */
+export declare const SVO_VERB_CONFIG: VerbConfig;
+/**
+ * SVO verb configuration for pro-drop languages (Spanish, Italian, Portuguese).
+ */
+export declare const SVO_PRODROP_VERB_CONFIG: VerbConfig;
+/**
+ * SOV verb configuration (verb at end, usually subject drop).
+ */
+export declare const SOV_VERB_CONFIG: VerbConfig;
+/**
+ * VSO verb configuration (Arabic).
+ */
+export declare const VSO_VERB_CONFIG: VerbConfig;
+/**
+ * German V2 verb configuration.
+ */
+export declare const V2_VERB_CONFIG: VerbConfig;
+/**
+ * English possessive configuration ('s marker).
+ */
+export declare const ENGLISH_POSSESSIVE: PossessiveConfig;
+/**
+ * Romance language possessive configuration (de + adjectives).
+ * Used by: Spanish, French, Portuguese, Italian
+ */
+export declare const ROMANCE_POSSESSIVE_BASE: Omit<PossessiveConfig, 'specialForms' | 'keywords'>;
+/**
+ * Japanese possessive configuration (の particle).
+ */
+export declare const JAPANESE_POSSESSIVE: PossessiveConfig;
+/**
+ * Korean possessive configuration (의 particle).
+ */
+export declare const KOREAN_POSSESSIVE: PossessiveConfig;
+/**
+ * German possessive configuration.
+ */
+export declare const GERMAN_POSSESSIVE: PossessiveConfig;
+/**
+ * Base configuration for SVO languages with prepositions.
+ */
+export interface SVOBaseConfig {
+    wordOrder: 'SVO';
+    markingStrategy: 'preposition';
+    usesSpaces: true;
+    direction: 'ltr';
+}
+export declare const SVO_BASE_CONFIG: SVOBaseConfig;
+/**
+ * Base configuration for SOV languages with particles.
+ */
+export interface SOVBaseConfig {
+    wordOrder: 'SOV';
+    markingStrategy: MarkingStrategy;
+    usesSpaces: boolean;
+    direction: 'ltr';
+}
+export declare const SOV_PARTICLE_CONFIG: SOVBaseConfig;
+export declare const SOV_SPACE_CONFIG: SOVBaseConfig;
+/**
+ * Base configuration for VSO languages.
+ */
+export interface VSOBaseConfig {
+    wordOrder: 'VSO';
+    markingStrategy: 'preposition';
+    usesSpaces: boolean;
+    direction: 'ltr' | 'rtl';
+}
+export declare const VSO_BASE_CONFIG: VSOBaseConfig;
+/**
+ * Create role markers by translating from a base template.
+ * Useful for creating language-specific markers from SVO_PREPOSITION_MARKERS.
+ */
+export declare function createRoleMarkers(translations: Partial<Record<SemanticRole, string | {
+    primary: string;
+    alternatives?: string[];
+}>>): Partial<Record<SemanticRole, RoleMarker>>;
+/**
+ * Create Romance possessive config with language-specific overrides.
+ */
+export declare function createRomancePossessive(specialForms: Record<string, string>, keywords: Record<string, string>): PossessiveConfig;
+//# sourceMappingURL=marker-templates.d.ts.map

package/dist/generators/profiles/marker-templates.d.ts.map

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

package/dist/generators/profiles/ms.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Malay Language Profile
+ *
+ * SVO word order, prepositions, space-separated.
+ */
+import type { LanguageProfile } from './types';
+export declare const malayProfile: LanguageProfile;
+//# sourceMappingURL=ms.d.ts.map

package/dist/generators/profiles/ms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ms.d.ts","sourceRoot":"","sources":["../../../src/generators/profiles/ms.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,YAAY,EAAE,eA+H1B,CAAC"}

package/dist/generators/profiles/polish.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Polish Language Profile
+ *
+ * SVO word order, prepositions, space-separated.
+ * Polish is a fusional language with rich verb conjugation.
+ * Unlike most languages, Polish software UI uses IMPERATIVE form.
+ */
+import type { LanguageProfile } from './types';
+export declare const polishProfile: LanguageProfile;
+//# sourceMappingURL=polish.d.ts.map

package/dist/generators/profiles/polish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polish.d.ts","sourceRoot":"","sources":["../../../src/generators/profiles/polish.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,aAAa,EAAE,eAgQ3B,CAAC"}

package/dist/generators/profiles/portuguese.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Portuguese Language Profile
+ *
+ * SVO word order, prepositions, space-separated.
+ * Features rich verb conjugation with pro-drop (subject omission).
+ */
+import type { LanguageProfile } from './types';
+export declare const portugueseProfile: LanguageProfile;
+//# sourceMappingURL=portuguese.d.ts.map

package/dist/generators/profiles/portuguese.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portuguese.d.ts","sourceRoot":"","sources":["../../../src/generators/profiles/portuguese.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,iBAAiB,EAAE,eA+H/B,CAAC"}

package/dist/generators/profiles/quechua.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Quechua Language Profile
+ *
+ * SOV word order, postpositions (suffixes), polysynthetic/agglutinative.
+ * Indigenous language of the Andean region with rich morphology.
+ */
+import type { LanguageProfile } from './types';
+export declare const quechuaProfile: LanguageProfile;
+//# sourceMappingURL=quechua.d.ts.map

package/dist/generators/profiles/quechua.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quechua.d.ts","sourceRoot":"","sources":["../../../src/generators/profiles/quechua.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,cAAc,EAAE,eA6H5B,CAAC"}

package/dist/generators/profiles/russian.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Russian Language Profile
+ *
+ * SVO word order, prepositions, space-separated.
+ * Russian is a fusional language with rich verb conjugation.
+ * Uses infinitive form in software UI (industry standard).
+ */
+import type { LanguageProfile } from './types';
+export declare const russianProfile: LanguageProfile;
+//# sourceMappingURL=russian.d.ts.map

package/dist/generators/profiles/russian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"russian.d.ts","sourceRoot":"","sources":["../../../src/generators/profiles/russian.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,cAAc,EAAE,eA0Q5B,CAAC"}

package/dist/generators/profiles/spanish.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Spanish Language Profile
+ *
+ * SVO word order, prepositions, space-separated.
+ * Features rich verb conjugation with pro-drop (subject omission).
+ */
+import type { LanguageProfile } from './types';
+export declare const spanishProfile: LanguageProfile;
+//# sourceMappingURL=spanish.d.ts.map

package/dist/generators/profiles/spanish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spanish.d.ts","sourceRoot":"","sources":["../../../src/generators/profiles/spanish.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,cAAc,EAAE,eA6I5B,CAAC"}

package/dist/generators/profiles/spanishMexico.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Mexican Spanish Language Profile
+ *
+ * ⚠️  EXAMPLE/TEST ONLY - NOT FOR PRODUCTION USE
+ *
+ * This profile demonstrates the language variant feature:
+ * - Extends base Spanish using `extends: 'es'`
+ * - Overrides specific keywords with regional alternatives
+ * - Reuses the Spanish tokenizer
+ *
+ * The Mexican-specific vocabulary (ahorita, jalar, aventar, etc.) is
+ * illustrative and has NOT been validated by native speakers.
+ *
+ * To create a production-ready regional variant, consult native speakers
+ * to verify vocabulary choices and completeness.
+ */
+import type { LanguageProfile } from './types';
+export declare const spanishMexicoProfile: LanguageProfile;
+//# sourceMappingURL=spanishMexico.d.ts.map

package/dist/generators/profiles/spanishMexico.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spanishMexico.d.ts","sourceRoot":"","sources":["../../../src/generators/profiles/spanishMexico.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,oBAAoB,EAAE,eAkKlC,CAAC"}

package/dist/generators/profiles/swahili.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Swahili Language Profile
+ *
+ * SVO word order, prepositions, space-separated, agglutinative.
+ * Features noun class system (18 classes) and verb agreement prefixes.
+ */
+import type { LanguageProfile } from './types';
+export declare const swahiliProfile: LanguageProfile;
+//# sourceMappingURL=swahili.d.ts.map

package/dist/generators/profiles/swahili.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swahili.d.ts","sourceRoot":"","sources":["../../../src/generators/profiles/swahili.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,cAAc,EAAE,eAkI5B,CAAC"}

package/dist/generators/profiles/thai.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Thai Language Profile
+ *
+ * SVO word order, prepositions, Thai script.
+ * Isolating language (like Chinese) with no inflection.
+ */
+import type { LanguageProfile } from './types';
+export declare const thaiProfile: LanguageProfile;
+//# sourceMappingURL=thai.d.ts.map

package/dist/generators/profiles/thai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thai.d.ts","sourceRoot":"","sources":["../../../src/generators/profiles/thai.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,WAAW,EAAE,eA2IzB,CAAC"}

package/dist/generators/profiles/tl.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tagalog Language Profile
+ *
+ * VSO word order, prepositions, space-separated.
+ */
+import type { LanguageProfile } from './types';
+export declare const tagalogProfile: LanguageProfile;
+//# sourceMappingURL=tl.d.ts.map

package/dist/generators/profiles/tl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tl.d.ts","sourceRoot":"","sources":["../../../src/generators/profiles/tl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,cAAc,EAAE,eAoI5B,CAAC"}

package/dist/generators/profiles/turkish.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Turkish Language Profile
+ *
+ * SOV word order, case suffixes (agglutinative), space-separated.
+ * Features vowel harmony and extensive suffixation.
+ */
+import type { LanguageProfile } from './types';
+export declare const turkishProfile: LanguageProfile;
+//# sourceMappingURL=turkish.d.ts.map

package/dist/generators/profiles/turkish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turkish.d.ts","sourceRoot":"","sources":["../../../src/generators/profiles/turkish.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,cAAc,EAAE,eAkK5B,CAAC"}

package/dist/generators/profiles/types.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Language Profile Types
+ *
+ * Type definitions for language profiles, separated for tree-shaking.
+ */
+import type { SemanticRole } from '../../types';
+/**
+ * Word order in a language (for declarative statements).
+ */
+export type WordOrder = 'SVO' | 'SOV' | 'VSO' | 'VOS' | 'OSV' | 'OVS';
+/**
+ * How grammatical relationships are marked.
+ */
+export type MarkingStrategy = 'preposition' | 'postposition' | 'particle' | 'case-suffix';
+/**
+ * A grammatical marker (preposition, particle, etc.) for a semantic role.
+ */
+export interface RoleMarker {
+    /** Primary marker for this role */
+    readonly primary: string;
+    /** Alternative markers that also work */
+    readonly alternatives?: string[];
+    /** Position relative to the role value */
+    readonly position: 'before' | 'after';
+}
+/**
+ * Verb form configuration for a language.
+ */
+export interface VerbConfig {
+    /** Position of verb in the sentence */
+    readonly position: 'start' | 'end' | 'second';
+    /** Common verb suffixes/conjugations to recognize */
+    readonly suffixes?: string[];
+    /** Whether the language commonly drops subjects */
+    readonly subjectDrop?: boolean;
+}
+/**
+ * Configuration for possessive expression construction.
+ * Defines how "X's property" is expressed in a language.
+ */
+export interface PossessiveConfig {
+    /** Possessive marker (e.g., "'s" in English, "の" in Japanese) */
+    readonly marker: string;
+    /** Position of marker: 'after-object' (X's Y), 'between' (X の Y), 'before-property' */
+    readonly markerPosition: 'after-object' | 'between' | 'before-property';
+    /** Special possessive forms (e.g., 'me' → 'my' in English) */
+    readonly specialForms?: Record<string, string>;
+    /** Whether to use possessive adjectives instead of marker (e.g., Spanish mi/tu/su) */
+    readonly usePossessiveAdjectives?: boolean;
+    /**
+     * Possessive keywords mapped to their corresponding reference.
+     * Used by pattern-matcher to recognize possessive expressions.
+     * Example: { my: 'me', your: 'you', its: 'it' }
+     */
+    readonly keywords?: Record<string, string>;
+}
+/**
+ * Complete language profile for pattern generation.
+ */
+export interface LanguageProfile {
+    /** ISO 639-1 or BCP 47 language code (e.g., 'es' or 'es-MX') */
+    readonly code: string;
+    /** Human-readable language name */
+    readonly name: string;
+    /** Native name */
+    readonly nativeName: string;
+    /** Text direction */
+    readonly direction: 'ltr' | 'rtl';
+    /** Primary word order */
+    readonly wordOrder: WordOrder;
+    /** How this language marks grammatical roles */
+    readonly markingStrategy: MarkingStrategy;
+    /** Markers for each semantic role */
+    readonly roleMarkers: Partial<Record<SemanticRole, RoleMarker>>;
+    /** Verb configuration */
+    readonly verb: VerbConfig;
+    /** Command keyword translations */
+    readonly keywords: Record<string, KeywordTranslation>;
+    /** Whether the language uses spaces between words */
+    readonly usesSpaces: boolean;
+    /** Special tokenization notes */
+    readonly tokenization?: TokenizationConfig;
+    /** Reference translations (me, it, you, etc.) */
+    readonly references?: Record<string, string>;
+    /** Possessive expression configuration */
+    readonly possessive?: PossessiveConfig;
+    /** Event handler pattern configuration (for simple SVO languages) */
+    readonly eventHandler?: EventHandlerConfig;
+    /**
+     * Default verb form for command keywords. Defaults to 'infinitive'.
+     *
+     * Based on software UI localization research:
+     * - 'infinitive': Spanish, French, German, Portuguese, Russian (industry standard)
+     * - 'imperative': Polish
+     * - 'base': English, Japanese, Korean (no distinction or same form)
+     *
+     * Individual keywords can override this via KeywordTranslation.form
+     */
+    readonly defaultVerbForm?: VerbForm;
+    /**
+     * Base language code to extend (for regional variants).
+     * When set, this profile inherits from the base and overrides specific fields.
+     * Example: 'es-MX' profile with extends: 'es' inherits from Spanish base.
+     */
+    readonly extends?: string;
+}
+/**
+ * Configuration for event handler pattern generation.
+ * Supports both SVO and SOV/VSO languages.
+ */
+export interface EventHandlerConfig {
+    /** Primary event keyword (e.g., 'on', 'bei', 'sur') for SVO */
+    readonly keyword?: KeywordTranslation;
+    /** Source filter marker (e.g., 'from', 'von', 'de') */
+    readonly sourceMarker?: RoleMarker;
+    /** Conditional keyword (e.g., 'when', 'wenn', 'quand') */
+    readonly conditionalKeyword?: KeywordTranslation;
+    /** Event marker for SOV/VSO languages (e.g., で (Japanese), 할 때 (Korean), da (Turkish), عند (Arabic)) */
+    readonly eventMarker?: RoleMarker;
+    /** Temporal/conditional markers that can optionally appear with events */
+    readonly temporalMarkers?: string[];
+    /**
+     * Negation marker for expressing negated events (e.g., Arabic عدم = "not/lack of").
+     * Used in patterns like: عند عدم التركيز = "when not focusing" = "on blur"
+     */
+    readonly negationMarker?: RoleMarker;
+}
+/**
+ * Verb form used for command keywords.
+ *
+ * Based on software localization research:
+ * - 'infinitive': Standard for most languages (Spanish, French, German, Russian)
+ *   Example: "Guardar", "Enregistrer", "Speichern"
+ * - 'imperative': Used by some languages (Polish)
+ *   Example: "Zapisz", "Otwórz"
+ * - 'base': For languages where forms are identical (English, Japanese, Korean)
+ *   or where the distinction doesn't apply
+ */
+export type VerbForm = 'infinitive' | 'imperative' | 'base';
+/**
+ * Translation of a command keyword.
+ */
+export interface KeywordTranslation {
+    /** Primary translation (used for output/rendering) */
+    readonly primary: string;
+    /** Alternative forms for parsing (conjugations, synonyms, informal variants) */
+    readonly alternatives?: string[];
+    /** Normalized English form for internal matching */
+    readonly normalized?: string;
+    /**
+     * The grammatical form of 'primary'. Defaults to 'infinitive'.
+     * This documents the form used and enables future form-switching features.
+     * - 'infinitive': Dictionary form (alternar, basculer) - industry standard
+     * - 'imperative': Command form (alterna, bascule) - for Polish, etc.
+     * - 'base': Same form for both (toggle, トグル) - English, Japanese, Korean
+     */
+    readonly form?: VerbForm;
+}
+/**
+ * Special tokenization configuration.
+ */
+export interface TokenizationConfig {
+    /** Particles to recognize (for particle languages) */
+    readonly particles?: string[];
+    /** Prefixes to recognize (for prefixing languages) */
+    readonly prefixes?: string[];
+    /** Word boundary detection strategy */
+    readonly boundaryStrategy?: 'space' | 'particle' | 'character';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/generators/profiles/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/generators/profiles/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,cAAc,GAAG,UAAU,GAAG,aAAa,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC9C,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uFAAuF;IACvF,QAAQ,CAAC,cAAc,EAAE,cAAc,GAAG,SAAS,GAAG,iBAAiB,CAAC;IACxE,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,sFAAsF;IACtF,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qBAAqB;IACrB,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;IAClC,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,qCAAqC;IACrC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAChE,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACtD,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAC3C,iDAAiD;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IACvC,qEAAqE;IACrE,QAAQ,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAC3C;;;;;;;;;OASG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IACtC,uDAAuD;IACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC;IACnC,0DAA0D;IAC1D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAEjD,wGAAwG;IACxG,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;CACtC;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,YAAY,GAAG,MAAM,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,oDAAoD;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,uCAAuC;IACvC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;CAChE"}

package/dist/generators/profiles/ukrainian.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Ukrainian Language Profile
+ *
+ * SVO word order, prepositions, space-separated.
+ * Ukrainian is a fusional language with rich verb conjugation.
+ * Uses infinitive form in software UI (industry standard).
+ */
+import type { LanguageProfile } from './types';
+export declare const ukrainianProfile: LanguageProfile;
+//# sourceMappingURL=ukrainian.d.ts.map

package/dist/generators/profiles/ukrainian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ukrainian.d.ts","sourceRoot":"","sources":["../../../src/generators/profiles/ukrainian.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,gBAAgB,EAAE,eAoR9B,CAAC"}

package/dist/generators/profiles/vietnamese.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Vietnamese Language Profile
+ *
+ * SVO word order, prepositions, space-separated.
+ * Vietnamese is an isolating (analytic) language with no inflection.
+ * Uses Latin script with extensive diacritics for tone marking.
+ */
+import type { LanguageProfile } from './types';
+export declare const vietnameseProfile: LanguageProfile;
+//# sourceMappingURL=vietnamese.d.ts.map

package/dist/generators/profiles/vietnamese.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vietnamese.d.ts","sourceRoot":"","sources":["../../../src/generators/profiles/vietnamese.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,iBAAiB,EAAE,eA2I/B,CAAC"}

package/dist/generators/schema-error-codes.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Schema Error Codes
+ *
+ * Provides machine-readable error codes for schema validation.
+ * These codes enable LLMs and tooling to programmatically identify
+ * and respond to specific validation issues.
+ */
+import type { SemanticRole } from '../types';
+/**
+ * Severity levels for schema validation items.
+ */
+export type SchemaValidationSeverity = 'error' | 'warning' | 'note';
+/**
+ * A structured validation item with machine-readable code.
+ */
+export interface SchemaValidationItem {
+    /** Machine-readable error code */
+    code: string;
+    /** Human-readable message */
+    message: string;
+    /** Severity level */
+    severity: SchemaValidationSeverity;
+    /** Affected role, if applicable */
+    role?: SemanticRole;
+    /** Suggested fix */
+    suggestion?: string;
+}
+/**
+ * Schema error codes organized by category.
+ */
+export declare const SchemaErrorCodes: {
+    readonly AMBIGUOUS_TYPE_LITERAL_SELECTOR: "SCHEMA_AMBIGUOUS_TYPE_LITERAL_SELECTOR";
+    readonly TOO_MANY_EXPECTED_TYPES: "SCHEMA_TOO_MANY_EXPECTED_TYPES";
+    readonly MULTI_TYPE_PATIENT_EXPECTED: "SCHEMA_MULTI_TYPE_PATIENT_EXPECTED";
+    readonly NO_REQUIRED_ROLES: "SCHEMA_NO_REQUIRED_ROLES";
+    readonly NO_REQUIRED_ROLES_EXPECTED: "SCHEMA_NO_REQUIRED_ROLES_EXPECTED";
+    readonly TRANSITION_PATIENT_ACCEPTS_SELECTOR: "SCHEMA_TRANSITION_PATIENT_ACCEPTS_SELECTOR";
+    readonly TRANSITION_MISSING_GOAL: "SCHEMA_TRANSITION_MISSING_GOAL";
+    readonly EVENT_HANDLER_MISSING_EVENT: "SCHEMA_EVENT_HANDLER_MISSING_EVENT";
+    readonly EVENT_HANDLER_EVENT_NOT_REQUIRED: "SCHEMA_EVENT_HANDLER_EVENT_NOT_REQUIRED";
+    readonly CONDITIONAL_MISSING_CONDITION: "SCHEMA_CONDITIONAL_MISSING_CONDITION";
+    readonly CONDITIONAL_CONDITION_NOT_REQUIRED: "SCHEMA_CONDITIONAL_CONDITION_NOT_REQUIRED";
+    readonly FOR_LOOP_MISSING_SOURCE: "SCHEMA_FOR_LOOP_MISSING_SOURCE";
+    readonly WHILE_LOOP_MISSING_CONDITION: "SCHEMA_WHILE_LOOP_MISSING_CONDITION";
+};
+export type SchemaErrorCode = (typeof SchemaErrorCodes)[keyof typeof SchemaErrorCodes];
+/**
+ * Message templates for each error code.
+ * Use {role}, {command}, {count} placeholders for dynamic values.
+ */
+export declare const SchemaErrorMessages: Record<SchemaErrorCode, string>;
+/**
+ * Suggested fixes for each error code.
+ */
+export declare const SchemaErrorSuggestions: Partial<Record<SchemaErrorCode, string>>;
+/**
+ * Create a schema validation item with proper interpolation.
+ */
+export declare function createSchemaValidationItem(code: SchemaErrorCode, severity: SchemaValidationSeverity, params?: Record<string, string | number>, role?: SemanticRole): SchemaValidationItem;
+//# sourceMappingURL=schema-error-codes.d.ts.map

package/dist/generators/schema-error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-error-codes.d.ts","sourceRoot":"","sources":["../../src/generators/schema-error-codes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,QAAQ,EAAE,wBAAwB,CAAC;IACnC,mCAAmC;IACnC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,oBAAoB;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;CAyBnB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAEvF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAqC/D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAoB3E,CAAC;AASF;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,wBAAwB,EAClC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAM,EAC5C,IAAI,CAAC,EAAE,YAAY,GAClB,oBAAoB,CAatB"}

package/dist/generators/schema-validator.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Schema Validation
+ *
+ * Validates command schemas to catch design issues early:
+ * - Ambiguous type combinations (e.g., both 'literal' and 'selector')
+ * - Missing required roles for specific commands
+ * - Schema inconsistencies
+ *
+ * This runs at build time in development to catch schema errors before they cause
+ * runtime issues.
+ */
+import type { CommandSchema } from './command-schemas';
+import type { ActionType } from '../types';
+import { type SchemaValidationItem, type SchemaValidationSeverity, SchemaErrorCodes } from './schema-error-codes';
+export type { SchemaValidationItem, SchemaValidationSeverity };
+export { SchemaErrorCodes };
+/**
+ * Result from validating a single command schema.
+ *
+ * The `items` array contains all validation results with machine-readable codes.
+ * For backward compatibility, `notes`, `warnings`, and `errors` getters are provided.
+ */
+export interface SchemaValidation {
+    action: ActionType;
+    /** All validation items with structured codes and severity */
+    items: SchemaValidationItem[];
+}
+/**
+ * Extended validation result with backward-compatible getters.
+ */
+export interface SchemaValidationResult extends SchemaValidation {
+    /** @deprecated Since v1.3.0. Will be removed in v2.0.0. Use items.filter(i => i.severity === 'note') */
+    readonly notes: string[];
+    /** @deprecated Since v1.3.0. Will be removed in v2.0.0. Use items.filter(i => i.severity === 'warning') */
+    readonly warnings: string[];
+    /** @deprecated Since v1.3.0. Will be removed in v2.0.0. Use items.filter(i => i.severity === 'error') */
+    readonly errors: string[];
+}
+/**
+ * Validate a single command schema for potential issues.
+ *
+ * @param schema - The command schema to validate
+ * @returns Validation result with structured items and backward-compatible getters
+ */
+export declare function validateCommandSchema(schema: CommandSchema): SchemaValidationResult;
+/**
+ * Validate all command schemas in the registry.
+ *
+ * @param schemas - Map of action names to command schemas
+ * @param options - Validation options
+ * @returns Map of action names to validation results (only includes schemas with issues)
+ */
+export declare function validateAllSchemas(schemas: Record<string, CommandSchema>, options?: {
+    includeNotes?: boolean;
+}): Map<string, SchemaValidationResult>;
+/**
+ * Format validation results for console output.
+ *
+ * @param validations - Map of validation results
+ * @param options - Formatting options
+ * @returns Formatted string for console output
+ */
+export declare function formatValidationResults(validations: Map<string, SchemaValidationResult>, options?: {
+    showNotes?: boolean;
+    showCodes?: boolean;
+}): string;
+/**
+ * Get validation statistics.
+ */
+export declare function getValidationStats(validations: Map<string, SchemaValidationResult>): {
+    totalCommands: number;
+    errors: number;
+    warnings: number;
+    notes: number;
+    byCode: Record<string, number>;
+};
+//# sourceMappingURL=schema-validator.d.ts.map