agentfootprint 10.3.0 → 10.3.1

package/dist/esm/core/time/range.js

@@ -1,269 +0,0 @@
-/**
- * core/time/range — the library's one range, its two spellings, and one
- * conversion per boundary a range crosses.
- *
- * Pattern: one internal shape, converted at every edge by a named function —
- *          never inline. Inside the library a range is HALF-OPEN `[from, to)`;
- *          the places a range crosses do not share that edge (the time design,
- *          `docs/design/time/README.md` § 3.3), so each crossing is a function
- *          here and its inverse.
- * Role:    core/ leaf (the time layer's one owner). Imports `instant.ts` and
- *          `duration.ts`. Asked by `arguments/declare.ts` ·
- *          `parsesUnderSpelling` (an `iso-range` argument is
- *          {@link splitRange} under `'..'` and the strict profile). No other
- *          file splits or joins a range.
- * Emits:   N/A.
- *
- * ## The boundaries
- *
- * | Boundary | Its edge | Into it from `[from, to)` | Back |
- * |----------|----------|---------------------------|------|
- * | a result's `DeclaredPeriod.queried` / `held` | inclusive at both ends | not converted — the tool declares it | {@link fromInclusive} with the tool's step (`granularity`, else 1 ms) |
- * | a tool argument bound | declared on every `bounds`/`object` end (TQ18); only the sugar defaults inclusive | {@link boundInto} | {@link boundFrom} |
- * | a look-back argument | `[until − L, until]` | {@link lookbackRange} | {@link lookbackOf} |
- * | an ask answer / an ISO 8601 interval | `from/to`, half-open | identity: {@link spellRange} | identity: {@link parseRange} |
- * | an inclusive interval clause (SQL `BETWEEN`, a chart brush) | inclusive at both ends | {@link toInclusive} | {@link fromInclusive} |
- *
- * `coverage/period.ts` · `periodVerdict` stays inclusive and is NOT routed
- * through here: it compares the two inclusive spans a result declared.
- *
- * A derived bound keeps the offset its source was written in, spelled in the
- * strict profile; a bound that is not derived is kept as written.
- *
- * @example
- * ```ts
- * parseRange('2026-10-09T08:00:00-07:00/2026-10-09T08:41:00-07:00');
- * // { from: '2026-10-09T08:00:00-07:00', to: '2026-10-09T08:41:00-07:00' }
- * toInclusive({ from: '2026-10-09T08:00:00-07:00', to: '2026-10-09T08:41:00-07:00' }, 60_000);
- * // { from: '2026-10-09T08:00:00-07:00', to: '2026-10-09T08:40:00-07:00' } — "through 08:40"
- * ```
- */
-import { durationMs, spellDuration } from './duration.js';
-import { compareInstants, instantOf, shiftInstant, spellInstant, } from './instant.js';
-/**
- * The two bounds of a joined range string — exactly one `joiner`, each half an
- * instant under `profile` — or `undefined`. The ORDER is not checked: a format
- * check, for a declaration that only promises a spelling.
- */
-export function splitRange(value, joiner, profile) {
-    if (typeof value !== 'string')
-        return undefined;
-    const halves = value.split(joiner);
-    if (halves.length !== 2)
-        return undefined;
-    const from = instantOf(halves[0], profile);
-    const to = instantOf(halves[1], profile);
-    return from === undefined || to === undefined ? undefined : [from, to];
-}
-/**
- * A joined string read as a {@link TimeRange} — strict instants, `from`
- * before `to` — or `undefined`. The bounds are kept as written.
- */
-export function parseRange(value, joiner = '/') {
-    const bounds = splitRange(value, joiner, 'strict');
-    if (bounds === undefined || compareInstants(bounds[0], bounds[1]) >= 0)
-        return undefined;
-    const [from, to] = value.split(joiner);
-    return { from, to };
-}
-/** Whether `value` is a well-formed {@link TimeRange}: strict instants, `from` before `to`, no other key. */
-export function isTimeRange(value) {
-    if (typeof value !== 'object' || value === null || Array.isArray(value))
-        return false;
-    const keys = Object.keys(value);
-    if (keys.length !== 2 || !keys.includes('from') || !keys.includes('to'))
-        return false;
-    const { from, to } = value;
-    const a = instantOf(from, 'strict');
-    const b = instantOf(to, 'strict');
-    return a !== undefined && b !== undefined && compareInstants(a, b) < 0;
-}
-function assertRange(range, caller) {
-    if (!isTimeRange(range)) {
-        throw new TypeError(`${caller}: ${JSON.stringify(range)} is not a TimeRange — two strict ISO 8601 instants with a zone, from before to.`);
-    }
-    return [instantOf(range.from, 'strict'), instantOf(range.to, 'strict')];
-}
-function assertStep(stepMs, caller) {
-    if (!Number.isSafeInteger(stepMs) || stepMs <= 0) {
-        throw new TypeError(`${caller}: the step ${String(stepMs)} is not a positive whole number of milliseconds.`);
-    }
-}
-function respell(instant, offsetMinutes, caller) {
-    const text = spellInstant(instant, offsetMinutes);
-    if (text === undefined)
-        throw new RangeError(`${caller}: the bound falls outside years 0000–9999.`);
-    return text;
-}
-/** The range spelled as one string: `from<joiner>to`, bounds as written. Throws on a range that is not well formed. */
-export function spellRange(range, joiner = '/') {
-    assertRange(range, 'spellRange');
-    return `${range.from}${joiner}${range.to}`;
-}
-/** The step a tool's `granularity` names (under `units`), else 1 ms — the § 3.3 rule. */
-export function stepMsOf(granularity, units) {
-    if (granularity === undefined)
-        return 1;
-    const ms = durationMs(granularity, units);
-    if (ms === undefined)
-        throw new TypeError(`stepMsOf: '${String(granularity)}' is not a duration in '${units}'.`);
-    return ms;
-}
-/**
- * An inclusive span read back as half-open: `[from, to + step)`. The step is
- * the source's smallest step (a tool's `granularity`, else 1 ms). The span is
- * read in the LENIENT profile — a result declares it.
- */
-export function fromInclusive(span, stepMs = 1) {
-    assertStep(stepMs, 'fromInclusive');
-    const from = instantOf(span.from, 'lenient');
-    const to = instantOf(span.to, 'lenient');
-    if (from === undefined || to === undefined || compareInstants(from, to) > 0) {
-        throw new TypeError(`fromInclusive: ${JSON.stringify(span)} is not an inclusive span of instants.`);
-    }
-    return {
-        // Kept as written when it is already strict; a lenient spelling (`t`, `z`, `:60`) is respelled.
-        from: instantOf(span.from, 'strict') !== undefined
-            ? span.from
-            : respell(from, from.offsetMinutes, 'fromInclusive'),
-        to: respell(shiftInstant(to, stepMs), to.offsetMinutes, 'fromInclusive'),
-    };
-}
-/**
- * A half-open range written with inclusive ends: `[from, to − step]` — the
- * last instant inside the range at the reader's precision. Refused when the
- * range is narrower than one step (it holds no instant at that precision).
- */
-export function toInclusive(range, stepMs = 1) {
-    assertStep(stepMs, 'toInclusive');
-    const [from, to] = assertRange(range, 'toInclusive');
-    const last = shiftInstant(to, -stepMs);
-    if (compareInstants(from, last) > 0) {
-        throw new RangeError(`toInclusive: ${spellRange(range)} is narrower than one step of ${stepMs} ms.`);
-    }
-    return { from: range.from, to: respell(last, to.offsetMinutes, 'toInclusive') };
-}
-/**
- * A half-open range's end as a tool's `to` bound: `exclusive` → as is;
- * `inclusive` → the last instant inside at the argument's precision
- * (`to − step`).
- */
-export function boundInto(to, edge, stepMs) {
-    assertStep(stepMs, 'boundInto');
-    const at = instantOf(to, 'strict');
-    if (at === undefined)
-        throw new TypeError(`boundInto: ${JSON.stringify(to)} is not a strict instant.`);
-    return edge === 'exclusive'
-        ? to
-        : respell(shiftInstant(at, -stepMs), at.offsetMinutes, 'boundInto');
-}
-/** The inverse of {@link boundInto}: a tool's `to` bound as a half-open range's end. */
-export function boundFrom(to, edge, stepMs) {
-    assertStep(stepMs, 'boundFrom');
-    const at = instantOf(to, 'strict');
-    if (at === undefined)
-        throw new TypeError(`boundFrom: ${JSON.stringify(to)} is not a strict instant.`);
-    return edge === 'exclusive'
-        ? to
-        : respell(shiftInstant(at, stepMs), at.offsetMinutes, 'boundFrom');
-}
-/**
- * A look-back `duration` evaluated at `until` — `[until − L, until]`, both
- * ends inside — as a half-open range `[until − L, until + 1 ms)`.
- */
-export function lookbackRange(until, duration, units) {
-    const at = instantOf(until, 'strict');
-    if (at === undefined)
-        throw new TypeError(`lookbackRange: ${JSON.stringify(until)} is not a strict instant.`);
-    const ms = durationMs(duration, units);
-    if (ms === undefined)
-        throw new TypeError(`lookbackRange: '${String(duration)}' is not a duration in '${units}'.`);
-    return fromInclusive({
-        from: respell(shiftInstant(at, -ms), at.offsetMinutes, 'lookbackRange'),
-        to: until,
-    });
-}
-/**
- * The inverse of {@link lookbackRange}: the `until` and the smallest exact
- * look-back spelling a half-open range is, or `undefined` when its length is
- * no whole duration in `units`.
- */
-export function lookbackOf(range, units) {
-    const [from, to] = assertRange(range, 'lookbackOf');
-    const until = shiftInstant(to, -1);
-    if (from.nanos !== until.nanos)
-        return undefined;
-    const duration = spellDuration(until.ms - from.ms, units);
-    return duration === undefined
-        ? undefined
-        : { until: respell(until, to.offsetMinutes, 'lookbackOf'), duration };
-}
-/**
- * How far a half-open range `[from, to)` REACHES, in milliseconds: from its
- * first instant to its last (`to − 1 ms − from`) — the length a tool's
- * `maxRange` is held against (an inclusive ceiling: a range is over it only
- * when its last instant lies further than `maxRange` after its first). The one
- * owner of that length, so a range is judged by the instants it holds, never by
- * how it was spelled: the look-back row `[until − L, until]` ({@link lookbackRange},
- * half-open `[until − L, until + 1 ms)`) reaches `L`, exactly as the same instants
- * written as bounds do — a look-back exactly `maxRange` long is one the tool reads
- * at once, and one more step (`L + 1 min`) is not.
- *
- * @example
- * ```ts
- * reachMs(Date.parse('2026-10-08T15:40:00Z'), Date.parse('2026-10-09T15:40:00.001Z')); // 86_400_000 — 'last 24h'
- * reachMs(Date.parse('2026-10-08T00:00:00Z'), Date.parse('2026-10-09T00:00:00Z'));     // 86_399_999 — one day
- * ```
- */
-export function reachMs(fromMs, toMs) {
-    return toMs - 1 - fromMs;
-}
-/** Whether `outer` holds every instant of `inner` (half-open). */
-export function covers(outer, inner) {
-    const [of, ot] = assertRange(outer, 'covers');
-    const [inf, int] = assertRange(inner, 'covers');
-    return compareInstants(of, inf) <= 0 && compareInstants(int, ot) <= 0;
-}
-/** Whether two ranges hold the same instants (their spellings and offsets aside). */
-export function sameRange(a, b) {
-    const af = instantOf(a.from, 'strict');
-    const at = instantOf(a.to, 'strict');
-    const bf = instantOf(b.from, 'strict');
-    const bt = instantOf(b.to, 'strict');
-    if (af === undefined || at === undefined || bf === undefined || bt === undefined)
-        return false;
-    return compareInstants(af, bf) === 0 && compareInstants(at, bt) === 0;
-}
-/** Whether `a` and `b` share at least one instant (half-open: touching ends do not overlap). */
-export function overlaps(a, b) {
-    const [af, at] = assertRange(a, 'overlaps');
-    const [bf, bt] = assertRange(b, 'overlaps');
-    return compareInstants(af, bt) < 0 && compareInstants(bf, at) < 0;
-}
-const floorTo = (instant, stepMs) => ({
-    ms: instant.ms - (((instant.ms % stepMs) + stepMs) % stepMs),
-    nanos: 0,
-});
-/**
- * The range widened to whole steps — `from` down, `to` up, never inward —
- * with `rounded` saying whether anything moved. Steps are counted from the
- * epoch in UTC: right for seconds, minutes and hours; a calendar day or week
- * in a zone is `zone.ts`'s question, not this one.
- */
-export function roundOutward(range, stepMs) {
-    assertStep(stepMs, 'roundOutward');
-    const [from, to] = assertRange(range, 'roundOutward');
-    const down = floorTo(from, stepMs);
-    const toFloor = floorTo(to, stepMs);
-    const up = compareInstants(toFloor, to) === 0 ? toFloor : shiftInstant(toFloor, stepMs);
-    const fromMoved = compareInstants(down, from) !== 0;
-    const toMoved = compareInstants(up, to) !== 0;
-    return {
-        range: {
-            from: fromMoved ? respell(down, from.offsetMinutes, 'roundOutward') : range.from,
-            to: toMoved ? respell(up, to.offsetMinutes, 'roundOutward') : range.to,
-        },
-        rounded: fromMoved || toMoved,
-    };
-}
-//# sourceMappingURL=range.js.map

