declapract-typescript-ehmpathy 0.49.14 → 0.50.0

package/dist/.test/assets/expo-migration/declarations/practices/rhachet/best-practice/.gitattributes.declapract.ts

@@ -0,0 +1,65 @@
+import type { FileCheckFunction, FileFixFunction } from 'declapract';
+import expect from 'expect';
+
+import {
+  defineExpectedGitattributesContents,
+  type GitattributesSection,
+} from '../../../utils/defineExpectedGitattributesContents';
+
+/**
+ * .what = the `.gitattributes` section this practice owns: route robocode folds in pr diffs
+ * .why  = rhachet installs the roles that drive routes (bhrain: `.route/`; bhuild:
+ *         `.behavior/`). a route carries stones, guards, reviews, caches: the trail. the
+ *         yields hold what the route concluded, and `.radio/` holds what it handed off. so a
+ *         pr folds the trail and opens on the yields and the radio
+ * .note = order carries load: git takes the last line that matches, so each
+ *         `-linguist-generated` exception follows the collapse line it carves out of.
+ *         attributes never recurse from a dir, so each pattern ends in `/**`
+ */
+const sections: readonly GitattributesSection[] = [
+  {
+    header: {
+      latest:
+        '# [rhachet] collapse route robocode in pr diffs; yields and radio stay open',
+      retired: [],
+    },
+    entries: {
+      latest: [
+        '.route/** linguist-generated',
+        '.route/**/*.yield.* -linguist-generated',
+        '.route/**/.radio/** -linguist-generated',
+        '.behavior/** linguist-generated',
+        '.behavior/**/*.yield.* -linguist-generated',
+        '.behavior/**/.radio/** -linguist-generated',
+      ],
+      retired: [],
+    },
+  },
+];
+
+/**
+ * .what = emits the `.gitattributes` this practice declares, given the repo's extant one
+ * .why  = several practices declare this file; they converge only through the shared util
+ */
+const defineExpectedContents = (input: { contents: string | null }): string =>
+  defineExpectedGitattributesContents({
+    contents: input.contents,
+    declarer: 'rhachet',
+    sections,
+  });
+
+/**
+ * .what = throws when the repo's `.gitattributes` differs from what the shared layout emits
+ * .why  = `check` gates `fix` (a throw means violated); exact equality, so `check(x) ⟺ x === fix(x)`
+ */
+export const check: FileCheckFunction = (contents) => {
+  expect(contents).toEqual(defineExpectedContents({ contents }));
+};
+
+/**
+ * .what = sets this practice's section into the repo's `.gitattributes`
+ * .why  = a fixed point: a second fix changes zero, and `check` passes on the output
+ */
+export const fix: FileFixFunction = (contents) => ({
+  contents: defineExpectedContents({ contents }),
+});

package/dist/.test/assets/expo-migration/declarations/practices/tests-any/best-practice/.declapract.readme.md

@@ -43,3 +43,10 @@
   - `jest.unit.env`
   - `jest.integration.env`
   - `jest.acceptance.env`
+
+## test source folds in a pr; snapshots stay open
+
+this practice declares a `# [tests-any]` section of the repo-root `.gitattributes`: `*.test.ts` and
+`*.test.tsx` are `linguist-generated`, so github renders them collapsed. `*.snap` files stay open, so
+a reviewer still reads each output change. to un-fold a path, see "what folds in a pr" in
+`src/practices/git/best-practice/.declapract.readme.md`.

package/dist/.test/assets/expo-migration/declarations/practices/tests-any/best-practice/.gitattributes.declapract.ts

@@ -0,0 +1,60 @@
+import type { FileCheckFunction, FileFixFunction } from 'declapract';
+import expect from 'expect';
+
+import {
+  defineExpectedGitattributesContents,
+  type GitattributesSection,
+} from '../../../utils/defineExpectedGitattributesContents';
+
+/**
+ * .what = the `.gitattributes` section this practice owns: test source folds in pr diffs
+ * .why  = a test file is the how; its snapshot is the proof. github folds a file marked
+ *         `linguist-generated`, one click away, so a pr opens on the snapshot diff and the
+ *         source, and the test source waits for the reviewer who asks for it
+ * .note = `*.snap` takes no line: linguist never marks a snapshot as generated, so it renders
+ *         open. `*.test.tsx` covers the expo cut, whose jest matches
+ *         `<star><star>/<star>.test.{ts,tsx}`
+ * .note = `<star>` stands in for the literal `*` wildcard, and must stay a stand-in. a literal
+ *         `*` immediately before a `/` closes this comment mid-prose
+ * .note = `linguist-generated` names a render hint here, not provenance; the header says so
+ */
+const sections: readonly GitattributesSection[] = [
+  {
+    header: {
+      latest:
+        '# [tests-any] collapse test source in pr diffs; snapshots stay open',
+      retired: [],
+    },
+    entries: {
+      latest: ['*.test.ts linguist-generated', '*.test.tsx linguist-generated'],
+      retired: [],
+    },
+  },
+];
+
+/**
+ * .what = emits the `.gitattributes` this practice declares, given the repo's extant one
+ * .why  = several practices declare this file; they converge only through the shared util
+ */
+const defineExpectedContents = (input: { contents: string | null }): string =>
+  defineExpectedGitattributesContents({
+    contents: input.contents,
+    declarer: 'tests-any',
+    sections,
+  });
+
+/**
+ * .what = throws when the repo's `.gitattributes` differs from what the shared layout emits
+ * .why  = `check` gates `fix` (a throw means violated); exact equality, so `check(x) ⟺ x === fix(x)`
+ */
+export const check: FileCheckFunction = (contents) => {
+  expect(contents).toEqual(defineExpectedContents({ contents }));
+};
+
+/**
+ * .what = sets this practice's section into the repo's `.gitattributes`
+ * .why  = a fixed point: a second fix changes zero, and `check` passes on the output
+ */
+export const fix: FileFixFunction = (contents) => ({
+  contents: defineExpectedContents({ contents }),
+});

