chaffjs 0.19.0 → 0.20.0

package/dist/grade/variants.js

@@ -0,0 +1,66 @@
+import { rateRows, sameReading } from "./pairing.js";
+import { summaryOf } from "./summary.js";
+import { variantGroupsOf } from "./variants-input.js";
+const PERCENT = 100;
+const PERCENT_SCALE = 10;
+const percentOf = (passed, outputs) => outputs === 0 ? undefined : Math.round((passed * PERCENT * PERCENT_SCALE) / outputs) / PERCENT_SCALE;
+const sum = (counts) => Object.values(counts).reduce((total, count) => total + count, 0);
+const columnOf = (variant, results) => {
+    const summary = summaryOf(results);
+    return {
+        variant,
+        outputs: summary.total,
+        passed: summary.passed,
+        passRate: percentOf(summary.passed, summary.total),
+        facts: { dropped: sum(summary.facts.dropped), added: sum(summary.facts.added) },
+        citations: summary.citations,
+        ...(summary.contexts === undefined ? {} : { contexts: { checked: summary.contexts.checked, unsupported: sum(summary.contexts.unsupported) } }),
+        ...(summary.penalty === undefined ? {} : { penalty: summary.penalty }),
+    };
+};
+const disagreementOf = (id, row, variants) => {
+    const passedIn = variants.filter((_, index) => row[index]?.pass === true);
+    if (passedIn.length === 0 || passedIn.length === variants.length)
+        return [];
+    const failedIn = variants.flatMap((variant, index) => {
+        const result = row[index];
+        return result === undefined || result.pass ? [] : [{ variant, failedBecause: result.failedBecause }];
+    });
+    return [{ id, passedIn, failedIn }];
+};
+/** Each id in order of first appearance, with its result in each variant, or undefined where the variant has none. */
+const rowsOf = (grouped, variants) => {
+    const ids = [...new Set([...grouped.values()].flatMap((byId) => [...byId.keys()]))];
+    return ids.map((id) => ({ id, row: variants.map((variant) => grouped.get(variant)?.get(id)) }));
+};
+const isComplete = (row) => row.every((result) => result !== undefined);
+/** The variants side by side over the ids they all answered. `grouped`: each variant's results by id, the variants in order. */
+export const compareVariantGroups = (grouped) => {
+    const variants = [...grouped.keys()];
+    const rows = rowsOf(grouped, variants);
+    const complete = rows.flatMap(({ id, row }) => (isComplete(row) ? [{ id, row }] : []));
+    const compared = complete.filter(({ row }) => sameReading(row));
+    const byVariant = variants.map((_, index) => compared.flatMap(({ row }) => row.slice(index, index + 1)));
+    return {
+        variants,
+        compared: compared.map(({ id }) => id),
+        missing: rows.flatMap(({ id, row }) => {
+            const missingFrom = variants.filter((_, index) => row[index] === undefined);
+            return missingFrom.length === 0 ? [] : [{ id, missingFrom }];
+        }),
+        readOtherwise: complete.filter(({ row }) => !sameReading(row)).map(({ id }) => id),
+        columns: variants.map((variant, index) => columnOf(variant, byVariant[index] ?? [])),
+        rules: rateRows(byVariant)
+            .filter((row) => row.rates.some((rate) => rate > 0))
+            .map(({ rule, unit, rates }) => ({ rule, unit, rates: Object.fromEntries(variants.map((variant, index) => [variant, rates[index] ?? 0])) })),
+        disagreements: compared.flatMap(({ id, row }) => disagreementOf(id, row, variants)),
+    };
+};
+/** A run's results compared variant by variant, or undefined when none has a variant label (the command line's input already checked). */
+export const variantsOfRun = (results) => {
+    if (!results.some((result) => result.variant !== undefined))
+        return undefined;
+    const read = variantGroupsOf(results);
+    return "groups" in read ? compareVariantGroups(read.groups) : undefined;
+};
+//# sourceMappingURL=variants.js.map

package/dist/grade/variants.js.map

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

package/dist/grade/verdict.d.ts

@@ -0,0 +1,18 @@
+import type { GradeFact, GradeResult } from "./result.ts";
+/** What pass or fail is decided from. */
+export type Graded = Pick<GradeResult, "findings" | "facts" | "citations" | "contexts">;
+export type Verdict = {
+    readonly pass: boolean;
+    readonly failedBecause: readonly string[];
+};
+/** A condition over a count, written as the reason when the count goes past its limit: `facts.dropped 3 > 0`. */
+export declare const overLimit: (name: string, count: number, limit: number) => string[];
+/** Facts that count against the output: those whose kind was not allowed to change. */
+export declare const counted: (facts: readonly GradeFact[]) => number;
+export declare const verdictOf: (failedBecause: readonly string[]) => Verdict;
+/**
+ * The pass or fail with no `grade:` in chaff.yaml (spec §29.3): an error finding, a fact dropped or added against the
+ * reference, a quotation not found, or a fact no retrieved passage states fails the output. Warnings and info are rates to compare, not a verdict on one output.
+ */
+export declare const defaultVerdict: (graded: Graded) => Verdict;
+//# sourceMappingURL=verdict.d.ts.map

