@fougere/compiler 0.8.4-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fougere contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/boot.d.ts

@@ -0,0 +1,42 @@
+import { type App, type CreateAppOptions, type Extension, type FougereConfig, type Transport } from '@fougere/core';
+import type { Container } from '@fougere/container';
+interface BootOptions {
+    /** Project root. Defaults to process.cwd(). */
+    root?: string;
+    /** Override config (merged with fougere.config.ts). */
+    config?: Partial<FougereConfig>;
+    /** Container factory. Required. */
+    createContainer: () => Container;
+    /** Only boot these fronds (by name). Absent = all. */
+    fronds?: string[];
+    /**
+     * Remote fronds — label → address. A declared remote wins over local
+     * presence (the frond runs elsewhere). Requires `remoteTransport`.
+     */
+    remotes?: Record<string, string>;
+    /** Builds the transport to reach `remotes`. Supplied by a layer-2 package. */
+    remoteTransport?: (url: string) => Transport;
+    /** Carries an announced fact out of this process. */
+    onEmit?: CreateAppOptions['onEmit'];
+    /**
+     * storage setup — returns the storage handle (db), an storageFactory, and its two halves.
+     * The `db` value is forwarded to the auth provider via AuthContext when `auth` is set.
+     */
+    db?: (config: FougereConfig) => {
+        db?: unknown;
+        storageFactory: CreateAppOptions['storageFactory'];
+        /** Bring the schema up to date — an extension's `up`, because it runs after the container. */
+        migrate?: (app: App) => Promise<void> | void;
+        /** Closes what the factory opened — `boot()` called it, so `boot()` releases it. */
+        close?: () => Promise<void>;
+    };
+    /**
+     * What this app takes on beyond its fronds. Appended after the framework's own, so a
+     * host adds to the ascent — or replaces a member of it by declaring the same name.
+     */
+    extensions?: readonly (Extension | undefined)[];
+}
+/** Boot a Fougere app from fougere.config.ts. */
+export declare function boot(options: BootOptions): Promise<App>;
+export {};
+//# sourceMappingURL=boot.d.ts.map

package/dist/boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../src/boot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsD,KAAK,GAAG,EAAE,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAIxK,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,UAAU,WAAW;IACnB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,mCAAmC;IACnC,eAAe,EAAE,MAAM,SAAS,CAAC;IACjC,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,8EAA8E;IAC9E,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;IAC7C,qDAAqD;IACrD,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACpC;;;OAGG;IACH,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK;QAC9B,EAAE,CAAC,EAAE,OAAO,CAAC;QACb,cAAc,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;QACnD,8FAA8F;QAC9F,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAC7C,oFAAoF;QACpF,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;KAC7B,CAAC;IACF;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC,EAAE,CAAC;CACjD;AAED,iDAAiD;AACjD,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CA4D7D"}

package/dist/boot.js

