@geonosis/oxlint-plugin-biological-architecture 3.1.0 → 3.3.0

package/dist/rules/lib/colors.js

@@ -1,257 +1,24 @@
 // src/rules/lib/colors.ts
-var FUNCTIONS = [
-  "color",
-  "color-mix",
-  "hsl",
-  "hsla",
-  "hwb",
-  "lab",
-  "lch",
-  "oklab",
-  "oklch",
-  "rgb",
-  "rgba"
-];
+var words = (list) => new Set(list.split(" "));
 var HEX = /^#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/i;
-var FUNCTION_CALL = new RegExp(`\\b(?:${FUNCTIONS.join("|")})\\(`, "i");
+var FUNCTION_NAMES = "color|color-mix|hsl|hsla|hwb|lab|lch|oklab|oklch|rgb|rgba";
+var FUNCTION_CALL = new RegExp(`\\b(?:${FUNCTION_NAMES})\\(`, "i");
+var FUNCTION_START = new RegExp(`^(?:${FUNCTION_NAMES})\\(`, "i");
 var HEX_ANYWHERE = /(?:^|[\s(,])#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})\b/i;
-var NAMED = new Set([
-  "aliceblue",
-  "antiquewhite",
-  "aqua",
-  "aquamarine",
-  "azure",
-  "beige",
-  "bisque",
-  "black",
-  "blanchedalmond",
-  "blue",
-  "blueviolet",
-  "brown",
-  "burlywood",
-  "cadetblue",
-  "chartreuse",
-  "chocolate",
-  "coral",
-  "cornflowerblue",
-  "cornsilk",
-  "crimson",
-  "cyan",
-  "darkblue",
-  "darkcyan",
-  "darkgoldenrod",
-  "darkgray",
-  "darkgreen",
-  "darkgrey",
-  "darkkhaki",
-  "darkmagenta",
-  "darkolivegreen",
-  "darkorange",
-  "darkorchid",
-  "darkred",
-  "darksalmon",
-  "darkseagreen",
-  "darkslateblue",
-  "darkslategray",
-  "darkslategrey",
-  "darkturquoise",
-  "darkviolet",
-  "deeppink",
-  "deepskyblue",
-  "dimgray",
-  "dimgrey",
-  "dodgerblue",
-  "firebrick",
-  "floralwhite",
-  "forestgreen",
-  "fuchsia",
-  "gainsboro",
-  "ghostwhite",
-  "gold",
-  "goldenrod",
-  "gray",
-  "green",
-  "greenyellow",
-  "grey",
-  "honeydew",
-  "hotpink",
-  "indianred",
-  "indigo",
-  "ivory",
-  "khaki",
-  "lavender",
-  "lavenderblush",
-  "lawngreen",
-  "lemonchiffon",
-  "lightblue",
-  "lightcoral",
-  "lightcyan",
-  "lightgoldenrodyellow",
-  "lightgray",
-  "lightgreen",
-  "lightgrey",
-  "lightpink",
-  "lightsalmon",
-  "lightseagreen",
-  "lightskyblue",
-  "lightslategray",
-  "lightslategrey",
-  "lightsteelblue",
-  "lightyellow",
-  "lime",
-  "limegreen",
-  "linen",
-  "magenta",
-  "maroon",
-  "mediumaquamarine",
-  "mediumblue",
-  "mediumorchid",
-  "mediumpurple",
-  "mediumseagreen",
-  "mediumslateblue",
-  "mediumspringgreen",
-  "mediumturquoise",
-  "mediumvioletred",
-  "midnightblue",
-  "mintcream",
-  "mistyrose",
-  "moccasin",
-  "navajowhite",
-  "navy",
-  "oldlace",
-  "olive",
-  "olivedrab",
-  "orange",
-  "orangered",
-  "orchid",
-  "palegoldenrod",
-  "palegreen",
-  "paleturquoise",
-  "palevioletred",
-  "papayawhip",
-  "peachpuff",
-  "peru",
-  "pink",
-  "plum",
-  "powderblue",
-  "purple",
-  "rebeccapurple",
-  "red",
-  "rosybrown",
-  "royalblue",
-  "saddlebrown",
-  "salmon",
-  "sandybrown",
-  "seagreen",
-  "seashell",
-  "sienna",
-  "silver",
-  "skyblue",
-  "slateblue",
-  "slategray",
-  "slategrey",
-  "snow",
-  "springgreen",
-  "steelblue",
-  "tan",
-  "teal",
-  "thistle",
-  "tomato",
-  "turquoise",
-  "violet",
-  "wheat",
-  "white",
-  "whitesmoke",
-  "yellow",
-  "yellowgreen"
-]);
+var NAMED = words("aliceblue antiquewhite aqua aquamarine azure beige bisque black blanchedalmond blue blueviolet brown burlywood cadetblue chartreuse chocolate coral cornflowerblue cornsilk crimson cyan darkblue darkcyan darkgoldenrod darkgray darkgreen darkgrey darkkhaki darkmagenta darkolivegreen darkorange darkorchid darkred darksalmon darkseagreen darkslateblue darkslategray darkslategrey darkturquoise darkviolet deeppink deepskyblue dimgray dimgrey dodgerblue firebrick floralwhite forestgreen fuchsia gainsboro ghostwhite gold goldenrod gray green greenyellow grey honeydew hotpink indianred indigo ivory khaki lavender lavenderblush lawngreen lemonchiffon lightblue lightcoral lightcyan lightgoldenrodyellow lightgray lightgreen lightgrey lightpink lightsalmon lightseagreen lightskyblue lightslategray lightslategrey lightsteelblue lightyellow lime limegreen linen magenta maroon mediumaquamarine mediumblue mediumorchid mediumpurple mediumseagreen mediumslateblue mediumspringgreen mediumturquoise mediumvioletred midnightblue mintcream mistyrose moccasin navajowhite navy oldlace olive olivedrab orange orangered orchid palegoldenrod palegreen paleturquoise palevioletred papayawhip peachpuff peru pink plum powderblue purple rebeccapurple red rosybrown royalblue saddlebrown salmon sandybrown seagreen seashell sienna silver skyblue slateblue slategray slategrey snow springgreen steelblue tan teal thistle tomato turquoise violet wheat white whitesmoke yellow yellowgreen");
 var isColorLiteral = (value) => {
   const trimmed = value.trim();
   if (trimmed === "")
     return false;
-  if (HEX.test(trimmed))
-    return true;
-  if (NAMED.has(trimmed.toLowerCase()))
-    return true;
-  return new RegExp(`^(?:${FUNCTIONS.join("|")})\\(`, "i").test(trimmed);
+  return HEX.test(trimmed) || NAMED.has(trimmed.toLowerCase()) || FUNCTION_START.test(trimmed);
 };
 var containsColorLiteral = (value) => HEX_ANYWHERE.test(value) || FUNCTION_CALL.test(value);
-var COLOR_PROPERTIES = new Set([
-  "accentColor",
-  "backgroundColor",
-  "borderBlockColor",
-  "borderBlockEndColor",
-  "borderBlockStartColor",
-  "borderBottomColor",
-  "borderColor",
-  "borderInlineColor",
-  "borderInlineEndColor",
-  "borderInlineStartColor",
-  "borderLeftColor",
-  "borderRightColor",
-  "borderTopColor",
-  "caretColor",
-  "color",
-  "columnRuleColor",
-  "fill",
-  "floodColor",
-  "lightingColor",
-  "outlineColor",
-  "stopColor",
-  "stroke",
-  "textDecorationColor",
-  "textEmphasisColor",
-  "WebkitTextFillColor",
-  "WebkitTextStrokeColor",
-  "webkitTextFillColor",
-  "webkitTextStrokeColor"
-]);
-var COLOR_SHORTHANDS = new Set([
-  "background",
-  "border",
-  "borderBottom",
-  "borderLeft",
-  "borderRight",
-  "borderTop",
-  "boxShadow",
-  "columnRule",
-  "filter",
-  "outline",
-  "textDecoration",
-  "textShadow"
-]);
+var COLOR_PROPERTIES = words("accentColor backgroundColor borderBlockColor borderBlockEndColor borderBlockStartColor borderBottomColor borderColor borderInlineColor borderInlineEndColor borderInlineStartColor borderLeftColor borderRightColor borderTopColor caretColor color columnRuleColor fill floodColor lightingColor outlineColor stopColor stroke textDecorationColor textEmphasisColor WebkitTextFillColor WebkitTextStrokeColor webkitTextFillColor webkitTextStrokeColor");
+var COLOR_SHORTHANDS = words("background border borderBottom borderLeft borderRight borderTop boxShadow columnRule filter outline textDecoration textShadow");
 var isColorProperty = (property) => COLOR_PROPERTIES.has(property);
 var isColorShorthand = (property) => COLOR_SHORTHANDS.has(property);
-var COLOR_UTILITIES = new Set([
-  "accent",
-  "bg",
-  "border",
-  "border-b",
-  "border-e",
-  "border-l",
-  "border-r",
-  "border-s",
-  "border-t",
-  "border-x",
-  "border-y",
-  "caret",
-  "decoration",
-  "divide",
-  "fill",
-  "from",
-  "inset-ring",
-  "inset-shadow",
-  "outline",
-  "placeholder",
-  "ring",
-  "ring-offset",
-  "shadow",
-  "stroke",
-  "text",
-  "to",
-  "via"
-]);
-var isColorUtility = (utility) => COLOR_UTILITIES.has(utility.replace(/^.*:/, ""));
+var COLOR_UTILITIES = words("accent bg border border-b border-e border-l border-r border-s border-t border-x border-y caret decoration divide fill from inset-ring inset-shadow outline placeholder ring ring-offset shadow stroke text to via");
+var isColorUtility = (utility) => COLOR_UTILITIES.has(utility);
 export {
   containsColorLiteral,
   isColorLiteral,

package/dist/rules/lib/comments.d.ts

@@ -0,0 +1,19 @@
+export type Comment = {
+    loc: {
+        end: {
+            line: number;
+        };
+        start: {
+            line: number;
+        };
+    };
+    type: string;
+    value: string;
+};
+export type SourceCode = {
+    ast?: {
+        comments?: Comment[];
+    };
+    getAllComments?: () => Comment[];
+};
+export declare const commentsOf: (sourceCode: SourceCode | undefined) => Comment[];

package/dist/rules/lib/comments.js

@@ -0,0 +1,5 @@
+// src/rules/lib/comments.ts
+var commentsOf = (sourceCode) => sourceCode?.getAllComments?.() ?? sourceCode?.ast?.comments ?? [];
+export {
+  commentsOf
+};

package/dist/rules/lib/context.d.ts

@@ -1,11 +1,3 @@
-/**
- * The `create(context)` parameter every rule hand-typed for itself.
- *
- * Fifty-six rules wrote out `{ filename: string; report: (descriptor: { data, messageId, node }) =>
- * void }` themselves — sometimes with the descriptor's fields in a different order, sometimes with
- * the parameter named `d` instead of `descriptor` — because oxlint's plugin API hands `create` a
- * plain object and names nothing a rule can import. One shape, named once.
- */
 type ReportDescriptor = {
     data: Record<string, string>;
     messageId: string;
@@ -15,11 +7,9 @@ export type RuleContext = {
     filename: string;
     report: (descriptor: ReportDescriptor) => void;
 };
-/** A rule whose schema is read, so oxlint hands it whatever the config named for it. */
 export type RuleContextWithOptions<Options> = RuleContext & {
     options?: [Options?];
 };
-/** A rule that reads its own options bag through `bagOf`, rather than a typed positional tuple. */
 export type RuleContextWithRawOptions = RuleContext & {
     options: readonly unknown[];
 };

package/dist/rules/lib/direction-rule.d.ts

@@ -1,42 +1,24 @@
+import { type Probe, type ProbeTree } from './probe.js';
 import { type Tier } from './tiers.js';
 import { type Visitor } from './visitors.js';
-/**
- * Ten of this plugin's rules said the same sentence: files HERE may not import things THERE. Each
- * one wrote its own scope test, its own source parse, its own visitor set and its own loop, and the
- * differences between them were not decisions — they were the order the rules happened to be
- * written in. One rule watched three node types and its neighbour four; one resolved a relative
- * source and its neighbour was blind to it; two counted type-only imports and the rest did not.
- *
- * So a direction rule is DATA now: which files it polices, which targets are forbidden, and what it
- * says. Everything mechanical — reading the filename, reading the source, which doors to watch —
- * happens once, here, where a fix reaches all ten.
- */
-/** A file or an import source, said in the terms a direction rule judges by. */
 type Classified = {
-    /** The last segment, as a diagnostic names it. */
     file: string;
-    /** The feature it belongs to, if the layout has features. */
     feature: string | undefined;
-    /** The path it is at — normalised, and for a relative source, resolved against the importer. */
     path: string;
-    /** The source exactly as it was written, for the message and for a rule that matches on it. */
     source: string;
-    /** The tier it sits in, if any. */
     tier: Tier | undefined;
 };
 export declare const classify: (path: string, source?: string) => Classified;
 type Declaration<Options> = {
-    /** The message data, when `{ file, source }` is not what the message names. */
     data?: (target: Classified, importer: Classified) => Record<string, string>;
     description: string;
     fixShape: string;
-    /** True when this import is a breach. */
     forbidden: (target: Classified, importer: Classified, options: Options) => boolean;
-    /** The id of the message reported; the only one, unless the declaration says otherwise. */
+    mayForbid?: (source: string) => boolean;
     messageId?: string;
+    probe?: (options: readonly unknown[]) => Probe | ProbeTree;
     messages: Record<string, string>;
     optionsFrom?: (raw: unknown) => Options;
-    /** Which files the rule polices: a tier, or a predicate for a scope no tier name describes. */
     scope: Tier | ((importer: Classified) => boolean);
     schema?: unknown[];
     typeOnly?: 'skip' | 'visit';
@@ -53,6 +35,7 @@ type Context = {
 export declare const directionRule: <Options = undefined>(declaration: Declaration<Options>) => {
     create(context: Context): Visitor;
     fixShape: string;
+    probe?: ((options: readonly unknown[]) => Probe | ProbeTree) | undefined;
     meta: {
         docs: {
             description: string;

package/dist/rules/lib/direction-rule.js

@@ -3,6 +3,7 @@ import { dirname, relative } from "node:path";
 import { resolveRelative } from "./imports.js";
 import { exportedNamesOf, landingsOf, namesATierFolder, rootOf } from "./landing.js";
 import { propertyNameOf } from "./nodes.js";
+import { destructuredNamesOf, withoutTypes } from "./objects.js";
 import { fileOf, normalise } from "./paths.js";
 import { featureOf, inTier, tierOf } from "./tiers.js";
 import { onImportSource } from "./visitors.js";
@@ -13,7 +14,6 @@ var classify = (path, source = path) => ({
   source,
   tier: tierOf(path)
 });
-var FORBIDDEN = "forbidden";
 var placeAndSource = (target, importer) => ({
   file: importer.file,
   source: target.source
@@ -30,7 +30,7 @@ var namespaceBoundBy = (node) => {
   return typeof local === "string" ? local : undefined;
 };
 var WHOLE = "whole";
-var targetsOf = (filename, importer, source, taken) => {
+var targetsFor = (filename, importer, source, taken) => {
   const spelled = classify(resolveRelative(importer.path, source), source);
   const door = landingsOf(filename, source, []).door;
   const landed = landingsOf(filename, source, taken === WHOLE ? door === undefined ? [] : [...exportedNamesOf(door)] : taken);
@@ -48,10 +48,20 @@ var targetsOf = (filename, importer, source, taken) => {
   targets.push(classify(judged(landed.door), source));
   return targets;
 };
+var targetsMemo = new Map;
+var targetsOf = (filename, importer, source, taken) => {
+  const key = `${filename}\x00${source}\x00${taken === WHOLE ? WHOLE : taken.join("\x00")}`;
+  const known = targetsMemo.get(key);
+  if (known !== undefined)
+    return known;
+  const found = targetsFor(filename, importer, source, taken);
+  targetsMemo.set(key, found);
+  return found;
+};
 var directionRule = (declaration) => {
   const {
     data = placeAndSource,
-    messageId = FORBIDDEN,
+    messageId = "forbidden",
     optionsFrom,
     scope,
     typeOnly = "skip"
@@ -64,6 +74,8 @@ var directionRule = (declaration) => {
       if (!inScope(importer))
         return {};
       const judge = (source, node, taken) => {
+        if (declaration.mayForbid?.(source) === false)
+          return;
         const target = targetsOf(context.filename, importer, source, taken).find((one) => declaration.forbidden(one, importer, options));
         if (target === undefined)
           return;
@@ -89,7 +101,8 @@ var directionRule = (declaration) => {
         reachedThrough.set(local, reached);
         namespaces.push({ node, reached, source });
       }, { typeOnly });
-      const whole = onImportSource((source, node) => judge(source, node, WHOLE), { typeOnly });
+      const destructured = new WeakMap;
+      const whole = onImportSource((source, node) => judge(source, node, destructured.get(node) ?? WHOLE), { typeOnly });
       return {
         CallExpression: whole.CallExpression,
         ExportAllDeclaration: whole.ExportAllDeclaration,
@@ -103,6 +116,13 @@ var directionRule = (declaration) => {
         MemberExpression(node) {
           reach(node.object, propertyNameOf(node));
         },
+        VariableDeclarator(node) {
+          const names = destructuredNamesOf(node.id);
+          const init = withoutTypes(node.init);
+          const call = init?.type === "AwaitExpression" ? withoutTypes(init.argument) : init;
+          if (names !== null && call !== undefined)
+            destructured.set(call, names);
+        },
         "Program:exit"() {
           for (const { node, reached, source } of namespaces) {
             judge(source, node, reached.size === 0 ? WHOLE : [...reached]);
@@ -111,6 +131,7 @@ var directionRule = (declaration) => {
       };
     },
     fixShape: declaration.fixShape,
+    ...declaration.probe === undefined ? {} : { probe: declaration.probe },
     meta: {
       docs: { description: declaration.description },
       messages: declaration.messages,

package/dist/rules/lib/doors.d.ts

@@ -1,26 +1,10 @@
-/**
- * A package's doors, read off its own `package.json` `exports`: each subpath, and the names the
- * file behind it exports — the map `subpath-over-barrel` needs, which one consumer kept by hand.
- *
- * Read with the same regexes three rules already read a re-export shim with, never a parser: a
- * door's entry is `export … from` lines and declarations, and `export *` is followed inside the
- * package to a small fixed depth. A door written as a pattern (`./icons/*`) names no file to read
- * and is left out; a name two doors both export is placed under neither, because the rule could
- * not tell a reader which one to open.
- */
 export type Doors = {
     name: string;
-    /** exported name → the door (subpath, no `./`) it lives under */ homes: Map<string, string>;
+    homes: Map<string, string>;
 };
-/** The doors a manifest declares, each with the names behind it. */
 export declare const doorsOf: (manifestPath: string) => Doors | undefined;
-/**
- * Where a bare specifier resolves from a file: the nearest `node_modules/<name>/package.json`
- * walking up. `own` says whether it is the repo's: linked in from outside any `node_modules` (a
- * workspace link — pnpm links a dependency too, but into its store's `node_modules/<name>`) or
- * private (npm refuses to publish one, so under `node_modules` it is the repo's).
- */
 export declare const resolvePackage: (from: string, name: string) => {
     manifest: string;
     own: boolean;
 } | undefined;
+export declare const nodeModulesAbove: (from: string) => boolean;

package/dist/rules/lib/doors.js

@@ -1,48 +1,56 @@
 // src/rules/lib/doors.ts
-import { existsSync, lstatSync, readFileSync, realpathSync } from "node:fs";
+import { existsSync, lstatSync, readdirSync, realpathSync } from "node:fs";
 import { dirname, join } from "node:path";
-import { conditionTargetOf, exportTableOf, fileFor } from "./module-text.js";
-var DEPTH = 8;
-var exportsOf = (file, seen, depth) => {
-  if (depth > DEPTH || seen.has(file))
-    return [];
-  seen.add(file);
-  const table = exportTableOf(file);
-  if (table === undefined)
+import { remembered } from "./fresh.js";
+import { exportedNamesOf } from "./landing.js";
+import { conditionTargetOf, fileFor, readManifest, recordOf } from "./module-text.js";
+import { workspaceMemberNamed } from "./workspace-members.js";
+var LISTED_FILES = 4000;
+var filesBelow = (dir, budget) => {
+  let entries;
+  try {
+    entries = readdirSync(dir, { withFileTypes: true });
+  } catch {
     return [];
-  const names = [...table.declared, ...table.reexports.keys()];
-  for (const star of table.stars) {
-    const next = fileFor(file, star);
-    if (next !== undefined)
-      names.push(...exportsOf(next, seen, depth + 1));
   }
-  return names.filter((one) => one !== "default");
+  return entries.flatMap((entry) => {
+    if (budget.left <= 0 || entry.name === "node_modules")
+      return [];
+    if (entry.isDirectory()) {
+      return filesBelow(join(dir, entry.name), budget).map((one) => `${entry.name}/${one}`);
+    }
+    budget.left -= 1;
+    return [entry.name];
+  });
+};
+var expanded = (dir, key, target) => {
+  const star = target.indexOf("*");
+  const before = target.slice(0, star);
+  const suffix = target.slice(star + 1);
+  const folder = before.slice(0, before.lastIndexOf("/") + 1);
+  const stem = before.slice(folder.length);
+  return filesBelow(join(dir, folder), { left: LISTED_FILES }).flatMap((relative) => {
+    if (!relative.startsWith(stem) || !relative.endsWith(suffix))
+      return [];
+    const matched = relative.slice(stem.length, relative.length - suffix.length);
+    return matched === "" ? [] : [[key.replace("*", matched).slice(2), `${folder}${relative}`]];
+  });
 };
 var doorsOf = (manifestPath) => {
-  let manifest;
-  try {
-    manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
-  } catch {
-    return;
-  }
-  if (typeof manifest.name !== "string")
-    return;
-  if (typeof manifest.exports !== "object" || manifest.exports === null)
+  const manifest = readManifest(manifestPath);
+  const exported = recordOf(manifest?.exports);
+  if (typeof manifest?.name !== "string" || exported === undefined)
     return;
   const dir = dirname(manifestPath);
   const placed = new Map;
   const contested = new Set;
-  for (const [key, value] of Object.entries(manifest.exports)) {
-    if (key === "." || !key.startsWith("./") || key.includes("*"))
-      continue;
-    const target = conditionTargetOf(value);
-    if (target === undefined)
-      continue;
+  const place = (door, target) => {
     const entry = fileFor(join(dir, "package.json"), target);
     if (entry === undefined)
-      continue;
-    const door = key.slice(2);
-    for (const name of new Set(exportsOf(entry, new Set, 0))) {
+      return;
+    for (const name of exportedNamesOf(entry)) {
+      if (name === "default")
+        continue;
       if (contested.has(name))
         continue;
       const already = placed.get(name);
@@ -53,10 +61,26 @@ var doorsOf = (manifestPath) => {
       }
       placed.set(name, door);
     }
+  };
+  for (const [key, value] of Object.entries(exported)) {
+    if (key === "." || !key.startsWith("./"))
+      continue;
+    const target = conditionTargetOf(value);
+    if (target === undefined)
+      continue;
+    if (key.includes("*")) {
+      if (!target.includes("*"))
+        continue;
+      for (const [door, concrete] of expanded(dir, key, target))
+        place(door, concrete);
+      continue;
+    }
+    place(key.slice(2), target);
   }
   return { homes: placed, name: manifest.name };
 };
-var resolvePackage = (from, name) => {
+var resolvedIn = new Map;
+var resolveInNodeModules = (from, name) => remembered(resolvedIn, `${dirname(from)}\x00${name}`, () => {
   let dir = dirname(from);
   for (;; ) {
     const packageDir = join(dir, "node_modules", name);
@@ -68,13 +92,8 @@ var resolvePackage = (from, name) => {
       } catch {
         own = false;
       }
-      if (!own) {
-        try {
-          own = JSON.parse(readFileSync(manifest, "utf8")).private === true;
-        } catch {
-          own = false;
-        }
-      }
+      if (!own)
+        own = readManifest(manifest)?.private === true;
       return { manifest, own };
     }
     const parent = dirname(dir);
@@ -82,8 +101,29 @@ var resolvePackage = (from, name) => {
       return;
     dir = parent;
   }
+});
+var resolvePackage = (from, name) => {
+  const found = resolveInNodeModules(from, name);
+  if (found?.own === true)
+    return found;
+  const member = workspaceMemberNamed(from, name);
+  if (member === undefined)
+    return found;
+  return { manifest: found?.manifest ?? member, own: true };
+};
+var nodeModulesAbove = (from) => {
+  let dir = dirname(from);
+  for (;; ) {
+    if (existsSync(join(dir, "node_modules")))
+      return true;
+    const parent = dirname(dir);
+    if (parent === dir)
+      return false;
+    dir = parent;
+  }
 };
 export {
   doorsOf,
+  nodeModulesAbove,
   resolvePackage
 };

package/dist/rules/lib/fresh.d.ts

@@ -0,0 +1,5 @@
+export declare const FRESH_MS = 1000;
+export declare const remembered: <Value>(held: Map<string, {
+    at: number;
+    value: Value;
+}>, key: string, compute: () => Value) => Value;

package/dist/rules/lib/fresh.js

@@ -0,0 +1,15 @@
+// src/rules/lib/fresh.ts
+var FRESH_MS = 1000;
+var remembered = (held, key, compute) => {
+  const now = Date.now();
+  const known = held.get(key);
+  if (known !== undefined && now - known.at < FRESH_MS)
+    return known.value;
+  const value = compute();
+  held.set(key, { at: now, value });
+  return value;
+};
+export {
+  FRESH_MS,
+  remembered
+};