@fougere/core 0.9.3-alpha.0 → 0.11.0-alpha.0

package/dist/AdapterConfig.d.ts

@@ -0,0 +1,10 @@
+/** Protocol adapters, by the name of the package that provides them. */
+export interface AdapterConfig {
+    /** `@fougere/adapter-rest` — REST under `/api/{frond}/{plural}`. */
+    rest?: boolean;
+    /** `@fougere/adapter-graphql` — a GraphQL schema over the same operations. */
+    graphql?: boolean;
+    /** A surface of your own; the framework only records that you declared it. */
+    [adapter: string]: boolean | undefined;
+}
+//# sourceMappingURL=AdapterConfig.d.ts.map

package/dist/AdapterConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdapterConfig.d.ts","sourceRoot":"","sources":["../src/AdapterConfig.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACxC"}

package/dist/AdapterConfig.js

@@ -0,0 +1,3 @@
+export {};
+// ── Loading ──────────────────────────────────────
+//# sourceMappingURL=AdapterConfig.js.map

package/dist/AdapterConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdapterConfig.js","sourceRoot":"","sources":["../src/AdapterConfig.ts"],"names":[],"mappings":";AAUA,oDAAoD"}

package/dist/AnswerFor.d.ts

@@ -0,0 +1,5 @@
+import type { FougerePorts } from './FougerePorts.js';
+import type { NameOf } from './NameOf.js';
+/** What may answer a port — its own realizations, or any class name where nothing was generated. */
+export type AnswerFor<Port extends string> = FougerePorts extends Record<Port, infer Answers extends string> ? Answers : NameOf<'handler'>;
+//# sourceMappingURL=AnswerFor.d.ts.map

package/dist/AnswerFor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnswerFor.d.ts","sourceRoot":"","sources":["../src/AnswerFor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,oGAAoG;AACpG,MAAM,MAAM,SAAS,CAAC,IAAI,SAAS,MAAM,IAAI,YAAY,SAAS,MAAM,CAAC,IAAI,EAAE,MAAM,OAAO,SAAS,MAAM,CAAC,GACxG,OAAO,GACP,MAAM,CAAC,SAAS,CAAC,CAAC"}

package/dist/AnswerFor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AnswerFor.js.map

package/dist/AnswerFor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnswerFor.js","sourceRoot":"","sources":["../src/AnswerFor.ts"],"names":[],"mappings":""}

package/dist/Binding.d.ts

@@ -0,0 +1,4 @@
+import type { BindingPlan } from './wire/binding.js';
+/** One argument's source, as the plan states it. */
+export type Binding = BindingPlan[number];
+//# sourceMappingURL=Binding.d.ts.map

package/dist/Binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Binding.d.ts","sourceRoot":"","sources":["../src/Binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,oDAAoD;AACpD,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC"}

package/dist/Binding.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Binding.js.map

package/dist/Binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Binding.js","sourceRoot":"","sources":["../src/Binding.ts"],"names":[],"mappings":""}

package/dist/{identity.d.ts → CallIdentity.d.ts}

@@ -1,19 +1,6 @@
-import type { SignedCall } from './wire/call.js';
-export type { SignedCall } from './wire/call.js';
-/** What a deployment hands a frond that CALLS: its own key, and the root's word for it. */
-export interface FrondIdentity {
-    /** The frond's private key, PEM (PKCS#8). */
-    privateKey: string;
-    /** The root's statement binding this frond's name to its public key. */
-    grant: string;
-}
-/** What `verifyEnvelope` establishes — never what the caller asked for. */
-export interface VerifiedCall {
-    /** The frond that signed, as the root named it. */
-    caller: string;
-    /** The state it asserted, now proven to come from `caller`. */
-    state: Record<string, unknown>;
-}
+import type { SignedCall } from './wire/SignedCall.js';
+import type { FrondIdentity } from './FrondIdentity.js';
+import type { VerifiedCall } from './VerifiedCall.js';
 /** Sign one call, whole. */
 export declare function signEnvelope(identity: FrondIdentity, call: SignedCall): Promise<string>;
 /** Establish the caller, or throw. */
