@reddoorla/maintenance 0.2.0 → 0.4.0

package/dist/configs/svelte.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Minimal shape we touch — the full type lives in @sveltejs/kit's `Config`.
+ * We don't import it directly to avoid a peer dependency for what amounts
+ * to a small config helper. Sites get full type-checking from their own
+ * `@sveltejs/kit` install when they invoke createSvelteConfig.
+ */
+type WarningFilter = (warning: {
+    code?: string;
+    message?: string;
+}) => boolean;
+type SvelteConfigLike = {
+    kit?: unknown;
+    preprocess?: unknown;
+    compilerOptions?: {
+        warningFilter?: WarningFilter;
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+};
+/**
+ * Compose a Svelte/Kit config with reddoor's canonical compilerOptions
+ * layered in. Sites pass their site-specific bits (`kit.adapter`,
+ * `preprocess`, etc.) and get back a complete config with the canonical
+ * warning filter applied.
+ *
+ * If the site supplies its own `compilerOptions.warningFilter`, the filters
+ * compose: a warning is shown only when both filters allow it.
+ *
+ * @example
+ *   import { createSvelteConfig } from "@reddoorla/maintenance/configs/svelte";
+ *   import adapter from "@sveltejs/adapter-auto";
+ *
+ *   export default createSvelteConfig({ kit: { adapter: adapter() } });
+ */
+declare function createSvelteConfig(siteConfig?: SvelteConfigLike): SvelteConfigLike & {
+    compilerOptions: NonNullable<SvelteConfigLike["compilerOptions"]>;
+};
+
+export { type SvelteConfigLike, createSvelteConfig, createSvelteConfig as default };

package/dist/configs/svelte.js

@@ -0,0 +1,30 @@
+// src/configs/svelte.ts
+var SILENCED_WARNING_CODES = /* @__PURE__ */ new Set([
+  // `<div ... />` shorthand is widely used across reddoor codebases; the
+  // Svelte 5 strictness change for non-void self-closing tags would flood
+  // dev logs with no actionable signal.
+  "element_invalid_self_closing_tag"
+]);
+function isSilenced(warning) {
+  return warning.code !== void 0 && SILENCED_WARNING_CODES.has(warning.code);
+}
+function createSvelteConfig(siteConfig = {}) {
+  const siteCompiler = siteConfig.compilerOptions ?? {};
+  const siteFilter = siteCompiler.warningFilter;
+  return {
+    ...siteConfig,
+    compilerOptions: {
+      ...siteCompiler,
+      warningFilter: (warning) => {
+        if (isSilenced(warning)) return false;
+        return siteFilter ? siteFilter(warning) : true;
+      }
+    }
+  };
+}
+var svelte_default = createSvelteConfig;
+export {
+  createSvelteConfig,
+  svelte_default as default
+};
+//# sourceMappingURL=svelte.js.map

package/dist/configs/svelte.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/configs/svelte.ts"],"sourcesContent":["/**\n * Minimal shape we touch — the full type lives in @sveltejs/kit's `Config`.\n * We don't import it directly to avoid a peer dependency for what amounts\n * to a small config helper. Sites get full type-checking from their own\n * `@sveltejs/kit` install when they invoke createSvelteConfig.\n */\ntype WarningFilter = (warning: { code?: string; message?: string }) => boolean;\n\nexport type SvelteConfigLike = {\n  kit?: unknown;\n  preprocess?: unknown;\n  compilerOptions?: {\n    warningFilter?: WarningFilter;\n    [k: string]: unknown;\n  };\n  [k: string]: unknown;\n};\n\n/** Compiler-level warnings the canonical reddoor stack treats as noise. */\nconst SILENCED_WARNING_CODES = new Set<string>([\n  // `<div ... />` shorthand is widely used across reddoor codebases; the\n  // Svelte 5 strictness change for non-void self-closing tags would flood\n  // dev logs with no actionable signal.\n  \"element_invalid_self_closing_tag\",\n]);\n\nfunction isSilenced(warning: { code?: string }): boolean {\n  return warning.code !== undefined && SILENCED_WARNING_CODES.has(warning.code);\n}\n\n/**\n * Compose a Svelte/Kit config with reddoor's canonical compilerOptions\n * layered in. Sites pass their site-specific bits (`kit.adapter`,\n * `preprocess`, etc.) and get back a complete config with the canonical\n * warning filter applied.\n *\n * If the site supplies its own `compilerOptions.warningFilter`, the filters\n * compose: a warning is shown only when both filters allow it.\n *\n * @example\n *   import { createSvelteConfig } from \"@reddoorla/maintenance/configs/svelte\";\n *   import adapter from \"@sveltejs/adapter-auto\";\n *\n *   export default createSvelteConfig({ kit: { adapter: adapter() } });\n */\nexport function createSvelteConfig(siteConfig: SvelteConfigLike = {}): SvelteConfigLike & {\n  compilerOptions: NonNullable<SvelteConfigLike[\"compilerOptions\"]>;\n} {\n  const siteCompiler = siteConfig.compilerOptions ?? {};\n  const siteFilter = siteCompiler.warningFilter;\n\n  return {\n    ...siteConfig,\n    compilerOptions: {\n      ...siteCompiler,\n      warningFilter: (warning) => {\n        if (isSilenced(warning)) return false;\n        return siteFilter ? siteFilter(warning) : true;\n      },\n    },\n  };\n}\n\nexport default createSvelteConfig;\n"],"mappings":";AAmBA,IAAM,yBAAyB,oBAAI,IAAY;AAAA;AAAA;AAAA;AAAA,EAI7C;AACF,CAAC;AAED,SAAS,WAAW,SAAqC;AACvD,SAAO,QAAQ,SAAS,UAAa,uBAAuB,IAAI,QAAQ,IAAI;AAC9E;AAiBO,SAAS,mBAAmB,aAA+B,CAAC,GAEjE;AACA,QAAM,eAAe,WAAW,mBAAmB,CAAC;AACpD,QAAM,aAAa,aAAa;AAEhC,SAAO;AAAA,IACL,GAAG;AAAA,IACH,iBAAiB;AAAA,MACf,GAAG;AAAA,MACH,eAAe,CAAC,YAAY;AAC1B,YAAI,WAAW,OAAO,EAAG,QAAO;AAChC,eAAO,aAAa,WAAW,OAAO,IAAI;AAAA,MAC5C;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,iBAAQ;","names":[]}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as Site, a as AuditResult, A as AuditName, b as RecipeResult, R as RecipeName, I as InventoryProvider } from './sync-configs-7XIzzN_L.js';
-export { C as ConfigName, c as SyncConfigsOptions, s as syncConfigs } from './sync-configs-7XIzzN_L.js';
+import { S as Site, a as AuditResult, A as AuditName, b as RecipeResult, R as RecipeName, I as InventoryProvider } from './sync-configs-C56tK7Go.js';
+export { C as ConfigName, c as SyncConfigsOptions, s as syncConfigs } from './sync-configs-C56tK7Go.js';
 
 type SpawnResult = {
     code: number;
@@ -56,6 +56,17 @@ type ConvertToPnpmOptions = {
 };
 declare function convertToPnpm(site: Site, opts?: ConvertToPnpmOptions): Promise<RecipeResult>;
 
+type OnboardAudit = "lighthouse" | "a11y";
+type OnboardOptions = {
+    spawn?: SpawnFn;
+    /** Which audit-related deps to ensure. Defaults to all known audits. */
+    audits?: OnboardAudit[];
+    /** Version range to pin for @reddoorla/maintenance. Defaults to the
+     *  current minor range. Update on each minor bump. */
+    packageVersion?: string;
+};
+declare function onboard(site: Site, opts?: OnboardOptions): Promise<RecipeResult>;
+
 declare const ALL_RECIPE_NAMES: RecipeName[];
 declare function isRecipeName(value: string): value is RecipeName;
 
@@ -66,4 +77,4 @@ declare function localPath(path: string, opts?: LocalPathOptions): InventoryProv
 
 declare function fromJsonFile(path: string): InventoryProvider;
 
-export { ALL_AUDIT_NAMES, ALL_RECIPE_NAMES, AuditName, AuditResult, type BumpDepsOptions, type ConvertToPnpmOptions, InventoryProvider, type LocalPathOptions, RecipeName, RecipeResult, Site, type UpgradeSvelte4to5Options, a11yAudit, bumpDeps, convertToPnpm, depsAudit, fromJsonFile, isRecipeName, lighthouseAudit, lintAudit, localPath, runAudits, runAuditsAcross, securityAudit, upgradeSvelte4to5 };
+export { ALL_AUDIT_NAMES, ALL_RECIPE_NAMES, AuditName, AuditResult, type BumpDepsOptions, type ConvertToPnpmOptions, InventoryProvider, type LocalPathOptions, type OnboardAudit, type OnboardOptions, RecipeName, RecipeResult, Site, type UpgradeSvelte4to5Options, a11yAudit, bumpDeps, convertToPnpm, depsAudit, fromJsonFile, isRecipeName, lighthouseAudit, lintAudit, localPath, onboard, runAudits, runAuditsAcross, securityAudit, upgradeSvelte4to5 };

package/dist/index.js

@@ -702,7 +702,25 @@ var playwrightA11y = {
   contents: `export { default } from "@reddoorla/maintenance/configs/playwright-a11y";
 `
 };
-var ALL_TEMPLATES = [eslint, prettier, lighthouse, playwrightA11y];
+var svelte = {
+  config: "svelte",
+  path: "svelte.config.js",
+  contents: `import { createSvelteConfig } from "@reddoorla/maintenance/configs/svelte";
+import adapter from "@sveltejs/adapter-auto";
+
+/** @type {import('@sveltejs/kit').Config} */
+export default createSvelteConfig({
+  kit: { adapter: adapter() },
+});
+`
+};
+var ALL_TEMPLATES = [
+  eslint,
+  prettier,
+  lighthouse,
+  playwrightA11y,
+  svelte
+];
 function templatesByName(which) {
   return ALL_TEMPLATES.filter((t) => which.includes(t.config));
 }
@@ -1358,12 +1376,110 @@ async function convertToPnpm(site, opts = {}) {
   };
 }
 
+// src/recipes/onboard.ts
+import { stat as stat2 } from "fs/promises";
+import { join as join13 } from "path";
+var PACKAGE_NAME = "@reddoorla/maintenance";
+var DEFAULT_PACKAGE_VERSION = "^0.2.0";
+var AUDIT_DEPS = {
+  lighthouse: [{ name: "@lhci/cli", version: "^0.15.1" }],
+  a11y: [
+    { name: "@playwright/test", version: "^1.59.1" },
+    { name: "@axe-core/playwright", version: "^4.11.3" }
+  ]
+};
+async function exists2(path) {
+  try {
+    await stat2(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function siteLabel10(site) {
+  return site.name ?? site.path;
+}
+function isDeclared(pkg, name) {
+  return Boolean(pkg.dependencies?.[name] ?? pkg.devDependencies?.[name]);
+}
+async function onboard(site, opts = {}) {
+  const label = siteLabel10(site);
+  const spawn2 = opts.spawn ?? defaultSpawn;
+  const audits = opts.audits ?? ["lighthouse", "a11y"];
+  const packageVersion = opts.packageVersion ?? DEFAULT_PACKAGE_VERSION;
+  if (!await exists2(join13(site.path, "pnpm-lock.yaml"))) {
+    return {
+      recipe: "onboard",
+      site: label,
+      status: "failed",
+      commits: [],
+      notes: "no pnpm-lock.yaml at site root \u2014 run convert-to-pnpm first"
+    };
+  }
+  const pkgPath = join13(site.path, "package.json");
+  const pkg = await readPackageJson(pkgPath);
+  const toAdd = [];
+  if (!isDeclared(pkg, PACKAGE_NAME)) {
+    toAdd.push({ name: PACKAGE_NAME, version: packageVersion });
+  }
+  for (const audit of audits) {
+    for (const dep of AUDIT_DEPS[audit]) {
+      if (!isDeclared(pkg, dep.name)) toAdd.push(dep);
+    }
+  }
+  if (toAdd.length === 0) {
+    return {
+      recipe: "onboard",
+      site: label,
+      status: "noop",
+      commits: [],
+      notes: `site already has ${PACKAGE_NAME} and audit deps (${audits.join("+")})`
+    };
+  }
+  if (!await isWorkingTreeClean(site.path)) {
+    throw new Error(`refusing to run: working tree is not clean at ${site.path}`);
+  }
+  const branch = branchName("onboard");
+  await createBranch(site.path, branch);
+  let next = pkg;
+  for (const dep of toAdd) {
+    next = bumpDep(next, dep.name, dep.version);
+  }
+  await writePackageJson(pkgPath, next);
+  const installResult = await spawn2("pnpm", ["install"], {
+    cwd: site.path,
+    streaming: true
+  });
+  if (installResult.code !== 0) {
+    return {
+      recipe: "onboard",
+      site: label,
+      status: "failed",
+      commits: [],
+      notes: `pnpm install failed (exit ${installResult.code}). branch ${branch} left for inspection.`
+    };
+  }
+  const sha = await commit(
+    site.path,
+    `chore(reddoor): onboard with ${PACKAGE_NAME} ${packageVersion}`
+  );
+  const shas = sha ? [sha] : [];
+  return {
+    recipe: "onboard",
+    site: label,
+    status: "applied",
+    commits: shas,
+    notes: `branch: ${branch}. Added ${toAdd.length} dep(s): ${toAdd.map((d) => d.name).join(", ")}`
+  };
+}
+
 // src/recipes/index.ts
 var ALL_RECIPE_NAMES = [
   "sync-configs",
   "bump-deps",
   "svelte-4-to-5",
-  "convert-to-pnpm"
+  "convert-to-pnpm",
+  "onboard"
 ];
 function isRecipeName(value) {
   return ALL_RECIPE_NAMES.includes(value);
@@ -1423,6 +1539,7 @@ export {
   lighthouseAudit,
   lintAudit,
   localPath,
+  onboard,
   runAudits,
   runAuditsAcross,
   securityAudit,