@@ -0,0 +1,59 @@
+import { Logger, applyConfig, createApp, migrating, seeding } from '@fougere/core';
+import { loadConfig } from '@fougere/core/node';
+import { scanProject } from './scan/scanner.js';
+/** Boot a Fougere app from fougere.config.ts. */
+export async function boot(options) {
+    const bootStart = performance.now();
+    const log = new Logger('boot');
+    const root = options.root ?? process.cwd();
+    log.info(`root: ${root}`);
+    log.debug('loading config');
+    const fileConfig = await loadConfig(root);
+    const config = { ...fileConfig, ...options.config };
+    // What this config changes in the process, said the same way at boot and at reload —
+    // there is one applier, and a host re-reading later calls the very same function.
+    applyConfig(config);
+    log.info('config loaded');
+    let dbSetup;
+    if (options.db) {
+        log.debug('initializing database');
+        dbSetup = options.db(config);
+        log.info('database initialized');
+    }
+    log.debug('creating app (scan + container)');
+    const app = await createApp({
+        // boot() lives on the Node entry, so boot() is what reads the disk. `createApp` is
+        // handed the answer and reaches for nothing.
+        scan: await scanProject(root, options.fronds, config.conventions),
+        createContainer: options.createContainer,
+        storageFactory: dbSetup?.storageFactory,
+        db: dbSetup?.db,
+        auth: config.auth,
+        remotes: options.remotes,
+        ports: config.ports,
+        // Read from the config for the same reason `ports` is, one line up: it is a fact the
+        // project states, not one the caller passes. Absent here, `serveRest` and
+        // `serveGraphQL` both answered `pass` on an app whose config declared them — the
+        // hosts got it right through their own boot (`app/shared/src/boot.ts`), and this
+        // path, the conventional one, served nothing.
+        adapters: config.adapters,
+        // boot() called the factory, so boot() owns closing what it opened. Not an extension:
+        // it was opened before the container existed, so it closes after the container goes.
+        onDispose: dbSetup?.close,
+        /**
+         * The whole ascent, in one ordered list — tables, then rows, then whatever the host takes on.
+         */
+        extensions: [
+            migrating(dbSetup?.migrate, (message) => log.warn(message)),
+            seeding((message) => log.debug(message)),
+            ...(options.extensions ?? []),
+        ],
+        onEmit: options.onEmit,
+        remoteTransport: options.remoteTransport,
+    });
+    log.info(`ascent: ${app.extensions().join(' → ') || 'nothing declared'}`);
+    const ms = (performance.now() - bootStart).toFixed(0);
+    log.info(`ready in ${ms}ms — ${app.fronds.length} frond(s)`);
+    return app;
+}
+//# sourceMappingURL=boot.js.map

package/dist/boot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.js","sourceRoot":"","sources":["../src/boot.ts"],"names":[],"mappings":"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"}

package/dist/declarations.d.ts

@@ -0,0 +1,35 @@
+/** What a handler file declares besides its handler. */
+import { type Conventions } from '@fougere/core';
+import { type HandlerEntry } from '@fougere/core/descriptor';
+export interface HandlerDeclaration {
+    /** Stable rule name — the same vocabulary `verify()` uses. */
+    rule: 'handler-declaration';
+    frond: string;
+    filePath: string;
+    /** The handler that hosts it. */
+    handler: string;
+    /** What is declared — `AGREED_WITHIN`, `says`, `Assessment`. */
+    subject: string;
+    /** What it is in the source: a value, or a shape. */
+    kind: 'value' | 'shape';
+    message: string;
+}
+/**
+ * Everything a handler file declares that is not the handler itself.
+ *
+ * A handler names gestures; what a gesture uses is declared where its nature says, and one
+ * question settles which: does it arrive INJECTED or IMPORTED? A threshold, a formula, a word
+ * list arrive imported and belong under `rules/`. Anything holding a client, a connection or
+ * a cursor arrives injected and belongs under `services/`. Neither ever belongs in the file
+ * that calls it — nothing there can be reached by a second caller, and the handler grows into
+ * the domain it was supposed to address.
+ *
+ * It names the two addresses, which `outsideConventions` does on the same question one file
+ * higher. Saying "a module beside its entities" instead left the reader to invent a place,
+ * and inventing one is the drift both rules report.
+ */
+export declare function handlerDeclarations(fronds: readonly {
+    name: string;
+    handlers: readonly Pick<HandlerEntry, 'name' | 'filePath'>[];
+}[], conventions: Conventions): Promise<HandlerDeclaration[]>;
+//# sourceMappingURL=declarations.d.ts.map

package/dist/declarations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarations.d.ts","sourceRoot":"","sources":["../src/declarations.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAU7D,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAuBD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC;CAC9D,EAAE,EACH,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA0C/B"}

package/dist/declarations.js

