@markbrutx/promptbook-core 0.1.0

package/dist/index.js

@@ -0,0 +1,15 @@
+export { ANNOTATION_QUEUE_DIR, ANNOTATION_QUEUE_FILE, parseInbox, serializeAnnotationLine, serializeInbox, } from "./annotations.js";
+export { serializeBook, serializeBookExpression, serializeBookJson } from "./bundle.js";
+export { defaultAssertions } from "./eval/assertions.js";
+export { evaluate } from "./eval/evaluate.js";
+export { loadFixtures } from "./eval/load-fixtures.js";
+export { parseFrontmatter } from "./frontmatter.js";
+export { nodeFs } from "./fs.js";
+export { interpolate } from "./interpolate.js";
+export { lint } from "./lint/lint.js";
+export { iterateReferences } from "./lint/references.js";
+export { bannedTokens, danglingReference, deadRule, defaultRules, estimateTokensByChars, exampleBalance, languageDirectivePosition, tokenBudget, unusedFragment, } from "./lint/rules/index.js";
+export { loadPrompts } from "./load.js";
+export { resolve } from "./resolve.js";
+export { resolveBook } from "./resolve-book.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,UAAU,EACV,uBAAuB,EACvB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAevD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAUzD,OAAO,EACL,YAAY,EAEZ,iBAAiB,EACjB,QAAQ,EACR,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,yBAAyB,EACzB,WAAW,EACX,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/interpolate.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from "./types.js";
+/**
+ * Substitute `${path}` placeholders in `body` using `context`.
+ *
+ * - A missing key resolves to an empty string and triggers `onMissing(key)`.
+ *   Interpolation never throws.
+ * - `\${path}` is an escape and renders the literal `${path}`.
+ * - Lookup is by flat key, matching the flat {@link Context} shape.
+ */
+export declare function interpolate(body: string, context: Context, onMissing: (key: string) => void): string;
+//# sourceMappingURL=interpolate.d.ts.map

package/dist/interpolate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../src/interpolate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAK1C;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAapG"}

package/dist/interpolate.js

@@ -0,0 +1,25 @@
+/** Matches `${path}` placeholders, capturing an optional leading `\` escape. */
+const VAR_RE = /(\\?)\$\{([^}]+)\}/g;
+/**
+ * Substitute `${path}` placeholders in `body` using `context`.
+ *
+ * - A missing key resolves to an empty string and triggers `onMissing(key)`.
+ *   Interpolation never throws.
+ * - `\${path}` is an escape and renders the literal `${path}`.
+ * - Lookup is by flat key, matching the flat {@link Context} shape.
+ */
+export function interpolate(body, context, onMissing) {
+    return body.replace(VAR_RE, (_match, backslash, expr) => {
+        if (backslash) {
+            return `\${${expr}}`;
+        }
+        const key = expr.trim();
+        const value = context[key];
+        if (value === undefined) {
+            onMissing(key);
+            return "";
+        }
+        return String(value);
+    });
+}
+//# sourceMappingURL=interpolate.js.map

package/dist/interpolate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.js","sourceRoot":"","sources":["../src/interpolate.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,MAAM,MAAM,GAAG,qBAAqB,CAAC;AAErC;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAAgB,EAAE,SAAgC;IAC1F,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,SAAiB,EAAE,IAAY,EAAE,EAAE;QACtE,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,MAAM,IAAI,GAAG,CAAC;QACvB,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS,CAAC,GAAG,CAAC,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lint/lint.d.ts

@@ -0,0 +1,11 @@
+import type { LintInput, LintReport, LintRule } from "./types.js";
+/**
+ * Run lint rules over an input and aggregate the findings.
+ *
+ * Book-scope rules always run. Resolved-scope rules run only when
+ * `input.result` is present, so calling `lint({ book })` lints structure only.
+ * The engine has no intelligence of its own: it dispatches by scope and counts
+ * severities. All judgement lives in the rules.
+ */
+export declare function lint(input: LintInput, rules?: LintRule[]): LintReport;
+//# sourceMappingURL=lint.d.ts.map

package/dist/lint/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/lint/lint.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE/E;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,GAAE,QAAQ,EAAmB,GAAG,UAAU,CAoBrF"}

