@timothyrusso/arch-rules 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Timothy Russo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# @timothyrusso/arch-rules
+
+dependency-cruiser rules for the kit's feature architecture, generated from each feature's
+`FEATURE_TIER` and the app's `kit.config.json`.
+
+## Use
+
+```sh
+npm install -D @timothyrusso/arch-rules @timothyrusso/config-presets dependency-cruiser
+```
+
+`.dependency-cruiser.js` at the app root:
+
+```js
+import { createDependencyCruiserConfig } from '@timothyrusso/arch-rules';
+import { loadKitConfig } from '@timothyrusso/config-presets';
+
+export default createDependencyCruiserConfig(loadKitConfig());
+```
+
+Then `npx depcruise features app --config .dependency-cruiser.js` (use `src/features` if that is
+the app's `featuresRoot`).
+
+`createArchRules(kitConfig, options)` returns only the `forbidden` array, for apps that keep their
+own resolver options. Both read `featuresRoot` and `appRoot` from the config; `options` takes:
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `rootDir` | `process.cwd()` | App root the two folders are relative to |
+| `featureTiers` | scanned | Feature path to tier, instead of reading each `index.ts` |
+| `tsxPublicApiExceptions` | `core/navigation`, `core/design-system` | Features whose public API a `.tsx` may import at runtime |
+| `domainPublicApiExceptions` | `core/error` | Features whose public API `domain/` may import at runtime |
+| `tsConfigFile` | `tsconfig.json` | `createDependencyCruiserConfig` only |
+
+## Tiers
+
+Every feature declares its tier in its `index.ts`:
+
+```ts
+export const FEATURE_TIER: FeatureTier = 2;
+```
+
+Tiers are the integers 0 to 5. A feature imports only strictly lower tiers; Tier 0 (core) may
+also import Tier 0. Features are found one and two levels under `featuresRoot`
+(`features/<name>` and `features/core/<concern>`).
+
+## Rules
+
+| Rule | Forbids |
+| --- | --- |
+| `no-tier-violation-<feature>` | Importing a same-tier peer or a higher tier (Tier 0 peers allowed) |
+| `enforce-index-boundary-<feature>` | Reaching into a feature other than through `index.ts`, `pages.ts` or `assets/` |
+| `tsx-no-direct-layer-import` | A `.tsx` importing facades, data, useCases, di, state, hooks, libraries or mappers |
+| `tsx-no-runtime-domain-import` | A `.tsx` importing runtime values from `domain/` (`import type` is fine) |
+| `tsx-no-cross-feature-public-api` | A `.tsx` outside `appRoot` importing runtime values from a feature `index.ts` |
+| `domain-no-outer-layer-import` | `domain/` importing any outer layer or `design-system/` |
+| `usecases-no-data-import` | `useCases/` importing `data/` |
+| `domain-no-cross-feature-runtime-import` | `domain/` importing another feature's `index.ts` |
+| `no-circular` | Circular dependencies |
+| `effect-only-in-inner-layers` | `effect` or `@effect/*` outside `domain/`, `data/`, `useCases/`, `di/` and `core/runtime`, `core/error`, `core/testing` |
+| `domain-pure-except-effect` | `domain/` importing anything from `node_modules` except `effect` |
+| `facades-run-through-boundary` | `facades/` importing `core/runtime`, `effect/ManagedRuntime` or `effect/Runtime` |
+
+dependency-cruiser sees modules, not imported names. A facade calling `Effect.runPromise` is
+already caught by `effect-only-in-inner-layers` (facades import no `effect` at all); the
+name-level check belongs to the ESLint plugin.

package/dist/createArchRules.d.ts

@@ -0,0 +1,39 @@
+import type { IConfiguration } from 'dependency-cruiser';
+import { type FeatureTiers } from './featureTiers.js';
+import { type ArchKitConfig, type ArchRule } from './paths.js';
+/** Feature folders whose public API a `.tsx` may import at runtime, relative to `featuresRoot`. */
+export declare const DEFAULT_TSX_PUBLIC_API_EXCEPTIONS: readonly ["core/navigation", "core/design-system"];
+/** Feature folders whose public API `domain/` may import at runtime, relative to `featuresRoot`. */
+export declare const DEFAULT_DOMAIN_PUBLIC_API_EXCEPTIONS: readonly ["core/error"];
+export interface ArchRulesOptions {
+    /** App root that `featuresRoot` and `appRoot` are relative to. Defaults to `process.cwd()`. */
+    readonly rootDir?: string;
+    /** Tiers to use instead of scanning each feature's `index.ts`. */
+    readonly featureTiers?: FeatureTiers;
+    /** Defaults to `DEFAULT_TSX_PUBLIC_API_EXCEPTIONS`. An empty list allows none. */
+    readonly tsxPublicApiExceptions?: readonly string[];
+    /** Defaults to `DEFAULT_DOMAIN_PUBLIC_API_EXCEPTIONS`. An empty list allows none. */
+    readonly domainPublicApiExceptions?: readonly string[];
+}
+/**
+ * The dependency-cruiser `forbidden` array for an app: tier rules and index boundary rules per
+ * feature (from each feature's `FEATURE_TIER`), the layer rules, and the Effect placement rules.
+ */
+export declare function createArchRules(config: ArchKitConfig, options?: ArchRulesOptions): ArchRule[];
+export interface DependencyCruiserConfigOptions extends ArchRulesOptions {
+    /** tsconfig the resolver reads path aliases from. Defaults to `tsconfig.json`. */
+    readonly tsConfigFile?: string;
+}
+/**
+ * A complete dependency-cruiser configuration: `createArchRules` plus the resolver and reporter
+ * options an Expo app needs. Use it as the whole `.dependency-cruiser.js`:
+ *
+ * ```js
+ * import { createDependencyCruiserConfig } from '@timothyrusso/arch-rules';
+ * import { loadKitConfig } from '@timothyrusso/config-presets';
+ *
+ * export default createDependencyCruiserConfig(loadKitConfig());
+ * ```
+ */
+export declare function createDependencyCruiserConfig(config: ArchKitConfig, options?: DependencyCruiserConfigOptions): IConfiguration;
+//# sourceMappingURL=createArchRules.d.ts.map

package/dist/createArchRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createArchRules.d.ts","sourceRoot":"","sources":["../src/createArchRules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,mBAAmB,CAAC;AAGxE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAe,MAAM,YAAY,CAAC;AAG5E,mGAAmG;AACnG,eAAO,MAAM,iCAAiC,oDAAqD,CAAC;AAEpG,oGAAoG;AACpG,eAAO,MAAM,oCAAoC,yBAA0B,CAAC;AAE5E,MAAM,WAAW,gBAAgB;IAC/B,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,kFAAkF;IAClF,QAAQ,CAAC,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpD,qFAAqF;IACrF,QAAQ,CAAC,yBAAyB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,gBAAqB,GAAG,QAAQ,EAAE,CAajG;AAED,MAAM,WAAW,8BAA+B,SAAQ,gBAAgB;IACtE,kFAAkF;IAClF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,8BAAmC,GAC3C,cAAc,CAqBhB"}

package/dist/createArchRules.js

@@ -0,0 +1,62 @@
+import { generateEffectRules } from './effectRules.js';
+import { findFeatureTiers } from './featureTiers.js';
+import { generateIndexBoundaryRules } from './indexBoundaryRules.js';
+import { generateLayerRules } from './layerRules.js';
+import { escapeRegex } from './paths.js';
+import { generateTierRules } from './tierRules.js';
+/** Feature folders whose public API a `.tsx` may import at runtime, relative to `featuresRoot`. */
+export const DEFAULT_TSX_PUBLIC_API_EXCEPTIONS = ['core/navigation', 'core/design-system'];
+/** Feature folders whose public API `domain/` may import at runtime, relative to `featuresRoot`. */
+export const DEFAULT_DOMAIN_PUBLIC_API_EXCEPTIONS = ['core/error'];
+/**
+ * The dependency-cruiser `forbidden` array for an app: tier rules and index boundary rules per
+ * feature (from each feature's `FEATURE_TIER`), the layer rules, and the Effect placement rules.
+ */
+export function createArchRules(config, options = {}) {
+    const featureTiers = options.featureTiers ?? findFeatureTiers(options.rootDir ?? process.cwd(), config.featuresRoot);
+    return [
+        ...generateTierRules(featureTiers),
+        ...generateIndexBoundaryRules(featureTiers),
+        ...generateLayerRules({
+            featuresRoot: config.featuresRoot,
+            appRoot: config.appRoot,
+            tsxPublicApiExceptions: options.tsxPublicApiExceptions ?? DEFAULT_TSX_PUBLIC_API_EXCEPTIONS,
+            domainPublicApiExceptions: options.domainPublicApiExceptions ?? DEFAULT_DOMAIN_PUBLIC_API_EXCEPTIONS,
+        }),
+        ...generateEffectRules({ featuresRoot: config.featuresRoot, appRoot: config.appRoot }),
+    ];
+}
+/**
+ * A complete dependency-cruiser configuration: `createArchRules` plus the resolver and reporter
+ * options an Expo app needs. Use it as the whole `.dependency-cruiser.js`:
+ *
+ * ```js
+ * import { createDependencyCruiserConfig } from '@timothyrusso/arch-rules';
+ * import { loadKitConfig } from '@timothyrusso/config-presets';
+ *
+ * export default createDependencyCruiserConfig(loadKitConfig());
+ * ```
+ */
+export function createDependencyCruiserConfig(config, options = {}) {
+    const roots = `(?:${escapeRegex(config.featuresRoot)}|${escapeRegex(config.appRoot)})`;
+    return {
+        forbidden: createArchRules(config, options),
+        options: {
+            doNotFollow: { path: ['node_modules'] },
+            tsPreCompilationDeps: true,
+            tsConfig: { fileName: options.tsConfigFile ?? 'tsconfig.json' },
+            enhancedResolveOptions: {
+                exportsFields: ['exports'],
+                conditionNames: ['react-native', 'import', 'require', 'node', 'default', 'types'],
+                mainFields: ['main', 'types', 'typings'],
+            },
+            skipAnalysisNotInRules: true,
+            reporterOptions: {
+                dot: { collapsePattern: 'node_modules/(?:@[^/]+/[^/]+|[^/]+)' },
+                archi: { collapsePattern: `^${roots}/[^/]+|node_modules/(?:@[^/]+/[^/]+|[^/]+)` },
+                text: { highlightFocused: true },
+            },
+        },
+    };
+}
+//# sourceMappingURL=createArchRules.js.map

package/dist/createArchRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createArchRules.js","sourceRoot":"","sources":["../src/createArchRules.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAqB,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAqC,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,mGAAmG;AACnG,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,iBAAiB,EAAE,oBAAoB,CAAU,CAAC;AAEpG,oGAAoG;AACpG,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,YAAY,CAAU,CAAC;AAa5E;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAqB,EAAE,UAA4B,EAAE;IACnF,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,gBAAgB,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IACrH,OAAO;QACL,GAAG,iBAAiB,CAAC,YAAY,CAAC;QAClC,GAAG,0BAA0B,CAAC,YAAY,CAAC;QAC3C,GAAG,kBAAkB,CAAC;YACpB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,sBAAsB,EAAE,OAAO,CAAC,sBAAsB,IAAI,iCAAiC;YAC3F,yBAAyB,EAAE,OAAO,CAAC,yBAAyB,IAAI,oCAAoC;SACrG,CAAC;QACF,GAAG,mBAAmB,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;KACvF,CAAC;AACJ,CAAC;AAOD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,6BAA6B,CAC3C,MAAqB,EACrB,UAA0C,EAAE;IAE5C,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;IACvF,OAAO;QACL,SAAS,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC;QAC3C,OAAO,EAAE;YACP,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,cAAc,CAAC,EAAE;YACvC,oBAAoB,EAAE,IAAI;YAC1B,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,YAAY,IAAI,eAAe,EAAE;YAC/D,sBAAsB,EAAE;gBACtB,aAAa,EAAE,CAAC,SAAS,CAAC;gBAC1B,cAAc,EAAE,CAAC,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;gBACjF,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC;aACzC;YACD,sBAAsB,EAAE,IAAI;YAC5B,eAAe,EAAE;gBACf,GAAG,EAAE,EAAE,eAAe,EAAE,qCAAqC,EAAE;gBAC/D,KAAK,EAAE,EAAE,eAAe,EAAE,IAAI,KAAK,4CAA4C,EAAE;gBACjF,IAAI,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE;aACjC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/effectRules.d.ts

@@ -0,0 +1,12 @@
+import { type ArchRule } from './paths.js';
+/** Layers inside a feature that may use Effect. */
+export declare const EFFECT_LAYERS: readonly ["domain", "data", "useCases", "di"];
+/** Core concerns, relative to the features folder, that may use Effect outside those layers. */
+export declare const EFFECT_CORE_FOLDERS: readonly ["core/runtime", "core/error", "core/testing"];
+export interface EffectRulesInput {
+    readonly featuresRoot: string;
+    readonly appRoot: string;
+}
+/** Where Effect may live, what `domain/` may depend on, and how facades run Effects. */
+export declare function generateEffectRules(input: EffectRulesInput): ArchRule[];
+//# sourceMappingURL=effectRules.d.ts.map

package/dist/effectRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effectRules.d.ts","sourceRoot":"","sources":["../src/effectRules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAA4B,MAAM,YAAY,CAAC;AAErE,mDAAmD;AACnD,eAAO,MAAM,aAAa,+CAAgD,CAAC;AAE3E,gGAAgG;AAChG,eAAO,MAAM,mBAAmB,yDAA0D,CAAC;AAkB3F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,QAAQ,EAAE,CA+BvE"}

package/dist/effectRules.js

@@ -0,0 +1,50 @@
+import { alternation, escapeRegex } from './paths.js';
+/** Layers inside a feature that may use Effect. */
+export const EFFECT_LAYERS = ['domain', 'data', 'useCases', 'di'];
+/** Core concerns, relative to the features folder, that may use Effect outside those layers. */
+export const EFFECT_CORE_FOLDERS = ['core/runtime', 'core/error', 'core/testing'];
+/**
+ * `effect` or an `@effect/*` package, whether resolved into `node_modules` or left unresolved
+ * as a bare specifier.
+ */
+const EFFECT_MODULE = '(^|/)node_modules/(effect|@effect/[^/]+)/|^(effect|@effect/[^/]+)(/|$)';
+/** The `effect` package itself, resolved or bare. */
+const EFFECT_PACKAGE = '(^|/)node_modules/effect/|^effect(/|$)';
+/**
+ * The modules that construct or run a runtime, `effect/ManagedRuntime` and `effect/Runtime`, bare or
+ * resolved to their JavaScript or declaration file.
+ */
+const EFFECT_RUNTIME_MODULE = '^effect/(ManagedRuntime|Runtime)$|(^|/)node_modules/effect/(ManagedRuntime|Runtime)(\\.d)?\\.[cm]?[jt]s$|(^|/)node_modules/effect/.*/(ManagedRuntime|Runtime)(\\.d)?\\.[cm]?[jt]s$';
+/** Where Effect may live, what `domain/` may depend on, and how facades run Effects. */
+export function generateEffectRules(input) {
+    const features = escapeRegex(input.featuresRoot);
+    const app = escapeRegex(input.appRoot);
+    const allowedCore = EFFECT_CORE_FOLDERS.map(folder => `${input.featuresRoot}/${folder}/`).join(', ');
+    return [
+        {
+            name: 'effect-only-in-inner-layers',
+            comment: `effect and @effect/* may be imported only from domain/, data/, useCases/ and di/, plus ${allowedCore}. Never from ui/, facades/, hooks/, state/ or ${input.appRoot}/: facades hand Effects to useEffectQuery and useEffectMutation`,
+            severity: 'error',
+            from: {
+                path: `^(${features}|${app})/`,
+                pathNot: `/(${EFFECT_LAYERS.join('|')})/|^${features}/${alternation(EFFECT_CORE_FOLDERS)}/`,
+            },
+            to: { path: EFFECT_MODULE },
+        },
+        {
+            name: 'domain-pure-except-effect',
+            comment: 'domain/ may import effect and nothing else from node_modules: it holds plain types, rules and errors',
+            severity: 'error',
+            from: { path: '/domain/' },
+            to: { path: '(^|/)node_modules/', pathNot: EFFECT_PACKAGE },
+        },
+        {
+            name: 'facades-run-through-boundary',
+            comment: `facades/ never touch the runtime: no ${input.featuresRoot}/core/runtime/, no ManagedRuntime, no Effect.run*. They run Effects only through useEffectQuery and useEffectMutation from @timothyrusso/effect-core/react`,
+            severity: 'error',
+            from: { path: '/facades/' },
+            to: { path: `^${features}/core/runtime/|${EFFECT_RUNTIME_MODULE}` },
+        },
+    ];
+}
+//# sourceMappingURL=effectRules.js.map

package/dist/effectRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effectRules.js","sourceRoot":"","sources":["../src/effectRules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAErE,mDAAmD;AACnD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAU,CAAC;AAE3E,gGAAgG;AAChG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,cAAc,EAAE,YAAY,EAAE,cAAc,CAAU,CAAC;AAE3F;;;GAGG;AACH,MAAM,aAAa,GAAG,wEAAwE,CAAC;AAE/F,qDAAqD;AACrD,MAAM,cAAc,GAAG,wCAAwC,CAAC;AAEhE;;;GAGG;AACH,MAAM,qBAAqB,GACzB,oLAAoL,CAAC;AAOvL,wFAAwF;AACxF,MAAM,UAAU,mBAAmB,CAAC,KAAuB;IACzD,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,YAAY,IAAI,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAErG,OAAO;QACL;YACE,IAAI,EAAE,6BAA6B;YACnC,OAAO,EAAE,0FAA0F,WAAW,iDAAiD,KAAK,CAAC,OAAO,iEAAiE;YAC7O,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE;gBACJ,IAAI,EAAE,KAAK,QAAQ,IAAI,GAAG,IAAI;gBAC9B,OAAO,EAAE,KAAK,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,QAAQ,IAAI,WAAW,CAAC,mBAAmB,CAAC,GAAG;aAC5F;YACD,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;SAC5B;QACD;YACE,IAAI,EAAE,2BAA2B;YACjC,OAAO,EAAE,sGAAsG;YAC/G,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;YAC1B,EAAE,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,cAAc,EAAE;SAC5D;QACD;YACE,IAAI,EAAE,8BAA8B;YACpC,OAAO,EAAE,wCAAwC,KAAK,CAAC,YAAY,4JAA4J;YAC/N,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;YAC3B,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,QAAQ,kBAAkB,qBAAqB,EAAE,EAAE;SACpE;KACF,CAAC;AACJ,CAAC"}

package/dist/featureTiers.d.ts

@@ -0,0 +1,20 @@
+/** Every tier a feature may declare, lowest first. */
+export declare const FEATURE_TIERS: readonly [0, 1, 2, 3, 4, 5];
+/**
+ * A feature's position in the dependency order. A feature imports only strictly lower tiers;
+ * Tier 0 (core) may also import Tier 0.
+ */
+export type FeatureTier = (typeof FEATURE_TIERS)[number];
+/** Feature folder (relative to the app root, e.g. `features/trips`) to its declared tier. */
+export type FeatureTiers = Readonly<Record<string, FeatureTier>>;
+/** Thrown when a feature's `index.ts` declares a tier outside `FEATURE_TIERS`. */
+export declare class FeatureTierError extends Error {
+    readonly name = "FeatureTierError";
+}
+/**
+ * Reads the tier of every feature under `featuresRoot`: each folder, one or two levels deep
+ * (`features/<name>` and `features/core/<concern>`), whose `index.ts` declares `FEATURE_TIER`.
+ * Keys are relative to `rootDir` with forward slashes, sorted.
+ */
+export declare function findFeatureTiers(rootDir: string, featuresRoot: string): FeatureTiers;
+//# sourceMappingURL=featureTiers.d.ts.map

package/dist/featureTiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureTiers.d.ts","sourceRoot":"","sources":["../src/featureTiers.ts"],"names":[],"mappings":"AAGA,sDAAsD;AACtD,eAAO,MAAM,aAAa,6BAA8B,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,6FAA6F;AAC7F,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AAEjE,kFAAkF;AAClF,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAkB,IAAI,sBAAsB;CAC7C;AAQD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,YAAY,CAiCpF"}

package/dist/featureTiers.js

@@ -0,0 +1,50 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join, relative, resolve } from 'node:path';
+/** Every tier a feature may declare, lowest first. */
+export const FEATURE_TIERS = [0, 1, 2, 3, 4, 5];
+/** Thrown when a feature's `index.ts` declares a tier outside `FEATURE_TIERS`. */
+export class FeatureTierError extends Error {
+    name = 'FeatureTierError';
+}
+const TIER_REGEX = /export const FEATURE_TIER(?:\s*:\s*FeatureTier)?\s*=\s*(\d+)/;
+function isFeatureTier(value) {
+    return FEATURE_TIERS.includes(value);
+}
+/**
+ * Reads the tier of every feature under `featuresRoot`: each folder, one or two levels deep
+ * (`features/<name>` and `features/core/<concern>`), whose `index.ts` declares `FEATURE_TIER`.
+ * Keys are relative to `rootDir` with forward slashes, sorted.
+ */
+export function findFeatureTiers(rootDir, featuresRoot) {
+    const root = resolve(rootDir);
+    const results = {};
+    const walk = (dir, depth) => {
+        if (depth > 1)
+            return;
+        const entries = readdirSync(dir, { withFileTypes: true })
+            .filter(entry => entry.isDirectory())
+            .map(entry => entry.name)
+            .sort();
+        for (const name of entries) {
+            const fullPath = join(dir, name);
+            const indexPath = join(fullPath, 'index.ts');
+            if (existsSync(indexPath)) {
+                const match = readFileSync(indexPath, 'utf8').match(TIER_REGEX);
+                if (match?.[1] !== undefined) {
+                    const tier = Number.parseInt(match[1], 10);
+                    const featurePath = relative(root, fullPath).replace(/\\/g, '/');
+                    if (!isFeatureTier(tier)) {
+                        throw new FeatureTierError(`${featurePath}/index.ts declares FEATURE_TIER = ${tier}; tiers are ${FEATURE_TIERS.join(', ')}.`);
+                    }
+                    results[featurePath] = tier;
+                }
+            }
+            walk(fullPath, depth + 1);
+        }
+    };
+    const featuresDir = join(root, featuresRoot);
+    if (existsSync(featuresDir))
+        walk(featuresDir, 0);
+    return results;
+}
+//# sourceMappingURL=featureTiers.js.map