@@ -0,0 +1,75 @@
+import { readFile } from 'node:fs/promises';
+let _ts;
+async function loadTs() {
+    if (!_ts)
+        _ts = (await import('@typescript/typescript6')).default;
+    return _ts;
+}
+function subjectsOf(typescript, source) {
+    const found = [];
+    for (const statement of source.statements) {
+        if (typescript.isVariableStatement(statement)) {
+            for (const declared of statement.declarationList.declarations)
+                if (typescript.isIdentifier(declared.name))
+                    found.push([declared.name.text, 'value']);
+        }
+        else if (typescript.isFunctionDeclaration(statement) && statement.name) {
+            found.push([statement.name.text, 'value']);
+        }
+        else if (typescript.isInterfaceDeclaration(statement) ||
+            typescript.isTypeAliasDeclaration(statement) ||
+            typescript.isEnumDeclaration(statement)) {
+            found.push([statement.name.text, 'shape']);
+        }
+    }
+    return found;
+}
+/**
+ * Everything a handler file declares that is not the handler itself.
+ *
+ * A handler names gestures; what a gesture uses is declared where its nature says, and one
+ * question settles which: does it arrive INJECTED or IMPORTED? A threshold, a formula, a word
+ * list arrive imported and belong under `rules/`. Anything holding a client, a connection or
+ * a cursor arrives injected and belongs under `services/`. Neither ever belongs in the file
+ * that calls it — nothing there can be reached by a second caller, and the handler grows into
+ * the domain it was supposed to address.
+ *
+ * It names the two addresses, which `outsideConventions` does on the same question one file
+ * higher. Saying "a module beside its entities" instead left the reader to invent a place,
+ * and inventing one is the drift both rules report.
+ */
+export async function handlerDeclarations(fronds, conventions) {
+    const typescript = await loadTs();
+    const found = [];
+    for (const frond of fronds) {
+        for (const handler of frond.handlers) {
+            const text = await readFile(handler.filePath, 'utf8').catch(() => undefined);
+            if (text === undefined)
+                continue;
+            const source = typescript.createSourceFile(handler.filePath, text, typescript.ScriptTarget.Latest, false);
+            for (const [subject, kind] of subjectsOf(typescript, source)) {
+                found.push({
+                    rule: 'handler-declaration',
+                    frond: frond.name,
+                    filePath: handler.filePath,
+                    handler: handler.name,
+                    subject,
+                    kind,
+                    message: kind === 'value'
+                        ? `'${subject}' is declared in ${handler.name}, so only ${handler.name} can reach it. `
+                            + `If it needs nothing but its arguments, it is a word of '${frond.name}' and belongs `
+                            + `in \`${conventions.dirs.rules}/\`; if it holds a dependency, it belongs in `
+                            + `\`${conventions.dirs.services}/\`. Either way it is stated once and imported, and `
+                            + `the handler keeps only the gesture.`
+                        : `'${subject}' is declared in ${handler.name}, which makes the shape of what an `
+                            + `operation answers readable only from the file that answers it. A shape belongs `
+                            + `with the entity it describes in \`${conventions.dirs.entities}/\`, or in `
+                            + `\`${conventions.dirs.rules}/\` beside the words that compute it — where the caller, `
+                            + `the test and the other operations can all name it.`,
+                });
+            }
+        }
+    }
+    return found;
+}
+//# sourceMappingURL=declarations.js.map

package/dist/declarations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarations.js","sourceRoot":"","sources":["../src/declarations.ts"],"names":[],"mappings":"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"}

package/dist/imports.d.ts

@@ -0,0 +1,17 @@
+/** A frond reaching into another one by FILE PATH. */
+import { type FrondDescriptor } from '@fougere/core/descriptor';
+export interface CrossFrondImport {
+    /** Stable rule name — the same vocabulary `verify()` uses. */
+    rule: 'cross-frond-import';
+    /** The frond doing the reaching. */
+    frond: string;
+    filePath: string;
+    /** The specifier as written. */
+    specifier: string;
+    /** The frond the path lands in — absent when it lands outside every frond. */
+    target?: string;
+    message: string;
+}
+/** Every relative import that resolves outside its own frond. */
+export declare function crossFrondImports(fronds: readonly Pick<FrondDescriptor, 'name' | 'source'>[]): Promise<CrossFrondImport[]>;
+//# sourceMappingURL=imports.d.ts.map

package/dist/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../src/imports.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAWhE,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,IAAI,EAAE,oBAAoB,CAAC;IAC3B,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AA2BD,iEAAiE;AACjE,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,QAAQ,CAAC,EAAE,GAC1D,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAwC7B"}

package/dist/imports.js

