@dryvcode/author 0.0.1

package/dist/interaction/part.d.ts

@@ -0,0 +1,58 @@
+import type { ExplanationKindState, ExplanationState } from "../contracts/index.js";
+import type { CollectPartState, DeclarationRef, InvokePartState, PartState, PresentPartState } from "../contracts/index.js";
+import type { OperationPortRef, OperationRef, TupleIndex, ValueRefTuple } from "../foundation/ref.js";
+interface ViewOwner {
+    ref(): DeclarationRef<"view">;
+    hasContext(name: string): boolean;
+}
+export declare class OutputFrom<T = unknown> {
+    #private;
+    constructor(port: OperationPortRef<T, "output">, select?: readonly string[]);
+    toState(): PresentPartState["source"];
+}
+export declare function outputFrom<T>(port: OperationPortRef<T, "output">, select?: readonly string[]): OutputFrom<T>;
+export declare class InputFrom<T = unknown> {
+    #private;
+    constructor(port: OperationPortRef<T, "input">, collect?: readonly string[], context?: Readonly<Record<string, string>>);
+    toState(view: ViewOwner): CollectPartState["target"];
+}
+export declare function inputFrom<T>(port: OperationPortRef<T, "input">, collect?: readonly string[], context?: Readonly<Record<string, string>>): InputFrom<T>;
+export declare abstract class PartDeclaration {
+    private _description?;
+    private _tags;
+    private _explanations;
+    private _view?;
+    description(value: string): this;
+    tags(...values: readonly string[]): this;
+    explain(kind: ExplanationKindState, text: string): this;
+    attach(view: ViewOwner): void;
+    protected view(): ViewOwner;
+    protected descriptionState(): {
+        readonly description?: string;
+        readonly tags?: readonly string[];
+        readonly explanations?: readonly ExplanationState[];
+    };
+    abstract toState(): PartState;
+}
+export declare class PresentPartDeclaration extends PartDeclaration {
+    #private;
+    constructor(source: OutputFrom);
+    toState(): PresentPartState;
+}
+export declare class CollectPartDeclaration extends PartDeclaration {
+    #private;
+    constructor(target: InputFrom);
+    toState(): CollectPartState;
+}
+export declare class InvokePartDeclaration<TInputs extends ValueRefTuple = ValueRefTuple> extends PartDeclaration {
+    #private;
+    constructor(operation: OperationRef<TInputs>, context?: Readonly<Partial<Record<TupleIndex<TInputs>, string>>>);
+    toState(): InvokePartState;
+}
+export declare const part: Readonly<{
+    present: (source: OutputFrom) => PresentPartDeclaration;
+    collect: (target: InputFrom) => CollectPartDeclaration;
+    invoke: <TInputs extends ValueRefTuple>(operation: OperationRef<TInputs>, context?: Readonly<Partial<Record<TupleIndex<TInputs>, string>>>) => InvokePartDeclaration<TInputs>;
+}>;
+export {};
+//# sourceMappingURL=part.d.ts.map

package/dist/interaction/part.d.ts.map

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

package/dist/interaction/part.js