package/dist/featureTiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureTiers.js","sourceRoot":"","sources":["../src/featureTiers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpD,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,CAAC;AAWzD,kFAAkF;AAClF,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACvB,IAAI,GAAG,kBAAkB,CAAC;CAC7C;AAED,MAAM,UAAU,GAAG,8DAA8D,CAAC;AAElF,SAAS,aAAa,CAAC,KAAa;IAClC,OAAQ,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,YAAoB;IACpE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAgC,EAAE,CAAC;IAEhD,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,KAAa,EAAQ,EAAE;QAChD,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO;QACtB,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aACtD,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;aACpC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;aACxB,IAAI,EAAE,CAAC;QACV,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACjC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YAC7C,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAChE,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;oBAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC3C,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;oBACjE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;wBACzB,MAAM,IAAI,gBAAgB,CACxB,GAAG,WAAW,qCAAqC,IAAI,eAAe,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAClG,CAAC;oBACJ,CAAC;oBACD,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;gBAC9B,CAAC;YACH,CAAC;YACD,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,WAAW,CAAC;QAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAClD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @timothyrusso/arch-rules. dependency-cruiser rule generators for feature tiers, layers and Effect placement.
+ */
+export { type ArchRulesOptions, createArchRules, createDependencyCruiserConfig, DEFAULT_DOMAIN_PUBLIC_API_EXCEPTIONS, DEFAULT_TSX_PUBLIC_API_EXCEPTIONS, type DependencyCruiserConfigOptions, } from './createArchRules.js';
+export { EFFECT_CORE_FOLDERS, EFFECT_LAYERS, generateEffectRules } from './effectRules.js';
+export { FEATURE_TIERS, type FeatureTier, FeatureTierError, type FeatureTiers, findFeatureTiers, } from './featureTiers.js';
+export { generateIndexBoundaryRules } from './indexBoundaryRules.js';
+export { generateLayerRules } from './layerRules.js';
+export type { ArchKitConfig, ArchRule } from './paths.js';
+export { generateTierRules } from './tierRules.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,KAAK,gBAAgB,EACrB,eAAe,EACf,6BAA6B,EAC7B,oCAAoC,EACpC,iCAAiC,EACjC,KAAK,8BAA8B,GACpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EACL,aAAa,EACb,KAAK,WAAW,EAChB,gBAAgB,EAChB,KAAK,YAAY,EACjB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @timothyrusso/arch-rules. dependency-cruiser rule generators for feature tiers, layers and Effect placement.
+ */
+export { createArchRules, createDependencyCruiserConfig, DEFAULT_DOMAIN_PUBLIC_API_EXCEPTIONS, DEFAULT_TSX_PUBLIC_API_EXCEPTIONS, } from './createArchRules.js';
+export { EFFECT_CORE_FOLDERS, EFFECT_LAYERS, generateEffectRules } from './effectRules.js';
+export { FEATURE_TIERS, FeatureTierError, findFeatureTiers, } from './featureTiers.js';
+export { generateIndexBoundaryRules } from './indexBoundaryRules.js';
+export { generateLayerRules } from './layerRules.js';
+export { generateTierRules } from './tierRules.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":"AAAA;;GAEG;AACH,OAAO,EAEL,eAAe,EACf,6BAA6B,EAC7B,oCAAoC,EACpC,iCAAiC,GAElC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EACL,aAAa,EAEb,gBAAgB,EAEhB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/indexBoundaryRules.d.ts

