@bluelibs/runner 3.4.2 → 4.0.1

package/dist/cli/extract-docs.js

@@ -1,88 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const path = require("path");
-const fs = require("fs");
-// Note: avoid file URLs to keep CommonJS require working well
-const introspect_1 = require("../docs/introspect");
-function parseArgs(argv) {
-    const args = { entry: "", outDir: "./documentation" };
-    const offset = argv[2] === "extract-docs" ? 3 : 2;
-    const rest = argv.slice(offset);
-    if (!rest[0]) {
-        console.error("Usage: runner extract-docs <entry> [--export <name>] [--out-dir <dir>] [--include-globals] [--config <path>] [--format json|md|all]");
-        process.exit(1);
-    }
-    args.entry = rest[0];
-    for (let i = 1; i < rest.length; i++) {
-        const flag = rest[i];
-        if (flag === "--export") {
-            args.exportName = rest[++i];
-        }
-        else if (flag === "--out-dir") {
-            args.outDir = rest[++i];
-        }
-        else if (flag === "--include-globals") {
-            args.includeGlobals = true;
-        }
-        else if (flag === "--config") {
-            args.configPath = rest[++i];
-        }
-        else if (flag === "--format") {
-            const val = rest[++i];
-            if (val === "json" || val === "md" || val === "all") {
-                args.format = val;
-            }
-        }
-    }
-    return args;
-}
-async function loadModule(entryPath) {
-    const resolved = path.isAbsolute(entryPath)
-        ? entryPath
-        : path.resolve(process.cwd(), entryPath);
-    // Prefer dynamic import; in CommonJS this becomes require(resolved)
-    return await Promise.resolve(`${resolved}`).then(s => require(s));
-}
-async function main() {
-    const args = parseArgs(process.argv);
-    const mod = await loadModule(args.entry);
-    const exportName = args.exportName || "default";
-    let resource;
-    if (exportName === "default") {
-        resource = (mod && mod.default) || mod;
-    }
-    else {
-        resource = mod[exportName];
-    }
-    if (!resource || typeof resource !== "object") {
-        console.error(`Could not find exported resource '${exportName}' from ${args.entry}`);
-        process.exit(2);
-    }
-    const config = args.configPath
-        ? JSON.parse(fs.readFileSync(args.configPath, "utf-8"))
-        : {};
-    const graph = await (0, introspect_1.introspectResource)(resource, config, {
-        includeGlobals: args.includeGlobals,
-    });
-    const outDir = path.isAbsolute(args.outDir)
-        ? args.outDir
-        : path.resolve(process.cwd(), args.outDir);
-    fs.mkdirSync(outDir, { recursive: true });
-    const format = args.format || "json";
-    if (format === "json" || format === "all") {
-        const outFile = path.join(outDir, "graph.json");
-        fs.writeFileSync(outFile, JSON.stringify(graph, null, 2), "utf-8");
-        console.log(`Docs graph written to ${outFile}`);
-    }
-    if (format === "md" || format === "all") {
-        const { renderMarkdown } = await Promise.resolve().then(() => require("../docs/markdown"));
-        renderMarkdown(graph, outDir);
-        console.log(`Markdown docs written under ${outDir}`);
-    }
-}
-main().catch((err) => {
-    console.error(err);
-    process.exit(99);
-});
-//# sourceMappingURL=extract-docs.js.map

package/dist/cli/extract-docs.js.map

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

package/dist/common.types.d.ts

@@ -1,20 +0,0 @@
-export interface IMeta {
-    title?: string;
-    description?: string;
-    tags?: string[];
-}
-export interface ITaskMeta extends IMeta {
-}
-export interface IResourceMeta extends IMeta {
-}
-export interface IEventMeta extends IMeta {
-}
-export interface IMiddlewareMeta extends IMeta {
-}
-export type Optional<T> = {
-    [K in keyof T]?: T[K];
-};
-export type IsVoid<T> = [T] extends [void] ? true : false;
-export type IsOptional<T> = undefined extends T ? true : false;
-export type OptionalOrVoidOrAnything<T> = IsVoid<T> extends true ? void : IsOptional<T> extends true ? Optional<T> : T;
-export type OnlyOptionalFields<T> = {} extends T ? true : false;

package/dist/common.types.js

@@ -1,4 +0,0 @@
-"use strict";
-// Common/shared types and utility types
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=common.types.js.map

package/dist/common.types.js.map

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

package/dist/defs/core.d.ts