package/dist/grade/verdict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict.d.ts","sourceRoot":"","sources":["../../src/grade/verdict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1D,yCAAyC;AACzC,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC,CAAC;AAExF,MAAM,MAAM,OAAO,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAE5F,iHAAiH;AACjH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,EAAE,OAAO,MAAM,KAAG,MAAM,EAA4E,CAAC;AAE1J,uFAAuF;AACvF,eAAO,MAAM,OAAO,GAAI,OAAO,SAAS,SAAS,EAAE,KAAG,MAAsD,CAAC;AAE7G,eAAO,MAAM,SAAS,GAAI,eAAe,SAAS,MAAM,EAAE,KAAG,OAAgE,CAAC;AAE9H;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,OAO5C,CAAC"}

package/dist/grade/verdict.js

@@ -0,0 +1,17 @@
+/** A condition over a count, written as the reason when the count goes past its limit: `facts.dropped 3 > 0`. */
+export const overLimit = (name, count, limit) => (count > limit ? [`${name} ${String(count)} > ${String(limit)}`] : []);
+/** Facts that count against the output: those whose kind was not allowed to change. */
+export const counted = (facts) => facts.filter((fact) => !fact.allowed).length;
+export const verdictOf = (failedBecause) => ({ pass: failedBecause.length === 0, failedBecause });
+/**
+ * The pass or fail with no `grade:` in chaff.yaml (spec §29.3): an error finding, a fact dropped or added against the
+ * reference, a quotation not found, or a fact no retrieved passage states fails the output. Warnings and info are rates to compare, not a verdict on one output.
+ */
+export const defaultVerdict = (graded) => verdictOf([
+    ...overLimit("findings.error", graded.findings.filter((finding) => finding.level === "error").length, 0),
+    ...overLimit("facts.dropped", counted(graded.facts?.dropped ?? []), 0),
+    ...overLimit("facts.added", counted(graded.facts?.added ?? []), 0),
+    ...overLimit("citations.failed", graded.citations?.failed.length ?? 0, 0),
+    ...overLimit("contexts.unsupported", counted(graded.contexts?.unsupported ?? []), 0),
+]);
+//# sourceMappingURL=verdict.js.map

package/dist/grade/verdict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict.js","sourceRoot":"","sources":["../../src/grade/verdict.ts"],"names":[],"mappings":"AAOA,iHAAiH;AACjH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,KAAa,EAAY,EAAE,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAE1J,uFAAuF;AACvF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAA2B,EAAU,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;AAE7G,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,aAAgC,EAAW,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC;AAE9H;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAW,EAAE,CACxD,SAAS,CAAC;IACR,GAAG,SAAS,CAAC,gBAAgB,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACxG,GAAG,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IACtE,GAAG,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAClE,GAAG,SAAS,CAAC,kBAAkB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;IACzE,GAAG,SAAS,CAAC,sBAAsB,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;CACrF,CAAC,CAAC"}

package/dist/grade-api.d.ts