package/dist/.test/assets/expo-toolchain/declarations/practices/tests-any/best-practice/.declapract.readme.md

@@ -43,3 +43,10 @@
   - `jest.unit.env`
   - `jest.integration.env`
   - `jest.acceptance.env`
+
+## test source folds in a pr; snapshots stay open
+
+this practice declares a `# [tests-any]` section of the repo-root `.gitattributes`: `*.test.ts` and
+`*.test.tsx` are `linguist-generated`, so github renders them collapsed. `*.snap` files stay open, so
+a reviewer still reads each output change. to un-fold a path, see "what folds in a pr" in
+`src/practices/git/best-practice/.declapract.readme.md`.

package/dist/.test/assets/expo-toolchain/declarations/practices/tests-any/best-practice/.gitattributes.declapract.ts

@@ -0,0 +1,60 @@
+import type { FileCheckFunction, FileFixFunction } from 'declapract';
+import expect from 'expect';
+
+import {
+  defineExpectedGitattributesContents,
+  type GitattributesSection,
+} from '../../../utils/defineExpectedGitattributesContents';
+
+/**
+ * .what = the `.gitattributes` section this practice owns: test source folds in pr diffs
+ * .why  = a test file is the how; its snapshot is the proof. github folds a file marked
+ *         `linguist-generated`, one click away, so a pr opens on the snapshot diff and the
+ *         source, and the test source waits for the reviewer who asks for it
+ * .note = `*.snap` takes no line: linguist never marks a snapshot as generated, so it renders
+ *         open. `*.test.tsx` covers the expo cut, whose jest matches
+ *         `<star><star>/<star>.test.{ts,tsx}`
+ * .note = `<star>` stands in for the literal `*` wildcard, and must stay a stand-in. a literal
+ *         `*` immediately before a `/` closes this comment mid-prose
+ * .note = `linguist-generated` names a render hint here, not provenance; the header says so
+ */
+const sections: readonly GitattributesSection[] = [
+  {
+    header: {
+      latest:
+        '# [tests-any] collapse test source in pr diffs; snapshots stay open',
+      retired: [],
+    },
+    entries: {
+      latest: ['*.test.ts linguist-generated', '*.test.tsx linguist-generated'],
+      retired: [],
+    },
+  },
+];
+
+/**
+ * .what = emits the `.gitattributes` this practice declares, given the repo's extant one
+ * .why  = several practices declare this file; they converge only through the shared util
+ */
+const defineExpectedContents = (input: { contents: string | null }): string =>
+  defineExpectedGitattributesContents({
+    contents: input.contents,
+    declarer: 'tests-any',
+    sections,
+  });
+
+/**
+ * .what = throws when the repo's `.gitattributes` differs from what the shared layout emits
+ * .why  = `check` gates `fix` (a throw means violated); exact equality, so `check(x) ⟺ x === fix(x)`
+ */
+export const check: FileCheckFunction = (contents) => {
+  expect(contents).toEqual(defineExpectedContents({ contents }));
+};
+
+/**
+ * .what = sets this practice's section into the repo's `.gitattributes`
+ * .why  = a fixed point: a second fix changes zero, and `check` passes on the output
+ */
+export const fix: FileFixFunction = (contents) => ({
+  contents: defineExpectedContents({ contents }),
+});

package/dist/.test/assets/git/declarations/declapract.declare.yml

@@ -0,0 +1,8 @@
+# minimal declarations for the gitignore integration test
+#
+# .note = this dir lives OUTSIDE src/practices on purpose. declapract deep-walks
+#         src/practices/** through symlinks, so a fixture that symlinks back to an
+#         ancestor it lives under forms a cycle -> ELOOP under full-suite load.
+declare:
+  practices: practices
+  use-cases: useCases.yml