@owlmeans/planning 0.1.18-rc.0

package/build/consts.js

@@ -0,0 +1,129 @@
+/** What a workcard IS. Cards, projects and specifications share one id space and one fold. */
+export var WorkcardKind;
+(function (WorkcardKind) {
+    WorkcardKind["Card"] = "card";
+    WorkcardKind["Project"] = "project";
+    WorkcardKind["Specification"] = "specification";
+})(WorkcardKind || (WorkcardKind = {}));
+/**
+ * The three states every status of every flow maps onto.
+ *
+ * A provider's statuses are its own vocabulary; these three are the only ones generic code — a
+ * summary, a board header, a gate — ever reads.
+ */
+export var IntrinsicStatus;
+(function (IntrinsicStatus) {
+    IntrinsicStatus["Planned"] = "planned";
+    IntrinsicStatus["InProgress"] = "in-progress";
+    IntrinsicStatus["Closed"] = "closed";
+})(IntrinsicStatus || (IntrinsicStatus = {}));
+/** Advancement order — `resolveIntrinsic` under {@link IntrinsicPolicy.All} takes the minimum. */
+export const INTRINSIC_ORDER = Object.freeze({
+    [IntrinsicStatus.Planned]: 0,
+    [IntrinsicStatus.InProgress]: 1,
+    [IntrinsicStatus.Closed]: 2,
+});
+/** How a type running several flows answers its one intrinsic status. */
+export var IntrinsicPolicy;
+(function (IntrinsicPolicy) {
+    /** The primary flow's status decides. */
+    IntrinsicPolicy["Primary"] = "primary";
+    /** The least advanced flow decides — closed only when every flow is closed. */
+    IntrinsicPolicy["All"] = "all";
+})(IntrinsicPolicy || (IntrinsicPolicy = {}));
+export var TransitionAction;
+(function (TransitionAction) {
+    TransitionAction["Create"] = "create";
+    TransitionAction["Update"] = "update";
+    TransitionAction["Transit"] = "transit";
+    TransitionAction["Link"] = "link";
+    TransitionAction["Unlink"] = "unlink";
+    TransitionAction["Delete"] = "delete";
+})(TransitionAction || (TransitionAction = {}));
+export var CommitState;
+(function (CommitState) {
+    CommitState["Pending"] = "pending";
+    CommitState["Committed"] = "committed";
+    CommitState["Failed"] = "failed";
+})(CommitState || (CommitState = {}));
+export var SpecificationFormat;
+(function (SpecificationFormat) {
+    SpecificationFormat["Markdown"] = "markdown";
+    SpecificationFormat["Json"] = "json";
+    SpecificationFormat["Text"] = "text";
+})(SpecificationFormat || (SpecificationFormat = {}));
+export var CodeStyle;
+(function (CodeStyle) {
+    CodeStyle["Random"] = "random";
+    CodeStyle["Sequential"] = "sequential";
+    CodeStyle["Slug"] = "slug";
+})(CodeStyle || (CodeStyle = {}));
+/** Where a minted code must be unique. */
+export var CodeScope;
+(function (CodeScope) {
+    CodeScope["Parent"] = "parent";
+    CodeScope["Entity"] = "entity";
+})(CodeScope || (CodeScope = {}));
+/** Service alias of the planning facade host. Identical on the server and in a client. */
+export const PLANNING_SERVICE = 'planning';
+/** The path segment the protocol tree answers under when the mount names none. */
+export const PLANNING_PATH = '/planning';
+/** The socket frame name the commit feed pushes under. */
+export const PLANNING_COMMIT_EVENT = 'planning-commit';
+/** The i18n resource the package's labels are registered under (`lib:planning.*`). */
+export const PLANNING_I18N = 'planning';
+/** A `from` that matches every status of the flow. */
+export const ANY_STATUS = '*';
+/** How long `committed()` waits by default, in milliseconds. */
+export const DEFAULT_COMMIT_TIMEOUT = 30_000;
+/** Seconds a single long poll of `commit.get` holds by default. */
+export const DEFAULT_COMMIT_POLL = 20;
+/** The longest single long poll a server grants, in seconds. */
+export const MAX_COMMIT_POLL = 55;
+/** Re-rolls a code policy gets before it refuses with `CodeTaken`. */
+export const CODE_MINT_ATTEMPTS = 8;
+/** Random part length of a code policy that names none. */
+export const DEFAULT_CODE_LENGTH = 6;
+export const DEFAULT_PLUGIN_ORDER = 50;
+export const DEFAULT_PAGE_SIZE = 100;
+export const PLANNING_SCHEMA_VERSION = 1;
+export const TITLE_MAX = 2048;
+export const DESCRIPTION_MAX = 16384;
+export const CODE_MAX = 64;
+export const TYPE_MAX = 128;
+export const LABEL_MAX = 64;
+export const MAX_LABELS = 32;
+export const MAX_PARENTS = 32;
+export const BODY_MAX = 1_048_576;
+export const CAUSE_MAX = 256;
+export const KEY_MAX = 256;
+export const REF_MAX = 1024;
+export const QUERY_TEXT_MAX = 256;
+/** The longest list a wire query carries in one value (ids, parents). */
+export const MAX_QUERY_LIST = 500;
+/**
+ * The aliases one planning tree answers under, derived from the mount's base alias.
+ *
+ * Two mounts of the tree in one deployment are two base aliases, never two copies of this table —
+ * which is why nothing here is a global constant.
+ */
+export const planningAliases = (base) => Object.freeze({
+    base,
+    schema: Object.freeze({ list: `${base}:schema:list` }),
+    card: Object.freeze({
+        list: `${base}:card:list`,
+        summary: `${base}:card:summary`,
+        get: `${base}:card:get`,
+        transitions: `${base}:card:transitions`,
+        specifications: `${base}:card:specifications`,
+    }),
+    spec: Object.freeze({
+        get: `${base}:specification:get`,
+        revisions: `${base}:specification:revisions`,
+    }),
+    link: Object.freeze({ list: `${base}:link:list` }),
+    transition: Object.freeze({ get: `${base}:transition:get` }),
+    execute: `${base}:execute`,
+    commit: Object.freeze({ get: `${base}:commit:get`, events: `${base}:commit:events` }),
+});
+//# sourceMappingURL=consts.js.map