package/dist/lint/lint.js

@@ -0,0 +1,30 @@
+import { defaultRules } from "./rules/index.js";
+/**
+ * Run lint rules over an input and aggregate the findings.
+ *
+ * Book-scope rules always run. Resolved-scope rules run only when
+ * `input.result` is present, so calling `lint({ book })` lints structure only.
+ * The engine has no intelligence of its own: it dispatches by scope and counts
+ * severities. All judgement lives in the rules.
+ */
+export function lint(input, rules = defaultRules()) {
+    const findings = [];
+    for (const rule of rules) {
+        if (rule.scope === "resolved" && input.result === undefined) {
+            continue;
+        }
+        findings.push(...rule.check(input));
+    }
+    let errorCount = 0;
+    let warningCount = 0;
+    for (const finding of findings) {
+        if (finding.severity === "error") {
+            errorCount += 1;
+        }
+        else if (finding.severity === "warning") {
+            warningCount += 1;
+        }
+    }
+    return { findings, errorCount, warningCount };
+}
+//# sourceMappingURL=lint.js.map

package/dist/lint/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/lint/lint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD;;;;;;;GAOG;AACH,MAAM,UAAU,IAAI,CAAC,KAAgB,EAAE,KAAK,GAAe,YAAY,EAAE;IACvE,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC5D,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,UAAU,IAAI,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC1C,YAAY,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;AAChD,CAAC"}

package/dist/lint/references.d.ts

@@ -0,0 +1,18 @@
+import type { PromptBook } from "../types.js";
+/** A single mention of a fragment id, with enough context to report it. */
+export interface FragmentReference {
+    id: string;
+    composition: string;
+    /** Where in a composition the fragment id is mentioned. */
+    role: "base" | "order" | "add" | "after" | "replace-from" | "replace-to" | "forbid" | "rule-order";
+    /** Index of the rule the reference came from, when it came from a rule. */
+    ruleIndex?: number;
+}
+/**
+ * Yield every place a fragment id is referenced across all compositions: base
+ * and explicit order lists, and each rule's add/after/replace/forbid/order.
+ * Shared by the `unused-fragment` and `dangling-reference` rules so both see
+ * the same reference surface.
+ */
+export declare function iterateReferences(book: PromptBook): Generator<FragmentReference>;
+//# sourceMappingURL=references.d.ts.map

package/dist/lint/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../src/lint/references.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,cAAc,GAAG,YAAY,GAAG,QAAQ,GAAG,YAAY,CAAC;IACnG,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAiB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,iBAAiB,CAAC,CA+BjF"}

package/dist/lint/references.js

@@ -0,0 +1,39 @@
+/**
+ * Yield every place a fragment id is referenced across all compositions: base
+ * and explicit order lists, and each rule's add/after/replace/forbid/order.
+ * Shared by the `unused-fragment` and `dangling-reference` rules so both see
+ * the same reference surface.
+ */
+export function* iterateReferences(book) {
+    for (const composition of book.compositions.values()) {
+        const composed = composition.name;
+        for (const id of composition.base) {
+            yield { id, composition: composed, role: "base" };
+        }
+        if (composition.order) {
+            for (const id of composition.order) {
+                yield { id, composition: composed, role: "order" };
+            }
+        }
+        for (const rule of composition.rules) {
+            const ruleIndex = rule.index;
+            for (const id of rule.add ?? []) {
+                yield { id, composition: composed, role: "add", ruleIndex };
+            }
+            if (rule.after !== undefined) {
+                yield { id: rule.after, composition: composed, role: "after", ruleIndex };
+            }
+            for (const [from, to] of Object.entries(rule.replace ?? {})) {
+                yield { id: from, composition: composed, role: "replace-from", ruleIndex };
+                yield { id: to, composition: composed, role: "replace-to", ruleIndex };
+            }
+            for (const id of rule.forbid ?? []) {
+                yield { id, composition: composed, role: "forbid", ruleIndex };
+            }
+            for (const id of rule.order ?? []) {
+                yield { id, composition: composed, role: "rule-order", ruleIndex };
+            }
+        }
+    }
+}
+//# sourceMappingURL=references.js.map