@@ -0,0 +1,53 @@
+import { type Config } from "./config/load.ts";
+import type { GradeResult } from "./grade/result.ts";
+import { type VariantComparison } from "./grade/variants.ts";
+import { type VariantInput } from "./grade/variants-input.ts";
+export type { FailedCitation, GradeCitations, GradeContexts, GradeFact, GradeFacts, GradeFinding, GradeResult, GradeScore, NotRunEntry, ScoreItem, Stamp, SupportedFact, } from "./grade/result.ts";
+export type { OutputSize } from "./grade/rates.ts";
+export { toScorer, type ChaffScore } from "./grade/scorer.ts";
+export type { Disagreement, VariantColumn, VariantComparison, VariantRates } from "./grade/variants.ts";
+export type { VariantInput } from "./grade/variants-input.ts";
+export type GradeOptions = {
+    /** The result's id. "output" when left out. */
+    readonly id?: string;
+    /** The document the output was made from: facts are checked against it, as `chaff compare` does. */
+    readonly reference?: string;
+    /** Each source's name and text. */
+    readonly sources?: Readonly<Record<string, string>>;
+    /** What the output quoted. `source` may be left out when there is one source. */
+    readonly citations?: readonly {
+        readonly source?: string;
+        readonly address: string;
+        readonly quote: string;
+    }[];
+    /** The retrieved passages the output was meant to rest on: each fact of the output is looked for in them. */
+    readonly contexts?: readonly string[];
+    readonly language?: string;
+    readonly genre?: string;
+    /** The prompt, model or setting that produced the output, kept on the result for compareVariants(). */
+    readonly variant?: string;
+    /** Run the experimental rules too, as --experimental does. chaff.yaml's `experimental` when left out. */
+    readonly experimental?: boolean;
+    /** chaff.yaml's path, or settings already read. Without it chaff's defaults apply and no file is read. */
+    readonly config?: string | Config;
+};
+/** An input or a chaff.yaml grade() cannot use: the same cases end `chaff grade` with exit 2. */
+export declare class GradeInputError extends Error {
+    readonly problems: readonly string[];
+    constructor(problems: readonly string[]);
+}
+/**
+ * Grades one output (spec §29.6): its findings and rates, its facts against `reference`, its `citations` against
+ * `sources`, and pass or fail by chaff.yaml's `grade:` or the default. Reads a file only when `config` is a path, and
+ * never writes one. Throws GradeInputError for an input or a chaff.yaml `chaff grade` would refuse with exit 2.
+ */
+export declare const grade: (output: string, options?: GradeOptions) => Promise<GradeResult>;
+/**
+ * Several variants' results side by side on the same inputs (spec §29.5), as `chaff grade` prints them for a file whose
+ * lines carry a variant: per variant the pass rate, each rule's rate, facts dropped and added, and failed quotations,
+ * over the ids every variant answered; and the ids where pass or fail differs. Takes results labelled by `variant`
+ * (grade() with `variant`, or `chaff grade --out`), or `{ [variant]: results }`. Throws GradeInputError for a result
+ * without an id or a variant, or an id given twice in one variant.
+ */
+export declare const compareVariants: (results: VariantInput) => VariantComparison;
+//# sourceMappingURL=grade-api.d.ts.map

package/dist/grade-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade-api.d.ts","sourceRoot":"","sources":["../src/grade-api.ts"],"names":[],"mappings":"AAOA,OAAO,EAAqB,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAMlE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI/E,YAAY,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,EACX,SAAS,EACT,KAAK,EACL,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxG,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAM,MAAM,YAAY,GAAG;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,oGAAoG;IACpG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,iFAAiF;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/G,6GAA6G;IAC7G,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,uGAAuG;IACvG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,yGAAyG;IACzG,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,0GAA0G;IAC1G,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACnC,CAAC;AAEF,iGAAiG;AACjG,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;gBAEzB,QAAQ,EAAE,SAAS,MAAM,EAAE;CAKxC;AA6ED;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAU,QAAQ,MAAM,EAAE,UAAS,YAAiB,KAAG,OAAO,CAAC,WAAW,CAiB3F,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,YAAY,KAAG,iBAIvD,CAAC"}

package/dist/grade-api.js

