@orkestrel/interpret 0.0.4 → 0.0.5

package/dist/src/core/index.d.cts

@@ -563,8 +563,8 @@ export declare function createSubjectManager(options?: SubjectManagerOptions): S
   * `{table}.{reasoning}` for the four reasons kinds, `result.quantitative.failed`
   * for the quantitative-result failure suffix, and `subject.fields` /
   * `subject.empty` for `describeSubject`. Every string is a plain
-  * `interpolateMessage` template — `{{name}}`-style placeholders resolved
-  * against the caller-supplied `values` record.
+  * @orkestrel/template `fillTemplate` template — `{{name}}`-style placeholders
+  * resolved against the caller-supplied `values` record.
   */
  export declare const DEFAULT_LEXICON: Lexicon;
 
@@ -1048,32 +1048,6 @@ export declare function createSubjectManager(options?: SubjectManagerOptions): S
      readonly confidence: number;
  }
 
- /**
-  * Interpolate `{{dotted.path}}` tokens in a message template against a record.
-  *
-  * @remarks
-  * Each token is split on `.` into a {@link FieldPath} array and resolved with
-  * the contracts `resolveField` (a plain string field is ONE key, never
-  * dot-split — the split here is the token-to-path bridge). A finite number
-  * renders with `en-US` thousand grouping (`5010` → `5,010`); any other
-  * resolved value String-coerces. An UNRESOLVED path (the resolved value is
-  * `undefined`) renders as the empty string — the deterministic "nothing to
-  * show" rule.
-  *
-  * @param template - The message template carrying `{{dotted.path}}` tokens
-  * @param record - The record tokens resolve against
-  * @returns The template with every token replaced
-  *
-  * @example
-  * ```ts
-  * import { interpolateMessage } from '@src/core'
-  *
-  * interpolateMessage('Limit is {{limit}}', { limit: 5010 }) // 'Limit is 5,010'
-  * interpolateMessage('Missing {{gone}}', {})                // 'Missing '
-  * ```
-  */
- export declare function interpolateMessage(template: string, record: Readonly<Record<string, unknown>>): string;
-
  /**
   * The interpretation orchestrator — the sole public entry point of the
   * `interprets` module, mirroring the reasons `Reason` orchestrator shape.
@@ -1509,8 +1483,11 @@ export declare function createSubjectManager(options?: SubjectManagerOptions): S
   * dotted `FieldPath` string to its display label, falling back to
   * `formatField` when absent. `templates` maps a template id (e.g.
   * `'definition.quantitative'`, `'result.symbolic'`, `'subject.fields'`) to an
-  * `interpolateMessage` template string — see `DEFAULT_LEXICON` for the
-  * pinned neutral key set.
+  * @orkestrel/template `fillTemplate` template string — see `DEFAULT_LEXICON`
+  * for the pinned neutral key set. Token grammar (the `[^{}]` token class, the
+  * `\{{` literal escape, whitespace trimming, and dotted-token path
+  * resolution) is defined by @orkestrel/template — see the vendored
+  * `guides/src/template.md` for the authoritative contract.
   */
  export declare interface Lexicon {
      readonly phrases?: Readonly<Record<string, Readonly<Record<string, string>>>>;

package/dist/src/core/index.d.ts

@@ -563,8 +563,8 @@ export declare function createSubjectManager(options?: SubjectManagerOptions): S
   * `{table}.{reasoning}` for the four reasons kinds, `result.quantitative.failed`
   * for the quantitative-result failure suffix, and `subject.fields` /
   * `subject.empty` for `describeSubject`. Every string is a plain
-  * `interpolateMessage` template — `{{name}}`-style placeholders resolved
-  * against the caller-supplied `values` record.
+  * @orkestrel/template `fillTemplate` template — `{{name}}`-style placeholders
+  * resolved against the caller-supplied `values` record.
   */
  export declare const DEFAULT_LEXICON: Lexicon;
 
@@ -1048,32 +1048,6 @@ export declare function createSubjectManager(options?: SubjectManagerOptions): S
      readonly confidence: number;
  }
 
