@anzusystems/common-admin 2.0.0-rc.1 → 2.0.0-rc.11

package/dist/shared/validators/vuelidate/common/useValidateMinValue.js

@@ -1,6 +1,6 @@
 import { commonT as e } from "../../../../plugins/i18n.js";
 import { createI18nMessage as t, minValue as n } from "@vuelidate/validators";
-//#region src/shared/validators/vuelidate/common/useValidateMinValue.ts
+// src/shared/validators/vuelidate/common/useValidateMinValue.ts
 var r = e;
 function i() {
 	return t({ t: r })(n, {
@@ -8,7 +8,6 @@ function i() {
 		messagePath: () => "error.jsValidation.minValue"
 	});
 }
-//#endregion
 export { i as useValidateMinValue };
 
 //# sourceMappingURL=useValidateMinValue.js.map

package/dist/shared/validators/vuelidate/common/useValidateNumeric.js

@@ -1,11 +1,10 @@
 import { commonT as e } from "../../../../plugins/i18n.js";
 import { createI18nMessage as t, numeric as n } from "@vuelidate/validators";
-//#region src/shared/validators/vuelidate/common/useValidateNumeric.ts
+// src/shared/validators/vuelidate/common/useValidateNumeric.ts
 var r = e;
 function i() {
 	return t({ t: r })(n, { messagePath: () => "error.jsValidation.numeric" });
 }
-//#endregion
 export { i as useValidateNumeric };
 
 //# sourceMappingURL=useValidateNumeric.js.map

package/dist/shared/validators/vuelidate/common/useValidateRequired.js

@@ -1,11 +1,10 @@
 import { commonT as e } from "../../../../plugins/i18n.js";
 import { createI18nMessage as t, required as n } from "@vuelidate/validators";
-//#region src/shared/validators/vuelidate/common/useValidateRequired.ts
+// src/shared/validators/vuelidate/common/useValidateRequired.ts
 var r = e;
 function i() {
 	return t({ t: r })(n, { messagePath: () => "error.jsValidation.required" });
 }
-//#endregion
 export { i as useValidateRequired };
 
 //# sourceMappingURL=useValidateRequired.js.map

package/dist/shared/validators/vuelidate/common/useValidateRequiredIf.js

@@ -1,6 +1,6 @@
 import { commonT as e } from "../../../../plugins/i18n.js";
 import { createI18nMessage as t, requiredIf as n } from "@vuelidate/validators";
-//#region src/shared/validators/vuelidate/common/useValidateRequiredIf.ts
+// src/shared/validators/vuelidate/common/useValidateRequiredIf.ts
 var r = e;
 function i() {
 	return t({ t: r })(n, {
@@ -8,7 +8,6 @@ function i() {
 		messagePath: () => "error.jsValidation.required"
 	});
 }
-//#endregion
 export { i as useValidateRequiredIf };
 
 //# sourceMappingURL=useValidateRequiredIf.js.map

package/dist/shared/validators/vuelidate/common/useValidateSlug.js

@@ -1,11 +1,10 @@
 import { commonT as e } from "../../../../plugins/i18n.js";
 import { createI18nMessage as t, helpers as n } from "@vuelidate/validators";
-//#region src/shared/validators/vuelidate/common/useValidateSlug.ts
+// src/shared/validators/vuelidate/common/useValidateSlug.ts
 var r = e;
 function i() {
 	return t({ t: r })(n.regex(/^[a-z\-0-9]+$/), { messagePath: () => "error.jsValidation.slug" });
 }
-//#endregion
 export { i as useValidateSlug };
 
 //# sourceMappingURL=useValidateSlug.js.map

package/dist/shared/validators/vuelidate/common/useValidateStringArrayItemLength.js

@@ -1,7 +1,7 @@
 import { commonT as e } from "../../../../plugins/i18n.js";
 import { unref as t } from "vue";
 import { createI18nMessage as n, helpers as r } from "@vuelidate/validators";
-//#region src/shared/validators/vuelidate/common/useValidateStringArrayItemLength.ts
+// src/shared/validators/vuelidate/common/useValidateStringArrayItemLength.ts
 var i = e;
 function a() {
 	let e = n({ t: i }), a = (e, n) => (i) => !r.req(i) || i.every((r) => r.length >= t(e) && r.length <= t(n));
@@ -17,7 +17,6 @@ function a() {
 		messagePath: () => "error.jsValidation.stringArrayItemLength"
 	});
 }
-//#endregion
 export { a as useValidateStringArrayItemLength };
 
 //# sourceMappingURL=useValidateStringArrayItemLength.js.map

package/dist/shared/validators/vuelidate/common/useValidateUrl.js

@@ -1,11 +1,10 @@
 import { commonT as e } from "../../../../plugins/i18n.js";
 import { createI18nMessage as t, url as n } from "@vuelidate/validators";
-//#region src/shared/validators/vuelidate/common/useValidateUrl.ts
+// src/shared/validators/vuelidate/common/useValidateUrl.ts
 var r = e;
 function i() {
 	return t({ t: r })(n, { messagePath: () => "error.jsValidation.url" });
 }
-//#endregion
 export { i as useValidateUrl };
 
 //# sourceMappingURL=useValidateUrl.js.map

package/dist/shared/validators/vuelidate/useValidate.js

@@ -12,7 +12,7 @@ import { useValidateSlug as u } from "./common/useValidateSlug.js";
 import { useValidateStringArrayItemLength as d } from "./common/useValidateStringArrayItemLength.js";
 import { useValidateUrl as f } from "./common/useValidateUrl.js";
 import { useValidateCompareDates as p } from "./common/useValidateCompareDates.js";
-//#region src/shared/validators/vuelidate/useValidate.ts
+// src/shared/validators/vuelidate/useValidate.ts
 function m() {
 	return {
 		required: c(),
@@ -31,7 +31,6 @@ function m() {
 		datesCompare: p()
 	};
 }
-//#endregion
 export { m as useValidate };
 
 //# sourceMappingURL=useValidate.js.map

package/dist/testing/appShell.d.ts

@@ -1,20 +1,21 @@
 export interface DescribeAlertHostOptions {
-    /** The admin's components: `import.meta.glob(['/src/**\/*.vue', '!/src/test/**'], { query: '?raw', import: 'default', eager: true })`. */
+    /**
+     * The admin's components: `import.meta.glob(['/src/**\/*.vue', '!/src/test/**'], { query: '?raw', import: 'default', eager: true })`.
+     */
     sources: Record<string, string>;
-    /** The component with the layout switch, which mounts `<AAlerts />`. */
     host?: string;
 }
 /**
- * Where the alerts land.
- *
- * `AAlerts` is the host every `showError` / `showWarning` renders into. It is mounted once, outside the
- * layout switch: by `ALayoutSwitch`, or next to the admin's own `<component :is="layout">`. A host inside a
- * layout took the alerts it was showing away with it when the route switched layouts -- a start-up
- * error raised under the loader vanished the moment the drawer replaced it -- and a layout without one
- * had nowhere to show them at all.
+ * `AAlerts` is the host every `showError` / `showWarning` renders into. It is mounted once, outside
+ * the layout switch: by `ALayoutSwitch`, or next to the admin's own `<component :is="layout">`.
+ * A host inside a layout takes its alerts away when the route switches layouts.
+ * A start-up error raised under the loader vanished when the drawer replaced it.
+ * A layout without a host has nowhere to show alerts.
  */
 export declare function describeAlertHost({ sources, host }: DescribeAlertHostOptions): void;
-/** The `@layer` statement an admin's index.html opens with: the library's layer sits between Vuetify's overrides and its utilities. */
+/**
+ * The `@layer` statement an admin's index.html opens with: the library's layer sits between Vuetify's overrides and its utilities.
+ */
 export declare const CSS_LAYER_ORDER: readonly ["vuetify-core", "vuetify-components", "vuetify-overrides", "anzu-common", "vuetify-utilities", "vuetify-final"];
 /**
  * Vuetify's sub-layers, in the order its `main.css` declares them. Its component stylesheets name them
@@ -26,7 +27,6 @@ export declare const CSS_SUBLAYER_ORDER: {
     readonly 'vuetify-utilities': readonly ["theme-base", "typography", "helpers", "theme-background", "theme-foreground"];
     readonly 'vuetify-final': readonly ["transitions", "trumps"];
 };
-/** The statements an admin's index.html opens its first `<style>` with, one per line. */
 export declare const CSS_LAYER_STATEMENTS: readonly string[];
 /**
  * The library's stylesheet is one cascade layer, `anzu-common`. The `@layer` statement in index.html

package/dist/testing/appShell.js

@@ -1,6 +1,6 @@
 import { globKeyToSrcPath as e } from "./typedRouter.js";
 import { describe as t, expect as n, it as r } from "vitest";
-//#region src/testing/appShell.ts
+// src/testing/appShell.ts
 function i({ sources: i, host: a = "src/layouts/AppLayout.vue" }) {
 	let o = new Map(Object.entries(i).map(([t, n]) => [e(t), n]));
 	t("the alerts host", () => {
@@ -51,7 +51,6 @@ function c({ indexHtml: e }) {
 		});
 	});
 }
-//#endregion
 export { a as CSS_LAYER_ORDER, s as CSS_LAYER_STATEMENTS, o as CSS_SUBLAYER_ORDER, i as describeAlertHost, c as describeCssLayerOrder };
 
 //# sourceMappingURL=appShell.js.map

package/dist/testing/appShell.js.map

@@ -1 +1 @@
-{"version":3,"file":"appShell.js","names":["describeAlertHost","bySrcPath","sources","path","source","globKeyToSrcPath","it","host","template","expect","withHost","CSS_LAYER_ORDER","CSS_SUBLAYER_ORDER","CSS_LAYER_STATEMENTS","parent","layers","layer","describeCssLayerOrder","html","indexHtml","layerList","statement","leadingStatements","css","first","head","statements"],"sources":["../../src/testing/appShell.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest'\nimport { globKeyToSrcPath } from '@/testing/typedRouter'\n\nexport interface DescribeAlertHostOptions {\n  /** The admin's components: `import.meta.glob(['/src/**\\/*.vue', '!/src/test/**'], { query: '?raw', import: 'default', eager: true })`. */\n  sources: Record<string, string>\n  /** The component with the layout switch, which mounts `<AAlerts />`. */\n  host?: string\n}\n\n/**\n * Where the alerts land.\n *\n * `AAlerts` is the host every `showError` / `showWarning` renders into. It is mounted once, outside the\n * layout switch: by `ALayoutSwitch`, or next to the admin's own `<component :is=\"layout\">`. A host inside a\n * layout took the alerts it was showing away with it when the route switched layouts -- a start-up\n * error raised under the loader vanished the moment the drawer replaced it -- and a layout without one\n * had nowhere to show them at all.\n */\nexport function describeAlertHost({ sources, host = 'src/layouts/AppLayout.vue' }: DescribeAlertHostOptions): void {\n  const bySrcPath = new Map(Object.entries(sources).map(([path, source]) => [globKeyToSrcPath(path), source]))\n\n  describe('the alerts host', () => {\n    it(`is mounted once, in ${host}, before the layout switch`, () => {\n      const source = bySrcPath.get(host)\n      expect(source).toBeDefined()\n      const template = source!.slice(source!.indexOf('<template>'))\n\n      // `ALayoutSwitch` mounts it itself, before the layout it switches.\n      if (/<ALayoutSwitch\\b/.test(template)) {\n        expect(template.match(/<ALayoutSwitch\\b/g)).toHaveLength(1)\n        expect(template).not.toMatch(/<AAlerts/)\n        return\n      }\n      expect(template.match(/<AAlerts\\s*\\/>/g)).toHaveLength(1)\n      expect(template.indexOf('<AAlerts')).toBeLessThan(template.indexOf('<component :is'))\n    })\n\n    it('is nowhere else: no layout, page or component of its own', () => {\n      // A guard on the guard: the glob has to see the layouts for the assertion below to mean anything.\n      expect([...bySrcPath.keys()].filter((path) => path.startsWith('src/layouts/')).length).toBeGreaterThan(2)\n\n      const withHost = [...bySrcPath]\n        .filter(([path, source]) => !path.startsWith('src/test/') && /<(AAlerts|ALayoutSwitch)\\b/.test(source))\n        .map(([path]) => path)\n\n      expect(withHost).toEqual([host])\n    })\n  })\n}\n\n/** The `@layer` statement an admin's index.html opens with: the library's layer sits between Vuetify's overrides and its utilities. */\nexport const CSS_LAYER_ORDER = [\n  'vuetify-core',\n  'vuetify-components',\n  'vuetify-overrides',\n  'anzu-common',\n  'vuetify-utilities',\n  'vuetify-final',\n] as const\n\n/**\n * Vuetify's sub-layers, in the order its `main.css` declares them. Its component stylesheets name them\n * too (13 of them name `vuetify-final.trumps`), and a component stylesheet can load before `main.css`: in a\n * cms build one named `trumps` ahead of `transitions` and put the two in reverse.\n */\nexport const CSS_SUBLAYER_ORDER = {\n  'vuetify-core': ['reset', 'base'],\n  'vuetify-utilities': ['theme-base', 'typography', 'helpers', 'theme-background', 'theme-foreground'],\n  'vuetify-final': ['transitions', 'trumps'],\n} as const\n\n/** The statements an admin's index.html opens its first `<style>` with, one per line. */\nexport const CSS_LAYER_STATEMENTS: readonly string[] = [\n  `@layer ${CSS_LAYER_ORDER.join(', ')};`,\n  ...Object.entries(CSS_SUBLAYER_ORDER).map(\n    ([parent, layers]) => `@layer ${layers.map((layer) => `${parent}.${layer}`).join(', ')};`\n  ),\n]\n\n/**\n * The library's stylesheet is one cascade layer, `anzu-common`. The `@layer` statement in index.html\n * comes before every stylesheet, so it alone decides where that layer lands: after Vuetify's overrides\n * and before its utility classes, so that a utility in a template beats the library's styles. A layer\n * the statement does not name is appended after `vuetify-final`, above the utilities.\n *\n * Layers are ordered by first mention, so the statements only decide if nothing names a layer before\n * them: they have to open the first style in the page, in `<head>`, ahead of any stylesheet link and any\n * other rule. The same holds for Vuetify's sub-layers, which follow in the same `<style>`.\n */\nexport function describeCssLayerOrder({ indexHtml }: { indexHtml: string | undefined }): void {\n  describe('the cascade layer order in index.html', () => {\n    // What the browser does not apply as a style of the page: comments, and the contents of <noscript>\n    // and <template>.\n    const html = (indexHtml ?? '')\n      .replace(/<!--[\\s\\S]*?-->/g, '')\n      .replace(/<(noscript|template)\\b[\\s\\S]*?<\\/\\1\\s*>/gi, '')\n    const layerList = (statement: string | undefined) =>\n      /^@layer\\s+([^;{]+);$/\n        .exec(statement ?? '')?.[1]\n        ?.split(',')\n        .map((layer) => layer.trim())\n    // The `@layer a, b;` statements a stylesheet opens with, up to its first other rule.\n    const leadingStatements = (css: string) =>\n      /^(?:\\s*@layer\\s[^;{]*;)*/.exec(css.replace(/\\/\\*[\\s\\S]*?\\*\\//g, ''))![0].match(/@layer\\s[^;{]*;/g) ?? []\n\n    it('puts the library between the Vuetify overrides and the utilities', () => {\n      expect(layerList(/@layer\\s[^;{]*;/.exec(html)?.[0])).toEqual([...CSS_LAYER_ORDER])\n    })\n\n    const first =\n      /<style\\b[^>]*>([\\s\\S]*?)<\\/style>|<link\\b[^>]*\\brel\\s*=\\s*[\"']?(?:stylesheet|preload\\b[^>]*\\bas\\s*=\\s*[\"']?style)\\b[^>]*>/i.exec(\n        html\n      )\n\n    it('opens the first style in the page', () => {\n      expect(first?.[0], 'the first <style> or stylesheet <link>').toMatch(/^<style/i)\n      const head = html.search(/<\\/head\\s*>/i)\n      if (head >= 0) expect(first!.index, 'the first <style> is in <head>').toBeLessThan(head)\n      expect(layerList(leadingStatements(first?.[1] ?? '')[0]), 'the first rule of the first <style>').toEqual([\n        ...CSS_LAYER_ORDER,\n      ])\n    })\n\n    it(\"orders Vuetify's sub-layers right after it\", () => {\n      const statements = leadingStatements(first?.[1] ?? '').slice(1)\n      expect(statements.slice(0, CSS_LAYER_STATEMENTS.length - 1).map(layerList)).toEqual(\n        CSS_LAYER_STATEMENTS.slice(1).map(layerList)\n      )\n    })\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"appShell.js","names":["describeAlertHost","bySrcPath","sources","path","source","globKeyToSrcPath","it","host","template","expect","withHost","CSS_LAYER_ORDER","CSS_SUBLAYER_ORDER","CSS_LAYER_STATEMENTS","parent","layers","layer","describeCssLayerOrder","html","indexHtml","layerList","statement","leadingStatements","css","first","head","statements"],"sources":["../../src/testing/appShell.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest'\nimport { globKeyToSrcPath } from '@/testing/typedRouter'\n\nexport interface DescribeAlertHostOptions {\n  /**\n   * The admin's components: `import.meta.glob(['/src/**\\/*.vue', '!/src/test/**'], { query: '?raw', import: 'default', eager: true })`.\n   */\n  sources: Record<string, string>\n  host?: string\n}\n\n/**\n * `AAlerts` is the host every `showError` / `showWarning` renders into. It is mounted once, outside\n * the layout switch: by `ALayoutSwitch`, or next to the admin's own `<component :is=\"layout\">`.\n * A host inside a layout takes its alerts away when the route switches layouts.\n * A start-up error raised under the loader vanished when the drawer replaced it.\n * A layout without a host has nowhere to show alerts.\n */\nexport function describeAlertHost({ sources, host = 'src/layouts/AppLayout.vue' }: DescribeAlertHostOptions): void {\n  const bySrcPath = new Map(Object.entries(sources).map(([path, source]) => [globKeyToSrcPath(path), source]))\n\n  describe('the alerts host', () => {\n    it(`is mounted once, in ${host}, before the layout switch`, () => {\n      const source = bySrcPath.get(host)\n      expect(source).toBeDefined()\n      const template = source!.slice(source!.indexOf('<template>'))\n\n      if (/<ALayoutSwitch\\b/.test(template)) {\n        expect(template.match(/<ALayoutSwitch\\b/g)).toHaveLength(1)\n        expect(template).not.toMatch(/<AAlerts/)\n        return\n      }\n      expect(template.match(/<AAlerts\\s*\\/>/g)).toHaveLength(1)\n      expect(template.indexOf('<AAlerts')).toBeLessThan(template.indexOf('<component :is'))\n    })\n\n    it('is nowhere else: no layout, page or component of its own', () => {\n      // A guard on the guard: the glob has to see the layouts for the assertion below to mean anything.\n      expect([...bySrcPath.keys()].filter((path) => path.startsWith('src/layouts/')).length).toBeGreaterThan(2)\n\n      const withHost = [...bySrcPath]\n        .filter(([path, source]) => !path.startsWith('src/test/') && /<(AAlerts|ALayoutSwitch)\\b/.test(source))\n        .map(([path]) => path)\n\n      expect(withHost).toEqual([host])\n    })\n  })\n}\n\n/**\n * The `@layer` statement an admin's index.html opens with: the library's layer sits between Vuetify's overrides and its utilities.\n */\nexport const CSS_LAYER_ORDER = [\n  'vuetify-core',\n  'vuetify-components',\n  'vuetify-overrides',\n  'anzu-common',\n  'vuetify-utilities',\n  'vuetify-final',\n] as const\n\n/**\n * Vuetify's sub-layers, in the order its `main.css` declares them. Its component stylesheets name them\n * too (13 of them name `vuetify-final.trumps`), and a component stylesheet can load before `main.css`: in a\n * cms build one named `trumps` ahead of `transitions` and put the two in reverse.\n */\nexport const CSS_SUBLAYER_ORDER = {\n  'vuetify-core': ['reset', 'base'],\n  'vuetify-utilities': ['theme-base', 'typography', 'helpers', 'theme-background', 'theme-foreground'],\n  'vuetify-final': ['transitions', 'trumps'],\n} as const\n\nexport const CSS_LAYER_STATEMENTS: readonly string[] = [\n  `@layer ${CSS_LAYER_ORDER.join(', ')};`,\n  ...Object.entries(CSS_SUBLAYER_ORDER).map(\n    ([parent, layers]) => `@layer ${layers.map((layer) => `${parent}.${layer}`).join(', ')};`\n  ),\n]\n\n/**\n * The library's stylesheet is one cascade layer, `anzu-common`. The `@layer` statement in index.html\n * comes before every stylesheet, so it alone decides where that layer lands: after Vuetify's overrides\n * and before its utility classes, so that a utility in a template beats the library's styles. A layer\n * the statement does not name is appended after `vuetify-final`, above the utilities.\n *\n * Layers are ordered by first mention, so the statements only decide if nothing names a layer before\n * them: they have to open the first style in the page, in `<head>`, ahead of any stylesheet link and any\n * other rule. The same holds for Vuetify's sub-layers, which follow in the same `<style>`.\n */\nexport function describeCssLayerOrder({ indexHtml }: { indexHtml: string | undefined }): void {\n  describe('the cascade layer order in index.html', () => {\n    const html = (indexHtml ?? '')\n      .replace(/<!--[\\s\\S]*?-->/g, '')\n      .replace(/<(noscript|template)\\b[\\s\\S]*?<\\/\\1\\s*>/gi, '')\n    const layerList = (statement: string | undefined) =>\n      /^@layer\\s+([^;{]+);$/\n        .exec(statement ?? '')?.[1]\n        ?.split(',')\n        .map((layer) => layer.trim())\n    const leadingStatements = (css: string) =>\n      /^(?:\\s*@layer\\s[^;{]*;)*/.exec(css.replace(/\\/\\*[\\s\\S]*?\\*\\//g, ''))![0].match(/@layer\\s[^;{]*;/g) ?? []\n\n    it('puts the library between the Vuetify overrides and the utilities', () => {\n      expect(layerList(/@layer\\s[^;{]*;/.exec(html)?.[0])).toEqual([...CSS_LAYER_ORDER])\n    })\n\n    const first =\n      /<style\\b[^>]*>([\\s\\S]*?)<\\/style>|<link\\b[^>]*\\brel\\s*=\\s*[\"']?(?:stylesheet|preload\\b[^>]*\\bas\\s*=\\s*[\"']?style)\\b[^>]*>/i.exec(\n        html\n      )\n\n    it('opens the first style in the page', () => {\n      expect(first?.[0], 'the first <style> or stylesheet <link>').toMatch(/^<style/i)\n      const head = html.search(/<\\/head\\s*>/i)\n      if (head >= 0) expect(first!.index, 'the first <style> is in <head>').toBeLessThan(head)\n      expect(layerList(leadingStatements(first?.[1] ?? '')[0]), 'the first rule of the first <style>').toEqual([\n        ...CSS_LAYER_ORDER,\n      ])\n    })\n\n    it(\"orders Vuetify's sub-layers right after it\", () => {\n      const statements = leadingStatements(first?.[1] ?? '').slice(1)\n      expect(statements.slice(0, CSS_LAYER_STATEMENTS.length - 1).map(layerList)).toEqual(\n        CSS_LAYER_STATEMENTS.slice(1).map(layerList)\n      )\n    })\n  })\n}\n"],"mappings":";;;AAkBA,SAAgBA,EAAkB,EAAE,YAAS,UAAO,+BAA+D;CACjH,IAAMC,IAAY,IAAI,IAAI,OAAO,QAAQC,CAAO,CAAC,CAAC,KAAK,CAACC,GAAMC,OAAY,CAACC,EAAiBF,CAAI,GAAGC,CAAM,CAAC,CAAC;CAE3G,EAAS,yBAAyB;EAehC,AAdAE,EAAG,uBAAuBC,EAAK,mCAAmC;GAChE,IAAMH,IAASH,EAAU,IAAIM,CAAI;GACjC,EAAOH,CAAM,CAAC,CAAC,YAAY;GAC3B,IAAMI,IAAWJ,EAAQ,MAAMA,EAAQ,QAAQ,YAAY,CAAC;GAE5D,AAAI,mBAAmB,KAAKI,CAAQ,KAClCC,EAAOD,EAAS,MAAM,mBAAmB,CAAC,CAAC,CAAC,aAAa,CAAC,GAC1DC,EAAOD,CAAQ,CAAC,CAAC,IAAI,QAAQ,UAAU,MAGzCC,EAAOD,EAAS,MAAM,iBAAiB,CAAC,CAAC,CAAC,aAAa,CAAC,GACxDC,EAAOD,EAAS,QAAQ,UAAU,CAAC,CAAC,CAAC,aAAaA,EAAS,QAAQ,gBAAgB,CAAC;EACtF,CAAC,GAEDF,EAAG,kEAAkE;GAEnE,EAAO,CAAC,GAAGL,EAAU,KAAK,CAAC,CAAC,CAAC,QAAQ,MAASE,EAAK,WAAW,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC;GAExG,IAAMO,IAAW,CAAC,GAAGT,CAAS,CAAC,CAC5B,QAAQ,CAACE,GAAMC,OAAY,CAACD,EAAK,WAAW,WAAW,KAAK,6BAA6B,KAAKC,CAAM,CAAC,CAAC,CACtG,KAAK,CAACD,OAAUA,CAAI;GAEvB,EAAOO,CAAQ,CAAC,CAAC,QAAQ,CAACH,CAAI,CAAC;EACjC,CAAC;CACH,CAAC;AACH;AAKA,IAAaI,IAAkB;CAC7B;CACA;CACA;CACA;CACA;CACA;AACF,GAOaC,IAAqB;CAChC,gBAAgB,CAAC,SAAS,MAAM;CAChC,qBAAqB;EAAC;EAAc;EAAc;EAAW;EAAoB;CAAkB;CACnG,iBAAiB,CAAC,eAAe,QAAQ;AAC3C,GAEaC,IAA0C,CACrD,UAAUF,EAAgB,KAAK,IAAI,EAAE,IACrC,GAAG,OAAO,QAAQC,CAAkB,CAAC,CAAC,KACnC,CAACE,GAAQC,OAAY,UAAUA,EAAO,KAAK,MAAU,GAAGD,EAAO,GAAGE,GAAO,CAAC,CAAC,KAAK,IAAI,EAAE,EACzF,CACF;AAYA,SAAgBC,EAAsB,EAAE,gBAAsD;CAC5F,EAAS,+CAA+C;EACtD,IAAMC,KAAQC,KAAa,GAAA,CACxB,QAAQ,oBAAoB,EAAE,CAAC,CAC/B,QAAQ,6CAA6C,EAAE,GACpDC,KAAa,MACjB,uBACG,KAAKC,KAAa,EAAE,CAAC,GAAG,EAAE,EACzB,MAAM,GAAG,CAAC,CACX,KAAK,MAAUL,EAAM,KAAK,CAAC,GAC1BM,KAAqB,MACzB,2BAA2B,KAAKC,EAAI,QAAQ,qBAAqB,EAAE,CAAC,CAAC,CAAE,EAAE,CAAC,MAAM,kBAAkB,KAAK,CAAC;EAE1G,EAAG,0EAA0E;GAC3E,EAAOH,EAAU,kBAAkB,KAAKF,CAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAGP,CAAe,CAAC;EACnF,CAAC;EAED,IAAMa,IACJ,6HAA6H,KAC3HN,CACF;EAWF,AATAZ,EAAG,2CAA2C;GAC5C,EAAOkB,IAAQ,IAAI,wCAAwC,CAAC,CAAC,QAAQ,UAAU;GAC/E,IAAMC,IAAOP,EAAK,OAAO,cAAc;GAEvC,AADIO,KAAQ,KAAGhB,EAAOe,EAAO,OAAO,gCAAgC,CAAC,CAAC,aAAaC,CAAI,GACvFhB,EAAOW,EAAUE,EAAkBE,IAAQ,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,qCAAqC,CAAC,CAAC,QAAQ,CACvG,GAAGb,CACL,CAAC;EACH,CAAC,GAEDL,EAAG,oDAAoD;GACrD,IAAMoB,IAAaJ,EAAkBE,IAAQ,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;GAC9D,EAAOE,EAAW,MAAM,GAAGb,EAAqB,SAAS,CAAC,CAAC,CAAC,IAAIO,CAAS,CAAC,CAAC,CAAC,QAC1EP,EAAqB,MAAM,CAAC,CAAC,CAAC,IAAIO,CAAS,CAC7C;EACF,CAAC;CACH,CAAC;AACH"}

package/dist/testing/closeButtons.d.ts

@@ -1,21 +1,19 @@
 export interface DescribeCloseButtonsOptions {
-    /** Every `.vue` of the admin: `import.meta.glob('/src/**\/*.vue', { query: '?raw', import: 'default', eager: true })`. */
+    /**
+     * Every `.vue` of the admin: `import.meta.glob('/src/**\/*.vue', { query: '?raw', import: 'default', eager: true })`.
+     */
     sources: Record<string, string>;
-    /** `src/typed-router.d.ts`, imported with `?raw`. */
     declaration: string;
-    /** The admin's route history blacklist. */
     routeHistoryBlacklist: readonly string[];
     /** How many buttons may compute their fallback, which two checks cannot read. */
     maxComputedFallbacks?: number;
 }
 /**
- * The close buttons and the two route lists each one carries.
- *
- * `AActionCloseButtonHistory` walks the recorded history backwards for the first entry whose name is
- * not in `skipRouteNames`, and falls back to `fallbackRouteName` only when that walk comes up empty.
- * Both lists are plain strings inside a template: `anzu/valid-route-name` only reaches route names
- * written in `<script>`, and nothing type-checks a string in an attribute. Rename a page and the lists
- * keep the old name, silently -- a skip list that no longer names the view it sits on hands the user
- * straight back to the view they just closed.
+ * `AActionCloseButtonHistory` walks the recorded history backwards for the first entry
+ * not in `skipRouteNames`. It uses `fallbackRouteName` only when that walk finds nothing.
+ * Both lists are plain strings in a template. `anzu/valid-route-name` only
+ * checks names in `<script>`, and nothing type-checks an attribute string.
+ * After a page rename the lists silently keep the old name. A skip list that no
+ * longer names its own view sends the user back to the view they just closed.
  */
 export declare function describeCloseButtons({ sources, declaration, routeHistoryBlacklist, maxComputedFallbacks, }: DescribeCloseButtonsOptions): void;

package/dist/testing/closeButtons.js

@@ -1,6 +1,6 @@
 import { globKeyToSrcPath as e, parseTypedRouterDeclaration as t } from "./typedRouter.js";
 import { describe as n, expect as r, it as i } from "vitest";
-//#region src/testing/closeButtons.ts
+// src/testing/closeButtons.ts
 function a({ sources: a, declaration: o, routeHistoryBlacklist: s, maxComputedFallbacks: c = 3 }) {
 	let l = t(o), u = new Set(l.names), d = l.pageRoutes, f = /* @__PURE__ */ new Map();
 	for (let [t, n] of Object.entries(a)) for (let [, r] of n.matchAll(/from\s+'(@\/[^']+\.vue)'/g)) {
@@ -54,7 +54,6 @@ function a({ sources: a, declaration: o, routeHistoryBlacklist: s, maxComputedFa
 		});
 	});
 }
-//#endregion
 export { a as describeCloseButtons };
 
 //# sourceMappingURL=closeButtons.js.map

package/dist/testing/closeButtons.js.map

@@ -1 +1 @@
-{"version":3,"file":"closeButtons.js","names":["describeCloseButtons","parsed","parseTypedRouterDeclaration","declaration","routeNames","pageRoutes","importedBy","path","source","sources","target","key","globKeyToSrcPath","owningRoutes","seen","file","parent","listOf","match","attrs","name","value","buttons","recordPrefix","parts","i","closableRoutes","it","plain","own","expect","skip","fallback","expected","record","other","listing","created","bad","label","computed","fallbackComputed","maxComputedFallbacks","routeHistoryBlacklist","blacklisted"],"sources":["../../src/testing/closeButtons.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest'\nimport { globKeyToSrcPath, parseTypedRouterDeclaration } from '@/testing/typedRouter'\n\nexport interface DescribeCloseButtonsOptions {\n  /** Every `.vue` of the admin: `import.meta.glob('/src/**\\/*.vue', { query: '?raw', import: 'default', eager: true })`. */\n  sources: Record<string, string>\n  /** `src/typed-router.d.ts`, imported with `?raw`. */\n  declaration: string\n  /** The admin's route history blacklist. */\n  routeHistoryBlacklist: readonly string[]\n  /** How many buttons may compute their fallback, which two checks cannot read. */\n  maxComputedFallbacks?: number\n}\n\n/**\n * The close buttons and the two route lists each one carries.\n *\n * `AActionCloseButtonHistory` walks the recorded history backwards for the first entry whose name is\n * not in `skipRouteNames`, and falls back to `fallbackRouteName` only when that walk comes up empty.\n * Both lists are plain strings inside a template: `anzu/valid-route-name` only reaches route names\n * written in `<script>`, and nothing type-checks a string in an attribute. Rename a page and the lists\n * keep the old name, silently -- a skip list that no longer names the view it sits on hands the user\n * straight back to the view they just closed.\n */\nexport function describeCloseButtons({\n  sources,\n  declaration,\n  routeHistoryBlacklist,\n  maxComputedFallbacks = 3,\n}: DescribeCloseButtonsOptions): void {\n  const parsed = parseTypedRouterDeclaration(declaration)\n  const routeNames = new Set(parsed.names)\n  const pageRoutes = parsed.pageRoutes\n\n  const importedBy = new Map<string, Set<string>>()\n  for (const [path, source] of Object.entries(sources)) {\n    for (const [, target] of source.matchAll(/from\\s+'(@\\/[^']+\\.vue)'/g)) {\n      const key = target!.replace(/^@\\//, 'src/')\n      if (!importedBy.has(key)) importedBy.set(key, new Set())\n      importedBy.get(key)!.add(globKeyToSrcPath(path))\n    }\n  }\n\n  // A button sitting in a shared component belongs to whichever pages render it, however many\n  // levels of component sit in between.\n  const owningRoutes = (file: string, seen = new Set<string>()): string[] => {\n    if (seen.has(file)) return []\n    seen.add(file)\n    const own = pageRoutes.get(file)\n    if (own) return own\n    return [...(importedBy.get(file) ?? [])].flatMap((parent) => owningRoutes(parent, seen))\n  }\n\n  const listOf = (attrs: string, name: string) => {\n    const match = attrs.match(new RegExp(`:${name}=\"([^\"]*)\"`))\n    return match ? [...match[1]!.matchAll(/'([^']*)'/g)].map(([, value]) => value!) : undefined\n  }\n\n  const buttons = Object.entries(sources).flatMap(([path, source]) =>\n    [...source.matchAll(/<AActionCloseButtonHistory(?![A-Za-z])([^>]*?)\\/>/g)].map(([, attrs]) => ({\n      file: globKeyToSrcPath(path),\n      label: globKeyToSrcPath(path),\n      // Absent means \"nothing beyond my own route\", which the library skips anyway -- the button\n      // defaults the prop to an empty list, so it still walks back by name.\n      skip: listOf(attrs!, 'skip-route-names') ?? [],\n      // A handful of buttons compute their destination, and those hold an expression rather than a\n      // literal -- the walk still has to be right, only the fallback cannot be read from here.\n      fallback: listOf(attrs!, 'fallback-route-name'),\n      // Told apart from a missing prop, so the checks that need a literal skip such a button loudly\n      // rather than passing over it.\n      fallbackComputed: /:fallback-route-name=\"/.test(attrs!) && !listOf(attrs!, 'fallback-route-name')?.length,\n    }))\n  )\n\n  // The longest prefix of a route whose last segment is dynamic -- `/x/[id]/edit` -> `/x/[id]`.\n  // Everything at or under it is another view of the same record.\n  const recordPrefix = (name: string) => {\n    const parts = name.split('/')\n    for (let i = parts.length - 1; i > 0; i--) {\n      if (/\\[[^\\]]*\\]/.test(parts[i]!)) return parts.slice(0, i + 1).join('/')\n    }\n    return name\n  }\n\n  const closableRoutes = [...new Set(buttons.flatMap(({ file }) => owningRoutes(file)))]\n\n  describe('close buttons', () => {\n    it('finds every button, and none of the plain variant', () => {\n      // A guard on the guard: were the glob to stop matching, every assertion below would iterate an\n      // empty list and pass while checking nothing.\n      expect(buttons.length).toBeGreaterThan(0)\n\n      const plain = Object.entries(sources)\n        .filter(([, source]) => /<AActionCloseButton(?![A-Za-z])/.test(source))\n        .map(([path]) => globKeyToSrcPath(path))\n\n      // The plain button navigates to a fixed route, so closing a record always lands on its listing\n      // even when the user arrived from somewhere else entirely.\n      expect(plain).toEqual([])\n    })\n\n    it.each(buttons)('$label does not repeat the route it sits on', ({ file, skip }) => {\n      // `navigateBack` skips the current route itself, so naming it here says nothing and is one\n      // more string to go stale when a page is renamed.\n      const own = owningRoutes(file)\n      expect(own).not.toEqual([])\n\n      if (own.length === 1) {\n        expect(skip).not.toContain(own[0])\n        return\n      }\n\n      // A component rendered by more than one page is the other way round: only the ACTIVE route is\n      // skipped for it, so every route it can appear on has to be named or closing one view hands the\n      // user straight into its sibling.\n      expect(own.filter((name) => !skip.includes(name))).toEqual([])\n    })\n\n    it.each(buttons)('$label names the sibling views of the record it closes', ({ file, skip, fallback }) => {\n      // The walk must not hand back another view OF THE SAME RECORD -- its edit form, a deeper\n      // record underneath it, or the create form a save redirected away from. Those are the ones\n      // the caller still has to name.\n      // Minus the fallback: a handful of edit views close one level up into their own detail rather\n      // than to a listing, and that route is the destination, not something to walk past.\n      const own = [...owningRoutes(file), ...(fallback ?? [])]\n      const expected = new Set<string>()\n      for (const name of owningRoutes(file)) {\n        const record = recordPrefix(name)\n        for (const other of closableRoutes) {\n          if (own.includes(other)) continue\n          if (other === record || other.startsWith(`${record}/`)) expected.add(other)\n        }\n        // Only when the fallback really is this record's own listing: creating pushes to the detail,\n        // so closing the detail must not walk back into the empty form. A button that closes across\n        // entities -- a stats detail returning to the jobs listing -- was never reached that way.\n        const listing = fallback?.[0] ?? ''\n        const created = `${listing}/new`\n        const ownListing = listing !== '' && name.startsWith(`${listing}/`)\n        if (ownListing && /\\[[^\\]]*\\]/.test(name) && routeNames.has(created) && !own.includes(created)) {\n          expected.add(created)\n        }\n      }\n\n      expect([...expected].filter((name) => !skip.includes(name))).toEqual([])\n    })\n\n    it.each(buttons)('$label points at routes that exist', ({ skip, fallback }) => {\n      expect([...skip, ...(fallback ?? [])].filter((name) => !routeNames.has(name))).toEqual([])\n    })\n\n    it('never skips the route it falls back to', () => {\n      // The fallback is where the author wants the user to land -- almost always the listing, but a\n      // handful of views close one level up into a parent record instead. Skipping that route would\n      // walk straight past the intended destination and only reach it in a fresh tab, where there is\n      // no history left to walk.\n      const bad = buttons.flatMap(({ label, skip, fallback }) =>\n        (fallback ?? []).filter((name) => skip.includes(name)).map((name) => `${label}: ${name}`)\n      )\n\n      expect(bad).toEqual([])\n    })\n\n    it('says how many buttons compute their fallback', () => {\n      // Two checks need a literal to read: \"points at routes that exist\" and \"never skips the route\n      // it falls back to\". A button whose fallback is a template expression is outside both, and\n      // silently so -- this states the size of that gap instead of leaving it invisible. The sibling\n      // check does still cover them, since it derives from the routes they sit on.\n      const computed = buttons.filter(({ fallbackComputed }) => fallbackComputed).map(({ label }) => label)\n\n      expect(computed.length).toBeLessThanOrEqual(maxComputedFallbacks)\n    })\n\n    it('blacklists only routes that exist', () => {\n      expect(routeHistoryBlacklist.filter((name) => !routeNames.has(name))).toEqual([])\n    })\n\n    it('never blacklists a route a close button falls back to', () => {\n      // The fallback is the last resort when history holds nothing to return to. Pointing it at a\n      // blacklisted route is not an error in itself -- the push still works -- but it means the\n      // button leads somewhere the app has decided is not a place to be.\n      const blacklisted = new Set(routeHistoryBlacklist)\n      const bad = buttons.flatMap(({ label, fallback }) =>\n        (fallback ?? []).filter((name) => blacklisted.has(name)).map((name) => `${label}: ${name}`)\n      )\n\n      expect(bad).toEqual([])\n    })\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"closeButtons.js","names":["describeCloseButtons","parsed","parseTypedRouterDeclaration","declaration","routeNames","pageRoutes","importedBy","path","source","sources","target","key","globKeyToSrcPath","owningRoutes","seen","file","parent","listOf","match","attrs","name","value","buttons","recordPrefix","parts","i","closableRoutes","it","plain","own","expect","skip","fallback","expected","record","other","listing","created","bad","label","computed","fallbackComputed","maxComputedFallbacks","routeHistoryBlacklist","blacklisted"],"sources":["../../src/testing/closeButtons.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest'\nimport { globKeyToSrcPath, parseTypedRouterDeclaration } from '@/testing/typedRouter'\n\nexport interface DescribeCloseButtonsOptions {\n  /**\n   * Every `.vue` of the admin: `import.meta.glob('/src/**\\/*.vue', { query: '?raw', import: 'default', eager: true })`.\n   */\n  sources: Record<string, string>\n  declaration: string\n  routeHistoryBlacklist: readonly string[]\n  /** How many buttons may compute their fallback, which two checks cannot read. */\n  maxComputedFallbacks?: number\n}\n\n/**\n * `AActionCloseButtonHistory` walks the recorded history backwards for the first entry\n * not in `skipRouteNames`. It uses `fallbackRouteName` only when that walk finds nothing.\n * Both lists are plain strings in a template. `anzu/valid-route-name` only\n * checks names in `<script>`, and nothing type-checks an attribute string.\n * After a page rename the lists silently keep the old name. A skip list that no\n * longer names its own view sends the user back to the view they just closed.\n */\nexport function describeCloseButtons({\n  sources,\n  declaration,\n  routeHistoryBlacklist,\n  maxComputedFallbacks = 3,\n}: DescribeCloseButtonsOptions): void {\n  const parsed = parseTypedRouterDeclaration(declaration)\n  const routeNames = new Set(parsed.names)\n  const pageRoutes = parsed.pageRoutes\n\n  const importedBy = new Map<string, Set<string>>()\n  for (const [path, source] of Object.entries(sources)) {\n    for (const [, target] of source.matchAll(/from\\s+'(@\\/[^']+\\.vue)'/g)) {\n      const key = target!.replace(/^@\\//, 'src/')\n      if (!importedBy.has(key)) importedBy.set(key, new Set())\n      importedBy.get(key)!.add(globKeyToSrcPath(path))\n    }\n  }\n\n  // A button sitting in a shared component belongs to whichever pages render it, however many\n  // levels of component sit in between.\n  const owningRoutes = (file: string, seen = new Set<string>()): string[] => {\n    if (seen.has(file)) return []\n    seen.add(file)\n    const own = pageRoutes.get(file)\n    if (own) return own\n    return [...(importedBy.get(file) ?? [])].flatMap((parent) => owningRoutes(parent, seen))\n  }\n\n  const listOf = (attrs: string, name: string) => {\n    const match = attrs.match(new RegExp(`:${name}=\"([^\"]*)\"`))\n    return match ? [...match[1]!.matchAll(/'([^']*)'/g)].map(([, value]) => value!) : undefined\n  }\n\n  const buttons = Object.entries(sources).flatMap(([path, source]) =>\n    [...source.matchAll(/<AActionCloseButtonHistory(?![A-Za-z])([^>]*?)\\/>/g)].map(([, attrs]) => ({\n      file: globKeyToSrcPath(path),\n      label: globKeyToSrcPath(path),\n      // Absent means \"nothing beyond my own route\", which the library skips anyway.\n      // The button defaults the prop to an empty list, so it still walks back by name.\n      skip: listOf(attrs!, 'skip-route-names') ?? [],\n      // A few buttons compute their destination, so they hold an expression, not a literal.\n      // The walk must still be right. Only the fallback cannot be read here.\n      fallback: listOf(attrs!, 'fallback-route-name'),\n      // Told apart from a missing prop, so the checks that need a literal skip such a button loudly\n      // rather than passing over it.\n      fallbackComputed: /:fallback-route-name=\"/.test(attrs!) && !listOf(attrs!, 'fallback-route-name')?.length,\n    }))\n  )\n\n  // The longest prefix of a route whose last segment is dynamic: `/x/[id]/edit` -> `/x/[id]`.\n  // Everything at or under it is another view of the same record.\n  const recordPrefix = (name: string) => {\n    const parts = name.split('/')\n    for (let i = parts.length - 1; i > 0; i--) {\n      if (/\\[[^\\]]*\\]/.test(parts[i]!)) return parts.slice(0, i + 1).join('/')\n    }\n    return name\n  }\n\n  const closableRoutes = [...new Set(buttons.flatMap(({ file }) => owningRoutes(file)))]\n\n  describe('close buttons', () => {\n    it('finds every button, and none of the plain variant', () => {\n      // A guard on the guard: were the glob to stop matching, every assertion below would iterate an\n      // empty list and pass while checking nothing.\n      expect(buttons.length).toBeGreaterThan(0)\n\n      const plain = Object.entries(sources)\n        .filter(([, source]) => /<AActionCloseButton(?![A-Za-z])/.test(source))\n        .map(([path]) => globKeyToSrcPath(path))\n\n      // The plain button navigates to a fixed route, so closing a record always lands on its listing\n      // even when the user arrived from somewhere else entirely.\n      expect(plain).toEqual([])\n    })\n\n    it.each(buttons)('$label does not repeat the route it sits on', ({ file, skip }) => {\n      // `navigateBack` skips the current route itself, so naming it here says nothing and is one\n      // more string to go stale when a page is renamed.\n      const own = owningRoutes(file)\n      expect(own).not.toEqual([])\n\n      if (own.length === 1) {\n        expect(skip).not.toContain(own[0])\n        return\n      }\n\n      // A component rendered by more than one page is the other way round: only the ACTIVE route is\n      // skipped for it, so every route it can appear on has to be named or closing one view hands the\n      // user straight into its sibling.\n      expect(own.filter((name) => !skip.includes(name))).toEqual([])\n    })\n\n    it.each(buttons)('$label names the sibling views of the record it closes', ({ file, skip, fallback }) => {\n      // The walk must not hand back another view OF THE SAME RECORD -- its edit form, a deeper\n      // record underneath it, or the create form a save redirected away from. Those are the ones\n      // the caller still has to name.\n      // Minus the fallback: a handful of edit views close one level up into their own detail rather\n      // than to a listing, and that route is the destination, not something to walk past.\n      const own = [...owningRoutes(file), ...(fallback ?? [])]\n      const expected = new Set<string>()\n      for (const name of owningRoutes(file)) {\n        const record = recordPrefix(name)\n        for (const other of closableRoutes) {\n          if (own.includes(other)) continue\n          if (other === record || other.startsWith(`${record}/`)) expected.add(other)\n        }\n        // Only when the fallback is this record's own listing: creating pushes to\n        // the detail, so closing the detail must not walk back into the empty form.\n        // A button that closes across entities, such as a stats detail\n        // returning to the jobs listing, was never reached that way.\n        const listing = fallback?.[0] ?? ''\n        const created = `${listing}/new`\n        const ownListing = listing !== '' && name.startsWith(`${listing}/`)\n        if (ownListing && /\\[[^\\]]*\\]/.test(name) && routeNames.has(created) && !own.includes(created)) {\n          expected.add(created)\n        }\n      }\n\n      expect([...expected].filter((name) => !skip.includes(name))).toEqual([])\n    })\n\n    it.each(buttons)('$label points at routes that exist', ({ skip, fallback }) => {\n      expect([...skip, ...(fallback ?? [])].filter((name) => !routeNames.has(name))).toEqual([])\n    })\n\n    it('never skips the route it falls back to', () => {\n      // The fallback is where the author wants the user to land. Usually that is\n      // the listing, but a few views close one level up into a parent record.\n      // Skipping that route would walk past the intended destination and\n      // reach it only in a fresh tab, where there is no history to walk.\n      const bad = buttons.flatMap(({ label, skip, fallback }) =>\n        (fallback ?? []).filter((name) => skip.includes(name)).map((name) => `${label}: ${name}`)\n      )\n\n      expect(bad).toEqual([])\n    })\n\n    it('says how many buttons compute their fallback', () => {\n      // Two checks need a literal: \"points at routes that exist\" and \"never skips the route it falls back to\".\n      // A button whose fallback is a template expression is outside\n      // both, silently. This test states the size of that gap.\n      // The sibling check still covers them, since it derives from the routes they sit on.\n      const computed = buttons.filter(({ fallbackComputed }) => fallbackComputed).map(({ label }) => label)\n\n      expect(computed.length).toBeLessThanOrEqual(maxComputedFallbacks)\n    })\n\n    it('blacklists only routes that exist', () => {\n      expect(routeHistoryBlacklist.filter((name) => !routeNames.has(name))).toEqual([])\n    })\n\n    it('never blacklists a route a close button falls back to', () => {\n      // The fallback is the last resort when history holds nothing to return to.\n      // Pointing it at a blacklisted route is not an error, since the push works. But\n      // the button then leads somewhere the app has decided is not a place to be.\n      const blacklisted = new Set(routeHistoryBlacklist)\n      const bad = buttons.flatMap(({ label, fallback }) =>\n        (fallback ?? []).filter((name) => blacklisted.has(name)).map((name) => `${label}: ${name}`)\n      )\n\n      expect(bad).toEqual([])\n    })\n  })\n}\n"],"mappings":"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"}

package/dist/testing/declaredDependencies.d.ts

@@ -5,9 +5,10 @@ export interface PackageJsonDependencies {
     optionalDependencies?: Record<string, string>;
 }
 export interface DescribeDeclaredDependenciesOptions {
-    /** The admin's sources: `import.meta.glob('/src/**\/*.{vue,ts,mts,scss}', { query: '?raw', import: 'default', eager: true })`. */
+    /**
+     * The admin's sources: `import.meta.glob('/src/**\/*.{vue,ts,mts,scss}', { query: '?raw', import: 'default', eager: true })`.
+     */
     sources: Record<string, string>;
-    /** The admin's `package.json`. */
     packageJson: PackageJsonDependencies;
     /** Bare specifier prefixes that name no package: the admin's own aliases (`@/` is built in). */
     aliases?: string[];
@@ -15,12 +16,11 @@ export interface DescribeDeclaredDependenciesOptions {
 export declare const withoutComments: (source: string) => string;
 /** The package a bare specifier imports from, or `null` for a relative path, an alias or a `scheme:` module. */
 export declare const packageOfSpecifier: (specifier: string, aliases?: string[]) => string | null;
-/** `file: specifier` for every import of a package the `package.json` does not declare. */
 export declare function undeclaredImports(sources: Record<string, string>, packageJson: PackageJsonDependencies, aliases?: string[]): string[];
 /**
- * A package the admin imports but does not declare works as long as another dependency brings it and the
- * package manager hoists it to the top of `node_modules` (yarn's `node-modules` linker does). Its version
- * is then whatever that dependency asks for, and a strict layout -- pnpm, or yarn's own PnP -- does not
- * hoist: the build stops at the first such import.
+ * An undeclared import works while another dependency brings the package and the package
+ * manager hoists it to the top of `node_modules` (yarn's `node-modules` linker does).
+ * Its version is then whatever that dependency asks for.
+ * A strict layout (pnpm, yarn PnP) does not hoist, so the build stops at the first such import.
  */
 export declare function describeDeclaredDependencies({ sources, packageJson, aliases, }: DescribeDeclaredDependenciesOptions): void;

package/dist/testing/declaredDependencies.js

@@ -1,6 +1,6 @@
 import { globKeyToSrcPath as e } from "./typedRouter.js";
 import { describe as t, expect as n, it as r } from "vitest";
-//#region src/testing/declaredDependencies.ts
+// src/testing/declaredDependencies.ts
 var i = /(?:(@(?:use|forward|import)\s+)|\bfrom\s+|\bimport\s*\(\s*|\bimport\s+|\brequire\s*\(\s*|\bvi\.(?:mock|doMock|importActual)\s*(?:<[^>]*>)?\(\s*)(['"])([^'"\s]+)\2(?=\s*(?:[;),]|$|with\s*[({]|assert\s*\{|as\s+[\w*-]+\s*;|show\b|hide\b))/gm, a = /\bdeclare\s+module\s+(['"])([^'"\s*]+)\1\s*\{/g, o = /(?:^|[^\w$])(?:return|typeof|instanceof|in|of|new|delete|void|throw|case|default|do|else|await|yield)$/, s = /* @__PURE__ */ new Set([
 	"",
 	"(",
@@ -103,7 +103,6 @@ function m({ sources: e, packageJson: i, aliases: a = [] }) {
 		});
 	});
 }
-//#endregion
 export { m as describeDeclaredDependencies, f as packageOfSpecifier, p as undeclaredImports, c as withoutComments };
 
 //# sourceMappingURL=declaredDependencies.js.map

package/dist/testing/declaredDependencies.js.map

@@ -1 +1 @@
-{"version":3,"file":"declaredDependencies.js","names":["SPECIFIER_RE","DECLARE_MODULE_RE","REGEX_AFTER_KEYWORD","REGEX_CAN_FOLLOW","withoutComments","out","previous","i","copyQuoted","start","source","quote","char","next","end","inClass","codeOf","key","block","isStylePartial","dir","at","specifier","sub","name","keys","ext","NODE_BUILTINS","packageOfSpecifier","path","aliases","alias","parts","undeclaredImports","declared","packageJson","deps","sources","found","code","match","globKeyToSrcPath","describeDeclaredDependencies","it"],"sources":["../../src/testing/declaredDependencies.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest'\nimport { globKeyToSrcPath } from '@/testing/typedRouter'\n\nexport interface PackageJsonDependencies {\n  dependencies?: Record<string, string>\n  devDependencies?: Record<string, string>\n  peerDependencies?: Record<string, string>\n  optionalDependencies?: Record<string, string>\n}\n\nexport interface DescribeDeclaredDependenciesOptions {\n  /** The admin's sources: `import.meta.glob('/src/**\\/*.{vue,ts,mts,scss}', { query: '?raw', import: 'default', eager: true })`. */\n  sources: Record<string, string>\n  /** The admin's `package.json`. */\n  packageJson: PackageJsonDependencies\n  /** Bare specifier prefixes that name no package: the admin's own aliases (`@/` is built in). */\n  aliases?: string[]\n}\n\n// Module specifiers in code (static, `export … from`, side-effect and dynamic imports, `require`, the vitest\n// module helpers, `typeof import()`) and in styles (`@use`, `@forward`, `@import`; group 1). A specifier has\n// no whitespace and ends its statement or call, which leaves out prose such as `it('… from \"now\"')`.\nconst SPECIFIER_RE =\n  /(?:(@(?:use|forward|import)\\s+)|\\bfrom\\s+|\\bimport\\s*\\(\\s*|\\bimport\\s+|\\brequire\\s*\\(\\s*|\\bvi\\.(?:mock|doMock|importActual)\\s*(?:<[^>]*>)?\\(\\s*)(['\"])([^'\"\\s]+)\\2(?=\\s*(?:[;),]|$|with\\s*[({]|assert\\s*\\{|as\\s+[\\w*-]+\\s*;|show\\b|hide\\b))/gm\n\n// A module augmentation (`declare module 'vue' {`) names a package too; a wildcard one (`'*.vue'`) names none.\nconst DECLARE_MODULE_RE = /\\bdeclare\\s+module\\s+(['\"])([^'\"\\s*]+)\\1\\s*\\{/g\n\n// Comments name modules in passing, so they go -- but only outside strings, template literals and regular\n// expressions: `'image/*'` or `/['\"]/` read as the start of a comment or a string would hide the code after it.\n// A `/` starts a regular expression after an operator or a keyword. Taken for one where it divides (a member\n// named like a keyword: `obj.in / 2`), the scan copies to the next `/` on that line and reads on from there.\nconst REGEX_AFTER_KEYWORD =\n  /(?:^|[^\\w$])(?:return|typeof|instanceof|in|of|new|delete|void|throw|case|default|do|else|await|yield)$/\nconst REGEX_CAN_FOLLOW = new Set([\n  '',\n  '(',\n  ',',\n  '=',\n  ':',\n  '[',\n  '!',\n  '&',\n  '|',\n  '?',\n  '{',\n  '}',\n  ';',\n  '+',\n  '-',\n  '*',\n  '%',\n  '<',\n  '>',\n  '~',\n  '^',\n])\nexport const withoutComments = (source: string): string => {\n  let out = ''\n  let previous = ''\n  let i = 0\n  const copyQuoted = (quote: string) => {\n    const start = i++\n    while (i < source.length && source[i] !== quote) {\n      if (source[i] === '\\\\') i++\n      else if (quote !== '`' && source[i] === '\\n') break\n      i++\n    }\n    i++\n    out += source.slice(start, i)\n  }\n  while (i < source.length) {\n    const char = source[i]!\n    const next = source[i + 1]\n    if (char === '/' && next === '/') {\n      const end = source.indexOf('\\n', i)\n      i = end === -1 ? source.length : end\n    } else if (char === '/' && next === '*') {\n      const end = source.indexOf('*/', i + 2)\n      i = end === -1 ? source.length : end + 2\n      out += ' '\n    } else if (char === \"'\" || char === '\"' || char === '`') {\n      copyQuoted(char)\n      previous = char\n    } else if (char === '/' && (REGEX_CAN_FOLLOW.has(previous) || REGEX_AFTER_KEYWORD.test(out.trimEnd()))) {\n      const start = i++\n      let inClass = false\n      while (i < source.length && source[i] !== '\\n' && (inClass || source[i] !== '/')) {\n        if (source[i] === '\\\\') i++\n        else if (source[i] === '[') inClass = true\n        else if (source[i] === ']') inClass = false\n        i++\n      }\n      i++\n      out += source.slice(start, i)\n      previous = '/'\n    } else {\n      out += char\n      if (!/\\s/.test(char)) previous = char\n      i++\n    }\n  }\n  return out\n}\n\n// A `.vue` file imports in its `<script>` and `<style>` blocks; the template's text is prose.\nconst codeOf = (key: string, source: string): string =>\n  key.endsWith('.vue')\n    ? [...source.matchAll(/<(script|style)\\b[^>]*>([\\s\\S]*?)<\\/\\1>/g)]\n        .map((block) => withoutComments(block[2]!))\n        .join('\\n')\n    : withoutComments(source)\n\n// Sass resolves `@use 'utils/forms'` against the file's own directory first: a partial there is no package.\nconst isStylePartial = (key: string, specifier: string, keys: Set<string>): boolean => {\n  const dir = key.slice(0, key.lastIndexOf('/'))\n  const at = specifier.lastIndexOf('/')\n  const [sub, name] = at === -1 ? ['', specifier] : [`/${specifier.slice(0, at)}`, specifier.slice(at + 1)]\n  return ['.scss', '.css'].some(\n    (ext) =>\n      keys.has(`${dir}/${specifier}${ext}`) ||\n      keys.has(`${dir}${sub}/_${name}${ext}`) ||\n      keys.has(`${dir}/${specifier}/_index${ext}`) ||\n      keys.has(`${dir}/${specifier}/index${ext}`)\n  )\n}\n\nconst NODE_BUILTINS = new Set([\n  'assert',\n  'buffer',\n  'child_process',\n  'crypto',\n  'events',\n  'fs',\n  'module',\n  'os',\n  'path',\n  'process',\n  'stream',\n  'url',\n  'util',\n  'worker_threads',\n  'zlib',\n])\n\n/** The package a bare specifier imports from, or `null` for a relative path, an alias or a `scheme:` module. */\nexport const packageOfSpecifier = (specifier: string, aliases: string[] = []): string | null => {\n  const path = specifier.split('?')[0]!\n  if (/^(?:\\.|\\/|@\\/|#|[a-z][a-z0-9+.-]*:)/.test(path)) return null\n  if (aliases.some((alias) => path.startsWith(alias))) return null\n  const parts = path.split('/')\n  const name = path.startsWith('@') ? parts.slice(0, 2).join('/') : parts[0]!\n  return NODE_BUILTINS.has(name) ? null : name\n}\n\n/** `file: specifier` for every import of a package the `package.json` does not declare. */\nexport function undeclaredImports(\n  sources: Record<string, string>,\n  packageJson: PackageJsonDependencies,\n  aliases: string[] = []\n): string[] {\n  const declared = new Set(\n    [\n      packageJson.dependencies,\n      packageJson.devDependencies,\n      packageJson.peerDependencies,\n      packageJson.optionalDependencies,\n    ]\n      .flatMap((deps) => Object.keys(deps ?? {}))\n      // `@types/x` declares the types of `x`, `@types/scope__x` those of `@scope/x`.\n      .flatMap((name) => (name.startsWith('@types/') ? [name, name.slice(7).replace(/^(.+)__/, '@$1/')] : [name]))\n  )\n  const keys = new Set(Object.keys(sources))\n  const found: string[] = []\n  for (const [key, source] of Object.entries(sources)) {\n    const code = codeOf(key, source)\n    for (const match of code.matchAll(SPECIFIER_RE)) {\n      const specifier = match[3]!\n      const name = packageOfSpecifier(specifier, aliases)\n      if (name === null || declared.has(name)) continue\n      if (match[1] && isStylePartial(key, specifier, keys)) continue\n      found.push(`${globKeyToSrcPath(key)}: ${specifier}`)\n    }\n    for (const match of code.matchAll(DECLARE_MODULE_RE)) {\n      const name = packageOfSpecifier(match[2]!, aliases)\n      if (name !== null && !declared.has(name)) found.push(`${globKeyToSrcPath(key)}: ${match[2]}`)\n    }\n  }\n  return [...new Set(found)].sort()\n}\n\n/**\n * A package the admin imports but does not declare works as long as another dependency brings it and the\n * package manager hoists it to the top of `node_modules` (yarn's `node-modules` linker does). Its version\n * is then whatever that dependency asks for, and a strict layout -- pnpm, or yarn's own PnP -- does not\n * hoist: the build stops at the first such import.\n */\nexport function describeDeclaredDependencies({\n  sources,\n  packageJson,\n  aliases = [],\n}: DescribeDeclaredDependenciesOptions): void {\n  describe('declared dependencies', () => {\n    it('reads the sources it is meant to check', () => {\n      // A guard on the guard: an empty glob would leave nothing to check and pass.\n      expect(Object.keys(sources).length).toBeGreaterThan(20)\n    })\n\n    it('imports only packages its package.json declares', () => {\n      expect(undeclaredImports(sources, packageJson, aliases)).toEqual([])\n    })\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"declaredDependencies.js","names":["SPECIFIER_RE","DECLARE_MODULE_RE","REGEX_AFTER_KEYWORD","REGEX_CAN_FOLLOW","withoutComments","out","previous","i","copyQuoted","start","source","quote","char","next","end","inClass","codeOf","key","block","isStylePartial","dir","at","specifier","sub","name","keys","ext","NODE_BUILTINS","packageOfSpecifier","path","aliases","alias","parts","undeclaredImports","declared","packageJson","deps","sources","found","code","match","globKeyToSrcPath","describeDeclaredDependencies","it"],"sources":["../../src/testing/declaredDependencies.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest'\nimport { globKeyToSrcPath } from '@/testing/typedRouter'\n\nexport interface PackageJsonDependencies {\n  dependencies?: Record<string, string>\n  devDependencies?: Record<string, string>\n  peerDependencies?: Record<string, string>\n  optionalDependencies?: Record<string, string>\n}\n\nexport interface DescribeDeclaredDependenciesOptions {\n  /**\n   * The admin's sources: `import.meta.glob('/src/**\\/*.{vue,ts,mts,scss}', { query: '?raw', import: 'default', eager: true })`.\n   */\n  sources: Record<string, string>\n  packageJson: PackageJsonDependencies\n  /** Bare specifier prefixes that name no package: the admin's own aliases (`@/` is built in). */\n  aliases?: string[]\n}\n\n// Module specifiers in code (static, `export … from`, side-effect and dynamic imports, `require`, the vitest\n// module helpers, `typeof import()`) and in styles (`@use`, `@forward`, `@import`; group 1). A specifier has\n// no whitespace and ends its statement or call, which leaves out prose such as `it('… from \"now\"')`.\nconst SPECIFIER_RE =\n  /(?:(@(?:use|forward|import)\\s+)|\\bfrom\\s+|\\bimport\\s*\\(\\s*|\\bimport\\s+|\\brequire\\s*\\(\\s*|\\bvi\\.(?:mock|doMock|importActual)\\s*(?:<[^>]*>)?\\(\\s*)(['\"])([^'\"\\s]+)\\2(?=\\s*(?:[;),]|$|with\\s*[({]|assert\\s*\\{|as\\s+[\\w*-]+\\s*;|show\\b|hide\\b))/gm\n\n// A module augmentation (`declare module 'vue' {`) names a package too; a wildcard one (`'*.vue'`) names none.\nconst DECLARE_MODULE_RE = /\\bdeclare\\s+module\\s+(['\"])([^'\"\\s*]+)\\1\\s*\\{/g\n\n// Comments name modules in passing, so they go -- but only outside strings, template literals and regular\n// expressions: `'image/*'` or `/['\"]/` read as the start of a comment or a string would hide the code after it.\n// A `/` starts a regular expression after an operator or a keyword. Taken for one where it divides (a member\n// named like a keyword: `obj.in / 2`), the scan copies to the next `/` on that line and reads on from there.\nconst REGEX_AFTER_KEYWORD =\n  /(?:^|[^\\w$])(?:return|typeof|instanceof|in|of|new|delete|void|throw|case|default|do|else|await|yield)$/\nconst REGEX_CAN_FOLLOW = new Set([\n  '',\n  '(',\n  ',',\n  '=',\n  ':',\n  '[',\n  '!',\n  '&',\n  '|',\n  '?',\n  '{',\n  '}',\n  ';',\n  '+',\n  '-',\n  '*',\n  '%',\n  '<',\n  '>',\n  '~',\n  '^',\n])\nexport const withoutComments = (source: string): string => {\n  let out = ''\n  let previous = ''\n  let i = 0\n  const copyQuoted = (quote: string) => {\n    const start = i++\n    while (i < source.length && source[i] !== quote) {\n      if (source[i] === '\\\\') i++\n      else if (quote !== '`' && source[i] === '\\n') break\n      i++\n    }\n    i++\n    out += source.slice(start, i)\n  }\n  while (i < source.length) {\n    const char = source[i]!\n    const next = source[i + 1]\n    if (char === '/' && next === '/') {\n      const end = source.indexOf('\\n', i)\n      i = end === -1 ? source.length : end\n    } else if (char === '/' && next === '*') {\n      const end = source.indexOf('*/', i + 2)\n      i = end === -1 ? source.length : end + 2\n      out += ' '\n    } else if (char === \"'\" || char === '\"' || char === '`') {\n      copyQuoted(char)\n      previous = char\n    } else if (char === '/' && (REGEX_CAN_FOLLOW.has(previous) || REGEX_AFTER_KEYWORD.test(out.trimEnd()))) {\n      const start = i++\n      let inClass = false\n      while (i < source.length && source[i] !== '\\n' && (inClass || source[i] !== '/')) {\n        if (source[i] === '\\\\') i++\n        else if (source[i] === '[') inClass = true\n        else if (source[i] === ']') inClass = false\n        i++\n      }\n      i++\n      out += source.slice(start, i)\n      previous = '/'\n    } else {\n      out += char\n      if (!/\\s/.test(char)) previous = char\n      i++\n    }\n  }\n  return out\n}\n\n// A `.vue` file imports in its `<script>` and `<style>` blocks; the template's text is prose.\nconst codeOf = (key: string, source: string): string =>\n  key.endsWith('.vue')\n    ? [...source.matchAll(/<(script|style)\\b[^>]*>([\\s\\S]*?)<\\/\\1>/g)]\n        .map((block) => withoutComments(block[2]!))\n        .join('\\n')\n    : withoutComments(source)\n\n// Sass resolves `@use 'utils/forms'` against the file's own directory first: a partial there is no package.\nconst isStylePartial = (key: string, specifier: string, keys: Set<string>): boolean => {\n  const dir = key.slice(0, key.lastIndexOf('/'))\n  const at = specifier.lastIndexOf('/')\n  const [sub, name] = at === -1 ? ['', specifier] : [`/${specifier.slice(0, at)}`, specifier.slice(at + 1)]\n  return ['.scss', '.css'].some(\n    (ext) =>\n      keys.has(`${dir}/${specifier}${ext}`) ||\n      keys.has(`${dir}${sub}/_${name}${ext}`) ||\n      keys.has(`${dir}/${specifier}/_index${ext}`) ||\n      keys.has(`${dir}/${specifier}/index${ext}`)\n  )\n}\n\nconst NODE_BUILTINS = new Set([\n  'assert',\n  'buffer',\n  'child_process',\n  'crypto',\n  'events',\n  'fs',\n  'module',\n  'os',\n  'path',\n  'process',\n  'stream',\n  'url',\n  'util',\n  'worker_threads',\n  'zlib',\n])\n\n/** The package a bare specifier imports from, or `null` for a relative path, an alias or a `scheme:` module. */\nexport const packageOfSpecifier = (specifier: string, aliases: string[] = []): string | null => {\n  const path = specifier.split('?')[0]!\n  if (/^(?:\\.|\\/|@\\/|#|[a-z][a-z0-9+.-]*:)/.test(path)) return null\n  if (aliases.some((alias) => path.startsWith(alias))) return null\n  const parts = path.split('/')\n  const name = path.startsWith('@') ? parts.slice(0, 2).join('/') : parts[0]!\n  return NODE_BUILTINS.has(name) ? null : name\n}\n\nexport function undeclaredImports(\n  sources: Record<string, string>,\n  packageJson: PackageJsonDependencies,\n  aliases: string[] = []\n): string[] {\n  const declared = new Set(\n    [\n      packageJson.dependencies,\n      packageJson.devDependencies,\n      packageJson.peerDependencies,\n      packageJson.optionalDependencies,\n    ]\n      .flatMap((deps) => Object.keys(deps ?? {}))\n      // `@types/x` declares the types of `x`, `@types/scope__x` those of `@scope/x`.\n      .flatMap((name) => (name.startsWith('@types/') ? [name, name.slice(7).replace(/^(.+)__/, '@$1/')] : [name]))\n  )\n  const keys = new Set(Object.keys(sources))\n  const found: string[] = []\n  for (const [key, source] of Object.entries(sources)) {\n    const code = codeOf(key, source)\n    for (const match of code.matchAll(SPECIFIER_RE)) {\n      const specifier = match[3]!\n      const name = packageOfSpecifier(specifier, aliases)\n      if (name === null || declared.has(name)) continue\n      if (match[1] && isStylePartial(key, specifier, keys)) continue\n      found.push(`${globKeyToSrcPath(key)}: ${specifier}`)\n    }\n    for (const match of code.matchAll(DECLARE_MODULE_RE)) {\n      const name = packageOfSpecifier(match[2]!, aliases)\n      if (name !== null && !declared.has(name)) found.push(`${globKeyToSrcPath(key)}: ${match[2]}`)\n    }\n  }\n  return [...new Set(found)].sort()\n}\n\n/**\n * An undeclared import works while another dependency brings the package and the package\n * manager hoists it to the top of `node_modules` (yarn's `node-modules` linker does).\n * Its version is then whatever that dependency asks for.\n * A strict layout (pnpm, yarn PnP) does not hoist, so the build stops at the first such import.\n */\nexport function describeDeclaredDependencies({\n  sources,\n  packageJson,\n  aliases = [],\n}: DescribeDeclaredDependenciesOptions): void {\n  describe('declared dependencies', () => {\n    it('reads the sources it is meant to check', () => {\n      // A guard on the guard: an empty glob would leave nothing to check and pass.\n      expect(Object.keys(sources).length).toBeGreaterThan(20)\n    })\n\n    it('imports only packages its package.json declares', () => {\n      expect(undeclaredImports(sources, packageJson, aliases)).toEqual([])\n    })\n  })\n}\n"],"mappings":"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"}

package/dist/testing/generatedRoutes.d.ts

@@ -2,7 +2,6 @@ import { RouteRecordRaw } from 'vue-router';
 export interface DescribeGeneratedRoutesOptions {
     /** `routes` from `vue-router/auto-routes`. */
     routes: RouteRecordRaw[];
-    /** `src/typed-router.d.ts`, imported with `?raw`. */
     declaration: string;
     /** `Object.keys(import.meta.glob('/src/pages/**\/*.vue'))`. */
     pageFiles: string[];
@@ -11,15 +10,11 @@ export interface DescribeGeneratedRoutesOptions {
 }
 /**
  * A smoke test over every generated route.
- *
- * `anzu/valid-route-name` checks that a name referenced in the code exists. It cannot check that the
- * route behind it can be reached: a path whose constraint never matches, or one shadowed by an earlier
- * record, still has a perfectly valid name. Navigating to it lands on the catch-all instead, which
- * renders a 404 page and throws nothing -- so a broken route looks exactly like a working one until
- * somebody clicks it.
- *
- * Importing `vue-router/auto-routes` is itself half the test: it pulls in every page component and,
- * through them, their stores, api clients and composables, so anything that throws while a module is
- * evaluated fails there. That half depends on `importMode` being `sync` in the admin's vitest config.
+ * `anzu/valid-route-name` checks that a referenced name exists, not that the route can be reached. A
+ * path whose constraint never matches, or one shadowed by an earlier record, still has a valid name.
+ * Navigating to it lands on the catch-all, which renders a 404 page and throws nothing.
+ * Importing `vue-router/auto-routes` is also part of the test: it loads every page
+ * component and their stores, api clients and composables, so errors thrown at module
+ * evaluation fail here. This needs `importMode` to be `sync` in the admin's vitest config.
  */
 export declare function describeGeneratedRoutes({ routes, declaration, pageFiles, catchAll, }: DescribeGeneratedRoutesOptions): void;

package/dist/testing/generatedRoutes.js

@@ -1,7 +1,7 @@
 import { parseTypedRouterDeclaration as e } from "./typedRouter.js";
 import { createMemoryHistory as t, createRouter as n } from "vue-router";
 import { describe as r, expect as i, it as a } from "vitest";
-//#region src/testing/generatedRoutes.ts
+// src/testing/generatedRoutes.ts
 var o = [
 	"1",
 	"00000000-0000-4000-8000-000000000001",
@@ -27,7 +27,6 @@ function s({ routes: s, declaration: c, pageFiles: l, catchAll: u = "pathMatch"
 		});
 	});
 }
-//#endregion
 export { s as describeGeneratedRoutes };
 
 //# sourceMappingURL=generatedRoutes.js.map

package/dist/testing/generatedRoutes.js.map

@@ -1 +1 @@
-{"version":3,"file":"generatedRoutes.js","names":["PARAM_SAMPLES","describeGeneratedRoutes","declaredPaths","parseTypedRouterDeclaration","declaration","path","catchAll","router","createRouter","createMemoryHistory","fillParams","regex","sample","it","pageFiles","resolved","expect","record","name","runtime","route","declared","withoutComponent"],"sources":["../../src/testing/generatedRoutes.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest'\nimport { createMemoryHistory, createRouter, type RouteRecordRaw } from 'vue-router'\nimport { parseTypedRouterDeclaration } from '@/testing/typedRouter'\n\n// One value per id shape the admins constrain a param to: an integer id, a uuid (any version, the\n// backends make v4, v6 and v7) and a log's Mongo ObjectId.\nconst PARAM_SAMPLES = ['1', '00000000-0000-4000-8000-000000000001', '000000000000000000000001']\n\nexport interface DescribeGeneratedRoutesOptions {\n  /** `routes` from `vue-router/auto-routes`. */\n  routes: RouteRecordRaw[]\n  /** `src/typed-router.d.ts`, imported with `?raw`. */\n  declaration: string\n  /** `Object.keys(import.meta.glob('/src/pages/**\\/*.vue'))`. */\n  pageFiles: string[]\n  /** The catch-all's param, whose route is left out. */\n  catchAll?: string\n}\n\n/**\n * A smoke test over every generated route.\n *\n * `anzu/valid-route-name` checks that a name referenced in the code exists. It cannot check that the\n * route behind it can be reached: a path whose constraint never matches, or one shadowed by an earlier\n * record, still has a perfectly valid name. Navigating to it lands on the catch-all instead, which\n * renders a 404 page and throws nothing -- so a broken route looks exactly like a working one until\n * somebody clicks it.\n *\n * Importing `vue-router/auto-routes` is itself half the test: it pulls in every page component and,\n * through them, their stores, api clients and composables, so anything that throws while a module is\n * evaluated fails there. That half depends on `importMode` being `sync` in the admin's vitest config.\n */\nexport function describeGeneratedRoutes({\n  routes,\n  declaration,\n  pageFiles,\n  catchAll = 'pathMatch',\n}: DescribeGeneratedRoutesOptions): void {\n  const declaredPaths = parseTypedRouterDeclaration(declaration).paths.filter(({ path }) => !path.includes(catchAll))\n  const router = createRouter({ history: createMemoryHistory(), routes })\n\n  // A constrained param -- `:id(\\d+)`, a uuid, a log's ObjectId -- has to be filled with something its\n  // regex accepts, or the route would fail to match for a reason that says nothing about the route\n  // itself: the first sample the regex takes, else `sample`. The trailing `?` of an optional param\n  // goes with it: left in place it starts a query string, and everything after it -- `/edit` in\n  // `/articles/:docId/:version?/edit` -- stops being part of the path.\n  const fillParams = (path: string) =>\n    path.replace(/:[a-zA-Z]+(?:\\(((?:\\\\.|[^\\\\)])*)\\))?\\??/g, (_match, regex?: string) =>\n      regex\n        ? // vue-router reads `\\)` as a group's closing parenthesis inside a custom regex, `RegExp` would not.\n          (PARAM_SAMPLES.find((sample) => new RegExp(`^(?:${regex.replace(/\\\\\\)/g, ')')})$`, 'i').test(sample)) ??\n          'sample')\n        : 'sample'\n    )\n\n  describe('generated routes', () => {\n    it('declares exactly the pages that exist on disk', () => {\n      // A guard on the guard: if the declaration were missing or the regex stopped matching, every\n      // assertion below would iterate an empty list and pass while checking nothing. Counted from\n      // disk rather than against a literal, so it cannot go stale as pages are added or removed --\n      // the one page file `declaredPaths` filters out is the catch-all.\n      expect(declaredPaths.length).toBe(pageFiles.length - 1)\n    })\n\n    it.each(declaredPaths)('resolves $path to its own record, not the catch-all', ({ name, path }) => {\n      const resolved = router.resolve(fillParams(path))\n\n      expect(resolved.matched.some((record) => record.path.includes(catchAll))).toBe(false)\n      expect(resolved.name).toBe(name)\n    })\n\n    it('has a runtime route for every declared one, and nothing extra', () => {\n      // The declaration is generated from the same scan as `routes`, but they are two artifacts and\n      // only one of them is regenerated by `generate:dts`. A stale declaration is exactly the state in\n      // which the assertions above would check routes the app no longer has.\n      //\n      // `router.getRoutes()` rather than `routes`: nested pages are children, so the raw array holds\n      // `/blogs/[id]` but not the `/blogs/[id]/edit` underneath it.\n      //\n      // Worth knowing when this fails locally and not in CI: a dev server left running watches\n      // `src/pages` and rewrites the declaration the moment a page file changes, which hides the\n      // mismatch this asserts. In CI nothing watches, and `generate:dts` runs before the tests.\n      const runtime = new Set(\n        router\n          .getRoutes()\n          .map((route) => route.name)\n          .filter((name): name is string => typeof name === 'string')\n      )\n      const declared = new Set(declaredPaths.map(({ name }) => name))\n\n      expect([...declared].filter((name) => !runtime.has(name))).toEqual([])\n      expect([...runtime].filter((name) => !declared.has(name) && !name.includes(catchAll))).toEqual([])\n    })\n\n    it('gives every route a component to render', () => {\n      const withoutComponent = router\n        .getRoutes()\n        .filter((route) => !route.components || Object.keys(route.components).length === 0)\n\n      expect(withoutComponent.map((route) => route.path)).toEqual([])\n    })\n  })\n}\n"],"mappings":";;;;AAMA,IAAMA,IAAgB;CAAC;CAAK;CAAwC;AAA0B;AA0B9F,SAAgBC,EAAwB,EACtC,WACA,gBACA,cACA,cAAW,eAC4B;CACvC,IAAMC,IAAgBC,EAA4BC,CAAW,CAAC,CAAC,MAAM,QAAQ,EAAE,cAAW,CAACC,EAAK,SAASC,CAAQ,CAAC,GAC5GC,IAASC,EAAa;EAAE,SAASC,EAAoB;EAAG;CAAO,CAAC,GAOhEC,KAAc,MAClBL,EAAK,QAAQ,6CAA6C,GAAQ,MAChEM,IAEKX,EAAc,MAAM,MAAe,OAAO,OAAOW,EAAM,QAAQ,SAAS,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,KAAKC,CAAM,CAAC,KACpG,WACA,QACN;CAEF,EAAS,0BAA0B;EAuCjC,AAtCAC,EAAG,uDAAuD;GAKxD,EAAOX,EAAc,MAAM,CAAC,CAAC,KAAKY,EAAU,SAAS,CAAC;EACxD,CAAC,GAEDD,EAAG,KAAKX,CAAa,CAAC,CAAC,wDAAwD,EAAE,SAAM,cAAW;GAChG,IAAMa,IAAWR,EAAO,QAAQG,EAAWL,CAAI,CAAC;GAGhD,AADAW,EAAOD,EAAS,QAAQ,MAAM,MAAWE,EAAO,KAAK,SAASX,CAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,EAAK,GACpFU,EAAOD,EAAS,IAAI,CAAC,CAAC,KAAKG,CAAI;EACjC,CAAC,GAEDL,EAAG,uEAAuE;GAWxE,IAAMM,IAAU,IAAI,IAClBZ,EACG,UAAU,CAAC,CACX,KAAK,MAAUa,EAAM,IAAI,CAAC,CAC1B,QAAQ,MAAyB,OAAOF,KAAS,QAAQ,CAC9D,GACMG,IAAW,IAAI,IAAInB,EAAc,KAAK,EAAE,cAAWgB,CAAI,CAAC;GAG9D,AADAF,EAAO,CAAC,GAAGK,CAAQ,CAAC,CAAC,QAAQ,MAAS,CAACF,EAAQ,IAAID,CAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GACrEF,EAAO,CAAC,GAAGG,CAAO,CAAC,CAAC,QAAQ,MAAS,CAACE,EAAS,IAAIH,CAAI,KAAK,CAACA,EAAK,SAASZ,CAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;EACnG,CAAC,GAEDO,EAAG,iDAAiD;GAClD,IAAMS,IAAmBf,EACtB,UAAU,CAAC,CACX,QAAQ,MAAU,CAACa,EAAM,cAAc,OAAO,KAAKA,EAAM,UAAU,CAAC,CAAC,WAAW,CAAC;GAEpF,EAAOE,EAAiB,KAAK,MAAUF,EAAM,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;EAChE,CAAC;CACH,CAAC;AACH"}
+{"version":3,"file":"generatedRoutes.js","names":["PARAM_SAMPLES","describeGeneratedRoutes","declaredPaths","parseTypedRouterDeclaration","declaration","path","catchAll","router","createRouter","createMemoryHistory","fillParams","regex","sample","it","pageFiles","resolved","expect","record","name","runtime","route","declared","withoutComponent"],"sources":["../../src/testing/generatedRoutes.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest'\nimport { createMemoryHistory, createRouter, type RouteRecordRaw } from 'vue-router'\nimport { parseTypedRouterDeclaration } from '@/testing/typedRouter'\n\n// One value per id shape the admins constrain a param to: an integer id, a uuid (any version, the\n// backends make v4, v6 and v7) and a log's Mongo ObjectId.\nconst PARAM_SAMPLES = ['1', '00000000-0000-4000-8000-000000000001', '000000000000000000000001']\n\nexport interface DescribeGeneratedRoutesOptions {\n  /** `routes` from `vue-router/auto-routes`. */\n  routes: RouteRecordRaw[]\n  declaration: string\n  /** `Object.keys(import.meta.glob('/src/pages/**\\/*.vue'))`. */\n  pageFiles: string[]\n  /** The catch-all's param, whose route is left out. */\n  catchAll?: string\n}\n\n/**\n * A smoke test over every generated route.\n * `anzu/valid-route-name` checks that a referenced name exists, not that the route can be reached. A\n * path whose constraint never matches, or one shadowed by an earlier record, still has a valid name.\n * Navigating to it lands on the catch-all, which renders a 404 page and throws nothing.\n * Importing `vue-router/auto-routes` is also part of the test: it loads every page\n * component and their stores, api clients and composables, so errors thrown at module\n * evaluation fail here. This needs `importMode` to be `sync` in the admin's vitest config.\n */\nexport function describeGeneratedRoutes({\n  routes,\n  declaration,\n  pageFiles,\n  catchAll = 'pathMatch',\n}: DescribeGeneratedRoutesOptions): void {\n  const declaredPaths = parseTypedRouterDeclaration(declaration).paths.filter(({ path }) => !path.includes(catchAll))\n  const router = createRouter({ history: createMemoryHistory(), routes })\n\n  // A constrained param (`:id(\\d+)`, a uuid, an ObjectId) must be filled with a value its\n  // regex accepts. Otherwise the route fails to match for a reason unrelated to the route.\n  // The value is the first sample the regex takes, else `sample`.\n  // The trailing `?` of an optional param is removed too. Left in place it starts a query\n  // string, and the rest of the path (`/edit` in `/articles/:docId/:version?/edit`) is lost.\n  const fillParams = (path: string) =>\n    path.replace(/:[a-zA-Z]+(?:\\(((?:\\\\.|[^\\\\)])*)\\))?\\??/g, (_match, regex?: string) =>\n      regex\n        ? // vue-router reads `\\)` as a group's closing parenthesis inside a custom regex, `RegExp` would not.\n          (PARAM_SAMPLES.find((sample) => new RegExp(`^(?:${regex.replace(/\\\\\\)/g, ')')})$`, 'i').test(sample)) ??\n          'sample')\n        : 'sample'\n    )\n\n  describe('generated routes', () => {\n    it('declares exactly the pages that exist on disk', () => {\n      // Guards the guard: if the declaration were missing or the regex stopped\n      // matching, the assertions below would iterate an empty list and pass.\n      // Counted from disk instead of a literal, so it does not go stale when pages\n      // change. The one page file `declaredPaths` filters out is the catch-all.\n      expect(declaredPaths.length).toBe(pageFiles.length - 1)\n    })\n\n    it.each(declaredPaths)('resolves $path to its own record, not the catch-all', ({ name, path }) => {\n      const resolved = router.resolve(fillParams(path))\n\n      expect(resolved.matched.some((record) => record.path.includes(catchAll))).toBe(false)\n      expect(resolved.name).toBe(name)\n    })\n\n    it('has a runtime route for every declared one, and nothing extra', () => {\n      // The declaration and `routes` are two artifacts, and only the declaration is regenerated by\n      // `generate:dts`. A stale declaration makes the assertions above check routes the app no longer has.\n      // `router.getRoutes()` is used instead of `routes` because nested pages are\n      // children: the raw array has `/blogs/[id]` but not `/blogs/[id]/edit`.\n      // When this fails locally but not in CI: a running dev server watches `src/pages` and rewrites the declaration on\n      // every page change, which hides the mismatch. In CI nothing watches, and `generate:dts` runs before the tests.\n      const runtime = new Set(\n        router\n          .getRoutes()\n          .map((route) => route.name)\n          .filter((name): name is string => typeof name === 'string')\n      )\n      const declared = new Set(declaredPaths.map(({ name }) => name))\n\n      expect([...declared].filter((name) => !runtime.has(name))).toEqual([])\n      expect([...runtime].filter((name) => !declared.has(name) && !name.includes(catchAll))).toEqual([])\n    })\n\n    it('gives every route a component to render', () => {\n      const withoutComponent = router\n        .getRoutes()\n        .filter((route) => !route.components || Object.keys(route.components).length === 0)\n\n      expect(withoutComponent.map((route) => route.path)).toEqual([])\n    })\n  })\n}\n"],"mappings":";;;;AAMA,IAAMA,IAAgB;CAAC;CAAK;CAAwC;AAA0B;AAqB9F,SAAgBC,EAAwB,EACtC,WACA,gBACA,cACA,cAAW,eAC4B;CACvC,IAAMC,IAAgBC,EAA4BC,CAAW,CAAC,CAAC,MAAM,QAAQ,EAAE,cAAW,CAACC,EAAK,SAASC,CAAQ,CAAC,GAC5GC,IAASC,EAAa;EAAE,SAASC,EAAoB;EAAG;CAAO,CAAC,GAOhEC,KAAc,MAClBL,EAAK,QAAQ,6CAA6C,GAAQ,MAChEM,IAEKX,EAAc,MAAM,MAAe,OAAO,OAAOW,EAAM,QAAQ,SAAS,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,KAAKC,CAAM,CAAC,KACpG,WACA,QACN;CAEF,EAAS,0BAA0B;EAmCjC,AAlCAC,EAAG,uDAAuD;GAKxD,EAAOX,EAAc,MAAM,CAAC,CAAC,KAAKY,EAAU,SAAS,CAAC;EACxD,CAAC,GAEDD,EAAG,KAAKX,CAAa,CAAC,CAAC,wDAAwD,EAAE,SAAM,cAAW;GAChG,IAAMa,IAAWR,EAAO,QAAQG,EAAWL,CAAI,CAAC;GAGhD,AADAW,EAAOD,EAAS,QAAQ,MAAM,MAAWE,EAAO,KAAK,SAASX,CAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,EAAK,GACpFU,EAAOD,EAAS,IAAI,CAAC,CAAC,KAAKG,CAAI;EACjC,CAAC,GAEDL,EAAG,uEAAuE;GAOxE,IAAMM,IAAU,IAAI,IAClBZ,EACG,UAAU,CAAC,CACX,KAAK,MAAUa,EAAM,IAAI,CAAC,CAC1B,QAAQ,MAAyB,OAAOF,KAAS,QAAQ,CAC9D,GACMG,IAAW,IAAI,IAAInB,EAAc,KAAK,EAAE,cAAWgB,CAAI,CAAC;GAG9D,AADAF,EAAO,CAAC,GAAGK,CAAQ,CAAC,CAAC,QAAQ,MAAS,CAACF,EAAQ,IAAID,CAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GACrEF,EAAO,CAAC,GAAGG,CAAO,CAAC,CAAC,QAAQ,MAAS,CAACE,EAAS,IAAIH,CAAI,KAAK,CAACA,EAAK,SAASZ,CAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;EACnG,CAAC,GAEDO,EAAG,iDAAiD;GAClD,IAAMS,IAAmBf,EACtB,UAAU,CAAC,CACX,QAAQ,MAAU,CAACa,EAAM,cAAc,OAAO,KAAKA,EAAM,UAAU,CAAC,CAAC,WAAW,CAAC;GAEpF,EAAOE,EAAiB,KAAK,MAAUF,EAAM,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;EAChE,CAAC;CACH,CAAC;AACH"}

package/dist/testing/routeHistory.d.ts

@@ -1,20 +1,13 @@
 export interface DescribeRouteHistoryOptions {
-    /** `src/typed-router.d.ts`, imported with `?raw`. */
     declaration: string;
-    /** The admin's route history blacklist. */
     routeHistoryBlacklist: readonly string[];
-    /** What the admin runs at start-up to set up the history. */
     initRouteHistory: () => void;
 }
 /**
- * What the close buttons stand on.
- *
- * `describeCloseButtons` checks that every button names the right routes; this checks that naming
- * them does anything. The history is module state inside the library, filled by the navigation guard
- * and read back by `navigateBack`, so the admin's set-up and the library are only correct together.
- *
- * The route names come out of the declaration rather than being made up: made-up ones would be
- * rejected by `anzu/valid-route-name`, and real ones keep the test honest about the strings the app
- * actually carries.
+ * `describeCloseButtons` checks that every button names the right routes. This checks that naming them does anything.
+ * The history is module state in the library, filled by the navigation guard and read
+ * by `navigateBack`, so the admin's set-up and the library are only correct together.
+ * Route names come from the declaration. Made-up names would be rejected
+ * by `anzu/valid-route-name`, and real ones keep the test honest.
  */
 export declare function describeRouteHistory({ declaration, routeHistoryBlacklist, initRouteHistory, }: DescribeRouteHistoryOptions): void;