package/build/consts.js.map

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

package/build/entrypoints.d.ts

@@ -0,0 +1,14 @@
+import type { PlanningProtocolOptions, PlanningProtocols } from './types.js';
+/**
+ * Declare the planning surface — one immutable tree a server binds and a client calls.
+ *
+ * Every leaf hangs under ONE base carrying the guards (and the gate), so they cannot drift apart;
+ * aliases derive from `opts.base.alias`. Static `/cards/summary` is declared before parametric
+ * `/cards/:id`. The commit feed is a socket under `socketBase` when given (it then inherits that
+ * base's guards), under the planning base otherwise.
+ *
+ * Queries travel as their `*Wire` shapes: encode with `encode*Query` before a call, decode with
+ * `decode*Query` in a handler.
+ */
+export declare const makePlanningProtocols: (opts: PlanningProtocolOptions) => PlanningProtocols;
+//# sourceMappingURL=entrypoints.d.ts.map

package/build/entrypoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entrypoints.d.ts","sourceRoot":"","sources":["../src/entrypoints.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAC+D,uBAAuB,EAChG,iBAAiB,EAIlB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,SAAU,uBAAuB,KAAG,iBAiGrE,CAAA"}

package/build/entrypoints.js

@@ -0,0 +1,69 @@
+import { contract, openProtocol, protocol, typed } from '@owlmeans/entrypoint';
+import { backend, route, RouteMethod, socket } from '@owlmeans/route';
+import { PLANNING_PATH, planningAliases } from './consts.js';
+import { CommitQuerySchema, ExecuteRequestSchema, RelationshipQuerySchema, RevisionsQuerySchema, SpecificationQuerySchema, SummaryQuerySchema, TransitionParamsSchema, TransitionQuerySchema, WorkcardParamsSchema, WorkcardQuerySchema, } from './schemas.js';
+/**
+ * Declare the planning surface — one immutable tree a server binds and a client calls.
+ *
+ * Every leaf hangs under ONE base carrying the guards (and the gate), so they cannot drift apart;
+ * aliases derive from `opts.base.alias`. Static `/cards/summary` is declared before parametric
+ * `/cards/:id`. The commit feed is a socket under `socketBase` when given (it then inherits that
+ * base's guards), under the planning base otherwise.
+ *
+ * Queries travel as their `*Wire` shapes: encode with `encode*Query` before a call, decode with
+ * `decode*Query` in a handler.
+ */
+export const makePlanningProtocols = (opts) => {
+    const aliases = planningAliases(opts.base.alias);
+    const mount = {
+        ...(opts.base.parent != null ? { parent: opts.base.parent } : {}),
+        ...(opts.base.service != null ? { service: opts.base.service } : {}),
+    };
+    const base = openProtocol(route(aliases.base, opts.base.path ?? PLANNING_PATH, backend(mount)), {
+        guards: opts.guards,
+        ...(opts.gate != null ? { gate: opts.gate } : {}),
+    });
+    const get = (alias, path) => route(alias, path, backend({ parent: base }, RouteMethod.GET));
+    return Object.freeze({
+        base,
+        schema: Object.freeze({
+            list: protocol(get(aliases.schema.list, '/schemas'), contract(typed())),
+        }),
+        card: Object.freeze({
+            list: protocol(get(aliases.card.list, '/cards'), contract.request({ query: typed(WorkcardQuerySchema) }, typed())),
+            // Static before parametric: `/cards/summary` must never be read as a card id.
+            summary: protocol(get(aliases.card.summary, '/cards/summary'), contract.request({ query: typed(SummaryQuerySchema) }, typed())),
+            get: protocol(get(aliases.card.get, '/cards/:id'), contract.request({ params: typed(WorkcardParamsSchema) }, typed())),
+            transitions: protocol(get(aliases.card.transitions, '/cards/:id/transitions'), contract.request({
+                params: typed(WorkcardParamsSchema),
+                query: typed(TransitionQuerySchema),
+            }, typed())),
+            specifications: protocol(get(aliases.card.specifications, '/cards/:id/specifications'), contract.request({
+                params: typed(WorkcardParamsSchema),
+                query: typed(SpecificationQuerySchema),
+            }, typed())),
+        }),
+        spec: Object.freeze({
+            get: protocol(get(aliases.spec.get, '/specifications/:id'), contract.request({ params: typed(WorkcardParamsSchema) }, typed())),
+            revisions: protocol(get(aliases.spec.revisions, '/specifications/:id/revisions'), contract.request({
+                params: typed(WorkcardParamsSchema),
+                query: typed(RevisionsQuerySchema),
+            }, typed())),
+        }),
+        link: Object.freeze({
+            list: protocol(get(aliases.link.list, '/links'), contract.request({ query: typed(RelationshipQuerySchema) }, typed())),
+        }),
+        transition: Object.freeze({
+            get: protocol(get(aliases.transition.get, '/transitions/:transition'), contract.request({ params: typed(TransitionParamsSchema) }, typed())),
+        }),
+        execute: protocol(route(aliases.execute, '/execute', backend({ parent: base }, RouteMethod.POST)), contract.request({ body: typed(ExecuteRequestSchema) }, typed())),
+        commit: Object.freeze({
+            get: protocol(get(aliases.commit.get, '/commits/:transition'), contract.request({
+                params: typed(TransitionParamsSchema),
+                query: typed(CommitQuerySchema),
+            }, typed())),
+            events: protocol(route(aliases.commit.events, '/commits', socket({ parent: opts.socketBase ?? base })), contract.request({ query: typed() }, typed())),
+        }),
+    });
+};
+//# sourceMappingURL=entrypoints.js.map