@@ -0,0 +1,140 @@
+// `chaffjs/grade`: chaff's grader for an in-process eval harness (spec §29.6). One output at a time, with the same
+// result as one line of `chaff grade --out`: both go through gradeItem with the same settings and stamp. A separate entry
+// from `chaffjs/api`, so the plugin API's version and the result's shape are not bound to one number.
+import { statSync } from "node:fs";
+import { resolve } from "node:path";
+import { packageFor } from "./adapter-load.js";
+import { CLI_TEXT } from "./cli-text.js";
+import { EMPTY, loadConfig } from "./config/load.js";
+import { withStyle } from "./config/style.js";
+import { withExtensions } from "./extension/load.js";
+import { GENRES } from "./genre.js";
+import { gradeItem } from "./grade/grade-item.js";
+import { readItem } from "./grade/item.js";
+import { parseRubric } from "./grade/rubric.js";
+import { gradeSetup } from "./grade/setup.js";
+import { GRADE_TEXT } from "./grade/text.js";
+import { compareVariantGroups } from "./grade/variants.js";
+import { variantGroupsOf } from "./grade/variants-input.js";
+import { settingProblems } from "./setting-problems.js";
+import { loadStyles } from "./style-load.js";
+export { toScorer } from "./grade/scorer.js";
+/** An input or a chaff.yaml grade() cannot use: the same cases end `chaff grade` with exit 2. */
+export class GradeInputError extends Error {
+    problems;
+    constructor(problems) {
+        super(problems.join("\n"));
+        this.name = "GradeInputError";
+        this.problems = problems;
+    }
+}
+const TEXT = GRADE_TEXT.en;
+/** Each chaff.yaml read, by its path and when it was last changed: one file is read and its code loaded once. */
+const readConfigs = new Map();
+const KEPT = 16;
+/** Adds to a cache, dropping the oldest entry past KEPT. */
+const remember = (cache, key, value) => {
+    cache.set(key, value);
+    const [oldest] = cache.keys();
+    if (cache.size > KEPT && oldest !== undefined)
+        cache.delete(oldest);
+    return value;
+};
+/** chaff.yaml read as the command line reads it: its style applied and the code it names loaded. */
+const readConfig = async (path) => {
+    const file = resolve(path);
+    const key = `${file}\n${String(statSync(file).mtimeMs)}`;
+    return readConfigs.get(key) ?? remember(readConfigs, key, await withExtensions(withStyle(loadConfig(file), loadStyles())));
+};
+/** A chaff.yaml that is missing or not YAML is an input grade() cannot use, as it is for the command line. */
+const readNamedConfig = async (path) => {
+    try {
+        return await readConfig(path);
+    }
+    catch (error) {
+        throw new GradeInputError([TEXT.unreadable(path, error instanceof Error ? error.message : String(error))]);
+    }
+};
+/** The settings to grade with, checked as the command line checks them, whether read here or given already read. */
+const configOf = async (given) => {
+    if (given === undefined)
+        return EMPTY;
+    const config = typeof given === "string" ? await readNamedConfig(given) : given;
+    const problems = settingProblems("grade", undefined, config, CLI_TEXT.en);
+    if (problems.length > 0)
+        throw new GradeInputError(problems);
+    return config;
+};
+const rubricOf = (config) => {
+    const parsed = parseRubric(config.grade);
+    if ("problems" in parsed)
+        throw new GradeInputError(parsed.problems.map((problem) => TEXT.rubricProblem(problem)));
+    return parsed.rubric;
+};
+/**
+ * Setups for each settings object, by what else decides them, so a harness grading many outputs loads the language
+ * packages and hashes the rules once. Keyed by the object itself: two chaff.yaml files that read alike may load other code.
+ */
+const setups = new WeakMap();
+const setupFor = (config, experimental, languages) => {
+    const run = { experimental, genre: undefined };
+    const own = setups.get(config) ?? new Map();
+    setups.set(config, own);
+    const key = `${String(experimental)}\n${languages.join(",")}`;
+    const known = own.get(key);
+    if (known !== undefined)
+        return known;
+    const made = remember(own, key, gradeSetup(config, run, languages, rubricOf(config)));
+    // A language package that failed to load may be installed before the next call: do not keep the failure.
+    made.catch(() => own.delete(key));
+    return made;
+};
+/** The setup, or GradeInputError when a language package cannot be loaded, as `chaff grade` ends with 2 then. */
+const loadedSetup = async (config, experimental, languages) => {
+    try {
+        return await setupFor(config, experimental, languages);
+    }
+    catch (error) {
+        if (error instanceof GradeInputError)
+            throw error;
+        throw new GradeInputError([TEXT.cannotLoad(error instanceof Error ? error.message : String(error))]);
+    }
+};
+/**
+ * Grades one output (spec §29.6): its findings and rates, its facts against `reference`, its `citations` against
+ * `sources`, and pass or fail by chaff.yaml's `grade:` or the default. Reads a file only when `config` is a path, and
+ * never writes one. Throws GradeInputError for an input or a chaff.yaml `chaff grade` would refuse with exit 2.
+ */
+export const grade = async (output, options = {}) => {
+    const config = await configOf(options.config);
+    const raw = {
+        id: options.id ?? "output",
+        output,
+        reference: options.reference,
+        sources: options.sources,
+        citations: options.citations,
+        contexts: options.contexts,
+        language: options.language,
+        genre: options.genre,
+        variant: options.variant,
+    };
+    const read = readItem(raw, { isLanguage: (language) => packageFor(language) !== undefined, genres: GENRES });
+    if ("problem" in read)
+        throw new GradeInputError([TEXT.problem(read.problem)]);
+    const languages = read.item.language === undefined ? [] : [read.item.language];
+    return gradeItem(read.item, await loadedSetup(config, options.experimental ?? config.experimental, languages));
+};
+/**
+ * Several variants' results side by side on the same inputs (spec §29.5), as `chaff grade` prints them for a file whose
+ * lines carry a variant: per variant the pass rate, each rule's rate, facts dropped and added, and failed quotations,
+ * over the ids every variant answered; and the ids where pass or fail differs. Takes results labelled by `variant`
+ * (grade() with `variant`, or `chaff grade --out`), or `{ [variant]: results }`. Throws GradeInputError for a result
+ * without an id or a variant, or an id given twice in one variant.
+ */
+export const compareVariants = (results) => {
+    const read = variantGroupsOf(results);
+    if ("problems" in read)
+        throw new GradeInputError(read.problems);
+    return compareVariantGroups(read.groups);
+};
+//# sourceMappingURL=grade-api.js.map

package/dist/grade-api.js.map

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

package/dist/heading-numbering.d.ts