@@ -29,4 +16,4 @@ export interface CallIdentity {
 }
 /** What the deployment injected, read once at boot. */
 export declare function identityFromEnv(env?: Record<string, string | undefined>): Promise<CallIdentity>;
-//# sourceMappingURL=identity.d.ts.map
+//# sourceMappingURL=CallIdentity.d.ts.map

package/dist/CallIdentity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CallIdentity.d.ts","sourceRoot":"","sources":["../src/CallIdentity.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA2DtD,4BAA4B;AAC5B,wBAAsB,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAE7F;AAaD,sCAAsC;AACtC,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAEvH;AA+BD,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,8EAA8E;IAC9E,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5E,oEAAoE;IACpE,eAAe,EAAE,OAAO,CAAC;CAC1B;AAOD,uDAAuD;AACvD,wBAAsB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAgBrH"}

package/dist/{identity.js → CallIdentity.js}

@@ -1,8 +1,3 @@
-/**
- * Who is calling — the proof, not the claim.
- *
- * Documented: [identity](https://fougere.dev/docs/infra/identity).
- */
 import { crypto } from '#crypto';
 import { b64url, unb64url, bytesOf, textOf, unb64 } from './crypto/encoding.js';
 /** How long a call envelope stays valid. A signed call is not a session. */
@@ -26,6 +21,8 @@ async function boundTo(call) {
         params: call.params ?? {},
         query: call.query ?? {},
         input: await digestOf(call.input),
+        // Omitted when absent, so a call with no hour pins what it always pinned.
+        ...(call.runAt === undefined ? {} : { runAt: call.runAt }),
     };
 }
 /** A JWS compact serialization, signed with Ed25519. */
@@ -121,4 +118,4 @@ function envOfProcess() {
     const proc = globalThis.process;
     return proc?.env ?? {};
 }
-//# sourceMappingURL=identity.js.map
+//# sourceMappingURL=CallIdentity.js.map

package/dist/CallIdentity.js.map

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

package/dist/Constraint.d.ts

@@ -0,0 +1,3 @@
+/** A promise the judge at the facade cannot keep, because it is about rows it never sees. */
+export type Constraint = 'unique' | 'relation';
+//# sourceMappingURL=Constraint.d.ts.map

package/dist/Constraint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Constraint.d.ts","sourceRoot":"","sources":["../src/Constraint.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC"}

package/dist/Constraint.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Constraint.js.map

package/dist/Constraint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Constraint.js","sourceRoot":"","sources":["../src/Constraint.ts"],"names":[],"mappings":""}

package/dist/{conventions.d.ts → Conventions.d.ts}

@@ -1,4 +1,4 @@
-/** The names the scan READS instead of deriving them. */
+import type { ConventionsInput } from './ConventionsInput.js';
 export interface Conventions {
     /** The scope a frond's package name carries — `@fronds/blog`. */
     scope: string;
@@ -27,16 +27,22 @@ export interface Conventions {
         rules: string;
         /** What its shapes used to be — written by `fougere freeze`, replayed by `migrate`. */
         versions: string;
+        /**
+         * The words this frond adds to the declaration — a generator, a format, a boundary codec.
+         * Read BEFORE `entities`, alone among the directories: an entity may write
+         * `generate: 'ulid'`, and a name a registry does not hold yet is a name it refuses.
+         */
+        vocabulary: string;
+        /**
+         * What rises and falls with the process, written beside the code it instruments.
+         * Recognized by its FORM — a module stating `up` or `down` — and it travels with its
+         * frond: moved behind `remotes:`, it mounts on the process that serves it there.
+         */
+        extensions: string;
     };
 }
 /** What a project means when it declares nothing — the convention itself. */
 export declare const DEFAULT_CONVENTIONS: Conventions;
-/** What a `fougere.config.ts` may state: only the names that differ. */
-export type ConventionsInput = {
-    scope?: string;
-    fronds?: string;
-    dirs?: Partial<Conventions['dirs']>;
-};
 /** The convention, with a project's exceptions folded in. */
 export declare function resolveConventions(input?: ConventionsInput): Conventions;
 /** The package name a frond answers to. */