- /**
-  * Interpolate `{{dotted.path}}` tokens in a message template against a record.
-  *
-  * @remarks
-  * Each token is split on `.` into a {@link FieldPath} array and resolved with
-  * the contracts `resolveField` (a plain string field is ONE key, never
-  * dot-split — the split here is the token-to-path bridge). A finite number
-  * renders with `en-US` thousand grouping (`5010` → `5,010`); any other
-  * resolved value String-coerces. An UNRESOLVED path (the resolved value is
-  * `undefined`) renders as the empty string — the deterministic "nothing to
-  * show" rule.
-  *
-  * @param template - The message template carrying `{{dotted.path}}` tokens
-  * @param record - The record tokens resolve against
-  * @returns The template with every token replaced
-  *
-  * @example
-  * ```ts
-  * import { interpolateMessage } from '@src/core'
-  *
-  * interpolateMessage('Limit is {{limit}}', { limit: 5010 }) // 'Limit is 5,010'
-  * interpolateMessage('Missing {{gone}}', {})                // 'Missing '
-  * ```
-  */
- export declare function interpolateMessage(template: string, record: Readonly<Record<string, unknown>>): string;
-
  /**
   * The interpretation orchestrator — the sole public entry point of the
   * `interprets` module, mirroring the reasons `Reason` orchestrator shape.
@@ -1509,8 +1483,11 @@ export declare function createSubjectManager(options?: SubjectManagerOptions): S
   * dotted `FieldPath` string to its display label, falling back to
   * `formatField` when absent. `templates` maps a template id (e.g.
   * `'definition.quantitative'`, `'result.symbolic'`, `'subject.fields'`) to an
-  * `interpolateMessage` template string — see `DEFAULT_LEXICON` for the
-  * pinned neutral key set.
+  * @orkestrel/template `fillTemplate` template string — see `DEFAULT_LEXICON`
+  * for the pinned neutral key set. Token grammar (the `[^{}]` token class, the
+  * `\{{` literal escape, whitespace trimming, and dotted-token path
+  * resolution) is defined by @orkestrel/template — see the vendored
+  * `guides/src/template.md` for the authoritative contract.
   */
  export declare interface Lexicon {
      readonly phrases?: Readonly<Record<string, Readonly<Record<string, string>>>>;

package/dist/src/core/index.js

@@ -1,6 +1,7 @@
-import { arrayOf, isBoolean, isFiniteNumber, isRecord, isString, notOf, parseJSONAs, recordOf, resolveField, unionOf } from "@orkestrel/contract";
+import { arrayOf, isBoolean, isFiniteNumber, isRecord, isString, notOf, parseJSONAs, recordOf, unionOf } from "@orkestrel/contract";
 import { applyOperation, formatField, isDefinition, isFieldPath, isSymbolicExpression } from "@orkestrel/reason";
 import { Emitter } from "@orkestrel/emitter";
+import { fillTemplate } from "@orkestrel/template";
 //#region src/core/constants.ts
 /**
 * Default `similarity` for `createInterpret` / `matchAlias` — the fuzzy
@@ -87,8 +88,8 @@ var DEFAULT_VERBS = Object.freeze({});
 * `{table}.{reasoning}` for the four reasons kinds, `result.quantitative.failed`
 * for the quantitative-result failure suffix, and `subject.fields` /
 * `subject.empty` for `describeSubject`. Every string is a plain
-* `interpolateMessage` template — `{{name}}`-style placeholders resolved
-* against the caller-supplied `values` record.
+* @orkestrel/template `fillTemplate` template — `{{name}}`-style placeholders
+* resolved against the caller-supplied `values` record.
 */
 var DEFAULT_LEXICON = Object.freeze({
 	phrases: Object.freeze({}),
@@ -367,38 +368,6 @@ function setField(subject, field, value) {
 	};
 }
 /**
-* Interpolate `{{dotted.path}}` tokens in a message template against a record.
-*
-* @remarks
-* Each token is split on `.` into a {@link FieldPath} array and resolved with
-* the contracts `resolveField` (a plain string field is ONE key, never
-* dot-split — the split here is the token-to-path bridge). A finite number
-* renders with `en-US` thousand grouping (`5010` → `5,010`); any other
-* resolved value String-coerces. An UNRESOLVED path (the resolved value is
-* `undefined`) renders as the empty string — the deterministic "nothing to
-* show" rule.
-*
-* @param template - The message template carrying `{{dotted.path}}` tokens
-* @param record - The record tokens resolve against
-* @returns The template with every token replaced
-*
-* @example
-* ```ts
-* import { interpolateMessage } from '@src/core'
-*
-* interpolateMessage('Limit is {{limit}}', { limit: 5010 }) // 'Limit is 5,010'
-* interpolateMessage('Missing {{gone}}', {})                // 'Missing '
-* ```
-*/
-function interpolateMessage(template, record) {
-	return template.replace(/\{\{\s*([^}]+?)\s*\}\}/g, (_match, path) => {
-		const value = resolveField(record, path.split("."));
-		if (value === void 0) return "";
-		if (isFiniteNumber(value)) return value.toLocaleString("en-US");
-		return String(value);
-	});
-}
-/**
 * Replace every whole-word occurrence of a map's keys with their values.
 *
 * @remarks
@@ -1516,7 +1485,7 @@ var Narrator = class {
 	line(id, values) {
 		if (!Object.hasOwn(this.#lexicon.templates, id)) return "";
 		const template = this.#lexicon.templates[id];
-		return typeof template === "string" ? interpolateMessage(template, values) : "";
+		return typeof template === "string" ? fillTemplate(template, values, { missing: "empty" }) : "";
 	}
 	value(unit, raw) {
 		if (Object.hasOwn(this.#formatters, unit)) {
@@ -2631,6 +2600,6 @@ function createNarrator(options) {
 	return new Narrator(options);
 }
 //#endregion
-export { CONFIDENCE_ALIAS, CONFIDENCE_CARRIED, CONFIDENCE_COLLECT, CONFIDENCE_COMPUTED, CONFIDENCE_DEFAULT, CONFIDENCE_EXACT, CONFIDENCE_POSITIONAL, Clarifier, DEFAULT_ABBREVIATIONS, DEFAULT_ACTIONS, DEFAULT_CONTRACTIONS, DEFAULT_CORRECTIONS, DEFAULT_DOMAINS, DEFAULT_INTERPRET_FLOOR, DEFAULT_INTERPRET_HISTORY, DEFAULT_INTERPRET_SIMILARITY, DEFAULT_LEXICON, DEFAULT_VERBS, DefinitionManager, Extractor, Formatter, Generator, INTERPRET_ID, Interpret, InterpretContext, InterpretError, NUMBER_PATTERN, Narrator, Normalizer, SubjectManager, TemplateManager, UNSAFE_FIELD_SEGMENTS, applyReplacements, assignEntities, canonicalize, classifyIntent, collapseWhitespace, createClarifier, createDefinitionManager, createExtractor, createFormatter, createGenerator, createInterpret, createInterpretContext, createNarrator, createNormalizer, createSubjectManager, createTemplate, createTemplateManager, deriveAggregateField, describeSubject, digestValue, escapeRegExp, extractNumbers, interpolateMessage, isComputedField, isEntityMapping, isFieldDefault, isInterpretError, isTemplate, matchAlias, matchTemplate, parseTemplate, resolveExpression, scoreSimilarity, scoreTemplate, setField, tokenize, variablesOf };
+export { CONFIDENCE_ALIAS, CONFIDENCE_CARRIED, CONFIDENCE_COLLECT, CONFIDENCE_COMPUTED, CONFIDENCE_DEFAULT, CONFIDENCE_EXACT, CONFIDENCE_POSITIONAL, Clarifier, DEFAULT_ABBREVIATIONS, DEFAULT_ACTIONS, DEFAULT_CONTRACTIONS, DEFAULT_CORRECTIONS, DEFAULT_DOMAINS, DEFAULT_INTERPRET_FLOOR, DEFAULT_INTERPRET_HISTORY, DEFAULT_INTERPRET_SIMILARITY, DEFAULT_LEXICON, DEFAULT_VERBS, DefinitionManager, Extractor, Formatter, Generator, INTERPRET_ID, Interpret, InterpretContext, InterpretError, NUMBER_PATTERN, Narrator, Normalizer, SubjectManager, TemplateManager, UNSAFE_FIELD_SEGMENTS, applyReplacements, assignEntities, canonicalize, classifyIntent, collapseWhitespace, createClarifier, createDefinitionManager, createExtractor, createFormatter, createGenerator, createInterpret, createInterpretContext, createNarrator, createNormalizer, createSubjectManager, createTemplate, createTemplateManager, deriveAggregateField, describeSubject, digestValue, escapeRegExp, extractNumbers, isComputedField, isEntityMapping, isFieldDefault, isInterpretError, isTemplate, matchAlias, matchTemplate, parseTemplate, resolveExpression, scoreSimilarity, scoreTemplate, setField, tokenize, variablesOf };
 
 //# sourceMappingURL=index.js.map