@@ -0,0 +1,178 @@
+import { explanation, normalizeTags, optionalSemanticMetadata, } from "../foundation/metadata.js";
+import { optionalDescription, requireText } from "../foundation/metadata.js";
+function semanticPath(value, field) {
+    const result = requireText(value, field);
+    const segments = result.split(".");
+    if (segments.some((segment) => !segment)) {
+        throw new TypeError(`${field} must not contain empty path segments`);
+    }
+    return result;
+}
+function semanticPaths(values, field) {
+    if (values === undefined)
+        return undefined;
+    if (values.length === 0) {
+        throw new TypeError(`${field} must be omitted when empty`);
+    }
+    const normalized = values.map((value) => semanticPath(value, field));
+    if (new Set(normalized).size !== normalized.length) {
+        throw new TypeError(`${field} paths must be unique`);
+    }
+    return normalized;
+}
+export class OutputFrom {
+    #port;
+    #select;
+    constructor(port, select) {
+        this.#port = port;
+        this.#select = semanticPaths(select, "output selector");
+    }
+    toState() {
+        return {
+            port: this.#port.toState(),
+            ...(this.#select === undefined ? {} : { select: [...this.#select] }),
+        };
+    }
+}
+export function outputFrom(port, select) {
+    return new OutputFrom(port, select);
+}
+export class InputFrom {
+    #port;
+    #collect;
+    #context;
+    constructor(port, collect, context = {}) {
+        this.#port = port;
+        this.#collect = semanticPaths(collect, "input collection selector");
+        this.#context = Object.fromEntries(Object.entries(context).map(([path, name]) => [
+            semanticPath(path, "context target path"),
+            requireText(name, "view context name"),
+        ]));
+        if (Object.keys(this.#context).length > 0 && this.#collect === undefined) {
+            throw new TypeError("inputFrom context bindings require explicit collected paths");
+        }
+    }
+    toState(view) {
+        const context = Object.entries(this.#context)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([path, name]) => {
+            if (!view.hasContext(name)) {
+                throw new TypeError(`unknown view context: ${name}`);
+            }
+            return { path, context: name };
+        });
+        return {
+            port: this.#port.toState(),
+            ...(this.#collect === undefined ? {} : { collect: [...this.#collect] }),
+            ...(context.length === 0 ? {} : { context }),
+        };
+    }
+}
+export function inputFrom(port, collect, context = {}) {
+    return new InputFrom(port, collect, context);
+}
+export class PartDeclaration {
+    _description;
+    _tags = [];
+    _explanations = [];
+    _view;
+    description(value) {
+        this._description = requireText(value, "part description");
+        return this;
+    }
+    tags(...values) {
+        this._tags = [...normalizeTags(values, "tags")];
+        return this;
+    }
+    explain(kind, text) {
+        this._explanations.push(explanation(kind, text, "explanation"));
+        return this;
+    }
+    attach(view) {
+        if (this._view !== undefined) {
+            throw new TypeError("part is already attached to a view");
+        }
+        this._view = view;
+    }
+    view() {
+        if (this._view === undefined) {
+            throw new TypeError("part must be attached to a view before snapshot");
+        }
+        return this._view;
+    }
+    descriptionState() {
+        return {
+            ...optionalDescription(this._description),
+            ...optionalSemanticMetadata(this._tags, this._explanations),
+        };
+    }
+}
+export class PresentPartDeclaration extends PartDeclaration {
+    #source;
+    constructor(source) {
+        super();
+        this.#source = source;
+    }
+    toState() {
+        this.view();
+        return {
+            kind: "present",
+            source: this.#source.toState(),
+            ...this.descriptionState(),
+        };
+    }
+}
+export class CollectPartDeclaration extends PartDeclaration {
+    #target;
+    constructor(target) {
+        super();
+        this.#target = target;
+    }
+    toState() {
+        return {
+            kind: "collect",
+            target: this.#target.toState(this.view()),
+            ...this.descriptionState(),
+        };
+    }
+}
+export class InvokePartDeclaration extends PartDeclaration {
+    #operation;
+    #context;
+    constructor(operation, context = {}) {
+        super();
+        this.#operation = operation;
+        this.#context = context;
+    }
+    toState() {
+        const view = this.view();
+        const context = Object.entries(this.#context)
+            .map(([indexText, name]) => {
+            const index = Number(indexText);
+            if (!Number.isInteger(index) || index < 0) {
+                throw new TypeError(`invalid operation input index: ${indexText}`);
+            }
+            const contextName = requireText(name, "view context name");
+            if (!view.hasContext(contextName)) {
+                throw new TypeError(`unknown view context: ${contextName}`);
+            }
+            return {
+                target: this.#operation.input(index).toState(),
+                context: contextName,
+            };
+        })
+            .sort((a, b) => a.target.index - b.target.index);
+        return {
+            kind: "invoke",
+            operation: this.#operation.ref(),
+            ...(context.length === 0 ? {} : { context }),
+            ...this.descriptionState(),
+        };
+    }
+}
+export const part = Object.freeze({
+    present: (source) => new PresentPartDeclaration(source),
+    collect: (target) => new CollectPartDeclaration(target),
+    invoke: (operation, context = {}) => new InvokePartDeclaration(operation, context),
+});
+//# sourceMappingURL=part.js.map

package/dist/interaction/part.js.map

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

package/dist/interaction/view.d.ts

@@ -0,0 +1,34 @@
+import type { ExplanationKindState, ViewRoleState } from "../contracts/index.js";
+import type { DeclarationRef, ViewState } from "../contracts/index.js";
+import { Declaration } from "../foundation/declaration.js";
+import type { SurfaceRef, ValueRef } from "../foundation/ref.js";
+import type { PartDeclaration } from "./part.js";
+export type ViewContextMap = Readonly<Record<string, ValueRef>>;
+export type PartMap = Readonly<Record<string, PartDeclaration>>;
+export type ViewPresentationMap = Readonly<Record<string, SurfaceRef>>;
+export declare class ViewDeclaration<TContext extends ViewContextMap = {}, TParts extends PartMap = {}, TPresentations extends ViewPresentationMap = {}> extends Declaration<"view"> {
+    readonly __parts?: TParts;
+    private _description?;
+    private _tags;
+    private _explanations;
+    private _role?;
+    private _context;
+    private _parts;
+    private _presentations;
+    constructor();
+    description(value: string): this;
+    tags(...values: readonly string[]): this;
+    explain(kind: ExplanationKindState, text: string): this;
+    role(value: ViewRoleState): this;
+    context<K extends string, V extends ValueRef>(name: K, value: V): ViewDeclaration<TContext & Readonly<Record<K, V>>, TParts, TPresentations>;
+    contexts<const T extends ViewContextMap>(values: T): ViewDeclaration<TContext & T, TParts, TPresentations>;
+    hasContext(name: string): boolean;
+    part<K extends string, V extends PartDeclaration>(name: K, value: V): ViewDeclaration<TContext, TParts & Readonly<Record<K, V>>, TPresentations>;
+    parts<const T extends PartMap>(values: T): ViewDeclaration<TContext, TParts & T, TPresentations>;
+    presentation<K extends string, V extends SurfaceRef>(name: K, surface: V): ViewDeclaration<TContext, TParts, TPresentations & Readonly<Record<K, V>>>;
+    presentations<const T extends ViewPresentationMap>(values: T): ViewDeclaration<TContext, TParts, TPresentations & T>;
+    ref(): DeclarationRef<"view">;
+    toState(): ViewState;
+}
+export declare function view(): ViewDeclaration;
+//# sourceMappingURL=view.d.ts.map

package/dist/interaction/view.d.ts.map

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

package/dist/interaction/view.js

@@ -0,0 +1,109 @@
+import { explanation, normalizeTags, optionalSemanticMetadata, } from "../foundation/metadata.js";
+import { Declaration } from "../foundation/declaration.js";
+import { optionalDescription, optionalOwner, optionalOrigin, requireText, } from "../foundation/metadata.js";
+export class ViewDeclaration extends Declaration {
+    _description;
+    _tags = [];
+    _explanations = [];
+    _role;
+    _context = {};
+    _parts = {};
+    _presentations = {};
+    constructor() {
+        super("view");
+    }
+    description(value) {
+        this._description = requireText(value, "view description");
+        return this;
+    }
+    tags(...values) {
+        this._tags = [...normalizeTags(values, "tags")];
+        return this;
+    }
+    explain(kind, text) {
+        this._explanations.push(explanation(kind, text, "explanation"));
+        return this;
+    }
+    role(value) {
+        this._role = value;
+        return this;
+    }
+    context(name, value) {
+        const key = requireText(name, "view context name");
+        if (this._context[key] !== undefined) {
+            throw new TypeError(`duplicate view context name: ${key}`);
+        }
+        this._context = { ...this._context, [key]: value };
+        return this;
+    }
+    contexts(values) {
+        for (const [name, value] of Object.entries(values)) {
+            this.context(name, value);
+        }
+        return this;
+    }
+    hasContext(name) {
+        return this._context[name] !== undefined;
+    }
+    part(name, value) {
+        const key = requireText(name, "part name");
+        if (this._parts[key] !== undefined) {
+            throw new TypeError(`duplicate view part name: ${key}`);
+        }
+        value.attach(this);
+        this._parts = { ...this._parts, [key]: value };
+        return this;
+    }
+    parts(values) {
+        for (const [name, value] of Object.entries(values)) {
+            this.part(name, value);
+        }
+        return this;
+    }
+    presentation(name, surface) {
+        const key = requireText(name, "view presentation name");
+        if (this._presentations[key] !== undefined) {
+            throw new TypeError(`duplicate view presentation name: ${key}`);
+        }
+        this._presentations = { ...this._presentations, [key]: surface };
+        return this;
+    }
+    presentations(values) {
+        for (const [name, surface] of Object.entries(values)) {
+            this.presentation(name, surface);
+        }
+        return this;
+    }
+    ref() {
+        return { kind: "view", identity: this.identity };
+    }
+    toState() {
+        const context = Object.fromEntries(Object.entries(this._context)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([name, value]) => [name, value.ref()]));
+        const parts = {};
+        for (const key of Object.keys(this._parts).sort()) {
+            parts[key] = this._parts[key].toState();
+        }
+        const presentations = {};
+        for (const key of Object.keys(this._presentations).sort()) {
+            presentations[key] = { surface: this._presentations[key].ref() };
+        }
+        return {
+            identity: this.identity,
+            kind: "view",
+            ...optionalSemanticMetadata(this._tags, this._explanations),
+            ...(this._role === undefined ? {} : { role: this._role }),
+            context,
+            parts,
+            presentations,
+            ...optionalDescription(this._description),
+            ...optionalOwner(this._group, this._feature),
+            ...optionalOrigin(this._origin),
+        };
+    }
+}
+export function view() {
+    return new ViewDeclaration();
+}
+//# sourceMappingURL=view.js.map