package/dist/lint/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../src/lint/references.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,MAAM,SAAS,CAAC,CAAC,iBAAiB,CAAC,IAAgB;IACjD,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC;QACrD,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC;QAClC,KAAK,MAAM,EAAE,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;YAClC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACpD,CAAC;QACD,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACtB,KAAK,MAAM,EAAE,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;gBACnC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACrD,CAAC;QACH,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACrC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC;YAC7B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC;gBAChC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YAC9D,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;YAC5E,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC5D,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;gBAC3E,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACzE,CAAC;YACD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;gBACnC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;YACjE,CAAC;YACD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;gBAClC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACrE,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/lint/rules/banned-tokens.d.ts

@@ -0,0 +1,13 @@
+import type { LintRule, Severity } from "../types.js";
+export interface BannedTokensOptions {
+    /** Substrings or patterns that must not appear in the assembled text. */
+    tokens?: (string | RegExp)[];
+    severity?: Severity;
+}
+/**
+ * `banned-tokens` (resolved): the assembled text must not contain any of the
+ * configured substrings or patterns. The default bans the em-dash. Patterns
+ * should not use the global flag, since each token is tested once.
+ */
+export declare function bannedTokens(options?: BannedTokensOptions): LintRule;
+//# sourceMappingURL=banned-tokens.d.ts.map

package/dist/lint/rules/banned-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banned-tokens.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/banned-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,QAAQ,CA4BxE"}

package/dist/lint/rules/banned-tokens.js

@@ -0,0 +1,38 @@
+// Em-dash: a common stylistic ban, and deliberately generic (not domain-specific).
+const EM_DASH = "\u2014";
+const DEFAULT_BANNED = [EM_DASH];
+/**
+ * `banned-tokens` (resolved): the assembled text must not contain any of the
+ * configured substrings or patterns. The default bans the em-dash. Patterns
+ * should not use the global flag, since each token is tested once.
+ */
+export function bannedTokens(options = {}) {
+    const tokens = options.tokens ?? DEFAULT_BANNED;
+    const severity = options.severity ?? "error";
+    return {
+        id: "banned-tokens",
+        description: "Resolved prompt must not contain banned substrings or patterns.",
+        scope: "resolved",
+        check(input) {
+            const result = input.result;
+            if (result === undefined) {
+                return [];
+            }
+            const text = result.text;
+            const findings = [];
+            for (const token of tokens) {
+                const matched = typeof token === "string" ? text.includes(token) : token.test(text);
+                if (matched) {
+                    const label = typeof token === "string" ? JSON.stringify(token) : String(token);
+                    findings.push({
+                        ruleId: "banned-tokens",
+                        severity,
+                        message: `text contains banned token ${label}`,
+                    });
+                }
+            }
+            return findings;
+        },
+    };
+}
+//# sourceMappingURL=banned-tokens.js.map

package/dist/lint/rules/banned-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banned-tokens.js","sourceRoot":"","sources":["../../../src/lint/rules/banned-tokens.ts"],"names":[],"mappings":"AAQA,mFAAmF;AACnF,MAAM,OAAO,GAAG,QAAQ,CAAC;AACzB,MAAM,cAAc,GAAwB,CAAC,OAAO,CAAC,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAAO,GAAwB,EAAE;IAC5D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC;IAC7C,OAAO;QACL,EAAE,EAAE,eAAe;QACnB,WAAW,EAAE,iEAAiE;QAC9E,KAAK,EAAE,UAAU;QACjB,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC5B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACzB,MAAM,QAAQ,GAAkB,EAAE,CAAC;YACnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpF,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBAChF,QAAQ,CAAC,IAAI,CAAC;wBACZ,MAAM,EAAE,eAAe;wBACvB,QAAQ;wBACR,OAAO,EAAE,8BAA8B,KAAK,EAAE;qBAC/C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lint/rules/dangling-reference.d.ts

@@ -0,0 +1,11 @@
+import type { LintRule, Severity } from "../types.js";
+export interface DanglingReferenceOptions {
+    severity?: Severity;
+}
+/**
+ * `dangling-reference` (book): any reference (base, order, or a rule's
+ * add/replace/forbid/order/after) that points at a fragment id which does not
+ * exist is a hard error — the prompt cannot assemble as written.
+ */
+export declare function danglingReference(options?: DanglingReferenceOptions): LintRule;
+//# sourceMappingURL=dangling-reference.d.ts.map

