@ghostry/fabricator 0.0.3 → 0.0.5

package/dist/types/Random/index.d.ts

@@ -63,7 +63,7 @@ export declare function toStream(algorithm: Algorithm, seed: string): Stream;
  * `toStream(algorithm, encode(trace)).seed === stream.seed`. Not a
  * {@link RandomSource} member: derivation depends on no per-source state (a
  * fork shares only the algorithm), so it is a free function of `(algorithm,
- * trace)`. `toRoot` is the only stateful member.
+ * trace)`. `toConstructionTrace` is the only stateful member.
  *
  * {@link deriveClock} cannot route through this: a {@link Trace} carries
  * `clock`, and `deriveClock` is what produces it. That circularity is why
@@ -76,7 +76,7 @@ export declare function toStreamFromTrace(algorithm: Algorithm, trace: Trace): S
  * single `initialize()` instance owns for its lifetime. `options.clock` is
  * baked in here, once, as a plain number — the `"derived"` policy is already
  * resolved by the caller (`Instance/Core.ts`'s `resolveClock`) before a source
- * is ever built, so every root this source resolves carries the identical
- * instant, and `fork` threads it forward unchanged.
+ * is ever built, so every construction trace this source resolves carries the
+ * identical instant, and `fork` threads it forward unchanged.
  */
 export declare function toRandomSource(options: Options): RandomSource;

package/dist/types/harnessing.d.ts

@@ -11,20 +11,32 @@
  * package's contract this integration uses, satisfied structurally, so neither
  * depends on the other.
  *
+ * **Mirrors the integration contract of `@ghostry/harness` 0.0.4.** Structural
+ * satisfaction is what keeps the two packages independent, and it is also what
+ * leaves nothing to check the pairing at install time: neither manifest names
+ * the other, so a mismatched pair is caught by `tsc` at the point a consumer
+ * passes `integration(instance)` to `initialize`, with an error about shapes
+ * rather than about versions. This line is the only record of which version the
+ * copy tracks, so move it whenever that contract does — the types below are
+ * where the drift actually lives.
+ *
  * @module
  */
 /**
  * Decorate an existing `Instance` as a `@ghostry/harness` integration — `{
- * name, provides, around }`. Takes an instance rather than minting one: the
+ * name, provides, frame }`. Takes an instance rather than minting one: the
  * caller owns `initialize(...)` (and in particular the suite-wide `clock`), and
  * this only wraps each test body in that instance's per-identity `wrap`.
  */
 export { integration } from "./Harnessing/Core";
 /**
  * `Identity` is what identifies one registered test or suite; `Integration` is
- * the `{ name, provides, around }` shape `integration(instance)` returns —
- * `provides` is a `Provides<$Context>`, one `Provider` per context key;
- * `FabricatorTestContext` is the `{ fabricator }` slice of the test context
- * this integration contributes.
+ * the `{ name, provides, frame }` shape `integration(instance)` returns —
+ * `provides` is a `Provides<$Context, $Established>`, one `Provider` per
+ * context key, each handed what the frame's wrapper established; `Frame` is the
+ * generator `frame` returns and `Wrapper` the optional value it yields; both
+ * hooks take a single object — `FrameArgs` for `frame`, and `ProviderArgs`, the
+ * same thing plus `established`, for a provider; `FabricatorTestContext` is the
+ * `{ fabricator }` slice of the test context this integration contributes.
  */
-export type { FabricatorTestContext, Identity, Integration, Provider, Provides, } from "./Harnessing/Types";
+export type { FabricatorTestContext, Frame, FrameArgs, Identity, Integration, Provider, ProviderArgs, Provides, Wrapper, } from "./Harnessing/Types";

package/dist/types/index.d.ts

@@ -50,7 +50,10 @@ export declare function initialize<const $Registry extends PlainObject = typeof
     clock?: Date | "derived";
     /**
      * The ambient carrier backing `wrap` for this lineage — override only to
-     * force a specific one.
+     * force a specific one. A choice of carrier and nothing more: lineage
+     * identity is the instance's own `ancestry[0]`, so handing the same carrier
+     * to two `initialize()` calls does not join them — neither one's reads ever
+     * resolve the other's frames.
      *
      * Left unset (the norm), the `#stack` package import picks it: every
      * runtime with `node:async_hooks` — Node, Bun, Deno — gets the
@@ -149,5 +152,11 @@ export type { Trace } from "./Random/Types";
  * parameter is a `Partial` of; `Overlay` is what `fork`/`wrap` accept;
  * `Context` is `instance.context`'s own type, so a caller writing a helper that
  * reads it can name the parameter.
+ *
+ * `Ancestry` comes with `Stack`, whose `visible` takes one, so anyone
+ * implementing a carrier can name the parameter. `Token` is deliberately _not_
+ * exported: a chain is opaque, its elements are comparable only by identity,
+ * and the ordinary "same lineage?" question is `a.root === b.root` rather than
+ * anything a caller needs to name.
  */
-export type { Config, Context, Overlay, Stack } from "./Instance/Types";
+export type { Ancestry, Config, Context, Overlay, Stack, } from "./Instance/Types";

package/dist/types/internal.d.ts

@@ -63,7 +63,7 @@ export type { Axis, Enumerable, Pin, Resolvable } from "./Enumeration/Types";
  * directly, beneath the level `initialize()` itself exposes.
  */
 export { defaultAlgorithm, encode, randomSalt, toRandomSource, toStream, toStreamFromTrace, } from "./Random";
-export type { Algorithm, ConstructionTrace, ConstructorOptions, RootPins, Salt, Trace, } from "./Random/Types";
+export type { Algorithm, ConstructionPins, ConstructionTrace, ConstructorOptions, Salt, Trace, } from "./Random/Types";
 /**
  * The synchronous ambient carrier. `#stack` (`package.json`) selects it only
  * where there is no `node:async_hooks` — in practice a browser bundle — so on

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghostry/fabricator",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "license": "MIT",
   "description": "Fabricate typed data from composable schemas.",
   "keywords": [
@@ -64,6 +64,9 @@
     "access": "public",
     "provenance": true
   },
+  "devDependencies": {
+    "@ghostry/harness": "^0.0.4"
+  },
   "scripts": {
     "build:reset": "rm -rf ./dist",
     "build:compile": "bunx --no-install --bun rslib build --config ./rslib.config.ts",