package/dist/interaction/view.js.map

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

package/dist/interfaces/facet.d.ts

@@ -0,0 +1,6 @@
+import type { FacetState } from "../contracts/index.js";
+/** Operation-owned transport mapping. This is not a registered declaration. */
+export interface FacetDeclaration {
+    toState(): FacetState;
+}
+//# sourceMappingURL=facet.d.ts.map

package/dist/interfaces/facet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facet.d.ts","sourceRoot":"","sources":["../../src/interfaces/facet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,IAAI,UAAU,CAAC;CACvB"}

package/dist/interfaces/facet.js

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

package/dist/interfaces/facet.js.map

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

package/dist/interfaces/http.d.ts

@@ -0,0 +1,39 @@
+import type { HttpFacetState, HttpInputState, HttpOutputState } from "../contracts/index.js";
+import type { FailureRef, OperationPortRef } from "../foundation/ref.js";
+import type { FacetDeclaration } from "./facet.js";
+import { type Representation } from "./representation.js";
+export declare class HttpInput {
+    #private;
+    constructor(state: HttpInputState);
+    toState(): HttpInputState;
+}
+export declare const path: (name: string) => HttpInput;
+export declare const query: (name: string) => HttpInput;
+export declare const queryObject: () => HttpInput;
+export declare const header: (name: string) => HttpInput;
+export declare const cookie: (name: string) => HttpInput;
+export declare const body: (value?: Representation) => HttpInput;
+export declare const multipart: (name: string) => HttpInput;
+export declare const form: (name: string) => HttpInput;
+export declare class HttpOutput {
+    #private;
+    constructor(status?: number, representations?: readonly Representation[]);
+    toState(): HttpOutputState;
+}
+export declare function respond(status?: number, ...representations: readonly Representation[]): HttpOutput;
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS" | "TRACE";
+export declare class HttpFacetDeclaration implements FacetDeclaration {
+    #private;
+    private _description?;
+    private _inputs;
+    private _outputs;
+    private _failures;
+    constructor(method: HttpMethod, pathValue: string);
+    description(value: string): this;
+    input(port: OperationPortRef<unknown, "input">, source: HttpInput): this;
+    output(port: OperationPortRef<unknown, "output">, response?: HttpOutput): this;
+    failure(value: FailureRef, status: number, representationValue?: Representation): this;
+    toState(): HttpFacetState;
+}
+export declare function http(method: HttpMethod, pathValue: string): HttpFacetDeclaration;
+//# sourceMappingURL=http.d.ts.map