@@ -1,144 +0,0 @@
-import { IEventMeta, IMiddlewareMeta, IResourceMeta, ITaskMeta } from "./tags";
-import { symbolEvent, symbolMiddleware, symbolMiddlewareConfigured, symbolMiddlewareEverywhereResources, symbolMiddlewareEverywhereTasks } from "./symbols";
-export interface ITask<TInput = any, TOutput extends Promise<any> = any, TDependencies extends DependencyMapType = {}, TOn extends "*" | IEventDefinition<any> | undefined = undefined> extends ITaskDefinition<TInput, TOutput, TDependencies, TOn> {
-    id: string | symbol;
-    dependencies: TDependencies | (() => TDependencies);
-    computedDependencies?: DependencyValuesType<TDependencies>;
-    middleware: MiddlewareAttachments[];
-    events: {
-        beforeRun: IEvent<BeforeRunEventPayload<TInput>>;
-        afterRun: IEvent<AfterRunEventPayload<TInput, TOutput>>;
-        onError: IEvent<OnErrorEventPayload>;
-    };
-}
-export type DependencyMapType = Record<string, ITask<any, any, any, any> | IResource<any, any, any> | IEventDefinition<any>>;
-type ExtractTaskInput<T> = T extends ITask<infer I, any, any, any> ? I : never;
-type ExtractTaskOutput<T> = T extends ITask<any, infer O, any, any> ? O : never;
-type ExtractResourceValue<T> = T extends IResource<any, infer V, any> ? V : never;
-type ExtractEventParams<T> = T extends IEvent<infer P> ? P : never;
-type TaskDependency<I, O> = (...args: I extends null | void ? [] : [I]) => O;
-type ResourceDependency<V> = V;
-type EventDependency<P> = P extends void ? (() => Promise<void>) & ((input?: Record<string, never>) => Promise<void>) : (input: P) => Promise<void>;
-export type DependencyValueType<T> = T extends ITask<any, any, any, any> ? TaskDependency<ExtractTaskInput<T>, ExtractTaskOutput<T>> : T extends IResource<any, any, any> ? ResourceDependency<ExtractResourceValue<T>> : T extends IEventDefinition<any> ? EventDependency<ExtractEventParams<T>> : never;
-export type DependencyValuesType<T extends DependencyMapType> = {
-    [K in keyof T]: DependencyValueType<T[K]>;
-};
-export type RegisterableItems<T = any> = IResourceWithConfig<any> | IResource<void, any, any, any> | IResource<{
-    [K in any]?: any;
-}, any, any, any> | ITask<any, any, any, any> | IMiddleware<any> | IEvent<any>;
-export type MiddlewareAttachments = IMiddleware<void> | IMiddleware<{
-    [K in any]?: any;
-}> | IMiddlewareConfigured<any>;
-export interface ITaskDefinition<TInput = any, TOutput extends Promise<any> = any, TDependencies extends DependencyMapType = {}, TOn extends "*" | IEventDefinition<any> | undefined = undefined> {
-    id?: string | symbol;
-    dependencies?: TDependencies | (() => TDependencies);
-    middleware?: MiddlewareAttachments[];
-    on?: TOn;
-    listenerOrder?: number;
-    meta?: ITaskMeta;
-    run: (input: TOn extends undefined ? TInput : IEventEmission<TOn extends "*" ? any : ExtractEventParams<TOn>>, dependencies: DependencyValuesType<TDependencies>) => TOutput;
-}
-export type BeforeRunEventPayload<TInput> = {
-    input: TInput;
-};
-export type AfterRunEventPayload<TInput, TOutput> = {
-    input: TInput;
-    output: TOutput extends Promise<infer U> ? U : TOutput;
-    setOutput(newOutput: TOutput extends Promise<infer U> ? U : TOutput): void;
-};
-export type OnErrorEventPayload = {
-    error: any;
-    suppress(): void;
-};
-export type BeforeInitEventPayload<TConfig> = {
-    config: TConfig;
-};
-export type AfterInitEventPayload<TConfig, TValue> = {
-    config: TConfig;
-    value: TValue;
-};
-export interface IResourceDefinition<TConfig = any, TValue = unknown, TDependencies extends DependencyMapType = {}, TContext = any> {
-    id?: string | symbol;
-    dependencies?: TDependencies | ((config: TConfig) => TDependencies);
-    register?: Array<RegisterableItems> | ((config: TConfig) => Array<RegisterableItems>);
-    init?: (this: any, config: TConfig, dependencies: DependencyValuesType<TDependencies>, context: TContext) => Promise<TValue>;
-    dispose?: (this: any, value: TValue, config: TConfig, dependencies: DependencyValuesType<TDependencies>, context: TContext) => Promise<void>;
-    meta?: IResourceMeta;
-    overrides?: Array<IResource | ITask | IMiddleware | IResourceWithConfig>;
-    middleware?: MiddlewareAttachments[];
-    context?: () => TContext;
-    [symbolFilePath]?: string;
-    [symbolIndexResource]?: boolean;
-}
-import { symbolFilePath, symbolIndexResource } from "./symbols";
-export interface IResource<TConfig = void, TValue = any, TDependencies extends DependencyMapType = any, TContext = any> extends IResourceDefinition<TConfig, TValue, TDependencies, TContext> {
-    id: string | symbol;
-    with(config: TConfig): IResourceWithConfig<TConfig, TValue, TDependencies>;
-    register: Array<RegisterableItems> | ((config: TConfig) => Array<RegisterableItems>);
-    events: {
-        beforeInit: IEvent<BeforeInitEventPayload<TConfig>>;
-        afterInit: IEvent<AfterInitEventPayload<TConfig, TValue>>;
-        onError: IEvent<OnErrorEventPayload>;
-    };
-    overrides: Array<IResource | ITask | IMiddleware | IResourceWithConfig>;
-    middleware: MiddlewareAttachments[];
-}
-export interface IResourceWithConfig<TConfig = any, TValue = any, TDependencies extends DependencyMapType = any> {
-    id: string;
-    resource: IResource<TConfig, TValue, TDependencies>;
-    config: TConfig;
-}
-export type EventHandlerType<T = any> = (event: IEventEmission<T>) => any | Promise<any>;
-export interface IEventDefinition<TPayload = void> {
-    id?: string | symbol;
-    meta?: IEventMeta;
-}
-export interface IEvent<TPayload = any> extends IEventDefinition<TPayload> {
-    id: string | symbol;
-    [symbolEvent]: true;
-}
-export interface IMiddlewareDefinition<TConfig = any, TDependencies extends DependencyMapType = any> {
-    id?: string | symbol;
-    dependencies?: TDependencies | ((config: TConfig) => TDependencies);
-    run: (input: IMiddlewareExecutionInput, dependencies: DependencyValuesType<TDependencies>, config: TConfig) => Promise<any>;
-    meta?: IMiddlewareMeta;
-}
-export interface IMiddleware<TConfig = any, TDependencies extends DependencyMapType = any> extends IMiddlewareDefinition<TConfig, TDependencies> {
-    [symbolMiddleware]: true;
-    [symbolMiddlewareConfigured]?: boolean;
-    [symbolMiddlewareEverywhereTasks]?: boolean;
-    [symbolMiddlewareEverywhereResources]?: boolean;
-    id: string | symbol;
-    dependencies: TDependencies | (() => TDependencies);
-    everywhere(config?: import("../define").MiddlewareEverywhereOptions): IMiddleware<TConfig, TDependencies>;
-    config: TConfig;
-    with: (config: TConfig) => IMiddlewareConfigured<TConfig, TDependencies>;
-}
-export interface IMiddlewareConfigured<TConfig = any, TDependencies extends DependencyMapType = any> extends IMiddleware<TConfig, TDependencies> {
-    [symbolMiddlewareConfigured]: true;
-}
-export interface IMiddlewareDefinitionConfigured<C extends Record<string, any> = {}> {
-    middleware: IMiddleware<C>;
-    config?: C;
-}
-export interface IMiddlewareExecutionInput<TTaskInput = any, TResourceConfig = any> {
-    task?: {
-        definition: ITask<TTaskInput>;
-        input: TTaskInput;
-    };
-    resource?: {
-        definition: IResource<TResourceConfig>;
-        config: TResourceConfig;
-    };
-    next: (taskInputOrResourceConfig?: TTaskInput | TResourceConfig) => Promise<any>;
-}
-export interface IEventEmission<TPayload = any> {
-    id: string | symbol;
-    data: TPayload;
-    timestamp: Date;
-    source: string | symbol;
-    meta: IEventMeta;
-    stopPropagation(): void;
-    isPropagationStopped(): boolean;
-}
-export {};

