agent-sanitizer 2.57.4 → 2.58.0

package/types/src/joining-type.d.mts

@@ -0,0 +1,32 @@
+/**
+ * The Unicode Joining_Type of a code point: "C", "D", "R", "L", "T", or "U"
+ * (the non-joining default) for anything not in the cursive tables.
+ * @param {number} cp
+ * @returns {string}
+ */
+export function joiningType(cp: number): string;
+/**
+ * True when `cp` is an Indic virama (the only position where a ZWNJ/ZWJ is
+ * linguistically meaningful in Brahmic scripts).
+ * @param {number} cp
+ * @returns {boolean}
+ */
+export function isVirama(cp: number): boolean;
+/**
+ * True when `cp` is a Brahmic consonant — the only base a virama attaches to,
+ * and therefore the only base after which a ZWJ/ZWNJ is a real conjunct
+ * request rather than a zero-width payload.
+ * @param {number} cp
+ * @returns {boolean}
+ */
+export function isBrahmicConsonant(cp: number): boolean;
+/**
+ * GENERATED by scripts/gen-joining-type.mjs from ucd-full@17.0.0 — DO NOT EDIT.
+ *
+ * Unicode Joining_Type, Indic virama and Brahmic consonant range tables backing
+ * the ZWNJ/ZWJ carve-out in invisible.mjs. Regenerate with `pnpm gen:joining-type`;
+ * test/joining-type.test.mjs fails if this drifts from the pinned UCD.
+ */
+export const UNICODE_VERSION: "17.0.0";
+/** @type {ReadonlyArray<readonly [string, number, number]>} */
+export const BRAHMIC_CONSONANT_RANGES: ReadonlyArray<readonly [string, number, number]>;

package/types/src/repo-scope.d.mts

@@ -0,0 +1,58 @@
+/**
+ * The linked worktrees in a `git worktree list --porcelain -z` dump, main and
+ * bare ones excluded — those are not removable, so their state is never at risk
+ * from a teardown command, and the main one is the scan root a prune must never
+ * swallow.
+ * @param {string} porcelain
+ * @returns {string[]} absolute worktree paths
+ */
+export function parseWorktreeList(porcelain: string): string[];
+/**
+ * The linked worktrees of the repo at `cwd`. The guard on `git worktree remove`
+ * asks this the same way the prune below does, so one parser answers for both.
+ * @param {string} cwd
+ * @param {GitRun} run
+ * @returns {string[]} absolute worktree paths
+ */
+export function linkedWorktrees(cwd: string, run: GitRun): string[];
+/**
+ * Directory paths a context scan of `dir` must not walk, relative to it and
+ * `/`-separated: every wholly-ignored directory (unless `ignoredDirs` is off)
+ * and every linked worktree nested inside it.
+ * @param {string} dir
+ * @param {{ ignoredDirs?: boolean, run?: GitRun }} [options]
+ * @returns {Set<string>}
+ */
+export function repoPrunedDirs(dir: string, { ignoredDirs, run }?: {
+    ignoredDirs?: boolean;
+    run?: GitRun;
+}): Set<string>;
+/**
+ * The `exclude` predicate for an instruction-file walk of `dir`: the static
+ * context-scope prune, plus {@link repoPrunedDirs}.
+ *
+ * `ignoredDirs: false` is the LAUNCH scan's posture, and it is a security
+ * choice rather than a performance one: `.gitignore` is repo-controlled, so
+ * honouring it in the one scan that covers launch-time ingress would let a
+ * hostile repo hide a planted `.claude/skills/…/SKILL.md` from it by ignoring
+ * that directory. The whole-tree scan can honour it because anything it prunes
+ * is still scanned by scan-loaded-instructions at the moment the host loads it.
+ *
+ * The lookup is EXACT, so the walk must hand it the same spelling
+ * {@link repoPrunedDirs} uses — one root-relative, `/`-separated path per entry,
+ * which is what walkContextGlobs normalizes to. A predicate that accepted a bare
+ * name as well would prune a tracked `src/build/` for a top-level ignored
+ * `build/`, splicing real instruction files out of the scan.
+ * @param {string} dir
+ * @param {{ ignoredDirs?: boolean, run?: GitRun }} [options]
+ * @returns {(entry: string) => boolean}
+ */
+export function contextScanExclude(dir: string, options?: {
+    ignoredDirs?: boolean;
+    run?: GitRun;
+}): (entry: string) => boolean;
+/**
+ * How git is asked. Injectable so a test can drive the failure paths, which no
+ * filesystem state can force.
+ */
+export type GitRun = (file: string, args: string[], cwd: string) => string;

package/types/src/standardized-variants.d.mts

@@ -0,0 +1,22 @@
+/**
+ * True when `base` followed by `selector` (a U+FE00–U+FE0D code point) is a
+ * registered standardized variation sequence.
+ * @param {number} base
+ * @param {number} selector
+ * @returns {boolean}
+ */
+export function isStandardizedVariant(base: number, selector: number): boolean;
+/**
+ * GENERATED by scripts/gen-standardized-variants.mjs from UCD
+ * StandardizedVariants.txt (Unicode 17.0.0) — DO NOT EDIT.
+ *
+ * Registered standardized variation sequences: a base code point followed by a
+ * variation selector in U+FE00–U+FE0D. invisible.mjs preserves such a selector
+ * only when the immediately preceding base appears here; every other FE00–FE0D
+ * selector is stripped as a hidden-payload byte. Regenerate with
+ * `node scripts/gen-standardized-variants.mjs`; test/invisible-charset.test.mjs
+ * fails if this drifts from the pinned UCD slice.
+ */
+export const UNICODE_VERSION: "17.0.0";
+/** @type {Array<[number, number]>} [base, selector], sorted by base then selector. */
+export const STANDARDIZED_VARIANTS: Array<[number, number]>;