package/dist/esm/core/time/range.js.map

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

package/dist/esm/core/time/reader.d.ts

@@ -1,169 +0,0 @@
-/**
- * core/time/reader — the port a strategy reads a person's words through, and
- * the checks every reading passes before anything resolves it.
- *
- * Pattern: port + adapter (Duckling's value/resolution split). A strategy
- *          TOKENIZES: it returns the parts it sees and the verbatim quote,
- *          never an instant, never a date order, never a zone. Everything
- *          that turns parts into instants is `resolve.ts`'s, the same way for
- *          every strategy (time design § 5.1).
- * Role:    core/ leaf (the time layer). Imports nothing. The builder's
- *          `.time({ reader })` checks a reader through {@link readerIssue};
- *          seed checks what it returned through {@link checkReading}.
- * Emits:   N/A.
- *
- * ## What is checked — shape, never meaning
- *
- * | Check | A failure |
- * |-------|-----------|
- * | the reader: `id`, `version`, `locale` non-empty strings, `kind` `'rule'` or `'model'`, `read` a function | refused at build |
- * | the reading: `{ mentions: [] }`, at most {@link MAX_MENTIONS} | the reader broke its port — the run fails, naming it |
- * | each mention's `quote`: a non-empty VERBATIM substring of the text read | the mention is refused (`quote-not-in-text`) and keeps no text |
- * | each mention's parts: the {@link TimeParts} shape, every field in range, no unknown key, at most {@link MAX_PARSES} | the mention is refused (`malformed`) |
- *
- * None of these checks what a word MEANS: a model that reads "yesterday" as
- * the wrong day passes every one of them. That is why NO reading is ever the
- * person's words — a `rule` reading as much as a `model` one (the owner's
- * decision "Always confirm", time design TQ29): a reading only PROPOSES a
- * window, offered through the time ask with its zone, and only what the
- * person picks or types in that form is theirs (`rowsBuild.ts` ·
- * `timeReadingRows`).
- *
- * @example
- * ```ts
- * const fixture: TimeReader = {
- *   id: 'fixture', version: '1.0.0', locale: 'en-US', kind: 'rule',
- *   read: () => ({ mentions: [{ quote: '10/09/26', parses: [{ date: { kind: 'numeric', fields: [10, 9, 26] } }] }] }),
- * };
- * readerIssue(fixture); // undefined — a well-formed reader
- * checkReading('errors on 10/09/26', fixture.read('', { locale: 'en-US' }), 'fixture');
- * // [{ quote: '10/09/26', parses: [{ date: { kind: 'numeric', fields: [10, 9, 26] } }] }]
- * ```
- */
-/** What a reader is told besides the text: a hint for its tokenizer — no clock, no zone, no map. */
-export interface TimeReadContext {
-    readonly locale: string;
-}
-/**
- * A strategy that reads a person's words into zone-less PARTS (time design
- * § 5.1). Armed with `.time({ reader })`; there is no default. It runs once
- * per turn, at the seed, on the message a person wrote, and never again for
- * that message — a resume and a retry read the recorded reading.
- *
- * @example
- * ```ts
- * const reader: TimeReader = {
- *   id: 'my-app/english', version: '1.2.0', locale: 'en-US', kind: 'rule',
- *   read: (text) => ({ mentions: tokenize(text) }),
- * };
- * Agent.create({ provider, model }).time({ zone: 'UTC', reader }).build();
- * ```
- */
-export interface TimeReader {
-    /** Recorded on every reading with the version, e.g. `'agentfootprint/english'`. */
-    readonly id: string;
-    readonly version: string;
-    /** The language it reads, e.g. `'en-US'`. */
-    readonly locale: string;
-    /**
-     * `'rule'`: deterministic over the text. `'model'`: an LLM or other learned
-     * reader. Neither kind's reading is ever the person's words: a `rule`
-     * reading is offered through the time ask to confirm; a `model` reading
-     * fills as a reading (`derived-from-reading`) until the person confirms it.
-     */
-    readonly kind: 'rule' | 'model';
-    read(text: string, context: TimeReadContext): TimeReading | Promise<TimeReading>;
-}
-/** What a reader returns: every time mention it found, in the order the text wrote them. */
-export interface TimeReading {
-    readonly mentions: readonly TimeMention[];
-}
-/** One mention of a time in the text. */
-export interface TimeMention {
-    /** A VERBATIM substring of the text — the library checks it. */
-    readonly quote: string;
-    /** Usually one; more only when the TOKENS split two ways. Empty when `problem` is set. */
-    readonly parses: readonly TimeParts[];
-    /** The reader saw a time here and could not read it. */
-    readonly problem?: 'unreadable';
-}
-/** A date as the text wrote it. */
-export type TimeDate = 
-/** `'10/09/26'` → `fields: [10, 9, 26]` — the ORDER is not decided by the reader. Two or three fields. */
-{
-    readonly kind: 'numeric';
-    readonly fields: readonly number[];
-    readonly yearDigits?: 2 | 4;
-}
-/** ISO or a named month: the text fixes the order. */
- | {
-    readonly kind: 'fixed';
-    readonly year?: number;
-    readonly month: number;
-    readonly day: number;
-};
-/** A wall-clock time as the text wrote it — no zone. */
-export interface TimeWall {
-    readonly h: number;
-    readonly m?: number;
-    readonly s?: number;
-    readonly meridiem?: 'am' | 'pm';
-    /**
-     * `'24h'`: the text's FORM is a 24-hour clock (an ISO instant's
-     * `T08:00`), so the hour is read as written — never also as pm. A form
-     * fact the reader sees and `resolve.ts` cannot; absent, an hour 1–12 with
-     * no meridiem is read both ways. Never with `meridiem`.
-     */
-    readonly clock?: '24h';
-}
-/** A time said relative to the message's moment. */
-export type TimeRelative = 
-/** `'yesterday'` = `{ unit: 'day', offset: -1 }`. */
-{
-    readonly unit: 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year';
-    readonly offset: number;
-}
-/** `'last 40 minutes'` = `{ unit: 'minute', count: 40 }` — a look-back. */
- | {
-    readonly unit: 'second' | 'minute' | 'hour' | 'day' | 'week';
-    readonly count: number;
-};
-/** Zone-less parts, in the order the text wrote them. Every field present was said. */
-export interface TimeParts {
-    readonly date?: TimeDate;
-    readonly wall?: TimeWall;
-    /** As written: `'PST'`, `'-07:00'`, `'America/Los_Angeles'` — `resolve.ts` maps it. */
-    readonly zoneToken?: string;
-    readonly relative?: TimeRelative;
-    /** `'morning'` — a KEY into a table, never hours. */
-    readonly partOfDay?: string;
-    /** `'the hour before that'` — resolved from the recorded previous window only. */
-    readonly anchor?: 'previous';
-    /** `'8 AM to 8:40 AM'`. */
-    readonly rangeOf?: readonly [TimeParts, TimeParts];
-}
-/** The most mentions one reading may hold — a bound on the record, not a guess at language. */
-export declare const MAX_MENTIONS = 16;
-/** The most parses one mention may hold. */
-export declare const MAX_PARSES = 4;
-/** Why `value` is not a {@link TimeReader}, or `undefined` when it is one. */
-export declare function readerIssue(value: unknown): string | undefined;
-/** Why one mention was refused. A refused mention keeps no text: its quote is not the person's words. */
-export type MentionRefusal = 'quote-not-in-text' | 'malformed';
-/** One mention after the checks. */
-export type CheckedMention = {
-    readonly quote: string;
-    readonly parses: readonly TimeParts[];
-    readonly problem?: 'unreadable';
-} | {
-    readonly refused: MentionRefusal;
-};
-/** Whether `value` is a well-formed {@link TimeParts} — `nested` refuses a range inside a range side. */
-export declare function isTimeParts(value: unknown, nested?: boolean): value is TimeParts;
-/**
- * A reader's answer for `text`, checked: one {@link CheckedMention} per
- * mention, in order. Throws a `TypeError` naming the reader when the answer
- * is not `{ mentions: [] }` (at most {@link MAX_MENTIONS}) — the reader
- * broke its port, and a run is never read by a guess at what it meant.
- */
-export declare function checkReading(text: string, value: unknown, readerId: string): CheckedMention[];