package/dist/interfaces/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/interfaces/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAEd,cAAc,EACd,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAExE,qBAAa,SAAS;;IAGpB,YAAY,KAAK,EAAE,cAAc,EAEhC;IAED,OAAO,IAAI,cAAc,CAExB;CACF;AAED,eAAO,MAAM,IAAI,SAAU,MAAM,KAAG,SACyC,CAAC;AAC9E,eAAO,MAAM,KAAK,SAAU,MAAM,KAAG,SAC0C,CAAC;AAChF,eAAO,MAAM,WAAW,QAAO,SACU,CAAC;AAC1C,eAAO,MAAM,MAAM,SAAU,MAAM,KAAG,SAIlC,CAAC;AACL,eAAO,MAAM,MAAM,SAAU,MAAM,KAAG,SAIlC,CAAC;AACL,eAAO,MAAM,IAAI,WAAW,cAAc,KAAY,SACY,CAAC;AACnE,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,SAIrC,CAAC;AACL,eAAO,MAAM,IAAI,SAAU,MAAM,KAAG,SACyC,CAAC;AAE9E,qBAAa,UAAU;;IAGrB,YACE,MAAM,SAAM,EACZ,eAAe,GAAE,SAAS,cAAc,EAAa,EAStD;IAED,OAAO,IAAI,eAAe,CAKzB;CACF;AAED,wBAAgB,OAAO,CACrB,MAAM,SAAM,EACZ,GAAG,eAAe,EAAE,SAAS,cAAc,EAAE,GAC5C,UAAU,CAKZ;AAED,MAAM,MAAM,UAAU,GAClB,KAAK,GACL,MAAM,GACN,KAAK,GACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,SAAS,GACT,OAAO,CAAC;AAEZ,qBAAa,oBAAqB,YAAW,gBAAgB;;IAG3D,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,OAAO,CAGN;IACT,OAAO,CAAC,QAAQ,CAGP;IACT,OAAO,CAAC,SAAS,CAA0B;IAE3C,YAAY,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAGhD;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG/B;IAED,KAAK,CAAC,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAGvE;IAED,MAAM,CACJ,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,EACzC,QAAQ,GAAE,UAAsB,GAC/B,IAAI,CAGN;IAED,OAAO,CACL,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,mBAAmB,CAAC,EAAE,cAAc,GACnC,IAAI,CAYN;IAED,OAAO,IAAI,cAAc,CAkBxB;CACF;AAED,wBAAgB,IAAI,CAClB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,GAChB,oBAAoB,CAEtB"}