@@ -0,0 +1,8 @@
+import type { FeatureTiers } from './featureTiers.js';
+import { type ArchRule } from './paths.js';
+/**
+ * One `enforce-index-boundary-<feature>` rule per feature: code outside a feature reaches it only
+ * through its `index.ts` (public API) or `pages.ts` (router entry), plus its `assets/`.
+ */
+export declare function generateIndexBoundaryRules(featureTiers: FeatureTiers): ArchRule[];
+//# sourceMappingURL=indexBoundaryRules.d.ts.map

package/dist/indexBoundaryRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexBoundaryRules.d.ts","sourceRoot":"","sources":["../src/indexBoundaryRules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,KAAK,QAAQ,EAAqB,MAAM,YAAY,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,YAAY,GAAG,QAAQ,EAAE,CAcjF"}

package/dist/indexBoundaryRules.js

@@ -0,0 +1,21 @@
+import { escapeRegex, slug } from './paths.js';
+/**
+ * One `enforce-index-boundary-<feature>` rule per feature: code outside a feature reaches it only
+ * through its `index.ts` (public API) or `pages.ts` (router entry), plus its `assets/`.
+ */
+export function generateIndexBoundaryRules(featureTiers) {
+    return Object.keys(featureTiers).map(featurePath => {
+        const own = escapeRegex(featurePath);
+        return {
+            name: `enforce-index-boundary-${slug(featurePath)}`,
+            comment: `All imports into ${featurePath} from outside must go through its index.ts or pages.ts`,
+            severity: 'error',
+            from: { pathNot: `^${own}/` },
+            to: {
+                path: `^${own}/`,
+                pathNot: `^${own}/(index|pages)\\.ts$|^${own}/assets/`,
+            },
+        };
+    });
+}
+//# sourceMappingURL=indexBoundaryRules.js.map

