@sharpee/lang-en-us 1.2.0 → 2.0.0

package/assembler/english-assembler.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @file English Assembler — realizes a phrase tree to text blocks (ADR-192 §4).
+ *
+ * Purpose: the single English-locale component that walks a `Phrase` tree and
+ * is the SOLE authority for every cross-cutting correctness concern — article,
+ * agreement, punctuation, whitespace, reference, and case. It replaces the
+ * left-to-right formatter chain (`applyFormatters`) whose early collapse to a
+ * bare string lost the metadata neighbours need to agree against.
+ *
+ * Public interface: `EnglishAssembler` (implements `Assembler`),
+ * `ASSEMBLER_DEFAULT_BLOCK_KEY`, and the standalone `capitalizeSentenceStart`
+ * case-authority helper.
+ *
+ * Owner context: `@sharpee/lang-en-us` — English realization. The ADR-190 list
+ * formatter logic is reproduced here in the `PhraseList` case (the old
+ * `formatters/list.ts` is retired in Phase 3, not called from here).
+ *
+ * INVARIANT (ADR-192 §7): `realize` is a pure function of `(tree, ctx)` GIVEN the
+ * `textState` snapshot — the same tree, context, and counters yield byte-identical
+ * output. No clocks, no `Math.random`. The one declared state transition is a
+ * `Choice` advancing its `textState` counter (ADR-196 §3) — seeded, deterministic.
+ *
+ * All if-domain kinds are realized here: the foundational kinds (Literal,
+ * NounPhrase, PhraseList, Sequence, Empty) plus the `Verb` (199), `Verbatim`
+ * (200), `Numeral` (198), `Pronoun` (197), `Contents` (194), `Slot` (195), and
+ * `Optional` / `Choice` (196) atoms. `PhraseNotImplementedError` is now only a
+ * defensive guard against a future unhandled kind.
+ */
+import { Assembler, Phrase, RenderContext } from '@sharpee/if-domain';
+import { ITextBlock } from '@sharpee/text-blocks';
+/**
+ * Default channel key for a realized tree. Phase 2 emits one block; the report
+ * layer (ADR-192 §6, Phase 4) assigns real channel keys (room.name, …) as it
+ * wires per-event trees.
+ */
+export declare const ASSEMBLER_DEFAULT_BLOCK_KEY: "action.result";
+/**
+ * Capitalize the first alphabetic character of a sentence. Exposed as the Case
+ * authority; the explicit `{capitalize …}` template hint is wired to it by the
+ * parser in Phase 3 (ADR-192 §5). Not auto-applied — realization preserves the
+ * author's case unless capitalization is requested.
+ *
+ * @param text the realized text
+ * @returns the text with its first letter upper-cased
+ */
+export declare function capitalizeSentenceStart(text: string): string;
+/**
+ * The English Assembler. Realizes a phrase tree to text blocks under the default
+ * channel key; the report layer re-keys per channel.
+ */
+export declare class EnglishAssembler implements Assembler {
+    /**
+     * Realize a phrase tree to text blocks.
+     *
+     * Newlines in the realized text are lifted to block boundaries (no block's
+     * content carries `\n`); horizontal whitespace is collapsed per block, except
+     * in verbatim runs. A single-line tree yields one block.
+     *
+     * @param tree the phrase tree to realize
+     * @param ctx the render context (world, params, settings, seams)
+     * @returns the realized text blocks
+     * @throws PhraseNotImplementedError when a reserved stub kind is encountered
+     */
+    realize(tree: Phrase, ctx: RenderContext): ITextBlock[];
+}
+//# sourceMappingURL=english-assembler.d.ts.map

package/assembler/english-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"english-assembler.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/lang-en-us/src/assembler/english-assembler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EACL,SAAS,EACT,MAAM,EAON,aAAa,EAgBd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAA6C,MAAM,sBAAsB,CAAC;AAK7F;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,iBAAgC,CAAC;AA0ZzE;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5D;AAiXD;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,SAAS;IAChD;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,UAAU,EAAE;CAwBxD"}