package/dist/defs/core.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const symbols_1 = require("./symbols");
-// symbol imports referenced above
-const symbols_2 = require("./symbols");
-//# sourceMappingURL=core.js.map

package/dist/defs/core.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/defs/core.ts"],"names":[],"mappings":";;AACA,uCASmB;AAyInB,kCAAkC;AAClC,uCAAgE"}

package/dist/defs/symbols.d.ts

@@ -1,42 +0,0 @@
-/**
- * Internal brand symbols used to tag created objects at runtime and help with
- * type‑narrowing. Prefer the `isTask`/`isResource`/`isEvent`/`isMiddleware`
- * helpers instead of touching these directly.
- * @internal
- */
-export declare const symbolTask: unique symbol;
-export declare const symbolResource: unique symbol;
-export declare const symbolResourceWithConfig: unique symbol;
-export declare const symbolEvent: unique symbol;
-export declare const symbolMiddleware: unique symbol;
-export declare const symbolMiddlewareConfigured: unique symbol;
-export declare const symbolMiddlewareGlobal: unique symbol;
-export declare const symbolMiddlewareEverywhereTasks: unique symbol;
-export declare const symbolMiddlewareEverywhereResources: unique symbol;
-/** @internal Path to aid anonymous id generation and error messages */
-export declare const symbolFilePath: unique symbol;
-/** @internal Marks disposable instances */
-export declare const symbolDispose: unique symbol;
-/** @internal Link to internal Store */
-export declare const symbolStore: unique symbol;
-/** @internal Brand used by index() resources */
-export declare const symbolIndexResource: unique symbol;
-/**
- * Convenience bag of internal symbols. Intended for framework internals;
- * consumers should not rely on this shape.
- * @internal
- */
-export declare const symbols: {
-    task: symbol;
-    resource: symbol;
-    resourceWithConfig: symbol;
-    indexResource: symbol;
-    event: symbol;
-    middleware: symbol;
-    middlewareEverywhereTasks: symbol;
-    middlewareEverywhereResources: symbol;
-    filePath: symbol;
-    dispose: symbol;
-    store: symbol;
-};
-export type SymbolsBag = typeof symbols;

