@hgdc/config 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,21 @@
-# Temporary Holding Version
+# @hgdc/config
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Configuration partagée des produits de la H family : presets TypeScript, oxlint et oxfmt, preset Renovate, versions exactes de la stack.
+
+```sh
+bun add --dev --exact @hgdc/config
+bunx hgdc-stack check   # échoue si une dépendance de la stack n'est pas à sa version
+bunx hgdc-stack sync    # réécrit package.json aux versions de la stack
+```
+
+| Export                                                     | Usage                               |
+| ---------------------------------------------------------- | ----------------------------------- |
+| `@hgdc/config/tsconfig/{base,app,convex,library}.json`     | `"extends"` d'un tsconfig           |
+| `@hgdc/config/oxlint`                                      | `extends` d'un `oxlint.config.ts`   |
+| `@hgdc/config/oxfmt`                                       | à étendre dans un `oxfmt.config.ts` |
+| `@hgdc/config/stack.json`                                  | versions exactes de la stack        |
+| `github>hugogebel-boop/hgdc-kit//packages/config/renovate` | preset Renovate                     |
+
+Mode d'emploi complet : [Adopter le kit](https://github.com/hugogebel-boop/hgdc-kit/blob/main/docs/guides/adopter-le-kit.md).
+
+Tous droits réservés, Hugo Gebel Développement Conseil.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import { readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { alignManifest, findDrift, loadStack, parseManifest } from "./stack.js";
+const USAGE = `Usage : hgdc-stack <check|sync> [--cwd <dossier>]
+
+  check  échoue si une dépendance de la stack n'est pas à sa version exacte
+  sync   réécrit package.json aux versions de la stack (lancer bun install ensuite)`;
+const { positionals, values } = parseArgs({
+    allowPositionals: true,
+    options: { cwd: { type: "string", default: process.cwd() } },
+});
+const command = positionals[0];
+if (command !== "check" && command !== "sync") {
+    console.error(USAGE);
+    process.exit(2);
+}
+const manifestPath = resolve(values.cwd, "package.json");
+const manifest = parseManifest(readFileSync(manifestPath, "utf8"));
+const stack = loadStack();
+const drift = findDrift(manifest, stack);
+if (drift.length === 0) {
+    console.log("Stack HGDC : à jour.");
+    process.exit(0);
+}
+for (const { name, field, current, expected } of drift) {
+    console.log(`  ${name} (${field}) : ${current} → ${expected}`);
+}
+if (command === "check") {
+    console.error(`\nStack HGDC : ${drift.length} écart(s). Corriger avec « hgdc-stack sync » puis « bun install ».`);
+    process.exit(1);
+}
+writeFileSync(manifestPath, `${JSON.stringify(alignManifest(manifest, stack), null, 2)}\n`);
+console.log(`\nStack HGDC : ${drift.length} version(s) réalignée(s). Lancer « bun install ».`);

package/dist/oxfmt.d.ts

@@ -0,0 +1,8 @@
+import { type OxfmtConfig } from "oxfmt";
+/**
+ * Format commun de la H family, aligné sur le code existant de host et mail
+ * (sans point-virgule, guillemets doubles). Le produit étend ce preset et ajoute,
+ * s'il utilise Tailwind, `sortTailwindcss.stylesheet` vers sa feuille principale.
+ */
+declare const hgdc: OxfmtConfig;
+export default hgdc;

package/dist/oxfmt.js

@@ -0,0 +1,15 @@
+import { defineConfig } from "oxfmt";
+/**
+ * Format commun de la H family, aligné sur le code existant de host et mail
+ * (sans point-virgule, guillemets doubles). Le produit étend ce preset et ajoute,
+ * s'il utilise Tailwind, `sortTailwindcss.stylesheet` vers sa feuille principale.
+ */
+const hgdc = defineConfig({
+    printWidth: 120,
+    semi: false,
+    singleQuote: false,
+    trailingComma: "all",
+    sortPackageJson: false,
+    ignorePatterns: ["**/_generated/**", "**/routeTree.gen.ts", "**/CHANGELOG.md", ".changeset/*.md"],
+});
+export default hgdc;

package/dist/oxlint.d.ts

@@ -0,0 +1,11 @@
+import { type OxlintConfig } from "oxlint";
+/**
+ * Règles communes de la H family : la catégorie `correctness` d'oxlint (son défaut recommandé)
+ * plus une courte liste de règles à forte valeur, toutes bloquantes. Pas d'avertissement :
+ * une règle qui ne bloque pas finit ignorée.
+ *
+ * À étendre depuis l'`oxlint.config.ts` racine du produit, qui pose aussi `options.typeAware`
+ * (oxlint ne lit cette option que dans la config racine).
+ */
+declare const hgdc: OxlintConfig;
+export default hgdc;

package/dist/oxlint.js

@@ -0,0 +1,63 @@
+import { defineConfig } from "oxlint";
+/**
+ * Règles communes de la H family : la catégorie `correctness` d'oxlint (son défaut recommandé)
+ * plus une courte liste de règles à forte valeur, toutes bloquantes. Pas d'avertissement :
+ * une règle qui ne bloque pas finit ignorée.
+ *
+ * À étendre depuis l'`oxlint.config.ts` racine du produit, qui pose aussi `options.typeAware`
+ * (oxlint ne lit cette option que dans la config racine).
+ */
+const hgdc = defineConfig({
+    plugins: ["eslint", "typescript", "unicorn", "oxc", "import", "promise", "react", "jsx-a11y", "vitest"],
+    categories: {
+        correctness: "error",
+    },
+    rules: {
+        // Promesse oubliée = écriture Convex perdue ou erreur avalée.
+        "typescript/no-floating-promises": "error",
+        // Handler async passé en attribut JSX : usage React normal (recommandation typescript-eslint).
+        "typescript/no-misused-promises": ["error", { checksVoidReturn: { attributes: false } }],
+        "typescript/await-thenable": "error",
+        "typescript/no-explicit-any": "error",
+        "typescript/consistent-type-imports": "error",
+        "eslint/eqeqeq": ["error", "smart"],
+        "eslint/no-console": ["error", { allow: ["warn", "error"] }],
+        "import/no-cycle": "error",
+        "react/rules-of-hooks": "error",
+        "react/exhaustive-deps": "error",
+        "react/jsx-key": "error",
+        // Accessibilité alignée sur le preset `recommended` de eslint-plugin-jsx-a11y.
+        "jsx-a11y/prefer-tag-over-role": "off",
+        "jsx-a11y/control-has-associated-label": "off",
+        "jsx-a11y/no-noninteractive-element-to-interactive-role": [
+            "error",
+            {
+                ul: ["listbox", "menu", "menubar", "radiogroup", "tablist", "tree", "treegrid"],
+                ol: ["listbox", "menu", "menubar", "radiogroup", "tablist", "tree", "treegrid"],
+                li: ["menuitem", "menuitemradio", "menuitemcheckbox", "option", "row", "tab", "treeitem"],
+                table: ["grid"],
+                td: ["gridcell"],
+            },
+        ],
+        // Contrôles du kit UI reconnus comme champs ; texte du label souvent imbriqué dans des <span>.
+        "jsx-a11y/label-has-associated-control": [
+            "error",
+            { controlComponents: ["Input", "Textarea", "Select", "Switch", "Checkbox", "RadioGroup"], depth: 3 },
+        ],
+        // Focus automatique voulu sur les écrans à une seule tâche (connexion, code à usage unique).
+        "jsx-a11y/no-autofocus": "off",
+    },
+    overrides: [
+        {
+            // Scripts et CLI : la console est leur interface. Convex : console.log alimente les logs du tableau de bord.
+            files: ["scripts/**", "**/cli.ts", "**/*.config.ts", "convex/**"],
+            rules: { "eslint/no-console": "off" },
+        },
+        {
+            // Composant Label générique (shadcn) : le champ est associé là où il est utilisé.
+            files: ["**/components/ui/label.tsx"],
+            rules: { "jsx-a11y/label-has-associated-control": "off" },
+        },
+    ],
+});
+export default hgdc;

package/dist/stack.d.ts

@@ -0,0 +1,26 @@
+/** Versions exactes de la stack commune, par nom de paquet. */
+export type Stack = Readonly<Record<string, string>>;
+declare const DEPENDENCY_FIELDS: readonly ["dependencies", "devDependencies", "optionalDependencies"];
+type DependencyField = (typeof DEPENDENCY_FIELDS)[number];
+/** Sous-ensemble d'un package.json utile ici ; les autres champs sont conservés tels quels. */
+export type Manifest = {
+    [K in DependencyField]?: Record<string, string>;
+} & Record<string, unknown>;
+export type Drift = {
+    name: string;
+    field: DependencyField;
+    current: string;
+    expected: string;
+};
+export declare function parseStack(text: string): Stack;
+export declare function parseManifest(text: string): Manifest;
+export declare function loadStack(): Stack;
+/**
+ * Écarts entre un manifeste et la stack. Un paquet absent du manifeste n'est pas un écart :
+ * la stack fixe la version de ce qu'un produit utilise, pas la liste de ses dépendances.
+ * `peerDependencies` est ignoré : une plage y est voulue.
+ */
+export declare function findDrift(manifest: Manifest, stack: Stack): Drift[];
+/** Copie du manifeste où chaque paquet de la stack est épinglé à sa version. */
+export declare function alignManifest(manifest: Manifest, stack: Stack): Manifest;
+export {};

package/dist/stack.js

@@ -0,0 +1,61 @@
+import { readFileSync } from "node:fs";
+const DEPENDENCY_FIELDS = ["dependencies", "devDependencies", "optionalDependencies"];
+const EXACT_VERSION = /^\d+\.\d+\.\d+(?:-[\w.]+)?$/;
+function isStringRecord(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        Object.values(value).every((v) => typeof v === "string"));
+}
+function isManifest(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const fields = { ...value };
+    return DEPENDENCY_FIELDS.every((field) => fields[field] === undefined || isStringRecord(fields[field]));
+}
+export function parseStack(text) {
+    const raw = JSON.parse(text);
+    if (!isStringRecord(raw))
+        throw new Error("stack.json doit associer un nom de paquet à une version");
+    const inexact = Object.entries(raw).filter(([, version]) => !EXACT_VERSION.test(version));
+    if (inexact.length > 0) {
+        throw new Error(`stack.json : versions non exactes : ${inexact.map(([n, v]) => `${n}@${v}`).join(", ")}`);
+    }
+    return raw;
+}
+export function parseManifest(text) {
+    const raw = JSON.parse(text);
+    if (!isManifest(raw))
+        throw new Error("package.json invalide : un champ de dépendances n'est pas un objet de chaînes");
+    return raw;
+}
+export function loadStack() {
+    return parseStack(readFileSync(new URL("../stack.json", import.meta.url), "utf8"));
+}
+/**
+ * Écarts entre un manifeste et la stack. Un paquet absent du manifeste n'est pas un écart :
+ * la stack fixe la version de ce qu'un produit utilise, pas la liste de ses dépendances.
+ * `peerDependencies` est ignoré : une plage y est voulue.
+ */
+export function findDrift(manifest, stack) {
+    const drift = [];
+    for (const field of DEPENDENCY_FIELDS) {
+        for (const [name, current] of Object.entries(manifest[field] ?? {})) {
+            const expected = stack[name];
+            if (expected !== undefined && current !== expected)
+                drift.push({ name, field, current, expected });
+        }
+    }
+    return drift;
+}
+/** Copie du manifeste où chaque paquet de la stack est épinglé à sa version. */
+export function alignManifest(manifest, stack) {
+    const aligned = { ...manifest };
+    for (const field of DEPENDENCY_FIELDS) {
+        const deps = manifest[field];
+        if (!deps)
+            continue;
+        aligned[field] = Object.fromEntries(Object.entries(deps).map(([name, version]) => [name, stack[name] ?? version]));
+    }
+    return aligned;
+}

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@hgdc/config",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Config partagée de la H family : tsconfig, oxlint, oxfmt, Renovate, versions exactes de la stack.",
+  "license": "UNLICENSED",
+  "homepage": "https://github.com/hugogebel-boop/hgdc-kit/tree/main/packages/config#readme",
+  "bugs": "https://github.com/hugogebel-boop/hgdc-kit/security/advisories/new",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hugogebel-boop/hgdc-kit.git",
+    "directory": "packages/config"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "tsconfig",
+    "renovate",
+    "stack.json"
+  ],
+  "bin": {
+    "hgdc-stack": "./dist/cli.js"
+  },
+  "exports": {
+    "./oxlint": {
+      "types": "./dist/oxlint.d.ts",
+      "default": "./dist/oxlint.js"
+    },
+    "./oxfmt": {
+      "types": "./dist/oxfmt.d.ts",
+      "default": "./dist/oxfmt.js"
+    },
+    "./stack": {
+      "types": "./dist/stack.d.ts",
+      "default": "./dist/stack.js"
+    },
+    "./stack.json": "./stack.json",
+    "./tsconfig/*": "./tsconfig/*",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "engines": {
+    "node": ">=22.18.0"
+  }
+}

