@lokascript/domain-learn 2.1.0

package/dist/generators/gloss-generator.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Gloss Generator — Interlinear Gloss for Learning
+ *
+ * Produces interlinear glosses from a SemanticNode, showing:
+ *   tokens:  target language tokens  ["#buttonに", ".activeを", "追加して"]
+ *   roles:   grammatical labels      ["DEST", "PAT", "VERB"]
+ *   english: English gloss           ["to #button", ".active", "add (imperative)"]
+ *
+ * Glosses help ESL students understand the grammatical function of each
+ * word/particle in context, and help code students understand the mapping
+ * between natural language and programming operations.
+ */
+import type { SemanticNode } from '@lokascript/framework';
+import type { InterlinearGloss, CommunicativeFunction } from '../types';
+/**
+ * Generate an interlinear gloss for a SemanticNode.
+ */
+export declare function generateGloss(node: SemanticNode, fn: CommunicativeFunction, language: string): InterlinearGloss | null;

package/dist/generators/learn-renderer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Learn Renderer — SemanticNode → DSL text in any language
+ *
+ * Inverse of the parser: converts a parsed SemanticNode back to
+ * natural-language DSL text. Used for cross-language translation
+ * exercises and round-trip verification.
+ */
+import type { SemanticNode } from '@lokascript/framework';
+/**
+ * Render a SemanticNode as DSL text in the target language.
+ * Produces the commanding form (imperative) of the command.
+ */
+export declare function renderLearn(node: SemanticNode, language: string): string;

package/dist/generators/sentence-generator.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Learn Code Generator — The Inverted Generator
+ *
+ * Unlike domain-sql (natural language → SQL), this generator produces
+ * natural language sentences WITH morphology applied as its "compiled output".
+ *
+ * The standard CodeGenerator.generate() interface returns the commanding form
+ * in English. The extended generateForFunction() method produces sentences in
+ * any language × communicative function combination.
+ */
+import type { SemanticNode, CodeGenerator } from '@lokascript/framework';
+import type { CommunicativeFunction, RenderedSentence, LearnLanguageProfile } from '../types';
+export interface ResolvedMarker {
+    marker: string;
+    position: 'before' | 'after';
+}
+export declare function resolveMarker(verb: string, role: string, language: string): ResolvedMarker;
+export declare function attachMarker(value: string, resolved: ResolvedMarker): string;
+export declare function registerProfile(code: string, profile: LearnLanguageProfile): void;
+export declare function getProfile(code: string): LearnLanguageProfile | undefined;
+/**
+ * Generate a sentence for a SemanticNode in a specific language and
+ * communicative function.
+ */
+export declare function generateForFunction(node: SemanticNode, fn: CommunicativeFunction, language: string): RenderedSentence | null;
+/**
+ * Standard CodeGenerator interface — returns the commanding form in English.
+ * This satisfies the framework's CodeGenerator contract.
+ */
+export declare const learnCodeGenerator: CodeGenerator;
+/** Render across all communicative functions for a language */
+export declare function generateAllFunctions(node: SemanticNode, language: string): RenderedSentence[];
+/** Render across all registered languages for a single function */
+export declare function generateCrossLingual(node: SemanticNode, fn: CommunicativeFunction): RenderedSentence[];