package/dist/interfaces/http.js

@@ -0,0 +1,109 @@
+import { requireText } from "../foundation/metadata.js";
+import { json } from "./representation.js";
+export class HttpInput {
+    #state;
+    constructor(state) {
+        this.#state = state;
+    }
+    toState() {
+        return this.#state;
+    }
+}
+export const path = (name) => new HttpInput({ kind: "path", name: requireText(name, "path input name") });
+export const query = (name) => new HttpInput({ kind: "query", name: requireText(name, "query input name") });
+export const queryObject = () => new HttpInput({ kind: "query-object" });
+export const header = (name) => new HttpInput({
+    kind: "header",
+    name: requireText(name, "header input name"),
+});
+export const cookie = (name) => new HttpInput({
+    kind: "cookie",
+    name: requireText(name, "cookie input name"),
+});
+export const body = (value = json()) => new HttpInput({ kind: "body", representation: value.toState() });
+export const multipart = (name) => new HttpInput({
+    kind: "multipart",
+    name: requireText(name, "multipart input name"),
+});
+export const form = (name) => new HttpInput({ kind: "form", name: requireText(name, "form input name") });
+export class HttpOutput {
+    #state;
+    constructor(status = 200, representations = [json()]) {
+        if (!Number.isInteger(status) || status < 100 || status > 599) {
+            throw new TypeError("HTTP status must be between 100 and 599");
+        }
+        this.#state = {
+            status,
+            representations: representations.map((item) => item.toState()),
+        };
+    }
+    toState() {
+        return {
+            ...this.#state,
+            representations: [...this.#state.representations],
+        };
+    }
+}
+export function respond(status = 200, ...representations) {
+    return new HttpOutput(status, representations.length === 0 ? [json()] : representations);
+}
+export class HttpFacetDeclaration {
+    #method;
+    #path;
+    _description;
+    _inputs = [];
+    _outputs = [];
+    _failures = [];
+    constructor(method, pathValue) {
+        this.#method = method;
+        this.#path = requireText(pathValue, "HTTP path");
+    }
+    description(value) {
+        this._description = requireText(value, "HTTP facet description");
+        return this;
+    }
+    input(port, source) {
+        this._inputs.push({ port, source });
+        return this;
+    }
+    output(port, response = respond()) {
+        this._outputs.push({ port, response });
+        return this;
+    }
+    failure(value, status, representationValue) {
+        if (!Number.isInteger(status) || status < 100 || status > 599) {
+            throw new TypeError("HTTP failure status must be between 100 and 599");
+        }
+        this._failures.push({
+            failure: value.ref(),
+            status,
+            ...(representationValue === undefined
+                ? {}
+                : { representation: representationValue.toState() }),
+        });
+        return this;
+    }
+    toState() {
+        return {
+            kind: "http",
+            ...(this._description === undefined
+                ? {}
+                : { description: this._description }),
+            method: this.#method,
+            path: this.#path,
+            inputs: this._inputs.map(({ port, source }) => ({
+                port: port.toState(),
+                source: source.toState(),
+            })),
+            outputs: this._outputs.map(({ port, response }) => ({
+                port: port.toState(),
+                response: response.toState(),
+            })),
+            failures: this._failures.map((item) => ({ ...item })),
+        };
+    }
+}
+export function http(method, pathValue) {
+    return new HttpFacetDeclaration(method, pathValue);
+}
+//# sourceMappingURL=http.js.map

