@fougere/core 0.1.0-alpha.0

package/dist/scan-cache.js

@@ -0,0 +1,92 @@
+/**
+ * Scan cache — caches parse results per file.
+ *
+ * Stores in .fougere/scan-cache.json.
+ * Key: cache key (file path + suffix) → { hash, data }.
+ * Hash: content hash of the source file.
+ * If hash matches, skip parsing entirely → TypeScript never loaded.
+ *
+ * The envelope carries PARSER_VERSION, and a mismatch drops the whole file. The hash
+ * answers "did this source change?"; it cannot answer "does the parser still read it the
+ * same way?". A parser fix therefore left every unchanged handler serving the OLD parse,
+ * indefinitely and without a word — that is how `Crud`'s inherited ops stayed silently
+ * underived for weeks, until someone deleted `.fougere/` by hand and the tests went red.
+ *
+ * Bump PARSER_VERSION whenever the parser's OUTPUT for unchanged source can differ.
+ */
+import { createHash } from 'node:crypto';
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Bump when the parser can read unchanged source differently.
+ *
+ * 2 — `handler-parser` unwraps a class returned through a call/assertion, so a mixin
+ *     like `asCrudConstructor(class { … })` yields its methods again.
+ * 3 — parsed array types carry `arrayDepth`, used to distinguish a presenter page
+ *     returning scalar fields from one returning list fields.
+ */
+// 4 — the parse became a pair (methods + unresolvedHeritage); a v3 entry
+// would answer with an array and lose the half that reports what it could not open.
+const PARSER_VERSION = 4;
+let root = process.cwd();
+let cache = null;
+let dirty = false;
+function cachePath() {
+    return join(root, '.fougere', 'scan-cache.json');
+}
+export function setCacheRoot(dir) {
+    root = dir;
+    cache = null;
+}
+function load() {
+    if (cache)
+        return cache;
+    const path = cachePath();
+    if (existsSync(path)) {
+        try {
+            const file = JSON.parse(readFileSync(path, 'utf-8'));
+            // A stamp from another parser is not stale data to refresh entry by entry — every
+            // entry in the file was produced by it. Drop the lot; the next scan is cold once.
+            if (file.parser === PARSER_VERSION && file.entries) {
+                cache = file.entries;
+                return cache;
+            }
+        }
+        catch {
+            // Corrupted cache — start fresh
+        }
+    }
+    cache = {};
+    return cache;
+}
+export function hashFile(filePath) {
+    const content = readFileSync(filePath, 'utf-8');
+    return createHash('sha1').update(content).digest('hex').slice(0, 16);
+}
+/** Get cached parse result. Returns null if cache miss. */
+export function getCached(key, hash) {
+    const data = load();
+    const entry = data[key];
+    if (entry && entry.hash === hash)
+        return entry.data;
+    return null;
+}
+/** Store parse result in cache. */
+export function setCached(key, hash, data) {
+    const store = load();
+    store[key] = { hash, data };
+    dirty = true;
+}
+// Legacy aliases — used by existing callers
+export { getCached as getCachedMethods, setCached as setCachedMethods };
+/** Write cache to disk if modified. */
+export function flushCache() {
+    if (!dirty || !cache)
+        return;
+    const path = cachePath();
+    mkdirSync(join(root, '.fougere'), { recursive: true });
+    const file = { parser: PARSER_VERSION, entries: cache };
+    writeFileSync(path, JSON.stringify(file, null, 2));
+    dirty = false;
+}
+//# sourceMappingURL=scan-cache.js.map

package/dist/scan-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-cache.js","sourceRoot":"","sources":["../src/scan-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;GAOG;AACH,yEAAyE;AACzE,oFAAoF;AACpF,MAAM,cAAc,GAAG,CAAC,CAAC;AAczB,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AACzB,IAAI,KAAK,GAAqB,IAAI,CAAC;AACnC,IAAI,KAAK,GAAG,KAAK,CAAC;AAElB,SAAS,SAAS;IAChB,OAAO,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IAAI,GAAG,GAAG,CAAC;IACX,KAAK,GAAG,IAAI,CAAC;AACf,CAAC;AAED,SAAS,IAAI;IACX,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;IACzB,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAuB,CAAC;YAC3E,kFAAkF;YAClF,kFAAkF;YAClF,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACnD,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;gBACrB,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;IACH,CAAC;IACD,KAAK,GAAG,EAAE,CAAC;IACX,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,SAAS,CAAI,GAAW,EAAE,IAAY;IACpD,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC;IACpB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC,IAAS,CAAC;IACzD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,IAAY,EAAE,IAAa;IAChE,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;IACrB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC5B,KAAK,GAAG,IAAI,CAAC;AACf,CAAC;AAED,4CAA4C;AAC5C,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,SAAS,IAAI,gBAAgB,EAAE,CAAC;AAExE,uCAAuC;AACvC,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK;QAAE,OAAO;IAC7B,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;IACzB,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,IAAI,GAAc,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACnE,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACnD,KAAK,GAAG,KAAK,CAAC;AAChB,CAAC"}

package/dist/scanner.d.ts

@@ -0,0 +1,34 @@
+import type { ScanResult } from './types.js';
+/** Module loader — can be swapped (e.g. jiti for TS files in Nuxt context). */
+export type ModuleLoader = (filePath: string) => Promise<Record<string, unknown>>;
+/** Override the module loader used by the scanner (e.g. for jiti/tsx support). */
+export declare function setModuleLoader(loader: ModuleLoader): void;
+/** Used by config-loader to load fougere.config.ts via the same TS-aware loader. */
+export declare function getModuleLoader(): ModuleLoader;
+/**
+ * The frond vocabulary — every directory {@link scanFrond} reads. A frond directory says
+ * nothing else, which is why this list is what a reader needs to bound one: the Nuxt
+ * module watches these for the root frond (watching the root itself would match every
+ * write), and a flat app's tsconfig lists them instead of `["."]`, which would swallow
+ * `app/` and `nuxt.config.ts`.
+ */
+export declare const FROND_DIRS: readonly ["entities", "handlers", "presenters", "collectors", "seeds", "services", "repositories"];
+export { toRegistrationName } from './contract.js';
+/**
+ * `@frond/<name>` → the directory it names, for every frond of a project.
+ *
+ * The framework states this convention — `FrondSource.package` has always spelled it, and
+ * `fougere sync` writes it into a consumer's tsconfig — and until now its own reader could
+ * not resolve it. The Nuxt module registered a Vite alias, so a `.vue` page could import
+ * `@frond/blog/entities/Post`, while the SCAN loaded sources through a bare jiti: a frond
+ * naming its neighbour got `Cannot find module '@frond/user/entities/User.js'`. So the one
+ * form that survives a split was the one form that did not run.
+ *
+ * Hand it to the module loader — `createJiti(url, { alias: await frondAliases(root) })` —
+ * and the named form resolves everywhere the framework reads. A directory listing and a
+ * `package.json` read, no parsing: it is deliberately callable BEFORE the loader exists,
+ * which is what makes the chicken-and-egg go away.
+ */
+export declare function frondAliases(root: string): Promise<Record<string, string>>;
+export declare function scanProject(root: string, filter?: string[]): Promise<ScanResult>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAwG,UAAU,EAAkB,MAAM,YAAY,CAAC;AAanK,+EAA+E;AAC/E,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAOlF,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAE1D;AAED,oFAAoF;AACpF,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AA6FD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,oGAEb,CAAC;AAEX,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAgcnD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsChF;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAgCtF"}