@@ -0,0 +1,32 @@
+/** 番号の無い見出しの書き方。ほかの書き方は "dot"（1.）や "label:章"（第1章）のように、番号を持つ語ごとに分ける。 */
+export declare const UNNUMBERED = "none";
+/** 番号を持つ語。before は語が番号の前（Chapter 1、ステップ1）、after は番号の後ろ（第1章、1章）。 */
+export type NumberLabel = {
+    readonly word: string;
+    readonly position: "before" | "after";
+};
+/** 見出しの言葉から、番号の書き方を読む。番号を持つ語（第1章）を先に、字だけの形（1.）を後に見る。 */
+export declare const numberingStyleOf: (heading: string, labels: readonly NumberLabel[]) => string;
+/** 見出し 1 つ。depth は深さ（#の数）、style は番号の書き方、skipped は番号を付けない前後の見出し（目次・参考文献）。 */
+export type NumberedHeading = {
+    readonly depth: number;
+    readonly style: string;
+    readonly skipped: boolean;
+};
+/** 親（直前の浅い見出し）と深さが同じ見出しの組。番号は兄弟の見出しのあいだで揃える。位置は渡した並びの添え字。 */
+export declare const siblingGroups: (headings: readonly NumberedHeading[]) => number[][];
+/** 指す見出しと、何に対して少ないか。kind は numbered（番号の有無）か style（番号の書き方）。majority は多いほうの書き方で、count はその数。 */
+export type NumberingMinority = {
+    readonly at: number;
+    readonly kind: "numbered" | "style";
+    readonly majority: string;
+    readonly count: number;
+    /** 多いほうの書き方の、最初の兄弟の位置。指摘が例に引く。 */
+    readonly example: number;
+};
+/**
+ * 兄弟の見出しのうち、少ないほうの書き方のもの。先に番号の有無を比べ（「1. 概要」「2. 手順」「まとめ」の「まとめ」）、
+ * 番号の付いた見出しのあいだで書き方を比べる（「1.」「2.」「3）」の「3）」）。同じ数なら言わない（二つだけの兄弟は必ず同じ数か一つの書き方）。前後の見出し（目次・参考文献）は数えない。
+ */
+export declare const numberingMinorities: (headings: readonly NumberedHeading[]) => NumberingMinority[];
+//# sourceMappingURL=heading-numbering.d.ts.map

package/dist/heading-numbering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-numbering.d.ts","sourceRoot":"","sources":["../src/heading-numbering.ts"],"names":[],"mappings":"AAGA,uEAAuE;AACvE,eAAO,MAAM,UAAU,SAAS,CAAC;AAEjC,mEAAmE;AACnE,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAA;CAAE,CAAC;AAoC3F,wDAAwD;AACxD,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,EAAE,QAAQ,SAAS,WAAW,EAAE,KAAG,MAKlF,CAAC;AAEF,4EAA4E;AAC5E,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5G,6DAA6D;AAC7D,eAAO,MAAM,aAAa,GAAI,UAAU,SAAS,eAAe,EAAE,KAAG,MAAM,EAAE,EAQ5E,CAAC;AAEF,6FAA6F;AAC7F,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAgBF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,UAAU,SAAS,eAAe,EAAE,KAAG,iBAAiB,EAYxF,CAAC"}

package/dist/heading-numbering.js