package/dist/lint/rules/dangling-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dangling-reference.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/dangling-reference.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,QAAQ,CA8BlF"}

package/dist/lint/rules/dangling-reference.js

@@ -0,0 +1,37 @@
+import { iterateReferences } from "../references.js";
+/**
+ * `dangling-reference` (book): any reference (base, order, or a rule's
+ * add/replace/forbid/order/after) that points at a fragment id which does not
+ * exist is a hard error — the prompt cannot assemble as written.
+ */
+export function danglingReference(options = {}) {
+    const severity = options.severity ?? "error";
+    return {
+        id: "dangling-reference",
+        description: "Every referenced fragment id must exist.",
+        scope: "book",
+        check(input) {
+            const findings = [];
+            for (const reference of iterateReferences(input.book)) {
+                if (input.book.fragments.has(reference.id)) {
+                    continue;
+                }
+                const where = reference.ruleIndex !== undefined
+                    ? `rule #${reference.ruleIndex} (${reference.role})`
+                    : reference.role;
+                const finding = {
+                    ruleId: "dangling-reference",
+                    severity,
+                    message: `composition "${reference.composition}" references unknown fragment "${reference.id}" via ${where}`,
+                    fragmentId: reference.id,
+                };
+                if (reference.ruleIndex !== undefined) {
+                    finding.ruleIndex = reference.ruleIndex;
+                }
+                findings.push(finding);
+            }
+            return findings;
+        },
+    };
+}
+//# sourceMappingURL=dangling-reference.js.map

package/dist/lint/rules/dangling-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dangling-reference.js","sourceRoot":"","sources":["../../../src/lint/rules/dangling-reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOrD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAO,GAA6B,EAAE;IACtE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC;IAC7C,OAAO;QACL,EAAE,EAAE,oBAAoB;QACxB,WAAW,EAAE,0CAA0C;QACvD,KAAK,EAAE,MAAM;QACb,KAAK,CAAC,KAAK;YACT,MAAM,QAAQ,GAAkB,EAAE,CAAC;YACnC,KAAK,MAAM,SAAS,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtD,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;oBAC3C,SAAS;gBACX,CAAC;gBACD,MAAM,KAAK,GACT,SAAS,CAAC,SAAS,KAAK,SAAS;oBAC/B,CAAC,CAAC,SAAS,SAAS,CAAC,SAAS,KAAK,SAAS,CAAC,IAAI,GAAG;oBACpD,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;gBACrB,MAAM,OAAO,GAAgB;oBAC3B,MAAM,EAAE,oBAAoB;oBAC5B,QAAQ;oBACR,OAAO,EAAE,gBAAgB,SAAS,CAAC,WAAW,kCAAkC,SAAS,CAAC,EAAE,SAAS,KAAK,EAAE;oBAC5G,UAAU,EAAE,SAAS,CAAC,EAAE;iBACzB,CAAC;gBACF,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;oBACtC,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;gBAC1C,CAAC;gBACD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lint/rules/dead-rule.d.ts

@@ -0,0 +1,21 @@
+import type { LintRule, Severity } from "../types.js";
+export interface DeadRuleOptions {
+    severity?: Severity;
+}
+/**
+ * `dead-rule` (book): catch rules that statically cannot do what they say.
+ * For each rule it flags a `replace` whose source is never present, an `add` of
+ * an already-present id, and an `order` naming an id that can never appear.
+ *
+ * `when` is taken into account: a prior rule only shapes the present-set a later
+ * rule sees if it is *guaranteed to co-fire* — i.e. its `when` is implied by the
+ * later rule's `when`. This keeps mutually-exclusive single-axis swaps (e.g.
+ * `tone=a|b|c` each replacing the same base fragment) from reading as dead,
+ * while still catching a replace whose source was unconditionally consumed by an
+ * earlier rule.
+ *
+ * v0 limitation: still a static check. "A rule that never fires under any
+ * context" (which requires enumerating contexts) remains out of scope.
+ */
+export declare function deadRule(options?: DeadRuleOptions): LintRule;
+//# sourceMappingURL=dead-rule.d.ts.map

