chokibasic 1.1.12 → 1.2.1

package/index.d.ts

@@ -1,5 +1,23 @@
-
 declare namespace chokibasic {
+  // --- NOUVEAUX TYPES POUR buildConf ---
+
+  /** 
+   * Callback pour buildConf. 
+   * Reçoit le contenu brut (Buffer) et le chemin relatif du fichier.
+   * Doit retourner la nouvelle valeur (string, objet, etc.) qui remplacera le chemin dans le JSON final.
+   */
+  export type BuildConfCallback = (content: Buffer, relPath: string) => any | Promise<any>;
+
+  /** 
+   * Dictionnaire de patterns globaux associés à des callbacks de transformation.
+   * Exemple: { "** / *.mid": (buf) => processMidi(buf) }
+   */
+  export interface BuildConfMatchers {
+    [glob: string]: BuildConfCallback;
+  }
+
+  // --- TYPES EXISTANTS ---
+
   export type GlobPattern = string;
 
   export type IgnoreMatcher =
@@ -10,9 +28,7 @@ declare namespace chokibasic {
   export type WatchEventType = "add" | "change" | "unlink" | (string & {});
 
   export interface WatchEvent {
-    /** Type d’évènement (dans le code actuel: surtout "change") */
     type: WatchEventType;
-    /** Chemin relatif à cwd, normalisé POSIX (slash "/") */
     file: string;
   }
 
@@ -21,22 +37,10 @@ declare namespace chokibasic {
   }
 
   export interface WatchRule {
-    /** Nom affiché en debug */
     name?: string;
-
-    /** Globs d’inclusion (ex: "src/styles/ ** / *.scss") */
     patterns: GlobPattern | GlobPattern[];
-
-    /** Ignorés additionnels (globs / regex / function) */
     ignored?: IgnoreMatcher[];
-
-    /** Debounce en ms (défaut: 150) */
     debounceMs?: number;
-
-    /**
-     * Callback appelé avec un batch d’évènements.
-     * Le batch contient des objets { type, file }.
-     */
     callback: (events: WatchEvent[], ctx: WatchRuleContext) => void | Promise<void>;
   }
 
@@ -46,39 +50,18 @@ declare namespace chokibasic {
   }
 
   export interface CreateWatchersOptions {
-    /** Répertoire racine utilisé pour calculer les chemins relatifs */
     cwd?: string;
-
-    /**
-     * Ignorés globaux (appliqués dans queue(), pas via chokidar "ignored")
-     * Défaut: ["** /node_modules/ **","** /.git/ **","** /dist/ **"]
-     */
     globalIgnored?: string[];
-
-    /** chokidar: ignoreInitial */
     ignoreInitial?: boolean;
-
-    /** chokidar: awaitWriteFinish */
     awaitWriteFinish?: boolean | AwaitWriteFinishOptions;
-
-    /** chokidar: usePolling */
     usePolling?: boolean;
-
-    /** chokidar: interval */
     interval?: number;
-
-    /** chokidar: binaryInterval */
     binaryInterval?: number;
-
-    /** Log console */
     debug?: boolean;
-
-    /** Permet d’accepter d’autres options sans casser les types */
     [key: string]: unknown;
   }
 
   export interface WatchersController {
-    /** Ferme tous les watchers et annule les timers */
     close: () => Promise<void>;
   }
 
@@ -94,23 +77,28 @@ declare namespace chokibasic {
     filter?: (relPath: string) => boolean;
   }
 
-  /** Options forwardées à esbuild.build() */
   export type BuildJSOptions = Parameters<typeof import("esbuild").build>[0];
-
-  /** Options forwardées à sass.compile() */
   export type BuildCSSOptions = NonNullable<Parameters<typeof import("sass").compile>[1]>;
 
+  // --- FONCTIONS EXPORTÉES ---
+
   /**
-   * Crée un ou plusieurs watchers (un par règle).
+   * Transforme un fichier YAML en JSON en appliquant des transformations sur les fichiers référencés.
+   * @param src Chemin vers le fichier source YAML.
+   * @param dst Chemin vers le fichier de destination JSON.
+   * @param matchers Dictionnaire de patterns et callbacks de transformation.
    */
+  export function buildConf(
+    src: string,
+    dst: string,
+    matchers?: BuildConfMatchers
+  ): Promise<void>;
+
   export function createWatchers(
     rules: WatchRule[],
     options?: CreateWatchersOptions
   ): WatchersController;
 
-  /**
-   * Exporte un dossier `src` vers `dist` en respectant .gitignore + exclusions.
-   */
   export function exportDist(
     src: string,
     dist: string,
@@ -118,38 +106,25 @@ declare namespace chokibasic {
     options?: ExportDistOptions
   ): Promise<ExportDistStats>;
 
-
-
-  /**
-   * Compile SCSS -> CSS minifié (csso), écrit dans outCssMin.
-   */
   export function buildCSS(
     inputScss: string,
     outCssMin: string,
     options?: BuildCSSOptions
   ): Promise<void>;
 
-  /**
-   * Bundle/minify JS via esbuild.
-   */
   export function buildJS(
     entry: string,
     outfile: string,
     options?: BuildJSOptions
   ): Promise<void>;
 
-  /**
-   * Rend un fichier via pxpros.render(file).
-   */
   export function buildPHP(file: string): Promise<void>;
 
-  /**
-   * Génère un sitemap via pxpros.sitemap(file).
-   */
   export function buildSitemap(file: string): Promise<void>;
 }
 
 declare const chokibasic: {
+  buildConf: typeof chokibasic.buildConf; // Ajouté ici aussi
   createWatchers: typeof chokibasic.createWatchers;
   exportDist: typeof chokibasic.exportDist;
   buildCSS: typeof chokibasic.buildCSS;
@@ -159,4 +134,4 @@ declare const chokibasic: {
 };
 
 export = chokibasic;
-export as namespace chokibasic;
+export as namespace chokibasic;

package/index.js

@@ -2,6 +2,7 @@ module.exports = {
 	...require("./src/buildjs.js"),
 	...require("./src/buildcss.js"),
 	...require("./src/buildphp.js"),
+	...require("./src/buildconf.js"),
 	...require("./src/export.js"),
 	...require("./src/watchers.js"),
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chokibasic",
-  "version": "1.1.12",
+  "version": "1.2.1",
   "description": "Basic chokidar watcher + pxpros + esbuild + sass + csso helpers",
   "main": "index.js",
   "types": "index.d.ts",
@@ -35,6 +35,8 @@
     "csso": "^5.0.5",
     "esbuild": "^0.28.0",
     "ignore": "^7.0.5",
+    "js-yaml": "^4.1.1",
+    "picomatch": "^4.0.4",
     "pxpros": "^1.1.3",
     "sass": "^1.99.0"
   }

package/readme.md

@@ -9,7 +9,7 @@ Tiny build & watch helpers for simple static projects.
 - `buildJS(entry, outfile, options?)`
 - `buildPHP(file)`
 - `buildSitemap(file)`
-- `exportDist(src, dist, bannerPath?)`
+- `exportDist(src, dist, bannerPath?, options?)`
 
 ---
 

package/src/buildconf.js

@@ -0,0 +1,74 @@
+const fs = require("fs").promises;
+const path = require("path");
+const yaml = require("js-yaml");
+const pm = require("picomatch");
+
+const ROOT = process.cwd();
+
+
+async function getMetadata() {
+    let version = "0.0.0";
+    try {
+        const pkg = JSON.parse(await fs.readFile(path.join(ROOT, "package.json"), "utf8"));
+        version = pkg.version || version;
+    } catch (e) {}
+
+    const now = new Date();
+    const pad = (n) => n.toString().padStart(2, '0');
+    const dateStr = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())} ${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}`;
+
+    return { version, date: dateStr };
+}
+
+
+async function walkAndTransform(node, matchers, metadata) {
+    if (Array.isArray(node)) {
+        return await Promise.all(node.map(item => walkAndTransform(item, matchers, metadata)));
+    }
+
+    if (typeof node === 'object' && node !== null) {
+        const newNode = {};
+        for (const [key, value] of Object.entries(node)) {
+            newNode[key] = await walkAndTransform(value, matchers, metadata);
+        }
+        return newNode;
+    }
+
+    if (typeof node === 'string') {
+        let processedString = node
+            .replace(/__VERSION__/g, metadata.version)
+            .replace(/__DATE__/g, metadata.date);
+
+        const fullPath = path.join(ROOT, processedString);
+        try {
+            const stats = await fs.stat(fullPath);
+            if (stats.isFile()) {
+                for (const [pattern, callback] of Object.entries(matchers)) {
+                    if (pm(pattern)(processedString)) {
+                        const content = await fs.readFile(fullPath);
+                        return await callback(content, processedString);
+                    }
+                }
+            }
+        } catch (err) {}
+        return processedString;
+    }
+
+    return node;
+}
+
+
+async function buildConf(src, dst, matchers = {}) {
+    try {
+        const metadata = await getMetadata();
+        const fileContents = await fs.readFile(src, 'utf8');
+        const rawData = yaml.load(fileContents);
+        const processedData = await walkAndTransform(rawData, matchers, metadata);
+        await fs.writeFile(dst, JSON.stringify(processedData, null, 2), 'utf8');
+        console.log(`✅ Build réussi : ${dst} (${metadata.version})`);
+    } catch (error) {
+        console.error("❌ Erreur :", error);
+    }
+}
+
+module.exports = { buildConf };