@@ -0,0 +1,72 @@
+// 見出しの番号の付け方。純粋な関数だけを置く。どの語が番号を持つか（第1章、Chapter 1）と、番号を付けない前後の見出し
+// （目次、参考文献）は言語パッケージの語彙表が言う。
+/** 番号の無い見出しの書き方。ほかの書き方は "dot"（1.）や "label:章"（第1章）のように、番号を持つ語ごとに分ける。 */
+export const UNNUMBERED = "none";
+const ARABIC = "[0-9０-９]+";
+const KANJI = "[一二三四五六七八九十百]+";
+const ROMAN = "[IVXⅠ-Ⅻ]+";
+/** 番号の後ろに続く見出しの言葉の頭。字で始まる。「8.2.3 (2026-08-06)」の版や「3 reasons」の数量は番号と読まない。 */
+const WORDS_FOLLOW = "(?=\\s*[\\p{L}])";
+/**
+ * 字だけで決まる書き方。上から順に試す。ラテン文字一字とローマ数字（A. と II.）は同じ書き方とする。どちらも番号の後ろに言葉が続くときだけ。
+ * 区切りの記号の無い数（「1 Introduction」）は数量（「10 reasons」）と見分けられないので読まない。
+ */
+const SHAPES = [
+    ["paren", /^[(（][0-9０-９]+[)）]/u],
+    ["close-paren", /^[0-9０-９]+[)）]/u],
+    ["dot", new RegExp(`^${ARABIC}[a-z]?(?:[.．]${ARABIC})*[.．](?![0-9０-９])${WORDS_FOLLOW}`, "u")],
+    ["dotted", new RegExp(`^${ARABIC}(?:[.．]${ARABIC})+\\s${WORDS_FOLLOW}`, "u")],
+    ["circled", /^[①-⑳]/u],
+    ["kanji", /^[一二三四五六七八九十]+[、.．]/u],
+    ["letter", /^(?:[IVX]+|[A-Z])[.)]\s+(?=\p{L})/u],
+];
+const escaped = (word) => word.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+/** 番号を持つ語は書いたとおりか、全部大文字で照らす（Chapter と CHAPTER。小文字の section は本文の語）。 */
+const casings = (word) => [...new Set([word, word.toUpperCase()])].map(escaped).join("|");
+const labelPattern = (label) => label.position === "before"
+    ? new RegExp(`^(?:${casings(label.word)})(?:\\s*(?:${ARABIC}|${KANJI}|${ROMAN})|\\s+[A-Z])(?![A-Za-z])`, "u")
+    : new RegExp(`^(?:第(?:${ARABIC}|${KANJI}|${ROMAN})|${ARABIC})${escaped(label.word)}`, "u");
+/** 見出しの頭の強調の印と空白。「**1. 概要**」も「1. 概要」と読む。 */
+const LEAD = /^[\s*_]+/u;
+/** 見出しの言葉から、番号の書き方を読む。番号を持つ語（第1章）を先に、字だけの形（1.）を後に見る。 */
+export const numberingStyleOf = (heading, labels) => {
+    const text = heading.replace(LEAD, "");
+    const label = labels.find((candidate) => labelPattern(candidate).test(text));
+    if (label !== undefined)
+        return `label:${label.word.toLowerCase()}`;
+    return SHAPES.find(([, shape]) => shape.test(text))?.[0] ?? UNNUMBERED;
+};
+/** 親（直前の浅い見出し）と深さが同じ見出しの組。番号は兄弟の見出しのあいだで揃える。位置は渡した並びの添え字。 */
+export const siblingGroups = (headings) => {
+    const parents = headings.map((heading, at) => headings.slice(0, at).findLastIndex((before) => before.depth < heading.depth));
+    const groups = new Map();
+    headings.forEach((heading, at) => {
+        const key = `${String(parents[at])}:${String(heading.depth)}`;
+        groups.set(key, [...(groups.get(key) ?? []), at]);
+    });
+    return [...groups.values()];
+};
+const minorityBy = (members, keyOf) => {
+    const counts = new Map();
+    members.forEach((at) => counts.set(keyOf(at), (counts.get(keyOf(at)) ?? 0) + 1));
+    const [top, second] = [...counts].toSorted((left, right) => right[1] - left[1]);
+    if (top === undefined || second === undefined || top[1] === second[1])
+        return undefined;
+    const example = members.find((at) => keyOf(at) === top[0]) ?? -1;
+    return { minority: members.filter((at) => keyOf(at) !== top[0]), majority: top[0], count: top[1], example };
+};
+const minoritiesOf = (split, kind) => split === undefined ? [] : split.minority.map((at) => ({ at, kind, majority: split.majority, count: split.count, example: split.example }));
+/**
+ * 兄弟の見出しのうち、少ないほうの書き方のもの。先に番号の有無を比べ（「1. 概要」「2. 手順」「まとめ」の「まとめ」）、
+ * 番号の付いた見出しのあいだで書き方を比べる（「1.」「2.」「3）」の「3）」）。同じ数なら言わない（二つだけの兄弟は必ず同じ数か一つの書き方）。前後の見出し（目次・参考文献）は数えない。
+ */
+export const numberingMinorities = (headings) => siblingGroups(headings).flatMap((group) => {
+    const members = group.filter((at) => headings[at]?.skipped !== true);
+    const styleOf = (at) => headings[at]?.style ?? UNNUMBERED;
+    const numbered = members.filter((at) => styleOf(at) !== UNNUMBERED);
+    return [
+        ...minoritiesOf(minorityBy(members, (at) => (styleOf(at) === UNNUMBERED ? UNNUMBERED : "numbered")), "numbered"),
+        ...minoritiesOf(minorityBy(numbered, styleOf), "style"),
+    ];
+});
+//# sourceMappingURL=heading-numbering.js.map

package/dist/heading-numbering.js.map

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

package/dist/kana-spelling.d.ts

@@ -0,0 +1,14 @@
+/** Hiragana as katakana, the script the adapter reads in. */
+export declare const toKatakana: (text: string) => string;
+export declare const isKanaOnly: (text: string) => boolean;
+/** The kanji of a spelling, in order: 引越 for both 引っ越し and 引越し, nothing for できる. */
+export declare const kanjiSkeleton: (text: string) => string;
+/**
+ * The reading of the dictionary form, from the reading of the written form: 下さい (クダサイ) with lemma 下さる reads クダサル.
+ * The written form and the lemma differ only in their kana ending, so that ending is swapped in the reading. When the ending is
+ * not kana, or the reading does not end with it (来 read キ for 来る), there is no answer.
+ */
+export declare const lemmaReading: (surface: string, lemma: string, reading: string) => string | undefined;
+/** A katakana word with ー dropped, small vowels made large, ヴ read as バ行 and エイ as エ: インターフェース and インタフェイス meet. */
+export declare const katakanaKey: (surface: string) => string;
+//# sourceMappingURL=kana-spelling.d.ts.map