@@ -45,4 +51,4 @@ export declare function frondPackage(name: string, conventions: Conventions): st
 export declare function providerDirsOf(conventions: Conventions): string[];
 /** The frond vocabulary — every directory the scan reads. */
 export declare function frondDirsOf(conventions: Conventions): string[];
-//# sourceMappingURL=conventions.d.ts.map
+//# sourceMappingURL=Conventions.d.ts.map

package/dist/Conventions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Conventions.d.ts","sourceRoot":"","sources":["../src/Conventions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd;;;;WAIG;QACH,WAAW,EAAE,MAAM,CAAC;QACpB;;;;WAIG;QACH,KAAK,EAAE,MAAM,CAAC;QACd,uFAAuF;QACvF,QAAQ,EAAE,MAAM,CAAC;QACjB;;;;WAIG;QACH,UAAU,EAAE,MAAM,CAAC;QACnB;;;;WAIG;QACH,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,EAAE,WAiBjC,CAAC;AAEF,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,WAAW,CAMxE;AAED,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,MAAM,CAE3E;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,EAAE,CAEjE;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,EAAE,CAU9D"}

package/dist/{conventions.js → Conventions.js}

@@ -1,4 +1,3 @@
-/** The names the scan READS instead of deriving them. */
 /** What a project means when it declares nothing — the convention itself. */
 export const DEFAULT_CONVENTIONS = {
     scope: '@fronds',
@@ -14,6 +13,8 @@ export const DEFAULT_CONVENTIONS = {
         middlewares: 'middlewares',
         rules: 'rules',
         versions: 'versions',
+        vocabulary: 'vocabulary',
+        extensions: 'extensions',
     },
 };
 /** The convention, with a project's exceptions folded in. */