package/dist/defs/symbols.js

@@ -1,45 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.symbols = exports.symbolIndexResource = exports.symbolStore = exports.symbolDispose = exports.symbolFilePath = exports.symbolMiddlewareEverywhereResources = exports.symbolMiddlewareEverywhereTasks = exports.symbolMiddlewareGlobal = exports.symbolMiddlewareConfigured = exports.symbolMiddleware = exports.symbolEvent = exports.symbolResourceWithConfig = exports.symbolResource = exports.symbolTask = void 0;
-/**
- * Internal brand symbols used to tag created objects at runtime and help with
- * type‑narrowing. Prefer the `isTask`/`isResource`/`isEvent`/`isMiddleware`
- * helpers instead of touching these directly.
- * @internal
- */
-exports.symbolTask = Symbol("runner.task");
-exports.symbolResource = Symbol("runner.resource");
-exports.symbolResourceWithConfig = Symbol("runner.resourceWithConfig");
-exports.symbolEvent = Symbol("runner.event");
-exports.symbolMiddleware = Symbol("runner.middleware");
-exports.symbolMiddlewareConfigured = Symbol("runner.middlewareConfigured");
-exports.symbolMiddlewareGlobal = Symbol("runner.middlewareGlobal");
-exports.symbolMiddlewareEverywhereTasks = Symbol("runner.middlewareGlobalTasks");
-exports.symbolMiddlewareEverywhereResources = Symbol("runner.middlewareGlobalResources");
-/** @internal Path to aid anonymous id generation and error messages */
-exports.symbolFilePath = Symbol("runner.filePath");
-/** @internal Marks disposable instances */
-exports.symbolDispose = Symbol("runner.dispose");
-/** @internal Link to internal Store */
-exports.symbolStore = Symbol("runner.store");
-/** @internal Brand used by index() resources */
-exports.symbolIndexResource = Symbol("runner.indexResource");
-/**
- * Convenience bag of internal symbols. Intended for framework internals;
- * consumers should not rely on this shape.
- * @internal
- */
-exports.symbols = {
-    task: exports.symbolTask,
-    resource: exports.symbolResource,
-    resourceWithConfig: exports.symbolResourceWithConfig,
-    indexResource: exports.symbolIndexResource,
-    event: exports.symbolEvent,
-    middleware: exports.symbolMiddleware,
-    middlewareEverywhereTasks: exports.symbolMiddlewareEverywhereTasks,
-    middlewareEverywhereResources: exports.symbolMiddlewareEverywhereResources,
-    filePath: exports.symbolFilePath,
-    dispose: exports.symbolDispose,
-    store: exports.symbolStore,
-};
-//# sourceMappingURL=symbols.js.map