@@ -0,0 +1,78 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join, resolve, dirname, relative, isAbsolute } from 'node:path';
+let _ts;
+async function loadTs() {
+    if (!_ts)
+        _ts = (await import('@typescript/typescript6')).default;
+    return _ts;
+}
+/** Is `child` inside `parent`? Path-based, so it says nothing about either existing. */
+function inside(parent, child) {
+    const rel = relative(parent, child);
+    return rel !== '' && !rel.startsWith('..') && !isAbsolute(rel);
+}
+async function sourcesUnder(dir) {
+    const out = [];
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        // Unreadable is the scan's complaint, not this rule's — and an absent directory is
+        // ordinary (a frond with no handlers).
+        return out;
+    }
+    for (const entry of entries) {
+        if (entry.name === 'node_modules' || entry.name.startsWith('.'))
+            continue;
+        const full = join(dir, entry.name);
+        if (entry.isDirectory())
+            out.push(...await sourcesUnder(full));
+        else if (entry.name.endsWith('.ts') && !entry.name.endsWith('.d.ts'))
+            out.push(full);
+    }
+    return out;
+}
+/** Every relative import that resolves outside its own frond. */
+export async function crossFrondImports(fronds) {
+    const typescript = await loadTs();
+    // `source.package` is the scoped name the scan already resolved — the remedy this rule
+    // prints must be the name that actually resolves, not one rebuilt from a prefix here.
+    const roots = fronds.map((frond) => ({
+        name: frond.name, path: resolve(frond.source.path), package: frond.source.package,
+    }));
+    const found = [];
+    for (const root of roots) {
+        for (const filePath of await sourcesUnder(root.path)) {
+            const text = await readFile(filePath, 'utf8').catch(() => undefined);
+            if (text === undefined)
+                continue;
+            for (const { fileName: specifier } of typescript.preProcessFile(text, true, true).importedFiles) {
+                if (!specifier.startsWith('.'))
+                    continue;
+                const landed = resolve(dirname(filePath), specifier);
+                if (inside(root.path, landed))
+                    continue;
+                const target = roots.find((other) => other.name !== root.name && inside(other.path, landed));
+                found.push({
+                    rule: 'cross-frond-import',
+                    frond: root.name,
+                    filePath,
+                    specifier,
+                    ...(target ? { target: target.name } : {}),
+                    message: target
+                        ? `'${specifier}' resolves into frond '${target.name}'. A relative path states that `
+                            + `these two fronds share a directory tree — a constraint nothing declares, and one `
+                            + `that nothing here can see. Write '${target.package}/…' instead: it says the `
+                            + `same dependency in terms the model reads, and it is the form \`fougere sync\` writes, `
+                            + `so it survives '${target.name}' moving out.`
+                        : `'${specifier}' resolves outside frond '${root.name}', into no frond at all. `
+                            + `Whatever it reaches is not part of any frond's contract, so nothing carries it `
+                            + `when this one is deployed on its own.`,
+                });
+            }
+        }
+    }
+    return found;
+}
+//# sourceMappingURL=imports.js.map

package/dist/imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.js","sourceRoot":"","sources":["../src/imports.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/** The scan: reading a project's source to produce the descriptors core boots from. */
+export { boot } from './boot.js';
+export { scanProject, frondAliases, watchPathsOf } from './scan/scanner.js';
+export { type Conventions, type ConventionsInput, DEFAULT_CONVENTIONS, resolveConventions, frondPackage, frondDirsOf, providerDirsOf, } from '@fougere/core';
+export { RUNTIME_PACKAGES } from './scan/bundling.js';
+export { emitScan, type EmitOptions } from './scan/emit.js';
+export { emitStatement } from './scan/statement.js';
+export { adaptersOf } from './scan/adapters.js';
+export { crossFrondImports, type CrossFrondImport } from './imports.js';
+export { handlerDeclarations, type HandlerDeclaration } from './declarations.js';
+export { outsideConventions, type OutsideConvention } from './placement.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EACL,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,mBAAmB,EAC5D,kBAAkB,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,GAC9D,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/** The scan: reading a project's source to produce the descriptors core boots from. */
+export { boot } from './boot.js';
+export { scanProject, frondAliases, watchPathsOf } from './scan/scanner.js';
+export { DEFAULT_CONVENTIONS, resolveConventions, frondPackage, frondDirsOf, providerDirsOf, } from '@fougere/core';
+export { RUNTIME_PACKAGES } from './scan/bundling.js';
+export { emitScan } from './scan/emit.js';
+export { emitStatement } from './scan/statement.js';
+export { adaptersOf } from './scan/adapters.js';
+export { crossFrondImports } from './imports.js';
+export { handlerDeclarations } from './declarations.js';
+export { outsideConventions } from './placement.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EACoC,mBAAmB,EAC5D,kBAAkB,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,GAC9D,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAoB,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAyB,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAA2B,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAA0B,MAAM,gBAAgB,CAAC"}