package/dist/indexBoundaryRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexBoundaryRules.js","sourceRoot":"","sources":["../src/indexBoundaryRules.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAE9D;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,YAA0B;IACnE,OAAO,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;QACjD,MAAM,GAAG,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;QACrC,OAAO;YACL,IAAI,EAAE,0BAA0B,IAAI,CAAC,WAAW,CAAC,EAAE;YACnD,OAAO,EAAE,oBAAoB,WAAW,wDAAwD;YAChG,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,GAAG,GAAG,EAAE;YAC7B,EAAE,EAAE;gBACF,IAAI,EAAE,IAAI,GAAG,GAAG;gBAChB,OAAO,EAAE,IAAI,GAAG,yBAAyB,GAAG,UAAU;aACvD;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/layerRules.d.ts

@@ -0,0 +1,12 @@
+import { type ArchRule } from './paths.js';
+export interface LayerRulesInput {
+    readonly featuresRoot: string;
+    readonly appRoot: string;
+    /** Feature folders, relative to `featuresRoot`, whose public API a `.tsx` may import at runtime. */
+    readonly tsxPublicApiExceptions: readonly string[];
+    /** Feature folders, relative to `featuresRoot`, whose public API `domain/` may import at runtime. */
+    readonly domainPublicApiExceptions: readonly string[];
+}
+/** The layer rules that do not depend on the feature list. */
+export declare function generateLayerRules(input: LayerRulesInput): ArchRule[];
+//# sourceMappingURL=layerRules.d.ts.map