package/dist/defs/symbols.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../../src/defs/symbols.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACU,QAAA,UAAU,GAAkB,MAAM,CAAC,aAAa,CAAC,CAAC;AAClD,QAAA,cAAc,GAAkB,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAC1D,QAAA,wBAAwB,GAAkB,MAAM,CAC3D,2BAA2B,CAC5B,CAAC;AACW,QAAA,WAAW,GAAkB,MAAM,CAAC,cAAc,CAAC,CAAC;AACpD,QAAA,gBAAgB,GAAkB,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAC9D,QAAA,0BAA0B,GAAkB,MAAM,CAC7D,6BAA6B,CAC9B,CAAC;AACW,QAAA,sBAAsB,GAAkB,MAAM,CACzD,yBAAyB,CAC1B,CAAC;AACW,QAAA,+BAA+B,GAAkB,MAAM,CAClE,8BAA8B,CAC/B,CAAC;AACW,QAAA,mCAAmC,GAAkB,MAAM,CACtE,kCAAkC,CACnC,CAAC;AAEF,uEAAuE;AAC1D,QAAA,cAAc,GAAkB,MAAM,CAAC,iBAAiB,CAAC,CAAC;AACvE,2CAA2C;AAC9B,QAAA,aAAa,GAAkB,MAAM,CAAC,gBAAgB,CAAC,CAAC;AACrE,uCAAuC;AAC1B,QAAA,WAAW,GAAkB,MAAM,CAAC,cAAc,CAAC,CAAC;AAEjE,gDAAgD;AACnC,QAAA,mBAAmB,GAAkB,MAAM,CACtD,sBAAsB,CACvB,CAAC;AAEF;;;;GAIG;AACU,QAAA,OAAO,GAAG;IACrB,IAAI,EAAE,kBAAU;IAChB,QAAQ,EAAE,sBAAc;IACxB,kBAAkB,EAAE,gCAAwB;IAC5C,aAAa,EAAE,2BAAmB;IAClC,KAAK,EAAE,mBAAW;IAClB,UAAU,EAAE,wBAAgB;IAC5B,yBAAyB,EAAE,uCAA+B;IAC1D,6BAA6B,EAAE,2CAAmC;IAClE,QAAQ,EAAE,sBAAc;IACxB,OAAO,EAAE,qBAAa;IACtB,KAAK,EAAE,mBAAW;CACnB,CAAC"}

package/dist/defs/tags.d.ts

@@ -1,70 +0,0 @@
-/**
- * Tag system and metadata types.
- */
-export interface ITagDefinition<TConfig = void> {
-    id: string | symbol;
-}
-/**
- * A configured instance of a tag as produced by `ITag.with()`.
- */
-export interface ITagWithConfig<TConfig = void> {
-    id: string | symbol;
-    /** The tag definition used to produce this configured instance. */
-    tag: ITag<TConfig>;
-    /** The configuration captured for this tag instance. */
-    config: TConfig;
-}
-/**
- * A tag definition (builder). Use `.with(config)` to obtain configured instances,
- * and `.extract(tags)` to find either a configured instance or the bare tag in a list.
- */
-export interface ITag<TConfig = void> extends ITagDefinition<TConfig> {
-    /** Creates a configured instance of the tag. */
-    with(config: TConfig): ITagWithConfig<TConfig>;
-    /**
-     * Extracts either a configured instance or the bare tag from a list of tags
-     * or from a taggable object (`{ meta: { tags?: [] } }`).
-     */
-    extract(target: TagType[] | ITaggable): ExtractedTagResult<TConfig> | null;
-}
-/**
- * Restrict bare tags to those whose config can be omitted (void or optional object),
- * mirroring the same principle used for resources in `RegisterableItems`.
- * Required-config tags must appear as configured instances.
- */
-export type TagType = string | ITag<void> | ITag<{
-    [K in any]?: any;
-}> | ITagWithConfig<any>;
-/**
- * Conditional result type for `ITag.extract`:
- * - For void config → just the identifier
- * - For optional object config → identifier with optional config
- * - For required config → identifier with required config
- */
-export type ExtractedTagResult<TConfig> = {} extends TConfig ? {
-    id: string | symbol;
-    config?: TConfig;
-} : {
-    id: string | symbol;
-    config: TConfig;
-};
-/** Any object that can carry tags via metadata. */
-export interface ITaggable {
-    meta?: {
-        tags?: TagType[];
-    };
-}
-/** Common metadata you can attach to tasks/resources/events/middleware. */
-export interface IMeta {
-    title?: string;
-    description?: string;
-    tags?: TagType[];
-}
-export interface ITaskMeta extends IMeta {
-}
-export interface IResourceMeta extends IMeta {
-}
-export interface IEventMeta extends IMeta {
-}
-export interface IMiddlewareMeta extends IMeta {
-}