package/renovate/default.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "description": "Preset Renovate des produits de la H family.",
+  "extends": ["config:recommended", ":semanticCommitTypeAll(chore)", "helpers:pinGitHubActionDigests"],
+  "timezone": "Europe/Zurich",
+  "schedule": ["before 6am on monday"],
+  "minimumReleaseAge": "3 days",
+  "rangeStrategy": "pin",
+  "lockFileMaintenance": {
+    "enabled": true,
+    "automerge": true
+  },
+  "packageRules": [
+    {
+      "description": "Kit et stack commune : propagés par hgdc-kit (propagate.yml), pas par Renovate.",
+      "matchPackageNames": [
+        "@hgdc/*",
+        "@changesets/cli",
+        "@convex-dev/better-auth",
+        "@convex-dev/react-query",
+        "@tailwindcss/vite",
+        "@tanstack/react-query",
+        "@tanstack/react-router",
+        "@tanstack/react-router-ssr-query",
+        "@tanstack/react-start",
+        "@types/bun",
+        "@types/node",
+        "@types/react",
+        "@types/react-dom",
+        "@vitejs/plugin-react",
+        "better-auth",
+        "convex",
+        "nitro",
+        "oxfmt",
+        "oxlint",
+        "oxlint-tsgolint",
+        "react",
+        "react-dom",
+        "tailwindcss",
+        "typescript",
+        "vite",
+        "vitest",
+        "zod"
+      ],
+      "enabled": false
+    },
+    {
+      "description": "Mineurs et correctifs d'une dépendance stable : fusion automatique si la CI passe.",
+      "matchUpdateTypes": ["minor", "patch", "pin", "digest"],
+      "matchCurrentVersion": "!/^v?0\\./",
+      "automerge": true
+    }
+  ]
+}