package/dist/layerRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layerRules.d.ts","sourceRoot":"","sources":["../src/layerRules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAA4B,MAAM,YAAY,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oGAAoG;IACpG,QAAQ,CAAC,sBAAsB,EAAE,SAAS,MAAM,EAAE,CAAC;IACnD,qGAAqG;IACrG,QAAQ,CAAC,yBAAyB,EAAE,SAAS,MAAM,EAAE,CAAC;CACvD;AAMD,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,QAAQ,EAAE,CAsErE"}

package/dist/layerRules.js

@@ -0,0 +1,72 @@
+import { alternation, escapeRegex } from './paths.js';
+function exceptionPath(features, folders) {
+    return folders.length === 0 ? {} : { pathNot: `^${features}/${alternation(folders)}/` };
+}
+/** The layer rules that do not depend on the feature list. */
+export function generateLayerRules(input) {
+    const features = escapeRegex(input.featuresRoot);
+    const app = escapeRegex(input.appRoot);
+    const publicApi = `^${features}/.*/index\\.ts$`;
+    const tsxExceptions = input.tsxPublicApiExceptions.map(folder => `${input.featuresRoot}/${folder}`).join(', ');
+    const domainExceptions = input.domainPublicApiExceptions.map(folder => `${input.featuresRoot}/${folder}`).join(', ');
+    return [
+        {
+            name: 'tsx-no-direct-layer-import',
+            comment: '.tsx files may only import the ViewModel (.logic.ts), UI components and styles, never facades, data, useCases, di, state, hooks, libraries or mappers directly. domain/ is allowed for import type only (see tsx-no-runtime-domain-import)',
+            severity: 'error',
+            from: { path: '\\.tsx$' },
+            to: { path: '/(facades|data|useCases|di|state|hooks|libraries|mappers)/' },
+        },
+        {
+            name: 'tsx-no-runtime-domain-import',
+            comment: '.tsx files may use import type from domain/ for prop annotations, but must never import runtime values from domain/: all runtime logic flows through the ViewModel (.logic.ts)',
+            severity: 'error',
+            from: { path: '\\.tsx$' },
+            to: { path: '/domain/', dependencyTypesNot: ['type-only'] },
+        },
+        {
+            name: 'tsx-no-cross-feature-public-api',
+            comment: `.tsx files must not import runtime values from a cross-feature public API (index.ts): cross-feature runtime values flow through the ViewModel (.logic.ts). import type from any feature index.ts is allowed for prop annotations. Route and layout files in ${input.appRoot}/ are thin entry points and may import public APIs directly.${tsxExceptions ? ` Exceptions: ${tsxExceptions}.` : ''}`,
+            severity: 'error',
+            from: { path: '\\.tsx$', pathNot: `^${app}/` },
+            to: {
+                path: publicApi,
+                ...exceptionPath(features, input.tsxPublicApiExceptions),
+                dependencyTypesNot: ['type-only'],
+            },
+        },
+        {
+            name: 'domain-no-outer-layer-import',
+            comment: 'domain/ is the innermost layer: it must not import from data/, useCases/, facades/, ui/, state/, hooks/, libraries/, di/ or mappers/, nor from the shared UI module design-system/',
+            severity: 'error',
+            from: { path: '/domain/' },
+            to: { path: '/(data|useCases|facades|ui|state|hooks|libraries|di|mappers|design-system)/' },
+        },
+        {
+            name: 'usecases-no-data-import',
+            comment: 'useCases/ depend only on domain/ interfaces, never on data/ concrete implementations',
+            severity: 'error',
+            from: { path: '/useCases/' },
+            to: { path: '/data/' },
+        },
+        {
+            name: 'domain-no-cross-feature-runtime-import',
+            comment: `domain/ files must not import runtime values from another feature's public API (index.ts). Use import type for cross-feature type references.${domainExceptions ? ` Exceptions: ${domainExceptions}.` : ''}`,
+            severity: 'error',
+            from: { path: '/domain/' },
+            to: {
+                path: publicApi,
+                ...exceptionPath(features, input.domainPublicApiExceptions),
+                dependencyTypes: ['import'],
+            },
+        },
+        {
+            name: 'no-circular',
+            comment: 'Circular dependencies make code hard to reason about and test: resolve them with dependency inversion or by restructuring modules',
+            severity: 'error',
+            from: {},
+            to: { circular: true },
+        },
+    ];
+}
+//# sourceMappingURL=layerRules.js.map