package/dist/kana-spelling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kana-spelling.d.ts","sourceRoot":"","sources":["../src/kana-spelling.ts"],"names":[],"mappings":"AASA,6DAA6D;AAC7D,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,MAAmH,CAAC;AAE9J,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,OAA+B,CAAC;AAE1E,oFAAoF;AACpF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAAqE,CAAC;AAUnH;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,EAAE,OAAO,MAAM,EAAE,SAAS,MAAM,KAAG,MAAM,GAAG,SAOvF,CAAC;AAKF,oHAAoH;AACpH,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,MAKrB,CAAC"}

package/dist/kana-spelling.js

@@ -0,0 +1,43 @@
+// Keys that make two Japanese spellings of one word meet: the reading of the dictionary form (出来る and できる are both デキル),
+// the kanji a spelling keeps (引っ越し and 引越し both keep 引越), and a katakana word with its small kana and ー evened out
+// (ウィンドウ and ウインドウ). Pure: the tokens come in from the language adapter.
+const HIRAGANA_TO_KATAKANA = 0x60;
+const HIRAGANA = /[ぁ-ゖ]/gu;
+const KANA_ONLY = /^[ぁ-ゖァ-ヺー]+$/u;
+const KANJI = /[\p{Script=Han}々]/gu;
+/** Hiragana as katakana, the script the adapter reads in. */
+export const toKatakana = (text) => text.replace(HIRAGANA, (char) => String.fromCodePoint((char.codePointAt(0) ?? 0) + HIRAGANA_TO_KATAKANA));
+export const isKanaOnly = (text) => KANA_ONLY.test(text);
+/** The kanji of a spelling, in order: 引越 for both 引っ越し and 引越し, nothing for できる. */
+export const kanjiSkeleton = (text) => [...text.matchAll(KANJI)].map((match) => match[0]).join("");
+/** The length, in UTF-16 units, of the start both strings share, compared character by character (𠮟 is one character, two units). */
+const sharedPrefixLength = (left, right) => {
+    const [leftChars, rightChars] = [[...left], [...right]];
+    const differs = leftChars.findIndex((char, at) => rightChars[at] !== char);
+    const shared = differs === -1 ? leftChars.slice(0, rightChars.length) : leftChars.slice(0, differs);
+    return shared.join("").length;
+};
+/**
+ * The reading of the dictionary form, from the reading of the written form: 下さい (クダサイ) with lemma 下さる reads クダサル.
+ * The written form and the lemma differ only in their kana ending, so that ending is swapped in the reading. When the ending is
+ * not kana, or the reading does not end with it (来 read キ for 来る), there is no answer.
+ */
+export const lemmaReading = (surface, lemma, reading) => {
+    const shared = sharedPrefixLength(surface, lemma);
+    const [writtenEnd, lemmaEnd] = [surface.slice(shared), lemma.slice(shared)];
+    if ((writtenEnd !== "" && !isKanaOnly(writtenEnd)) || (lemmaEnd !== "" && !isKanaOnly(lemmaEnd)))
+        return undefined;
+    const spoken = toKatakana(writtenEnd);
+    if (!reading.endsWith(spoken))
+        return undefined;
+    return reading.slice(0, reading.length - spoken.length) + toKatakana(lemmaEnd);
+};
+const SMALL_TO_LARGE = { ァ: "ア", ィ: "イ", ゥ: "ウ", ェ: "エ", ォ: "オ", ヵ: "カ", ヶ: "ケ", ヮ: "ワ" };
+const VU = { ヴァ: "バ", ヴィ: "ビ", ヴェ: "ベ", ヴォ: "ボ", ヴ: "ブ" };
+/** A katakana word with ー dropped, small vowels made large, ヴ read as バ行 and エイ as エ: インターフェース and インタフェイス meet. */
+export const katakanaKey = (surface) => surface
+    .replace(/ヴ[ァィェォ]?/gu, (match) => VU[match] ?? match)
+    .replace(/[ァィゥェォヵヶヮ]/gu, (char) => SMALL_TO_LARGE[char] ?? char)
+    .replace(/ー/gu, "")
+    .replace(/エイ/gu, "エ");
+//# sourceMappingURL=kana-spelling.js.map

package/dist/kana-spelling.js.map

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

package/dist/link-text.d.ts

