@jterrazz/test 12.0.2 → 12.1.0

package/dist/oxlint.cjs

@@ -340,7 +340,7 @@ const RULE_DOCS = {
 	},
 	"c1-domain-structure": {
 		channel: "statique",
-		convention: "La forme de l’arbre `specs/` se déclare via l’option `depth` : `facet-domain` (défaut — `*.test.ts` à la profondeur facet/domain, `*.specification.ts` au root de la facette), `mirror` (test à toute profondeur ≥ 1, nommé d’après son dossier), `off`.",
+		convention: "La forme de l’arbre `specs/` se déclare via l’option `depth` : `facet-domain` (défaut — `*.test.ts` à la profondeur facet/domain, `*.specification.ts` au root de la facette), `facet` (test au root de la facette OU un dossier domaine plus bas, jamais plus profond), `mirror` (test à toute profondeur ≥ 1, nommé d’après son dossier), `off`.",
 		family: "C",
 		id: "C1",
 		rationale: "Une profondeur fixe rend la place de chaque fichier prévisible et détectable statiquement."
@@ -1471,6 +1471,16 @@ const DEFAULT_DEPTH = "facet-domain";
 * - a `*.specification.ts` sits at the facet root — exactly
 *   `specs/<facet>/<file>.specification.ts`, never inside a domain.
 *
+* `depth: 'facet'`
+*
+* The same facet root, one degree looser: the folder follows the assets. A
+* `*.test.ts` sits EITHER at the facet root (`specs/<facet>/<aspect>.test.ts`)
+* or one domain folder down (`specs/<facet>/<domain>/<aspect>.test.ts`) — a
+* test earns a domain folder when it carries assets of its own, and sits
+* beside its siblings when it does not. Anything deeper is rejected, and so is
+* a test loose at the specs root. A `*.specification.ts` sits at the facet
+* root, exactly as in `facet-domain`.
+*
 * `depth: 'mirror'`
 *
 * The tree mirrors something outside itself (a command tree, a source tree), so
@@ -1495,6 +1505,24 @@ const c1DomainStructure = {
 			if (anchor === void 0) return;
 			const base = anchor.relative.at(-1) ?? "";
 			const nesting = anchor.relative.length - 1;
+			if (depth === "facet") {
+				if (base.endsWith(TEST_SUFFIX)) {
+					if (nesting < 1) context.report({
+						messageId: "testOutsideFacet",
+						node
+					});
+					else if (nesting > 2) context.report({
+						messageId: "testTooDeepForFacet",
+						node
+					});
+					return;
+				}
+				if (base.endsWith(SPECIFICATION_SUFFIX) && nesting !== 1) context.report({
+					messageId: "specNotAtFacetRoot",
+					node
+				});
+				return;
+			}
 			if (depth === "mirror") {
 				if (!base.endsWith(TEST_SUFFIX)) return;
 				if (nesting < 1) {
@@ -1539,12 +1567,15 @@ const c1DomainStructure = {
 			testAtFacetRoot: "A `*.test.ts` must live in a domain folder: `specs/<facet>/<domain>/<aspect>.test.ts` — tests directly at the facet root are forbidden (C1 — see docs/10-linting.md).",
 			testAtSpecsRoot: "A `*.test.ts` must live in a directory under specs/ — with `depth: \"mirror\"` the tree mirrors a structure, and the specs root mirrors nothing (C1 — see docs/10-linting.md).",
 			testNotMirroringDirectory: "A `*.test.ts` must be named after the directory holding it — `{{directory}}/{{directory}}.test.ts` — with `depth: \"mirror\"` (C1 — see docs/10-linting.md).",
-			testTooDeep: "A `*.test.ts` must sit at facet/domain depth: `specs/<facet>/<domain>/<aspect>.test.ts` — no deeper nesting (C1 — see docs/10-linting.md)."
+			testOutsideFacet: "A `*.test.ts` must live in a facet folder — `specs/<facet>/<aspect>.test.ts`, or one domain deeper: with `depth: \"facet\"` the specs root holds facets, not tests (C1 — see docs/10-linting.md).",
+			testTooDeep: "A `*.test.ts` must sit at facet/domain depth: `specs/<facet>/<domain>/<aspect>.test.ts` — no deeper nesting (C1 — see docs/10-linting.md).",
+			testTooDeepForFacet: "A `*.test.ts` must sit at the facet root or one domain folder down — `specs/<facet>/<aspect>.test.ts` or `specs/<facet>/<domain>/<aspect>.test.ts`: with `depth: \"facet\"` nothing nests deeper (C1 — see docs/10-linting.md)."
 		},
 		schema: [{
 			additionalProperties: false,
 			properties: { depth: {
 				enum: [
+					"facet",
 					"facet-domain",
 					"mirror",
 					"off"

package/dist/oxlint.js

@@ -336,7 +336,7 @@ const RULE_DOCS = {
 	},
 	"c1-domain-structure": {
 		channel: "statique",
-		convention: "La forme de l’arbre `specs/` se déclare via l’option `depth` : `facet-domain` (défaut — `*.test.ts` à la profondeur facet/domain, `*.specification.ts` au root de la facette), `mirror` (test à toute profondeur ≥ 1, nommé d’après son dossier), `off`.",
+		convention: "La forme de l’arbre `specs/` se déclare via l’option `depth` : `facet-domain` (défaut — `*.test.ts` à la profondeur facet/domain, `*.specification.ts` au root de la facette), `facet` (test au root de la facette OU un dossier domaine plus bas, jamais plus profond), `mirror` (test à toute profondeur ≥ 1, nommé d’après son dossier), `off`.",
 		family: "C",
 		id: "C1",
 		rationale: "Une profondeur fixe rend la place de chaque fichier prévisible et détectable statiquement."
@@ -1467,6 +1467,16 @@ const DEFAULT_DEPTH = "facet-domain";
 * - a `*.specification.ts` sits at the facet root — exactly
 *   `specs/<facet>/<file>.specification.ts`, never inside a domain.
 *
+* `depth: 'facet'`
+*
+* The same facet root, one degree looser: the folder follows the assets. A
+* `*.test.ts` sits EITHER at the facet root (`specs/<facet>/<aspect>.test.ts`)
+* or one domain folder down (`specs/<facet>/<domain>/<aspect>.test.ts`) — a
+* test earns a domain folder when it carries assets of its own, and sits
+* beside its siblings when it does not. Anything deeper is rejected, and so is
+* a test loose at the specs root. A `*.specification.ts` sits at the facet
+* root, exactly as in `facet-domain`.
+*
 * `depth: 'mirror'`
 *
 * The tree mirrors something outside itself (a command tree, a source tree), so
@@ -1491,6 +1501,24 @@ const c1DomainStructure = {
 			if (anchor === void 0) return;
 			const base = anchor.relative.at(-1) ?? "";
 			const nesting = anchor.relative.length - 1;
+			if (depth === "facet") {
+				if (base.endsWith(TEST_SUFFIX)) {
+					if (nesting < 1) context.report({
+						messageId: "testOutsideFacet",
+						node
+					});
+					else if (nesting > 2) context.report({
+						messageId: "testTooDeepForFacet",
+						node
+					});
+					return;
+				}
+				if (base.endsWith(SPECIFICATION_SUFFIX) && nesting !== 1) context.report({
+					messageId: "specNotAtFacetRoot",
+					node
+				});
+				return;
+			}
 			if (depth === "mirror") {
 				if (!base.endsWith(TEST_SUFFIX)) return;
 				if (nesting < 1) {
@@ -1535,12 +1563,15 @@ const c1DomainStructure = {
 			testAtFacetRoot: "A `*.test.ts` must live in a domain folder: `specs/<facet>/<domain>/<aspect>.test.ts` — tests directly at the facet root are forbidden (C1 — see docs/10-linting.md).",
 			testAtSpecsRoot: "A `*.test.ts` must live in a directory under specs/ — with `depth: \"mirror\"` the tree mirrors a structure, and the specs root mirrors nothing (C1 — see docs/10-linting.md).",
 			testNotMirroringDirectory: "A `*.test.ts` must be named after the directory holding it — `{{directory}}/{{directory}}.test.ts` — with `depth: \"mirror\"` (C1 — see docs/10-linting.md).",
-			testTooDeep: "A `*.test.ts` must sit at facet/domain depth: `specs/<facet>/<domain>/<aspect>.test.ts` — no deeper nesting (C1 — see docs/10-linting.md)."
+			testOutsideFacet: "A `*.test.ts` must live in a facet folder — `specs/<facet>/<aspect>.test.ts`, or one domain deeper: with `depth: \"facet\"` the specs root holds facets, not tests (C1 — see docs/10-linting.md).",
+			testTooDeep: "A `*.test.ts` must sit at facet/domain depth: `specs/<facet>/<domain>/<aspect>.test.ts` — no deeper nesting (C1 — see docs/10-linting.md).",
+			testTooDeepForFacet: "A `*.test.ts` must sit at the facet root or one domain folder down — `specs/<facet>/<aspect>.test.ts` or `specs/<facet>/<domain>/<aspect>.test.ts`: with `depth: \"facet\"` nothing nests deeper (C1 — see docs/10-linting.md)."
 		},
 		schema: [{
 			additionalProperties: false,
 			properties: { depth: {
 				enum: [
+					"facet",
 					"facet-domain",
 					"mirror",
 					"off"

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jterrazz/test",
-    "version": "12.0.2",
+    "version": "12.1.0",
     "description": "Declarative testing framework for HTTP APIs, CLIs, and background jobs — one entry point, real infrastructure, golden-file assertions, plus an oxlint convention plugin.",
     "keywords": [
         "api-testing",