package/dist/esm/core/time/reader.js

@@ -1,204 +0,0 @@
-/**
- * core/time/reader — the port a strategy reads a person's words through, and
- * the checks every reading passes before anything resolves it.
- *
- * Pattern: port + adapter (Duckling's value/resolution split). A strategy
- *          TOKENIZES: it returns the parts it sees and the verbatim quote,
- *          never an instant, never a date order, never a zone. Everything
- *          that turns parts into instants is `resolve.ts`'s, the same way for
- *          every strategy (time design § 5.1).
- * Role:    core/ leaf (the time layer). Imports nothing. The builder's
- *          `.time({ reader })` checks a reader through {@link readerIssue};
- *          seed checks what it returned through {@link checkReading}.
- * Emits:   N/A.
- *
- * ## What is checked — shape, never meaning
- *
- * | Check | A failure |
- * |-------|-----------|
- * | the reader: `id`, `version`, `locale` non-empty strings, `kind` `'rule'` or `'model'`, `read` a function | refused at build |
- * | the reading: `{ mentions: [] }`, at most {@link MAX_MENTIONS} | the reader broke its port — the run fails, naming it |
- * | each mention's `quote`: a non-empty VERBATIM substring of the text read | the mention is refused (`quote-not-in-text`) and keeps no text |
- * | each mention's parts: the {@link TimeParts} shape, every field in range, no unknown key, at most {@link MAX_PARSES} | the mention is refused (`malformed`) |
- *
- * None of these checks what a word MEANS: a model that reads "yesterday" as
- * the wrong day passes every one of them. That is why NO reading is ever the
- * person's words — a `rule` reading as much as a `model` one (the owner's
- * decision "Always confirm", time design TQ29): a reading only PROPOSES a
- * window, offered through the time ask with its zone, and only what the
- * person picks or types in that form is theirs (`rowsBuild.ts` ·
- * `timeReadingRows`).
- *
- * @example
- * ```ts
- * const fixture: TimeReader = {
- *   id: 'fixture', version: '1.0.0', locale: 'en-US', kind: 'rule',
- *   read: () => ({ mentions: [{ quote: '10/09/26', parses: [{ date: { kind: 'numeric', fields: [10, 9, 26] } }] }] }),
- * };
- * readerIssue(fixture); // undefined — a well-formed reader
- * checkReading('errors on 10/09/26', fixture.read('', { locale: 'en-US' }), 'fixture');
- * // [{ quote: '10/09/26', parses: [{ date: { kind: 'numeric', fields: [10, 9, 26] } }] }]
- * ```
- */
-// ─── Limits ──────────────────────────────────────────────────────────────
-/** The most mentions one reading may hold — a bound on the record, not a guess at language. */
-export const MAX_MENTIONS = 16;
-/** The most parses one mention may hold. */
-export const MAX_PARSES = 4;
-const MAX_TOKEN = 64;
-const MAX_OFFSET = 1000;
-const MAX_COUNT = 100_000;
-// ─── The reader ──────────────────────────────────────────────────────────
-const nonEmpty = (value) => typeof value === 'string' && value.trim().length > 0 && value.length <= 128;
-/**
- * Whether `Intl` reads `value` as a BCP 47 language tag — the time ask renders
- * its labels in the reader's locale (`present.ts`), so a tag it cannot read is
- * refused at the builder, never met at the first label.
- */
-function isLanguageTag(value) {
-    try {
-        return Intl.getCanonicalLocales(value).length === 1;
-    }
-    catch {
-        return false;
-    }
-}
-/** Why `value` is not a {@link TimeReader}, or `undefined` when it is one. */
-export function readerIssue(value) {
-    if (value === null || typeof value !== 'object') {
-        return 'reader must be a TimeReader — { id, version, locale, kind, read }';
-    }
-    const r = value;
-    if (!nonEmpty(r.id))
-        return 'reader.id must be a non-empty string';
-    if (!nonEmpty(r.version))
-        return 'reader.version must be a non-empty string';
-    if (!nonEmpty(r.locale) || !isLanguageTag(r.locale)) {
-        return "reader.locale must be a language tag such as 'en-US'";
-    }
-    if (r.kind !== 'rule' && r.kind !== 'model')
-        return "reader.kind must be 'rule' or 'model'";
-    if (typeof r.read !== 'function')
-        return 'reader.read must be a function';
-    return undefined;
-}
-const isRecord = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
-const isInt = (value, lo, hi) => typeof value === 'number' && Number.isInteger(value) && value >= lo && value <= hi;
-const onlyKeys = (value, allowed) => Object.keys(value).every((k) => allowed.includes(k) && value[k] !== undefined);
-function isDate(value) {
-    if (!isRecord(value))
-        return false;
-    if (value.kind === 'numeric') {
-        const fields = value.fields;
-        return (onlyKeys(value, ['kind', 'fields', 'yearDigits']) &&
-            Array.isArray(fields) &&
-            (fields.length === 2 || fields.length === 3) &&
-            fields.every((f) => isInt(f, 0, 9999)) &&
-            (value.yearDigits === undefined || value.yearDigits === 2 || value.yearDigits === 4));
-    }
-    if (value.kind === 'fixed') {
-        return (onlyKeys(value, ['kind', 'year', 'month', 'day']) &&
-            (value.year === undefined || isInt(value.year, 0, 9999)) &&
-            isInt(value.month, 1, 12) &&
-            isInt(value.day, 1, 31));
-    }
-    return false;
-}
-function isWall(value) {
-    return (isRecord(value) &&
-        onlyKeys(value, ['h', 'm', 's', 'meridiem', 'clock']) &&
-        isInt(value.h, 0, 23) &&
-        (value.m === undefined || isInt(value.m, 0, 59)) &&
-        (value.s === undefined || (value.m !== undefined && isInt(value.s, 0, 59))) &&
-        (value.meridiem === undefined || value.meridiem === 'am' || value.meridiem === 'pm') &&
-        (value.clock === undefined || (value.clock === '24h' && value.meridiem === undefined)));
-}
-const OFFSET_UNITS = ['minute', 'hour', 'day', 'week', 'month', 'year'];
-const COUNT_UNITS = ['second', 'minute', 'hour', 'day', 'week'];
-function isRelative(value) {
-    if (!isRecord(value) || typeof value.unit !== 'string')
-        return false;
-    if (value.offset !== undefined) {
-        return (onlyKeys(value, ['unit', 'offset']) &&
-            OFFSET_UNITS.includes(value.unit) &&
-            isInt(value.offset, -MAX_OFFSET, MAX_OFFSET));
-    }
-    return (onlyKeys(value, ['unit', 'count']) &&
-        COUNT_UNITS.includes(value.unit) &&
-        isInt(value.count, 1, MAX_COUNT));
-}
-const PART_KEYS = [
-    'date',
-    'wall',
-    'zoneToken',
-    'relative',
-    'partOfDay',
-    'anchor',
-    'rangeOf',
-];
-/** Whether `value` is a well-formed {@link TimeParts} — `nested` refuses a range inside a range side. */
-export function isTimeParts(value, nested = false) {
-    if (!isRecord(value) || !onlyKeys(value, PART_KEYS))
-        return false;
-    if (Object.keys(value).length === 0)
-        return false;
-    if (value.date !== undefined && !isDate(value.date))
-        return false;
-    if (value.wall !== undefined && !isWall(value.wall))
-        return false;
-    if (value.zoneToken !== undefined && !nonEmptyToken(value.zoneToken))
-        return false;
-    if (value.relative !== undefined && !isRelative(value.relative))
-        return false;
-    if (value.partOfDay !== undefined && !nonEmptyToken(value.partOfDay))
-        return false;
-    if (value.anchor !== undefined && value.anchor !== 'previous')
-        return false;
-    if (value.rangeOf !== undefined) {
-        const sides = value.rangeOf;
-        if (nested || !Array.isArray(sides) || sides.length !== 2)
-            return false;
-        if (!sides.every((side) => isTimeParts(side, true)))
-            return false;
-    }
-    return true;
-}
-function nonEmptyToken(value) {
-    return typeof value === 'string' && value.trim().length > 0 && value.length <= MAX_TOKEN;
-}
-function checkMention(text, value) {
-    if (!isRecord(value) || !onlyKeys(value, ['quote', 'parses', 'problem'])) {
-        return { refused: 'malformed' };
-    }
-    const { quote, parses, problem } = value;
-    if (!Array.isArray(parses) || parses.length > MAX_PARSES)
-        return { refused: 'malformed' };
-    if (problem !== undefined && problem !== 'unreadable')
-        return { refused: 'malformed' };
-    // An unreadable mention carries no parses; a readable one carries at least one.
-    if ((problem === 'unreadable') !== (parses.length === 0))
-        return { refused: 'malformed' };
-    if (!parses.every((p) => isTimeParts(p)))
-        return { refused: 'malformed' };
-    if (typeof quote !== 'string' || quote.length === 0 || !text.includes(quote)) {
-        return { refused: 'quote-not-in-text' };
-    }
-    return {
-        quote,
-        parses: parses,
-        ...(problem === 'unreadable' && { problem: 'unreadable' }),
-    };
-}
-/**
- * A reader's answer for `text`, checked: one {@link CheckedMention} per
- * mention, in order. Throws a `TypeError` naming the reader when the answer
- * is not `{ mentions: [] }` (at most {@link MAX_MENTIONS}) — the reader
- * broke its port, and a run is never read by a guess at what it meant.
- */
-export function checkReading(text, value, readerId) {
-    if (!isRecord(value) || !Array.isArray(value.mentions) || value.mentions.length > MAX_MENTIONS) {
-        throw new TypeError(`TimeReader '${readerId}' returned ${isRecord(value) && Array.isArray(value.mentions) ? 'too many mentions' : 'no reading'} — read() answers { mentions: [] } with at most ${MAX_MENTIONS} mentions.`);
-    }
-    return value.mentions.map((m) => checkMention(text, m));
-}
-//# sourceMappingURL=reader.js.map