@@ -0,0 +1,12 @@
+/**
+ * インラインのリンク（`[言葉](行き先)`）の言葉。参照の定義（`[1]: url`）と自動リンク（`<https://…>`）は言葉を持たないので undefined。
+ * 位置は字（コードポイント）で数える。
+ */
+export declare const linkTextOf: (written: string) => string | undefined;
+/** 見せる形。逃がしの印と、強調と鉤括弧と終わりの句読点を外し、空白をまとめる。コードの印（`）は外さない。コードの言葉は語ではない。 */
+export declare const bareLinkText: (text: string) => string;
+/** 比べる形。見せる形を小文字にしたもの。 */
+export declare const comparableLinkText: (text: string) => string;
+/** リンクの言葉が、それだけでは行き先を言わない言葉（語彙表の語）そのものか。言葉の一部に含むだけ（「料金表はこちら」）なら違う。 */
+export declare const isVagueLinkText: (text: string, vague: ReadonlySet<string>) => boolean;
+//# sourceMappingURL=link-text.d.ts.map

package/dist/link-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-text.d.ts","sourceRoot":"","sources":["../src/link-text.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,KAAG,MAAM,GAAG,SAMrD,CAAC;AAeF,wEAAwE;AACxE,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,MAAyE,CAAC;AAEtH,0BAA0B;AAC1B,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,MAA0C,CAAC;AAE7F,sEAAsE;AACtE,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAG,OAA8C,CAAC"}

package/dist/link-text.js

@@ -0,0 +1,45 @@
+// リンクの言葉（`[こちら](url)` の「こちら」）を読む。純粋な関数だけを置く。
+/** `[` から、対応する `]` の位置。入れ子の角括弧（`[a [b] c]`）を数える。閉じなければ undefined。 */
+const closingBracket = (written) => {
+    let depth = 0;
+    for (const [at, char] of [...written].entries()) {
+        if (char === "[")
+            depth += 1;
+        if (char === "]")
+            depth -= 1;
+        if (depth === 0)
+            return at;
+    }
+    return undefined;
+};
+/**
+ * インラインのリンク（`[言葉](行き先)`）の言葉。参照の定義（`[1]: url`）と自動リンク（`<https://…>`）は言葉を持たないので undefined。
+ * 位置は字（コードポイント）で数える。
+ */
+export const linkTextOf = (written) => {
+    if (!written.startsWith("["))
+        return undefined;
+    const close = closingBracket(written);
+    const chars = [...written];
+    if (close === undefined || chars[close + 1] !== "(")
+        return undefined;
+    return chars.slice(1, close).join("");
+};
+/** 言葉を包む強調の印と鉤括弧（前後とも）、終わりの句読点（後ろだけ）。「**こちら**」も「こちら。」も「こちら」と読む。 */
+const LEADING = new Set(" \t\n*_「『\"“'");
+const TRAILING = new Set([...LEADING, ..."」』”。．.、，,!！?？:："]);
+const trimmed = (chars) => {
+    const start = chars.findIndex((char) => !LEADING.has(char));
+    if (start === -1)
+        return "";
+    return chars.slice(start, chars.findLastIndex((char) => !TRAILING.has(char)) + 1).join("");
+};
+/** Markdown の逃がし（`here\\.`）。字はそのまま見えるので、逃がしの印だけを外す。 */
+const ESCAPED = /\\(\p{P})/gu;
+/** 見せる形。逃がしの印と、強調と鉤括弧と終わりの句読点を外し、空白をまとめる。コードの印（`）は外さない。コードの言葉は語ではない。 */
+export const bareLinkText = (text) => trimmed([...text.replace(ESCAPED, "$1")]).replace(/\s+/gu, " ");
+/** 比べる形。見せる形を小文字にしたもの。 */
+export const comparableLinkText = (text) => bareLinkText(text).toLowerCase();
+/** リンクの言葉が、それだけでは行き先を言わない言葉（語彙表の語）そのものか。言葉の一部に含むだけ（「料金表はこちら」）なら違う。 */
+export const isVagueLinkText = (text, vague) => vague.has(comparableLinkText(text));
+//# sourceMappingURL=link-text.js.map

package/dist/link-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-text.js","sourceRoot":"","sources":["../src/link-text.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C,qEAAqE;AACrE,MAAM,cAAc,GAAG,CAAC,OAAe,EAAsB,EAAE;IAC7D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAChD,IAAI,IAAI,KAAK,GAAG;YAAE,KAAK,IAAI,CAAC,CAAC;QAC7B,IAAI,IAAI,KAAK,GAAG;YAAE,KAAK,IAAI,CAAC,CAAC;QAC7B,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAe,EAAsB,EAAE;IAChE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAC3B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;QAAE,OAAO,SAAS,CAAC;IACtE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,mEAAmE;AACnE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;AACzC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,iBAAiB,CAAC,CAAC,CAAC;AAE7D,MAAM,OAAO,GAAG,CAAC,KAAwB,EAAU,EAAE;IACnD,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5B,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7F,CAAC,CAAC;AAEF,uDAAuD;AACvD,MAAM,OAAO,GAAG,aAAa,CAAC;AAE9B,wEAAwE;AACxE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAEtH,0BAA0B;AAC1B,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AAE7F,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,KAA0B,EAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC"}