package/dist/interfaces/http.js.map

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

package/dist/interfaces/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./facet.js";
+export * from "./representation.js";
+export * from "./http.js";
+export * from "./websocket.js";
+export * from "./schedule.js";
+export * from "./surface.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}

package/dist/interfaces/index.js

@@ -0,0 +1,7 @@
+export * from "./facet.js";
+export * from "./representation.js";
+export * from "./http.js";
+export * from "./websocket.js";
+export * from "./schedule.js";
+export * from "./surface.js";
+//# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}

package/dist/interfaces/representation.d.ts

@@ -0,0 +1,14 @@
+import type { RepresentationKind, RepresentationState } from "../contracts/index.js";
+export declare class Representation {
+    #private;
+    constructor(kind: RepresentationKind, mediaType?: string);
+    toState(): RepresentationState;
+}
+export declare function representation(kind: RepresentationKind, mediaType?: string): Representation;
+export declare const json: (mediaType?: string) => Representation;
+export declare const xml: (mediaType?: string) => Representation;
+export declare const csv: (mediaType?: string) => Representation;
+export declare const text: (mediaType?: string) => Representation;
+export declare const bytes: (mediaType?: string) => Representation;
+export declare const eventStream: (mediaType?: string) => Representation;
+//# sourceMappingURL=representation.d.ts.map

package/dist/interfaces/representation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"representation.d.ts","sourceRoot":"","sources":["../../src/interfaces/representation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAG3B,qBAAa,cAAc;;IAGzB,YAAY,IAAI,EAAE,kBAAkB,EAAE,SAAS,CAAC,EAAE,MAAM,EAOvD;IAED,OAAO,IAAI,mBAAmB,CAE7B;CACF;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,kBAAkB,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,cAAc,CAEhB;AAED,eAAO,MAAM,IAAI,eAAgB,MAAM,KAAG,cACP,CAAC;AACpC,eAAO,MAAM,GAAG,eAAgB,MAAM,KAAG,cACP,CAAC;AACnC,eAAO,MAAM,GAAG,eAAgB,MAAM,KAAG,cACP,CAAC;AACnC,eAAO,MAAM,IAAI,eAAgB,MAAM,KAAG,cACP,CAAC;AACpC,eAAO,MAAM,KAAK,eAAgB,MAAM,KAAG,cACP,CAAC;AACrC,eAAO,MAAM,WAAW,eAAgB,MAAM,KAAG,cACN,CAAC"}