package/stack.json

@@ -0,0 +1,28 @@
+{
+  "@changesets/cli": "3.0.3",
+  "@convex-dev/better-auth": "0.12.5",
+  "@convex-dev/react-query": "0.1.0",
+  "@tailwindcss/vite": "4.3.3",
+  "@tanstack/react-query": "5.104.1",
+  "@tanstack/react-router": "1.170.42",
+  "@tanstack/react-router-ssr-query": "1.167.3",
+  "@tanstack/react-start": "1.168.61",
+  "@types/bun": "1.4.2",
+  "@types/node": "24.19.2",
+  "@types/react": "19.3.0",
+  "@types/react-dom": "19.3.0",
+  "@vitejs/plugin-react": "6.1.2",
+  "better-auth": "1.6.16",
+  "convex": "1.46.0",
+  "nitro": "3.0.260903-beta",
+  "oxfmt": "0.72.0",
+  "oxlint": "1.87.0",
+  "oxlint-tsgolint": "7.0.2004",
+  "react": "19.3.0",
+  "react-dom": "19.3.0",
+  "tailwindcss": "4.3.3",
+  "typescript": "7.0.2",
+  "vite": "8.3.4",
+  "vitest": "5.0.3",
+  "zod": "4.6.5"
+}

package/tsconfig/app.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "lib": ["ES2024", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx",
+    "types": ["vite/client"]
+  }
+}

package/tsconfig/base.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "target": "ES2024",
+    "lib": ["ES2024"],
+    "module": "preserve",
+    "moduleResolution": "bundler",
+    "moduleDetection": "force",
+    "resolveJsonModule": true,
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  }
+}

package/tsconfig/convex.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "lib": ["ES2024", "DOM"],
+    "jsx": "react-jsx",
+    "allowJs": true,
+    "types": ["node"]
+  }
+}

package/tsconfig/library.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
+    "rewriteRelativeImportExtensions": true,
+    "noEmit": false,
+    "declaration": true,
+    "isolatedDeclarations": true
+  }
+}