package/dist/defs/tags.js

@@ -1,6 +0,0 @@
-"use strict";
-/**
- * Tag system and metadata types.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=tags.js.map

package/dist/defs/tags.js.map

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

package/dist/defs.returnTag.d.ts

@@ -1,36 +0,0 @@
-import { ITag, ITagWithConfig } from "./defs";
-import { IMeta } from "./defs";
-type NonVoid<T> = [T] extends [void] ? never : T;
-type ExtractReturnFromTag<T> = T extends ITagWithConfig<any, infer R> ? NonVoid<R> : T extends ITag<any, infer R> ? NonVoid<R> : never;
-type IsTuple<T extends readonly unknown[]> = number extends T["length"] ? false : true;
-type FilterContracts<TTags extends readonly unknown[], Acc extends readonly unknown[] = []> = TTags extends readonly [infer H, ...infer R] ? ExtractReturnFromTag<H> extends never ? FilterContracts<R, Acc> : FilterContracts<R, [...Acc, ExtractReturnFromTag<H>]> : Acc;
-export type ExtractContractsFromTags<TTags extends readonly unknown[]> = IsTuple<TTags> extends true ? FilterContracts<TTags> : Array<ExtractReturnFromTag<TTags[number]>>;
-export type ExtractTagsWithNonVoidReturnTypeFromMeta<TMeta extends IMeta> = TMeta extends {
-    tags?: infer TTags;
-} ? TTags extends readonly unknown[] ? ExtractContractsFromTags<TTags> : [] : [];
-export type HasContracts<T extends IMeta> = ExtractTagsWithNonVoidReturnTypeFromMeta<T> extends never[] ? false : true;
-type UnionToIntersection<U> = (U extends any ? (arg: U) => void : never) extends (arg: infer I) => void ? I : never;
-type ContractsUnion<TMeta extends IMeta> = ExtractTagsWithNonVoidReturnTypeFromMeta<TMeta> extends readonly (infer U)[] ? U : never;
-type ContractsIntersection<TMeta extends IMeta> = UnionToIntersection<ContractsUnion<TMeta>>;
-/**
- * Pretty-print helper to expand intersections for better IDE display.
- */
-type Simplify<T> = {
-    [K in keyof T]: T[K];
-} & {};
-/**
- * Verbose compile-time error surfaced when a value does not satisfy
- * the intersection of all tag-enforced contracts.
- *
- * Intersected with `never` in call sites when desired to ensure assignment
- * fails while still surfacing a readable shape in tooltips.
- */
-export type ContractViolationError<TMeta extends IMeta, TActual> = {
-    message: "Value does not satisfy all tag contracts";
-    expected: Simplify<ContractsIntersection<TMeta>>;
-    received: TActual;
-};
-export type EnsureResponseSatisfiesContracts<TMeta extends IMeta, TResponse> = [
-    ContractsUnion<TMeta>
-] extends [never] ? TResponse : TResponse extends Promise<infer U> ? Promise<U extends ContractsIntersection<TMeta> ? U : ContractViolationError<TMeta, U>> : TResponse extends ContractsIntersection<TMeta> ? TResponse : ContractViolationError<TMeta, TResponse>;
-export {};

package/dist/defs.returnTag.js

@@ -1,4 +0,0 @@
-"use strict";
-// HasContracts<Meta> → true if contracts present, else false
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=defs.returnTag.js.map

package/dist/defs.returnTag.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"defs.returnTag.js","sourceRoot":"","sources":["../src/defs.returnTag.ts"],"names":[],"mappings":";AAAA,6DAA6D"}

package/dist/docs/introspect.d.ts

@@ -1,7 +0,0 @@
-import type { IResource } from "../defs";
-import { DocsGraph } from "./model";
-type IntrospectOptions = {
-    includeGlobals?: boolean;
-};
-export declare function introspectResource(root: IResource<any, any, any, any>, config?: any, options?: IntrospectOptions): Promise<DocsGraph>;
-export {};