package/build/entrypoints.js.map

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

package/build/errors.d.ts

@@ -0,0 +1,94 @@
+import { ResilientError } from '@owlmeans/error';
+/**
+ * The planning refusal family.
+ *
+ * Every message starts with `planning:` followed by the class's own marker (`workcard-not-found:`,
+ * `illegal-transition:` …) and the detail. The marker is what survives a hop where the class is not
+ * registered, so it is part of the contract, not decoration.
+ */
+export declare class PlanningError extends ResilientError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** The card does not exist — or belongs to another entity, which is deliberately the same answer. */
+export declare class WorkcardNotFound extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+export declare class UnknownWorkcardType extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+export declare class UnknownStatusFlow extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+export declare class ParentNotFound extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** The parent project's type does not list this card (or project) type. */
+export declare class CardTypeNotAllowed extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** A plugin's `before` middleware refused the execution without a class of its own. */
+export declare class PlanningRefused extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** The flow offers no rule of that name from the card's current status. */
+export declare class IllegalTransition extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+export declare class FieldsInvalid extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+export declare class LabelNotAllowed extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+export declare class SpecificationSlotUnknown extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** A second document for a slot that holds one — revise the existing record instead. */
+export declare class SpecificationRevisionConflict extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+export declare class RelationshipRefused extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+export declare class CodeTaken extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** `expectSeq` no longer matches the card's head — somebody else wrote first. Re-read and retry. */
+export declare class WorkcardConflict extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** The transition was appended but did not commit in time. It stays pending — nothing is undone. */
+export declare class CommitTimeout extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+export declare class CommitFailed extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** A card of another entity was addressed. Handlers answer it as {@link WorkcardNotFound}. */
+export declare class PlanningScopeMismatch extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** The store behind this type cannot do what was asked (a foreign provider without a log). */
+export declare class PlanningUnsupported extends PlanningError {
+    static typeName: string;
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/build/errors.d.ts.map

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

package/build/errors.js

@@ -0,0 +1,169 @@
+import { ResilientError } from '@owlmeans/error';
+/**
+ * The planning refusal family.
+ *
+ * Every message starts with `planning:` followed by the class's own marker (`workcard-not-found:`,
+ * `illegal-transition:` …) and the detail. The marker is what survives a hop where the class is not
+ * registered, so it is part of the contract, not decoration.
+ */
+export class PlanningError extends ResilientError {
+    static typeName = 'PlanningError';
+    constructor(message = 'error') {
+        super(PlanningError.typeName, `planning:${message}`);
+    }
+}
+/** The card does not exist — or belongs to another entity, which is deliberately the same answer. */
+export class WorkcardNotFound extends PlanningError {
+    static typeName = `${PlanningError.typeName}WorkcardNotFound`;
+    constructor(message = 'error') {
+        super(`workcard-not-found:${message}`);
+        this.type = WorkcardNotFound.typeName;
+    }
+}
+export class UnknownWorkcardType extends PlanningError {
+    static typeName = `${PlanningError.typeName}UnknownWorkcardType`;
+    constructor(message = 'error') {
+        super(`unknown-type:${message}`);
+        this.type = UnknownWorkcardType.typeName;
+    }
+}
+export class UnknownStatusFlow extends PlanningError {
+    static typeName = `${PlanningError.typeName}UnknownStatusFlow`;
+    constructor(message = 'error') {
+        super(`unknown-flow:${message}`);
+        this.type = UnknownStatusFlow.typeName;
+    }
+}
+export class ParentNotFound extends PlanningError {
+    static typeName = `${PlanningError.typeName}ParentNotFound`;
+    constructor(message = 'error') {
+        super(`parent-not-found:${message}`);
+        this.type = ParentNotFound.typeName;
+    }
+}
+/** The parent project's type does not list this card (or project) type. */
+export class CardTypeNotAllowed extends PlanningError {
+    static typeName = `${PlanningError.typeName}CardTypeNotAllowed`;
+    constructor(message = 'error') {
+        super(`card-type-not-allowed:${message}`);
+        this.type = CardTypeNotAllowed.typeName;
+    }
+}
+/** A plugin's `before` middleware refused the execution without a class of its own. */
+export class PlanningRefused extends PlanningError {
+    static typeName = `${PlanningError.typeName}Refused`;
+    constructor(message = 'error') {
+        super(`refused:${message}`);
+        this.type = PlanningRefused.typeName;
+    }
+}
+/** The flow offers no rule of that name from the card's current status. */
+export class IllegalTransition extends PlanningError {
+    static typeName = `${PlanningError.typeName}IllegalTransition`;
+    constructor(message = 'error') {
+        super(`illegal-transition:${message}`);
+        this.type = IllegalTransition.typeName;
+    }
+}
+export class FieldsInvalid extends PlanningError {
+    static typeName = `${PlanningError.typeName}FieldsInvalid`;
+    constructor(message = 'error') {
+        super(`fields-invalid:${message}`);
+        this.type = FieldsInvalid.typeName;
+    }
+}
+export class LabelNotAllowed extends PlanningError {
+    static typeName = `${PlanningError.typeName}LabelNotAllowed`;
+    constructor(message = 'error') {
+        super(`label-not-allowed:${message}`);
+        this.type = LabelNotAllowed.typeName;
+    }
+}
+export class SpecificationSlotUnknown extends PlanningError {
+    static typeName = `${PlanningError.typeName}SpecificationSlotUnknown`;
+    constructor(message = 'error') {
+        super(`specification-slot-unknown:${message}`);
+        this.type = SpecificationSlotUnknown.typeName;
+    }
+}
+/** A second document for a slot that holds one — revise the existing record instead. */
+export class SpecificationRevisionConflict extends PlanningError {
+    static typeName = `${PlanningError.typeName}SpecificationRevisionConflict`;
+    constructor(message = 'error') {
+        super(`specification-revision-conflict:${message}`);
+        this.type = SpecificationRevisionConflict.typeName;
+    }
+}
+export class RelationshipRefused extends PlanningError {
+    static typeName = `${PlanningError.typeName}RelationshipRefused`;
+    constructor(message = 'error') {
+        super(`relationship-refused:${message}`);
+        this.type = RelationshipRefused.typeName;
+    }
+}
+export class CodeTaken extends PlanningError {
+    static typeName = `${PlanningError.typeName}CodeTaken`;
+    constructor(message = 'error') {
+        super(`code-taken:${message}`);
+        this.type = CodeTaken.typeName;
+    }
+}
+/** `expectSeq` no longer matches the card's head — somebody else wrote first. Re-read and retry. */
+export class WorkcardConflict extends PlanningError {
+    static typeName = `${PlanningError.typeName}WorkcardConflict`;
+    constructor(message = 'error') {
+        super(`workcard-conflict:${message}`);
+        this.type = WorkcardConflict.typeName;
+    }
+}
+/** The transition was appended but did not commit in time. It stays pending — nothing is undone. */
+export class CommitTimeout extends PlanningError {
+    static typeName = `${PlanningError.typeName}CommitTimeout`;
+    constructor(message = 'error') {
+        super(`commit-timeout:${message}`);
+        this.type = CommitTimeout.typeName;
+    }
+}
+export class CommitFailed extends PlanningError {
+    static typeName = `${PlanningError.typeName}CommitFailed`;
+    constructor(message = 'error') {
+        super(`commit-failed:${message}`);
+        this.type = CommitFailed.typeName;
+    }
+}
+/** A card of another entity was addressed. Handlers answer it as {@link WorkcardNotFound}. */
+export class PlanningScopeMismatch extends PlanningError {
+    static typeName = `${PlanningError.typeName}ScopeMismatch`;
+    constructor(message = 'error') {
+        super(`scope-mismatch:${message}`);
+        this.type = PlanningScopeMismatch.typeName;
+    }
+}
+/** The store behind this type cannot do what was asked (a foreign provider without a log). */
+export class PlanningUnsupported extends PlanningError {
+    static typeName = `${PlanningError.typeName}Unsupported`;
+    constructor(message = 'error') {
+        super(`unsupported:${message}`);
+        this.type = PlanningUnsupported.typeName;
+    }
+}
+ResilientError.registerErrorClass(PlanningError);
+ResilientError.registerErrorClass(WorkcardNotFound);
+ResilientError.registerErrorClass(UnknownWorkcardType);
+ResilientError.registerErrorClass(UnknownStatusFlow);
+ResilientError.registerErrorClass(ParentNotFound);
+ResilientError.registerErrorClass(CardTypeNotAllowed);
+ResilientError.registerErrorClass(PlanningRefused);
+ResilientError.registerErrorClass(IllegalTransition);
+ResilientError.registerErrorClass(FieldsInvalid);
+ResilientError.registerErrorClass(LabelNotAllowed);
+ResilientError.registerErrorClass(SpecificationSlotUnknown);
+ResilientError.registerErrorClass(SpecificationRevisionConflict);
+ResilientError.registerErrorClass(RelationshipRefused);
+ResilientError.registerErrorClass(CodeTaken);
+ResilientError.registerErrorClass(WorkcardConflict);
+ResilientError.registerErrorClass(CommitTimeout);
+ResilientError.registerErrorClass(CommitFailed);
+ResilientError.registerErrorClass(PlanningScopeMismatch);
+ResilientError.registerErrorClass(PlanningUnsupported);
+//# sourceMappingURL=errors.js.map

package/build/errors.js.map

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

package/build/helpers/apply.d.ts

@@ -0,0 +1,27 @@
+import type { Relationship, Transition, Workcard } from '../types.js';
+/**
+ * THE fold: the card after one transition. Pure, total, no I/O — every store (memory, Mongo, a
+ * client mirror) folds with this and nothing else, so one log always means one card.
+ *
+ * - An already-applied transition (`seq <= card.seq`) returns the card unchanged: re-folding is
+ *   safe.
+ * - Anything but the next seq (`card.seq + 1`, or 1 for a create with no card) is refused with
+ *   `PlanningError('fold:out-of-order')`.
+ * - `create` builds the whole record from `changes` plus the transition's identity; `delete`
+ *   answers `null`; `link`/`unlink` only move `seq`/`head`/`updatedAt` (the edges are
+ *   {@link applyRelationship}'s); `update`/`transit` write `changes` — `fields` and `flows` merge,
+ *   everything else replaces — and clear `unset`.
+ * - Every result has `seq = transition.seq`, `head = max(head, seq)`, `updatedAt = transition.at`.
+ *
+ * @throws {PlanningError} `planning:fold:out-of-order:…`
+ */
+export declare const applyTransition: <T extends Workcard = Workcard>(card: T | null | undefined, transition: Transition) => T | null;
+/**
+ * The relationships after one transition. Pure and total, like {@link applyTransition}.
+ *
+ * `create` adds its `links`, `link` adds its `link`, `unlink` removes the matching edge, and a
+ * `delete` removes every edge touching the card. An edge that already exists is kept as it is, so
+ * re-folding adds nothing. Every other action answers the list unchanged. Always a new array.
+ */
+export declare const applyRelationship: (links: Relationship[], transition: Transition) => Relationship[];
+//# sourceMappingURL=apply.d.ts.map

package/build/helpers/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/helpers/apply.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAqB,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AA+DxF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,QAAQ,GAAG,QAAQ,QACrD,CAAC,GAAG,IAAI,GAAG,SAAS,cAAc,UAAU,KACjD,CAAC,GAAG,IAoDN,CAAA;AAgBD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,UAAW,YAAY,EAAE,cAAc,UAAU,KAAG,YAAY,EAwB7F,CAAA"}