package/dist/lint/rules/dead-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-rule.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/dead-rule.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAe,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,QAAQ,CA6DhE"}

package/dist/lint/rules/dead-rule.js

@@ -0,0 +1,135 @@
+import { valuesEqual } from "../../resolve-book.js";
+/**
+ * `dead-rule` (book): catch rules that statically cannot do what they say.
+ * For each rule it flags a `replace` whose source is never present, an `add` of
+ * an already-present id, and an `order` naming an id that can never appear.
+ *
+ * `when` is taken into account: a prior rule only shapes the present-set a later
+ * rule sees if it is *guaranteed to co-fire* — i.e. its `when` is implied by the
+ * later rule's `when`. This keeps mutually-exclusive single-axis swaps (e.g.
+ * `tone=a|b|c` each replacing the same base fragment) from reading as dead,
+ * while still catching a replace whose source was unconditionally consumed by an
+ * earlier rule.
+ *
+ * v0 limitation: still a static check. "A rule that never fires under any
+ * context" (which requires enumerating contexts) remains out of scope.
+ */
+export function deadRule(options = {}) {
+    const severity = options.severity ?? "warning";
+    return {
+        id: "dead-rule",
+        description: "Rules should affect fragments that can be present (static check).",
+        scope: "book",
+        check(input) {
+            const findings = [];
+            for (const composition of input.book.compositions.values()) {
+                const everPresent = everPresentSet(composition);
+                composition.rules.forEach((rule, position) => {
+                    const present = presentSetFor(composition.base, composition.rules, position, rule.when);
+                    switch (rule.action) {
+                        case "add":
+                            for (const id of rule.add ?? []) {
+                                if (present.has(id)) {
+                                    findings.push({
+                                        ruleId: "dead-rule",
+                                        severity,
+                                        message: `rule #${rule.index} in "${composition.name}" adds "${id}", which is already present`,
+                                        fragmentId: id,
+                                        ruleIndex: rule.index,
+                                    });
+                                }
+                            }
+                            break;
+                        case "replace":
+                            for (const from of Object.keys(rule.replace ?? {})) {
+                                if (!present.has(from)) {
+                                    findings.push({
+                                        ruleId: "dead-rule",
+                                        severity,
+                                        message: `rule #${rule.index} in "${composition.name}" replaces "${from}", which is never present`,
+                                        fragmentId: from,
+                                        ruleIndex: rule.index,
+                                    });
+                                }
+                            }
+                            break;
+                        case "order":
+                            for (const id of rule.order ?? []) {
+                                if (!everPresent.has(id)) {
+                                    findings.push({
+                                        ruleId: "dead-rule",
+                                        severity,
+                                        message: `rule #${rule.index} in "${composition.name}" orders unknown id "${id}"`,
+                                        fragmentId: id,
+                                        ruleIndex: rule.index,
+                                    });
+                                }
+                            }
+                            break;
+                        case "forbid":
+                            // `forbid` does not feed the static present-set in v0.
+                            break;
+                    }
+                });
+            }
+            return findings;
+        },
+    };
+}
+/**
+ * The present-set a rule sees: `base` mutated by every earlier rule that is
+ * guaranteed to co-fire (its `when` is implied by this rule's `when`).
+ */
+function presentSetFor(base, rules, position, currentWhen) {
+    const present = new Set(base);
+    for (let i = 0; i < position; i++) {
+        const prior = rules[i];
+        if (!prior || !firesWhenever(prior.when, currentWhen)) {
+            continue;
+        }
+        if (prior.action === "add") {
+            for (const id of prior.add ?? []) {
+                present.add(id);
+            }
+        }
+        else if (prior.action === "replace") {
+            for (const [from, to] of Object.entries(prior.replace ?? {})) {
+                if (present.has(from)) {
+                    present.delete(from);
+                    present.add(to);
+                }
+            }
+        }
+    }
+    return present;
+}
+/** Every id that can ever appear: base plus all add ids and all replace targets. */
+function everPresentSet(composition) {
+    const present = new Set(composition.base);
+    for (const rule of composition.rules) {
+        if (rule.action === "add") {
+            for (const id of rule.add ?? []) {
+                present.add(id);
+            }
+        }
+        else if (rule.action === "replace") {
+            for (const to of Object.values(rule.replace ?? {})) {
+                present.add(to);
+            }
+        }
+    }
+    return present;
+}
+/** True if `prior` fires in every context where `current` fires — i.e. every
+ * constraint in `prior` is also required (same value) by `current`. An empty
+ * `prior` (unconditional) always co-fires. */
+function firesWhenever(prior, current) {
+    for (const [key, value] of Object.entries(prior)) {
+        const actual = current[key];
+        if (actual === undefined || !valuesEqual(actual, value)) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=dead-rule.js.map

package/dist/lint/rules/dead-rule.js.map

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

package/dist/lint/rules/example-balance.d.ts

@@ -0,0 +1,19 @@
+import type { LintRule, Severity } from "../types.js";
+export interface ExampleBalanceOptions {
+    /** Fragment `kind` treated as an example. */
+    kind?: string;
+    /** Tag prefix that groups examples, e.g. "case:". */
+    groupTagPrefix?: string;
+    /** Maximum allowed difference between the largest and smallest group. */
+    maxSkew?: number;
+    severity?: Severity;
+}
+/**
+ * `example-balance` (resolved): few-shot examples (fragments of the configured
+ * kind) are grouped by their `groupTagPrefix` tag (e.g. `case:positive`). When
+ * the largest group exceeds the smallest by more than `maxSkew`, attention is
+ * skewed and a finding is raised. Examples without a group tag are ignored, so
+ * the rule only compares groups that actually have examples.
+ */
+export declare function exampleBalance(options?: ExampleBalanceOptions): LintRule;
+//# sourceMappingURL=example-balance.d.ts.map

package/dist/lint/rules/example-balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-balance.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/example-balance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,QAAQ,CAgD5E"}

package/dist/lint/rules/example-balance.js

@@ -0,0 +1,57 @@
+/**
+ * `example-balance` (resolved): few-shot examples (fragments of the configured
+ * kind) are grouped by their `groupTagPrefix` tag (e.g. `case:positive`). When
+ * the largest group exceeds the smallest by more than `maxSkew`, attention is
+ * skewed and a finding is raised. Examples without a group tag are ignored, so
+ * the rule only compares groups that actually have examples.
+ */
+export function exampleBalance(options = {}) {
+    const kind = options.kind ?? "example";
+    const groupTagPrefix = options.groupTagPrefix ?? "case:";
+    const maxSkew = options.maxSkew ?? 1;
+    const severity = options.severity ?? "warning";
+    return {
+        id: "example-balance",
+        description: `Example groups (kind "${kind}", tag "${groupTagPrefix}*") should differ by at most ${maxSkew}.`,
+        scope: "resolved",
+        check(input) {
+            const result = input.result;
+            if (result === undefined) {
+                return [];
+            }
+            const counts = new Map();
+            for (const id of result.trace.finalOrder) {
+                const fragment = input.book.fragments.get(id);
+                if (fragment?.kind !== kind) {
+                    continue;
+                }
+                for (const tag of fragment.tags ?? []) {
+                    if (tag.startsWith(groupTagPrefix)) {
+                        counts.set(tag, (counts.get(tag) ?? 0) + 1);
+                    }
+                }
+            }
+            if (counts.size < 2) {
+                return [];
+            }
+            const values = [...counts.values()];
+            const max = Math.max(...values);
+            const min = Math.min(...values);
+            if (max - min <= maxSkew) {
+                return [];
+            }
+            const summary = [...counts.entries()]
+                .sort(([a], [b]) => a.localeCompare(b))
+                .map(([group, count]) => `${group}=${count}`)
+                .join(", ");
+            return [
+                {
+                    ruleId: "example-balance",
+                    severity,
+                    message: `example groups are imbalanced (${summary}); skew ${max - min} exceeds ${maxSkew}`,
+                },
+            ];
+        },
+    };
+}
+//# sourceMappingURL=example-balance.js.map

package/dist/lint/rules/example-balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-balance.js","sourceRoot":"","sources":["../../../src/lint/rules/example-balance.ts"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAO,GAA0B,EAAE;IAChE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;IACvC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC;IACzD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC;IAC/C,OAAO;QACL,EAAE,EAAE,iBAAiB;QACrB,WAAW,EAAE,yBAAyB,IAAI,WAAW,cAAc,gCAAgC,OAAO,GAAG;QAC7G,KAAK,EAAE,UAAU;QACjB,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC5B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;YACzC,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;gBACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC9C,IAAI,QAAQ,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;oBAC5B,SAAS;gBACX,CAAC;gBACD,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;oBACtC,IAAI,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;wBACnC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC9C,CAAC;gBACH,CAAC;YACH,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACpB,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;YAChC,IAAI,GAAG,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC;gBACzB,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;iBAClC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;iBACtC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC;iBAC5C,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,OAAO;gBACL;oBACE,MAAM,EAAE,iBAAiB;oBACzB,QAAQ;oBACR,OAAO,EAAE,kCAAkC,OAAO,WAAW,GAAG,GAAG,GAAG,YAAY,OAAO,EAAE;iBAC5F;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lint/rules/index.d.ts

@@ -0,0 +1,28 @@
+import type { LintRule } from "../types.js";
+/** Options surfaced through {@link defaultRules}; per-rule factories take more. */
+export interface DefaultRulesOptions {
+    /** Override the token-budget ceiling. */
+    maxTokens?: number;
+    /** Override the banned-tokens list. */
+    bannedTokens?: (string | RegExp)[];
+}
+/**
+ * The built-in rule set, instantiated with optional overrides. Callers can
+ * also build their own array and pass it to `lint` to swap the set entirely.
+ */
+export declare function defaultRules(options?: DefaultRulesOptions): LintRule[];
+export type { BannedTokensOptions } from "./banned-tokens.js";
+export { bannedTokens } from "./banned-tokens.js";
+export type { DanglingReferenceOptions } from "./dangling-reference.js";
+export { danglingReference } from "./dangling-reference.js";
+export type { DeadRuleOptions } from "./dead-rule.js";
+export { deadRule } from "./dead-rule.js";
+export type { ExampleBalanceOptions } from "./example-balance.js";
+export { exampleBalance } from "./example-balance.js";
+export type { LanguageDirectivePositionOptions } from "./language-directive-position.js";
+export { languageDirectivePosition } from "./language-directive-position.js";
+export type { TokenBudgetOptions } from "./token-budget.js";
+export { estimateTokensByChars, tokenBudget } from "./token-budget.js";
+export type { UnusedFragmentOptions } from "./unused-fragment.js";
+export { unusedFragment } from "./unused-fragment.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lint/rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAS5C,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,YAAY,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,QAAQ,EAAE,CAU1E;AAED,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AACzF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/lint/rules/index.js

@@ -0,0 +1,30 @@
+import { bannedTokens } from "./banned-tokens.js";
+import { danglingReference } from "./dangling-reference.js";
+import { deadRule } from "./dead-rule.js";
+import { exampleBalance } from "./example-balance.js";
+import { languageDirectivePosition } from "./language-directive-position.js";
+import { tokenBudget } from "./token-budget.js";
+import { unusedFragment } from "./unused-fragment.js";
+/**
+ * The built-in rule set, instantiated with optional overrides. Callers can
+ * also build their own array and pass it to `lint` to swap the set entirely.
+ */
+export function defaultRules(options = {}) {
+    return [
+        tokenBudget(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),
+        languageDirectivePosition(),
+        exampleBalance(),
+        bannedTokens(options.bannedTokens !== undefined ? { tokens: options.bannedTokens } : {}),
+        unusedFragment(),
+        danglingReference(),
+        deadRule(),
+    ];
+}
+export { bannedTokens } from "./banned-tokens.js";
+export { danglingReference } from "./dangling-reference.js";
+export { deadRule } from "./dead-rule.js";
+export { exampleBalance } from "./example-balance.js";
+export { languageDirectivePosition } from "./language-directive-position.js";
+export { estimateTokensByChars, tokenBudget } from "./token-budget.js";
+export { unusedFragment } from "./unused-fragment.js";
+//# sourceMappingURL=index.js.map