package/dist/placement.d.ts

@@ -0,0 +1,26 @@
+/** A file inside a frond that no convention names. */
+import { type Conventions } from '@fougere/core';
+import { type FrondDescriptor } from '@fougere/core/descriptor';
+export interface OutsideConvention {
+    /** Stable rule name — the same vocabulary `verify()` uses. */
+    rule: 'outside-convention';
+    frond: string;
+    filePath: string;
+    kind: 'file' | 'directory';
+    message: string;
+}
+/**
+ * What sits in a frond and belongs to no convention — a directory somebody invented, or a
+ * module dropped at the root.
+ *
+ * The eight names are the frond's whole vocabulary, and until now nothing said so: a scan
+ * READS them and steps over everything else in silence, so a file outside them is not
+ * refused, it is unseen. That silence is what lets a domain word settle wherever it was
+ * first needed — most often in the handler that used it, which is a second rule
+ * (`handler-declaration`) reporting the same drift one file lower.
+ *
+ * It names the addresses rather than describing them: a rule that says "put it somewhere
+ * better" is advice, and advice is what everybody already had.
+ */
+export declare function outsideConventions(fronds: readonly Pick<FrondDescriptor, 'name' | 'source'>[], conventions: Conventions): Promise<OutsideConvention[]>;
+//# sourceMappingURL=placement.d.ts.map

package/dist/placement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placement.d.ts","sourceRoot":"","sources":["../src/placement.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAIhE,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAaD;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,QAAQ,CAAC,EAAE,EAC3D,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA2C9B"}

package/dist/placement.js

@@ -0,0 +1,69 @@
+/** A file inside a frond that no convention names. */
+import { frondDirsOf } from '@fougere/core';
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * `tests` is not a convention and is not an offence either: `@fougere/testing` reads the
+ * LEVEL a case runs at from where its file sits, so a frond holding its own tests is a
+ * supported shape (`demos/test-gradient`). The rest are outputs and installs, which are
+ * not the project's source at all.
+ */
+const NOT_SOURCE = new Set(['tests', 'node_modules', 'dist', 'build', 'coverage']);
+/** The one file a frond states about itself, at its root. */
+const FROND_FILES = new Set(['frond.config.ts', 'package.json', 'tsconfig.json', 'README.md']);
+/**
+ * What sits in a frond and belongs to no convention — a directory somebody invented, or a
+ * module dropped at the root.
+ *
+ * The eight names are the frond's whole vocabulary, and until now nothing said so: a scan
+ * READS them and steps over everything else in silence, so a file outside them is not
+ * refused, it is unseen. That silence is what lets a domain word settle wherever it was
+ * first needed — most often in the handler that used it, which is a second rule
+ * (`handler-declaration`) reporting the same drift one file lower.
+ *
+ * It names the addresses rather than describing them: a rule that says "put it somewhere
+ * better" is advice, and advice is what everybody already had.
+ */
+export async function outsideConventions(fronds, conventions) {
+    const known = new Set(frondDirsOf(conventions));
+    const addresses = [...known].sort().join(', ');
+    const found = [];
+    for (const frond of fronds) {
+        const entries = await readdir(frond.source.path, { withFileTypes: true }).catch(() => []);
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') || NOT_SOURCE.has(entry.name))
+                continue;
+            const filePath = join(frond.source.path, entry.name);
+            if (entry.isDirectory()) {
+                if (known.has(entry.name))
+                    continue;
+                found.push({
+                    rule: 'outside-convention',
+                    frond: frond.name,
+                    filePath,
+                    kind: 'directory',
+                    message: `'${entry.name}/' is a directory no convention names, so nothing in it is read `
+                        + `as anything — it is a subject somebody filed under its own word. A frond's `
+                        + `directories are ${addresses}. If what it holds computes with nothing injected it `
+                        + `is \`${conventions.dirs.rules}/\`; if it holds a dependency it is `
+                        + `\`${conventions.dirs.services}/\`.`,
+                });
+                continue;
+            }
+            if (!entry.name.endsWith('.ts') || FROND_FILES.has(entry.name))
+                continue;
+            found.push({
+                rule: 'outside-convention',
+                frond: frond.name,
+                filePath,
+                kind: 'file',
+                message: `'${entry.name}' sits at the root of '${frond.name}', where the frond states `
+                    + `itself and nothing else. A frond's directories are ${addresses} — this one belongs `
+                    + `in \`${conventions.dirs.rules}/\` if it computes with nothing injected, in `
+                    + `\`${conventions.dirs.services}/\` if it holds a dependency.`,
+            });
+        }
+    }
+    return found;
+}
+//# sourceMappingURL=placement.js.map