package/dist/layerRules.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,27 @@
+import type { IRegularForbiddenRuleType } from 'dependency-cruiser';
+/** A generated dependency-cruiser `forbidden` rule. Every rule has a name and an error severity. */
+export type ArchRule = IRegularForbiddenRuleType & {
+    name: string;
+    comment: string;
+    severity: 'error';
+};
+/**
+ * The fields of `kit.config.json` the generators read. A `KitConfig` from
+ * `@timothyrusso/config-presets` satisfies it.
+ */
+export interface ArchKitConfig {
+    /** Folder that holds the feature modules, relative to the app root. */
+    readonly featuresRoot: string;
+    /** expo-router app folder, relative to the app root. */
+    readonly appRoot: string;
+}
+/** Escapes a literal path for use inside a regular expression. Hyphens and slashes stay as they are. */
+export declare function escapeRegex(path: string): string;
+/** Turns a feature path such as `features/core/navigation` into a rule name suffix. */
+export declare function slug(featurePath: string): string;
+/**
+ * Builds one regex alternation for a list of paths relative to a folder, grouping siblings:
+ * `['core/navigation', 'core/design-system']` becomes `core/(navigation|design-system)`.
+ */
+export declare function alternation(paths: readonly string[]): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAEpE,oGAAoG;AACpG,MAAM,MAAM,QAAQ,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAExG;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wGAAwG;AACxG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,uFAAuF;AACvF,wBAAgB,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAc5D"}