@@ -35,9 +36,12 @@ export function providerDirsOf(conventions) {
 /** The frond vocabulary — every directory the scan reads. */
 export function frondDirsOf(conventions) {
     const { entities, handlers, presenters, collectors, seeds, middlewares, rules, versions } = conventions.dirs;
+    const { vocabulary, extensions } = conventions.dirs;
+    // `vocabulary` first, and the order is the point: an entity may name what it registers.
     return [...new Set([
-            entities, handlers, presenters, collectors, seeds, middlewares, rules, versions,
+            vocabulary,
+            entities, handlers, presenters, collectors, seeds, middlewares, rules, versions, extensions,
             ...providerDirsOf(conventions),
         ])];
 }
-//# sourceMappingURL=conventions.js.map
+//# sourceMappingURL=Conventions.js.map

package/dist/Conventions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Conventions.js","sourceRoot":"","sources":["../src/Conventions.ts"],"names":[],"mappings":"AA6CA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,mBAAmB,GAAgB;IAC9C,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE;QACJ,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,UAAU;QACpB,YAAY,EAAE,cAAc;QAC5B,UAAU,EAAE,YAAY;QACxB,UAAU,EAAE,YAAY;QACxB,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,aAAa;QAC1B,KAAK,EAAE,OAAO;QACd,QAAQ,EAAE,UAAU;QACpB,UAAU,EAAE,YAAY;QACxB,UAAU,EAAE,YAAY;KACzB;CACF,CAAC;AAEF,6DAA6D;AAC7D,MAAM,UAAU,kBAAkB,CAAC,KAAwB;IACzD,OAAO;QACL,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,mBAAmB,CAAC,KAAK;QAChD,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,mBAAmB,CAAC,MAAM;QACnD,IAAI,EAAE,EAAE,GAAG,mBAAmB,CAAC,IAAI,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE;KACtD,CAAC;AACJ,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,WAAwB;IACjE,OAAO,GAAG,WAAW,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;AACxC,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,cAAc,CAAC,WAAwB;IACrD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,WAAW,CAAC,WAAwB;IAClD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC;IAC7G,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC;IAEpD,wFAAwF;IACxF,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC;YACjB,UAAU;YACV,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU;YAC3F,GAAG,cAAc,CAAC,WAAW,CAAC;SAC/B,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/ConventionsInput.d.ts

@@ -0,0 +1,8 @@
+import type { Conventions } from './Conventions.js';
+/** What a `fougere.config.ts` may state: only the names that differ. */
+export type ConventionsInput = {
+    scope?: string;
+    fronds?: string;
+    dirs?: Partial<Conventions['dirs']>;
+};
+//# sourceMappingURL=ConventionsInput.d.ts.map

package/dist/ConventionsInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConventionsInput.d.ts","sourceRoot":"","sources":["../src/ConventionsInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;CACrC,CAAC"}

package/dist/ConventionsInput.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ConventionsInput.js.map

package/dist/ConventionsInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConventionsInput.js","sourceRoot":"","sources":["../src/ConventionsInput.ts"],"names":[],"mappings":""}

package/dist/Ctor.d.ts

@@ -0,0 +1,3 @@
+/** Any class, whatever it takes — what a declaration names when it names one. */
+export type Ctor = new (...args: never[]) => unknown;
+//# sourceMappingURL=Ctor.d.ts.map

package/dist/Ctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ctor.d.ts","sourceRoot":"","sources":["../src/Ctor.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC"}

package/dist/Ctor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Ctor.js.map

package/dist/Ctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ctor.js","sourceRoot":"","sources":["../src/Ctor.ts"],"names":[],"mappings":""}

package/dist/Declared.d.ts

@@ -0,0 +1,8 @@
+import type { Ctor } from './Ctor.js';
+import type { DeclaredSubject } from './DeclaredSubject.js';
+/** A class on its own, or a class with what it asks for. */
+export type Declared = Ctor | (DeclaredSubject & {
+    /** The container key, when the class's own name cannot be trusted to survive a build. */
+    name?: string;
+});
+//# sourceMappingURL=Declared.d.ts.map

package/dist/Declared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Declared.d.ts","sourceRoot":"","sources":["../src/Declared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,4DAA4D;AAC5D,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,eAAe,GAAG;IAC/C,yFAAyF;IACzF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC,CAAC"}

package/dist/Declared.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Declared.js.map

package/dist/Declared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Declared.js","sourceRoot":"","sources":["../src/Declared.ts"],"names":[],"mappings":""}

package/dist/DeclaredHandler.d.ts

@@ -0,0 +1,18 @@
+import type { OperationContract } from './wire/OperationContract.js';
+import type { DeclaredSubject } from './DeclaredSubject.js';
+/** A handler, and the surface it answers on when it is not the default one. */
+export interface DeclaredHandler extends DeclaredSubject {
+    /**
+     * The scan reads this from the directory (`handlers/public/`), so a statement has to say it: two
+     * handlers over one entity collide on their address otherwise, and the refusal names the same
+     * route twice.
+     */
+    surface?: string;
+    /**
+     * What each method takes and answers — read from SOURCE by the scan, and unreachable
+     * from a class at runtime. A prefab declares its own (`Crud.__ops`) and needs nothing
+     * here; a method someone wrote does, or the route it should serve does not exist.
+     */
+    operations?: ReadonlyMap<string, OperationContract> | Record<string, OperationContract>;
+}
+//# sourceMappingURL=DeclaredHandler.d.ts.map

package/dist/DeclaredHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeclaredHandler.d.ts","sourceRoot":"","sources":["../src/DeclaredHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,+EAA+E;AAC/E,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACzF"}

package/dist/DeclaredHandler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DeclaredHandler.js.map

package/dist/DeclaredHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeclaredHandler.js","sourceRoot":"","sources":["../src/DeclaredHandler.ts"],"names":[],"mappings":""}

package/dist/DeclaredSubject.d.ts

@@ -0,0 +1,7 @@
+import type { Ctor } from './Ctor.js';
+/** What a subject needs beyond its class, when its constructor names a frame or a port. */
+export interface DeclaredSubject {
+    ctor: Ctor;
+    deps?: string[];
+}
+//# sourceMappingURL=DeclaredSubject.d.ts.map

package/dist/DeclaredSubject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeclaredSubject.d.ts","sourceRoot":"","sources":["../src/DeclaredSubject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,2FAA2F;AAC3F,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/DeclaredSubject.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DeclaredSubject.js.map

package/dist/DeclaredSubject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeclaredSubject.js","sourceRoot":"","sources":["../src/DeclaredSubject.ts"],"names":[],"mappings":""}

package/dist/{graph.d.ts → DomainCluster.d.ts}

@@ -1,14 +1,5 @@
-/**
- * Entity dependency graph — analyzes ref() links between entities
- * to suggest domain boundaries for splitting fronds.
- */
-import type { FrondDescriptor } from './descriptor/frond.js';
-export interface EntityNode {
-    name: string;
-    frond: string;
-    refs: string[];
-    referencedBy: string[];
-}
+import type { FrondDescriptor } from './descriptor/FrondDescriptor.js';
+import type { EntityNode } from './EntityNode.js';
 export interface DomainCluster {
     name: string;
     entities: string[];
@@ -30,4 +21,4 @@ export declare function clusterEntities(nodes: Map<string, EntityNode>): DomainC
  * heuristic: find the entity with the fewest cross-links and use it as a cut point.
  */
 export declare function suggestSplit(nodes: Map<string, EntityNode>, minClusterSize?: number): DomainCluster[];
-//# sourceMappingURL=graph.d.ts.map
+//# sourceMappingURL=DomainCluster.d.ts.map

package/dist/DomainCluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainCluster.d.ts","sourceRoot":"","sources":["../src/DomainCluster.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAClE;AAED,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CA6B7E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,aAAa,EAAE,CAwC/E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAC9B,cAAc,SAAI,GACjB,aAAa,EAAE,CAmDjB"}

package/dist/{graph.js → DomainCluster.js}

@@ -140,4 +140,4 @@ function annotateCrossRefs(clusters, nodes) {
     }
     return clusters;
 }
-//# sourceMappingURL=graph.js.map
+//# sourceMappingURL=DomainCluster.js.map

package/dist/DomainCluster.js.map

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

package/dist/EffectiveCollector.d.ts

@@ -0,0 +1,8 @@
+export interface EffectiveCollector {
+    parameter: string;
+    typeName: string;
+    className: string;
+    frond: string;
+    filePath: string;
+}
+//# sourceMappingURL=EffectiveCollector.d.ts.map

package/dist/EffectiveCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffectiveCollector.d.ts","sourceRoot":"","sources":["../src/EffectiveCollector.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/EffectiveCollector.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EffectiveCollector.js.map

package/dist/EffectiveCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffectiveCollector.js","sourceRoot":"","sources":["../src/EffectiveCollector.ts"],"names":[],"mappings":""}

package/dist/EffectiveOperation.d.ts

@@ -0,0 +1,65 @@
+import { EFFECTIVE_OPERATION_SEMANTICS } from './EffectiveOperationSemantics.js';
+import { type BindingPlan } from './wire/binding.js';
+import { type OperationContract } from './wire/OperationContract.js';
+import { type OperationKind } from './wire/OperationKind.js';
+import type { EffectiveParameter } from './EffectiveParameter.js';
+import type { EffectiveCollector } from './EffectiveCollector.js';
+export interface EffectiveOperation extends OperationContract {
+    /** Stable qualified identity: `blog/public/Post.publish`. */
+    id: string;
+    /** Human-facing identity independent of placement: `Post.publish`. */
+    operation: string;
+    name: string;
+    kind: OperationKind;
+    kindSource: 'explicit' | 'convention';
+    handler: {
+        className: string;
+        address: string;
+        filePath: string;
+    };
+    /** The class and method that execute after an optional operation override. */
+    implementation: {
+        className: string;
+        address: string;
+        method: string;
+        filePath: string;
+    };
+    /** Every valid operation has a plan, including the empty plan. */
+    binding: BindingPlan;
+    parameters: EffectiveParameter[];
+    collectors: EffectiveCollector[];
+    contexts: string[];
+    placement: {
+        frond: string;
+        runtime: 'local' | 'remote';
+        remote?: string;
+    };
+    /**
+     * What running this op reaches, and how much of that crosses a process.
+     *
+     * `placement` says where the op ANSWERS; this says where it GOES. The pair is what every
+     * number a process hard-codes is really a function of — how often a trace is sampled, where
+     * a latency histogram's bounds should sit, what a load threshold may assume. An op that
+     * answers here and hops twice is not the same subject as one that answers here and hops none.
+     *
+     * Read from the handler, never from the op: a dependency is declared on the constructor, so
+     * the crossing belongs to the CLASS. Every op of one handler reaches the same fronds, and
+     * saying otherwise would dress a structural fact as a precise effect.
+     */
+    reach: {
+        fronds: {
+            frond: string;
+            runtime: 'local' | 'remote';
+        }[];
+        /** How many of them are a process away — zero when everything it reaches runs here. */
+        hops: number;
+    };
+    exposure: {
+        surfaces: string[];
+        adapters: string[];
+    };
+    /** Whether output is an explicitly closed per-operation view. */
+    outputClosed: boolean;
+    semantics: typeof EFFECTIVE_OPERATION_SEMANTICS;
+}
+//# sourceMappingURL=EffectiveOperation.d.ts.map

package/dist/EffectiveOperation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffectiveOperation.d.ts","sourceRoot":"","sources":["../src/EffectiveOperation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,UAAU,GAAG,YAAY,CAAC;IACtC,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,8EAA8E;IAC9E,cAAc,EAAE;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,kEAAkE;IAClE,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC;QAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF;;;;;;;;;;;OAWG;IACH,KAAK,EAAE;QACL,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAA;SAAE,EAAE,CAAC;QACzD,uFAAuF;QACvF,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,iEAAiE;IACjE,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,6BAA6B,CAAC;CACjD"}

package/dist/EffectiveOperation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EffectiveOperation.js.map

package/dist/EffectiveOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffectiveOperation.js","sourceRoot":"","sources":["../src/EffectiveOperation.ts"],"names":[],"mappings":""}

package/dist/EffectiveOperationModel.d.ts

@@ -0,0 +1,24 @@
+import type { FrondDescriptor } from './descriptor/FrondDescriptor.js';
+import type { HandlerEntry } from './descriptor/HandlerEntry.js';
+import type { Diagnostic } from './diagnostic.js';
+import { type OperationsMap } from './wire/OperationsMap.js';
+import type { EffectiveOperation } from './EffectiveOperation.js';
+import type { EffectiveOperationsMap } from './EffectiveOperationsMap.js';
+import type { EffectiveOperationOptions } from './EffectiveOperationOptions.js';
+/**
+ * One resolved program. The handler map preserves object identity from the scan, so the
+ * boot never has to find a handler again by an order-dependent name lookup.
+ */
+export declare class EffectiveOperationModel {
+    private readonly byHandler;
+    readonly operations: EffectiveOperation[];
+    readonly diagnostics: Diagnostic[];
+    readonly resolutionDiagnostics: Diagnostic[];
+    constructor(operations: EffectiveOperation[], diagnostics: Diagnostic[], resolutionDiagnostics: Diagnostic[], byHandler: Map<HandlerEntry, EffectiveOperationsMap>);
+    forHandler(handler: HandlerEntry): EffectiveOperationsMap;
+}
+/** Resolve the complete operation model without starting the application. */
+export declare function resolveEffectiveOperations(fronds: readonly FrondDescriptor[], options?: EffectiveOperationOptions): EffectiveOperationModel;
+/** The contract of every operation a handler serves — the three producers, merged once. */
+export declare function resolveContracts(handler: Pick<HandlerEntry, 'ctor' | 'operations'>, overrides: FrondDescriptor['operationsOverrides'], collectorTypeNames: Set<string>): OperationsMap;
+//# sourceMappingURL=EffectiveOperationModel.d.ts.map

package/dist/EffectiveOperationModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffectiveOperationModel.d.ts","sourceRoot":"","sources":["../src/EffectiveOperationModel.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIlD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAyBhF;;;GAGG;AACH,qBAAa,uBAAuB;IAShC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAR5B,QAAQ,CAAC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IACnC,QAAQ,CAAC,qBAAqB,EAAE,UAAU,EAAE,CAAC;gBAG3C,UAAU,EAAE,kBAAkB,EAAE,EAChC,WAAW,EAAE,UAAU,EAAE,EACzB,qBAAqB,EAAE,UAAU,EAAE,EAClB,SAAS,EAAE,GAAG,CAAC,YAAY,EAAE,sBAAsB,CAAC;IAOvE,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,sBAAsB;CAG1D;AAED,6EAA6E;AAC7E,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,OAAO,GAAE,yBAA8B,GACtC,uBAAuB,CAmMzB;AAuQD,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CAAC,EAClD,SAAS,EAAE,eAAe,CAAC,qBAAqB,CAAC,EACjD,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC9B,aAAa,CA0Bf"}

package/dist/{effective-operation.js → EffectiveOperationModel.js}

@@ -1,12 +1,12 @@
-/** The operation model after every declaration and convention has been resolved. */
 import { lowerFirst } from '@fougere/schema';
 import { statementDrift } from './boot/statement-drift.js';
 import { reachedBy, servedBy } from './boot/declared.js';
 import { computeBindingPlan } from './wire/binding.js';
 import { targetOf } from './prefab/prefab.js';
+import { EFFECTIVE_OPERATION_SEMANTICS } from './EffectiveOperationSemantics.js';
 import { servedSurfaces } from './descriptor/surface.js';
 import { verify } from './verify.js';
-import { inferOperationKind, knownVerbs, } from './wire/operation.js';
+import { inferOperationKind, knownVerbs } from './wire/OperationContract.js';
 /**
  * Where an op's work goes: the fronds its handler reaches, and how many are a process away.
  *
@@ -20,13 +20,6 @@ function reachOf(deps, from, index, remotes) {
         .map((frond) => ({ frond, runtime: (remotes[frond] ? 'remote' : 'local') }));
     return { fronds, hops: fronds.filter((one) => one.runtime === 'remote').length };
 }
-/** The absence rules every door normalises to before the handler is invoked. */
-export const EFFECTIVE_OPERATION_SEMANTICS = Object.freeze({
-    optional: 'undefined',
-    undefined: 'absence',
-    null: 'explicit-value',
-    jsonObjectUndefined: 'omitted',
-});
 /**
  * One resolved program. The handler map preserves object identity from the scan, so the
  * boot never has to find a handler again by an order-dependent name lookup.
@@ -211,19 +204,12 @@ export function resolveEffectiveOperations(fronds, options = {}) {
     }
     // Topology and DI are part of the same effective program. A dependency targeting an
     // actually remote frond is a refusal, not the warning appropriate to a future split.
-    for (const violation of verify({ fronds })) {
-        const remoteBoundary = options.remotes?.[violation.frond] !== undefined
-            || options.remotes?.[violation.dependsOn.frond] !== undefined;
-        resolutionDiagnostics.push({
-            severity: remoteBoundary && violation.rule === 'cross-frond-dependency'
-                ? 'blocking'
-                : violation.severity,
-            code: violation.rule,
-            filePath: violation.filePath,
-            frond: violation.frond,
-            subject: violation.subject,
-            message: violation.message,
-        });
+    for (const misplaced of verify({ fronds })) {
+        const remoteBoundary = options.remotes?.[misplaced.frond] !== undefined
+            || options.remotes?.[misplaced.dependsOn.frond] !== undefined;
+        resolutionDiagnostics.push(remoteBoundary && misplaced.code === 'cross-frond-dependency'
+            ? { ...misplaced, severity: 'blocking' }
+            : misplaced);
     }
     const resolution = uniqueDiagnostics(resolutionDiagnostics);
     return new EffectiveOperationModel(operations, uniqueDiagnostics([...scanDiagnostics, ...resolution]), resolution, byHandler);
@@ -483,4 +469,4 @@ export function resolveContracts(handler, overrides, collectorTypeNames) {
     }
     return contracts;
 }
-//# sourceMappingURL=effective-operation.js.map
+//# sourceMappingURL=EffectiveOperationModel.js.map