package/dist/placement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placement.js","sourceRoot":"","sources":["../src/placement.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,OAAO,EAAE,WAAW,EAAoB,MAAM,eAAe,CAAC;AAE9D,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAWjC;;;;;GAKG;AACH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;AAEnF,6DAA6D;AAC7D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC,CAAC;AAE/F;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAA2D,EAC3D,WAAwB;IAExB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAwB,EAAE,CAAC;IAEtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAE1F,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAErD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,SAAS;gBACpC,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,oBAAoB;oBAC1B,KAAK,EAAE,KAAK,CAAC,IAAI;oBACjB,QAAQ;oBACR,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,IAAI,KAAK,CAAC,IAAI,kEAAkE;0BACrF,6EAA6E;0BAC7E,mBAAmB,SAAS,uDAAuD;0BACnF,QAAQ,WAAW,CAAC,IAAI,CAAC,KAAK,sCAAsC;0BACpE,KAAK,WAAW,CAAC,IAAI,CAAC,QAAQ,MAAM;iBACzC,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YACzE,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,oBAAoB;gBAC1B,KAAK,EAAE,KAAK,CAAC,IAAI;gBACjB,QAAQ;gBACR,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,IAAI,KAAK,CAAC,IAAI,0BAA0B,KAAK,CAAC,IAAI,4BAA4B;sBACnF,sDAAsD,SAAS,sBAAsB;sBACrF,QAAQ,WAAW,CAAC,IAAI,CAAC,KAAK,+CAA+C;sBAC7E,KAAK,WAAW,CAAC,IAAI,CAAC,QAAQ,+BAA+B;aAClE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/scan/adapters.d.ts

@@ -0,0 +1,3 @@
+/** The adapter names this project depends on — empty when it has no package.json to read. */
+export declare function adaptersOf(root: string): Promise<string[]>;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/scan/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/scan/adapters.ts"],"names":[],"mappings":"AAMA,6FAA6F;AAC7F,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAShE"}

package/dist/scan/adapters.js

@@ -0,0 +1,25 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/** Which adapters a PROJECT could load, read off its dependencies. */
+const ADAPTER_PACKAGE = /^@fougere\/adapter-(.+)$/;
+/** The adapter names this project depends on — empty when it has no package.json to read. */
+export async function adaptersOf(root) {
+    const manifest = await read(join(root, 'package.json'));
+    if (!manifest)
+        return [];
+    const declared = { ...manifest.dependencies, ...manifest.devDependencies };
+    return Object.keys(declared)
+        .map((name) => ADAPTER_PACKAGE.exec(name)?.[1])
+        .filter((name) => name !== undefined);
+}
+async function read(path) {
+    try {
+        return JSON.parse(await readFile(path, 'utf8'));
+    }
+    catch {
+        // No manifest, or one that is not JSON. Either way this cannot validate a name, and
+        // reporting every `adapters:` key as unknown would be worse than saying nothing.
+        return undefined;
+    }
+}
+//# sourceMappingURL=adapters.js.map