package/dist/paths.js

@@ -0,0 +1,26 @@
+/** Escapes a literal path for use inside a regular expression. Hyphens and slashes stay as they are. */
+export function escapeRegex(path) {
+    return path.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Turns a feature path such as `features/core/navigation` into a rule name suffix. */
+export function slug(featurePath) {
+    return featurePath.replace(/\//g, '-');
+}
+/**
+ * Builds one regex alternation for a list of paths relative to a folder, grouping siblings:
+ * `['core/navigation', 'core/design-system']` becomes `core/(navigation|design-system)`.
+ */
+export function alternation(paths) {
+    const groups = new Map();
+    for (const path of paths) {
+        const cut = path.lastIndexOf('/');
+        const parent = cut === -1 ? '' : path.slice(0, cut + 1);
+        const leaf = path.slice(cut + 1);
+        const leaves = groups.get(parent) ?? [];
+        leaves.push(escapeRegex(leaf));
+        groups.set(parent, leaves);
+    }
+    const parts = [...groups].map(([parent, leaves]) => leaves.length === 1 ? `${escapeRegex(parent)}${leaves[0]}` : `${escapeRegex(parent)}(${leaves.join('|')})`);
+    return parts.length === 1 ? (parts[0] ?? '') : `(${parts.join('|')})`;
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAgBA,wGAAwG;AACxG,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,IAAI,CAAC,WAAmB;IACtC,OAAO,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAwB;IAClD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,CACjD,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAC3G,CAAC;IACF,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AACxE,CAAC"}

package/dist/tierRules.d.ts

@@ -0,0 +1,8 @@
+import { type FeatureTiers } from './featureTiers.js';
+import { type ArchRule } from './paths.js';
+/**
+ * One `no-tier-violation-<feature>` rule per feature that has something above it: a feature
+ * imports only strictly lower tiers, and Tier 0 may import Tier 0.
+ */
+export declare function generateTierRules(featureTiers: FeatureTiers): ArchRule[];
+//# sourceMappingURL=tierRules.d.ts.map

package/dist/tierRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tierRules.d.ts","sourceRoot":"","sources":["../src/tierRules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,KAAK,QAAQ,EAAqB,MAAM,YAAY,CAAC;AAM9D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,YAAY,GAAG,QAAQ,EAAE,CA4BxE"}

package/dist/tierRules.js

@@ -0,0 +1,35 @@
+import { FEATURE_TIERS } from './featureTiers.js';
+import { escapeRegex, slug } from './paths.js';
+function forbiddenTiersFor(tier) {
+    return tier === 0 ? FEATURE_TIERS.filter(t => t > 0) : FEATURE_TIERS.filter(t => t >= tier);
+}
+/**
+ * One `no-tier-violation-<feature>` rule per feature that has something above it: a feature
+ * imports only strictly lower tiers, and Tier 0 may import Tier 0.
+ */
+export function generateTierRules(featureTiers) {
+    const featuresByTier = new Map();
+    for (const [featurePath, tier] of Object.entries(featureTiers)) {
+        const peers = featuresByTier.get(tier) ?? [];
+        peers.push(featurePath);
+        featuresByTier.set(tier, peers);
+    }
+    return Object.entries(featureTiers).flatMap(([featurePath, tier]) => {
+        const forbiddenPaths = forbiddenTiersFor(tier).flatMap(t => (featuresByTier.get(t) ?? []).map(f => `^${escapeRegex(f)}/`));
+        if (forbiddenPaths.length === 0)
+            return [];
+        const own = `^${escapeRegex(featurePath)}/`;
+        return [
+            {
+                name: `no-tier-violation-${slug(featurePath)}`,
+                comment: tier === 0
+                    ? 'Tier 0 (core): import only Tier 0 peers; never a feature of Tier 1 or above'
+                    : `Tier ${tier}: import only strictly lower tiers; never a Tier ${tier} peer or a higher tier`,
+                severity: 'error',
+                from: { path: own },
+                to: { path: forbiddenPaths.join('|'), pathNot: own },
+            },
+        ];
+    });
+}
+//# sourceMappingURL=tierRules.js.map

package/dist/tierRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tierRules.js","sourceRoot":"","sources":["../src/tierRules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAuC,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAiB,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAE9D,SAAS,iBAAiB,CAAC,IAAiB;IAC1C,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;AAC9F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,YAA0B;IAC1D,MAAM,cAAc,GAAG,IAAI,GAAG,EAAyB,CAAC;IACxD,KAAK,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,EAAc,EAAE;QAC9E,MAAM,cAAc,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CACzD,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAC9D,CAAC;QACF,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAE3C,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC;QAC5C,OAAO;YACL;gBACE,IAAI,EAAE,qBAAqB,IAAI,CAAC,WAAW,CAAC,EAAE;gBAC9C,OAAO,EACL,IAAI,KAAK,CAAC;oBACR,CAAC,CAAC,6EAA6E;oBAC/E,CAAC,CAAC,QAAQ,IAAI,oDAAoD,IAAI,wBAAwB;gBAClG,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE;gBACnB,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE;aACrD;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@timothyrusso/arch-rules",
+  "version": "0.1.0",
+  "description": "dependency-cruiser rule generators for feature tiers, layers and Effect placement.",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/timothyrusso/agentic-kit.git",
+    "directory": "packages/arch-rules"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "NODE_OPTIONS=\"--experimental-vm-modules --no-warnings=ExperimentalWarning\" jest"
+  },
+  "devDependencies": {
+    "dependency-cruiser": "^18.4.0"
+  },
+  "peerDependencies": {
+    "dependency-cruiser": "^18.0.0"
+  }
+}