package/dist/scan/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/scan/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,sEAAsE;AACtE,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAEnD,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;IACxD,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzB,MAAM,QAAQ,GAAG,EAAE,GAAG,QAAQ,CAAC,YAAY,EAAE,GAAG,QAAQ,CAAC,eAAe,EAAE,CAAC;IAE3E,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;SACzB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SAC9C,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED,KAAK,UAAU,IAAI,CAAC,IAAY;IAC9B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAa,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,oFAAoF;QACpF,iFAAiF;QACjF,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/scan/bundling.d.ts

@@ -0,0 +1,3 @@
+/** What a Fougere boot loads at RUNTIME, so a bundler must leave it alone. */
+export declare const RUNTIME_PACKAGES: readonly string[];
+//# sourceMappingURL=bundling.d.ts.map

package/dist/scan/bundling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundling.d.ts","sourceRoot":"","sources":["../../src/scan/bundling.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAY7C,CAAC"}

package/dist/scan/bundling.js

@@ -0,0 +1,15 @@
+/** What a Fougere boot loads at RUNTIME, so a bundler must leave it alone. */
+export const RUNTIME_PACKAGES = [
+    '@fougere/app',
+    '@fougere/core',
+    '@fougere/schema',
+    '@fougere/defaults',
+    '@fougere/transport-http',
+    '@fougere/adapter-sql',
+    '@fougere/adapter-graphql',
+    '@fougere/auth-better',
+    'better-sqlite3',
+    'jiti',
+    'typescript',
+];
+//# sourceMappingURL=bundling.js.map

package/dist/scan/bundling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundling.js","sourceRoot":"","sources":["../../src/scan/bundling.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,cAAc;IACd,eAAe;IACf,iBAAiB;IACjB,mBAAmB;IACnB,yBAAyB;IACzB,sBAAsB;IACtB,0BAA0B;IAC1B,sBAAsB;IACtB,gBAAgB;IAChB,MAAM;IACN,YAAY;CACb,CAAC"}

package/dist/scan/contract.d.ts

@@ -0,0 +1,27 @@
+/** An operation contract, written down — the half two emitters say the same way. */
+import { type OperationContract } from '@fougere/core/descriptor';
+import { type SchemaView } from '@fougere/schema';
+/** A value that ends up as an import in the module being written. */
+export type Live = object;
+/**
+ * What the writer needs of an emitter's imports, and nothing more.
+ *
+ * The two emitters index theirs differently — one by value against a relative path, one
+ * by file against the package specifier a project already uses — and neither is wrong for
+ * the module it writes. What they agree on is this: a value already imported has an
+ * alias, a class can be imported by name, and an entity can be found by its class name.
+ */
+export interface Aliases {
+    aliasOf(value: Live): string | undefined;
+    named(value: Live, filePath: string, name: string): string;
+    /** The entity class this name belongs to — what a `Partial<X>` names as its source. */
+    classNamed(name: string): Live | undefined;
+}
+export declare const lit: (value: unknown) => string;
+/** What a schema slot becomes in the generated module. */
+export declare function schemaRef(schema: SchemaView | undefined, declaredIn: string, imports: Aliases): string | undefined;
+/** One entry of an operations Map, as its module spells it. */
+export declare function contractOf(op: string, contract: OperationContract, declaredIn: string, imports: Aliases): string;
+/** The operations of one handler, as the Map its reader builds. */
+export declare function operationsOf(operations: ReadonlyMap<string, OperationContract>, declaredIn: string, imports: Aliases, indent: string): string;
+//# sourceMappingURL=contract.d.ts.map

package/dist/scan/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/scan/contract.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE/E,qEAAqE;AACrE,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC;AAE1B;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3D,uFAAuF;IACvF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CAC5C;AAED,eAAO,MAAM,GAAG,UAAW,OAAO,KAAG,MAAuC,CAAC;AAE7E,0DAA0D;AAC1D,wBAAgB,SAAS,CACvB,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,GACf,MAAM,GAAG,SAAS,CAiBpB;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CACxB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,iBAAiB,EAC3B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,GACf,MAAM,CAYR;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAC1B,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAClD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,CAIR"}