@owlmeans/planning 0.1.18-rc.0

package/build/helpers/code.js

@@ -0,0 +1,47 @@
+import { createIdOfLength, generateWordSlug, IdStyle, nextSlugCandidate } from '@owlmeans/basic-ids';
+import { CODE_MAX, CODE_MINT_ATTEMPTS, CodeScope, CodeStyle, DEFAULT_CODE_LENGTH } from '../consts.js';
+import { CodeTaken } from '../errors.js';
+/** `Some Title!` → `some-title`. */
+export const slugOf = (text, max = CODE_MAX) => text
+    .normalize('NFKD').replace(/[̀-ͯ]/g, '')
+    .toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '')
+    .slice(0, max).replace(/-+$/g, '');
+const candidateOf = (policy, attempt, base, opts) => {
+    const prefix = policy.prefix ?? '';
+    switch (policy.style) {
+        case CodeStyle.Slug:
+            return `${prefix}${nextSlugCandidate(base, attempt + 1)}`;
+        case CodeStyle.Sequential: {
+            const number = `${(opts?.count ?? 0) + attempt + 1}`;
+            return `${prefix}${policy.length != null ? number.padStart(policy.length, '0') : number}`;
+        }
+        case CodeStyle.Random:
+        default: {
+            const random = createIdOfLength(policy.length ?? DEFAULT_CODE_LENGTH, IdStyle.Base58);
+            return `${prefix}${policy.uppercase === true ? random.toUpperCase() : random}`;
+        }
+    }
+};
+/**
+ * Mint a code under a policy, asking `taken` for each candidate.
+ *
+ * `random` draws `prefix + Base58(length)` (upper-cased when asked) afresh per attempt; `slug`
+ * walks `base`, `base-2`, `base-3` from the seed (a word slug without one); `sequential` counts on
+ * from `opts.count`, zero-padded to `length`. After `attempts` taken candidates it refuses.
+ *
+ * @throws {CodeTaken}
+ */
+export const mintCode = async (policy, taken, attempts = CODE_MINT_ATTEMPTS, opts) => {
+    const seeded = opts?.seed != null ? slugOf(opts.seed, CODE_MAX - (policy.prefix?.length ?? 0) - 4) : '';
+    const base = policy.style === CodeStyle.Slug ? (seeded !== '' ? seeded : generateWordSlug()) : '';
+    for (let attempt = 0; attempt < attempts; ++attempt) {
+        const candidate = candidateOf(policy, attempt, base, opts);
+        if (!await taken(candidate)) {
+            return candidate;
+        }
+    }
+    throw new CodeTaken(`${policy.style}:${policy.prefix ?? ''}:${attempts}`);
+};
+/** Where a draft's code must be unique: its parent, or the whole entity. */
+export const codeScopeOf = (policy, draft) => policy.uniqueWithin === CodeScope.Parent ? { parent: draft.parent } : {};
+//# sourceMappingURL=code.js.map

package/build/helpers/code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.js","sourceRoot":"","sources":["../../src/helpers/code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACpG,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACtG,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAUxC,oCAAoC;AACpC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,GAAG,GAAW,QAAQ,EAAU,EAAE,CAAC,IAAI;KACzE,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;KACvC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;KACjE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAEpC,MAAM,WAAW,GAAG,CAAC,MAAkB,EAAE,OAAe,EAAE,IAAY,EAAE,IAAsB,EAAU,EAAE;IACxG,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAA;IAClC,QAAQ,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,KAAK,SAAS,CAAC,IAAI;YACjB,OAAO,GAAG,MAAM,GAAG,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,EAAE,CAAA;QAC3D,KAAK,SAAS,CAAC,UAAU,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,EAAE,CAAA;YACpD,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;QAC3F,CAAC;QACD,KAAK,SAAS,CAAC,MAAM,CAAC;QACtB,SAAS,CAAC;YACR,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,IAAI,mBAAmB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;YACrF,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;QAChF,CAAC;IACH,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAC3B,MAAkB,EAClB,KAAmD,EACnD,QAAQ,GAAW,kBAAkB,EACrC,IAAsB,EACL,EAAE;IACnB,MAAM,MAAM,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACvG,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAEjG,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;QAC1D,IAAI,CAAC,MAAM,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,SAAS,CAAC,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,IAAI,QAAQ,EAAE,CAAC,CAAA;AAC3E,CAAC,CAAA;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAkB,EAAE,KAAoC,EAAuB,EAAE,CAC3G,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA"}

package/build/helpers/index.d.ts

@@ -0,0 +1,9 @@
+export * from './apply.js';
+export * from './card.js';
+export * from './changes.js';
+export * from './code.js';
+export * from './query.js';
+export * from './specification.js';
+export * from './status.js';
+export * from './validate.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}

package/build/helpers/index.js

@@ -0,0 +1,9 @@
+export * from './apply.js';
+export * from './card.js';
+export * from './changes.js';
+export * from './code.js';
+export * from './query.js';
+export * from './specification.js';
+export * from './status.js';
+export * from './validate.js';
+//# sourceMappingURL=index.js.map

package/build/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}

package/build/helpers/query.d.ts

@@ -0,0 +1,39 @@
+import type { Criteria, ListOptions, ResourceRecord, Sort } from '@owlmeans/resource';
+import type { PlanningScope, RelationshipQuery, RelationshipQueryWire, RelationshipWhere, Specification, SpecificationQuery, SpecificationQueryWire, SummaryQuery, SummaryQueryWire, SummaryView, TransitionQuery, TransitionQueryWire, TransitionWhere, Workcard, WorkcardQuery, WorkcardQueryWire } from '../types.js';
+type Scope = Pick<PlanningScope, 'entityId'>;
+/**
+ * `WorkcardQuery` → `Criteria<Workcard>` — the ONE translation every store answers, so a query
+ * means the same thing in memory, in Mongo and in a client mirror.
+ *
+ * `entityId` always comes from the scope (a query that forgot it would be a cross-tenant read);
+ * `undefined` values are omitted. Paging and sorting are {@link listOptionsOf}'s.
+ */
+export declare const criteriaOf: (query?: WorkcardQuery | null, scope?: Scope) => Criteria<Workcard>;
+/** Paging and sorting out of a query. `size: 0` (no limit) survives. */
+export declare const listOptionsOf: <T extends ResourceRecord>(query?: ListOptions<T> | null) => ListOptions<T>;
+/** The criteria over a parent's specifications. */
+export declare const specCriteriaOf: (parent: string, query?: SpecificationQuery | null, scope?: Scope) => Criteria<Specification>;
+export declare const linkWhereOf: (query: RelationshipQuery | null | undefined, scope: Scope) => RelationshipWhere;
+export declare const transitionWhereOf: (query: TransitionQuery | null | undefined, scope: Scope) => TransitionWhere;
+/** Counts of DIRECT children (`card.parent`) per parent, by intrinsic state. No key for a parent with none. */
+export declare const summaryOf: (cards: Workcard[], parents: string[]) => SummaryView;
+/** A list as one query value: comma-joined, or JSON when an element itself holds a comma. */
+export declare const encodeList: (value?: string | readonly string[] | null) => string | undefined;
+/** Every entry of a list query value, whatever shape the transport left it in. */
+export declare const decodeList: (value: unknown, key?: string) => string[] | undefined;
+/** `[{ field: 'order' }, { field: 'updatedAt', order: 'desc' }]` ⇄ `order,-updatedAt`. */
+export declare const encodeSort: <T>(sort?: Sort<T>[] | null) => string | undefined;
+export declare const decodeSort: <T>(value: unknown) => Sort<T>[] | undefined;
+export declare const encodeWorkcardQuery: (query?: WorkcardQuery | null) => WorkcardQueryWire;
+/** @throws {PlanningError} `malformed:query:<key>` for a value that does not decode */
+export declare const decodeWorkcardQuery: (wire?: WorkcardQueryWire | WorkcardQuery | null) => WorkcardQuery;
+export declare const encodeSummaryQuery: (query: SummaryQuery) => SummaryQueryWire;
+export declare const decodeSummaryQuery: (wire?: SummaryQueryWire | SummaryQuery | null) => SummaryQuery;
+export declare const encodeTransitionQuery: (query?: TransitionQuery | null) => TransitionQueryWire;
+export declare const decodeTransitionQuery: (wire?: TransitionQueryWire | TransitionQuery | null) => TransitionQuery;
+export declare const encodeSpecificationQuery: (query?: SpecificationQuery | null) => SpecificationQueryWire;
+export declare const decodeSpecificationQuery: (wire?: SpecificationQueryWire | SpecificationQuery | null) => SpecificationQuery;
+export declare const encodeRelationshipQuery: (query?: RelationshipQuery | null) => RelationshipQueryWire;
+export declare const decodeRelationshipQuery: (wire?: RelationshipQueryWire | RelationshipQuery | null) => RelationshipQuery;
+export {};
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/helpers/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAGrF,OAAO,KAAK,EACiB,aAAa,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,iBAAiB,EACrG,aAAa,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EACtG,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,iBAAiB,EAClG,MAAM,aAAa,CAAA;AAEpB,KAAK,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAA;AAQ5C;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,WAAY,aAAa,GAAG,IAAI,UAAU,KAAK,KAAG,QAAQ,CAAC,QAAQ,CAiCzF,CAAA;AAED,wEAAwE;AACxE,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,cAAc,UAAU,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,KAAG,WAAW,CAAC,CAAC,CAInG,CAAA;AAEF,mDAAmD;AACnD,eAAO,MAAM,cAAc,WACjB,MAAM,UAAU,kBAAkB,GAAG,IAAI,UAAU,KAAK,KAC/D,QAAQ,CAAC,aAAa,CAKI,CAAA;AAE7B,eAAO,MAAM,WAAW,UAAW,iBAAiB,GAAG,IAAI,GAAG,SAAS,SAAS,KAAK,KAAG,iBAKtF,CAAA;AAEF,eAAO,MAAM,iBAAiB,UAAW,eAAe,GAAG,IAAI,GAAG,SAAS,SAAS,KAAK,KAAG,eAO1F,CAAA;AAMF,+GAA+G;AAC/G,eAAO,MAAM,SAAS,UAAW,QAAQ,EAAE,WAAW,MAAM,EAAE,KAAG,WAWhE,CAAA;AAID,6FAA6F;AAC7F,eAAO,MAAM,UAAU,WAAY,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI,KAAG,MAAM,GAAG,SAc/E,CAAA;AAED,kFAAkF;AAClF,eAAO,MAAM,UAAU,UAAW,OAAO,QAAO,MAAM,KAAY,MAAM,EAAE,GAAG,SAwB5E,CAAA;AA0CD,0FAA0F;AAC1F,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,KAAG,MAAM,GAAG,SAGI,CAAA;AAErE,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,OAAO,KAAG,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,SAmB1D,CAAA;AAiBD,eAAO,MAAM,mBAAmB,WAAY,aAAa,GAAG,IAAI,KAAG,iBAgBjE,CAAA;AAEF,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,UAAW,iBAAiB,GAAG,aAAa,GAAG,IAAI,KAAG,aAmBrF,CAAA;AAED,eAAO,MAAM,kBAAkB,UAAW,YAAY,KAAG,gBAIvD,CAAA;AAEF,eAAO,MAAM,kBAAkB,UAAW,gBAAgB,GAAG,YAAY,GAAG,IAAI,KAAG,YAOlF,CAAA;AAED,eAAO,MAAM,qBAAqB,WAAY,eAAe,GAAG,IAAI,KAAG,mBAOrE,CAAA;AAEF,eAAO,MAAM,qBAAqB,UAAW,mBAAmB,GAAG,eAAe,GAAG,IAAI,KAAG,eAU3F,CAAA;AAED,eAAO,MAAM,wBAAwB,WAAY,kBAAkB,GAAG,IAAI,KAAG,sBAI3E,CAAA;AAEF,eAAO,MAAM,wBAAwB,UAAW,sBAAsB,GAAG,kBAAkB,GAAG,IAAI,KAAG,kBAOpG,CAAA;AAED,eAAO,MAAM,uBAAuB,WAAY,iBAAiB,GAAG,IAAI,KAAG,qBAKzE,CAAA;AAEF,eAAO,MAAM,uBAAuB,UAAW,qBAAqB,GAAG,iBAAiB,GAAG,IAAI,KAAG,iBAQjG,CAAA"}

package/build/helpers/query.js

@@ -0,0 +1,293 @@
+import { IntrinsicStatus, WorkcardKind } from '../consts.js';
+import { PlanningError } from '../errors.js';
+const clean = (record) => Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined));
+/** `%`, `_` and `\` are wildcards/escapes to `$ilike`; a search text means them literally. */
+const escapeLike = (text) => text.replace(/[\\%_]/g, char => `\\${char}`);
+/**
+ * `WorkcardQuery` → `Criteria<Workcard>` — the ONE translation every store answers, so a query
+ * means the same thing in memory, in Mongo and in a client mirror.
+ *
+ * `entityId` always comes from the scope (a query that forgot it would be a cross-tenant read);
+ * `undefined` values are omitted. Paging and sorting are {@link listOptionsOf}'s.
+ */
+export const criteriaOf = (query, scope) => {
+    const where = {
+        entityId: scope?.entityId,
+        kind: query?.kind,
+        type: query?.type,
+        status: query?.status,
+        intrinsic: query?.intrinsic,
+        code: query?.code,
+        parent: query?.parent,
+        parents: query?.within != null ? { $contains: query.within } : undefined,
+        labels: query?.labels != null ? { $overlaps: query.labels } : undefined,
+        id: query?.ids != null ? { $in: query.ids } : undefined,
+        category: query?.category,
+        updatedAt: query?.updatedSince != null ? { $gte: query.updatedSince } : undefined,
+    };
+    if (query?.flow != null) {
+        where[`flows.${query.flow.id}`] = query.flow.status;
+    }
+    for (const [key, value] of Object.entries(query?.fields ?? {})) {
+        if (value !== undefined) {
+            where[`fields.${key}`] = value;
+        }
+    }
+    if (query?.q != null && query.q !== '') {
+        const like = `%${escapeLike(query.q)}%`;
+        where.$or = [
+            { title: { $ilike: like } },
+            { description: { $ilike: like } },
+            { code: { $startsWith: query.q } },
+        ];
+    }
+    return clean(where);
+};
+/** Paging and sorting out of a query. `size: 0` (no limit) survives. */
+export const listOptionsOf = (query) => clean({
+    page: query?.page,
+    size: query?.size,
+    sort: query?.sort,
+});
+/** The criteria over a parent's specifications. */
+export const specCriteriaOf = (parent, query, scope) => clean({
+    entityId: scope?.entityId,
+    kind: WorkcardKind.Specification,
+    parent,
+    category: query?.category,
+});
+export const linkWhereOf = (query, scope) => clean({
+    entityId: scope.entityId,
+    from: query?.from,
+    to: query?.to,
+    type: query?.type,
+});
+export const transitionWhereOf = (query, scope) => clean({
+    entityId: scope.entityId,
+    card: query?.card,
+    project: query?.project,
+    sinceSeq: query?.sinceSeq,
+    action: query?.action,
+    state: query?.state,
+});
+const emptyCounts = () => ({
+    total: 0, [IntrinsicStatus.Planned]: 0, [IntrinsicStatus.InProgress]: 0, [IntrinsicStatus.Closed]: 0,
+});
+/** Counts of DIRECT children (`card.parent`) per parent, by intrinsic state. No key for a parent with none. */
+export const summaryOf = (cards, parents) => cards.reduce((view, card) => {
+    if (card.parent == null || !parents.includes(card.parent)) {
+        return view;
+    }
+    const counts = view[card.parent] ?? emptyCounts();
+    counts.total += 1;
+    counts[card.intrinsic] = (counts[card.intrinsic] ?? 0) + 1;
+    view[card.parent] = counts;
+    return view;
+}, {});
+// ─── Wire encoding ───────────────────────────────────────────────────────────────────────────────
+/** A list as one query value: comma-joined, or JSON when an element itself holds a comma. */
+export const encodeList = (value) => {
+    if (value == null) {
+        return undefined;
+    }
+    if (typeof value === 'string') {
+        return encodeList([value]);
+    }
+    if (value.length === 0) {
+        return undefined;
+    }
+    return value.some(entry => entry.includes(',') || entry.startsWith('['))
+        ? JSON.stringify(value)
+        : value.join(',');
+};
+/** Every entry of a list query value, whatever shape the transport left it in. */
+export const decodeList = (value, key = 'list') => {
+    if (value == null || value === '') {
+        return undefined;
+    }
+    if (Array.isArray(value)) {
+        const entries = value.filter(entry => entry != null && entry !== '').map(entry => `${entry}`);
+        return entries.length > 0 ? entries : undefined;
+    }
+    if (typeof value !== 'string') {
+        return [`${value}`];
+    }
+    if (value.startsWith('[')) {
+        const parsed = (() => {
+            try {
+                return JSON.parse(value);
+            }
+            catch {
+                throw new PlanningError(`malformed:query:${key}`);
+            }
+        })();
+        return Array.isArray(parsed) ? parsed.map(entry => `${entry}`) : undefined;
+    }
+    const entries = value.split(',').map(entry => entry.trim()).filter(entry => entry !== '');
+    return entries.length > 0 ? entries : undefined;
+};
+/** A list decoded to a bare value when it holds one — the same criteria either way. */
+const decodeOneOrMany = (value, key) => {
+    const entries = decodeList(value, key);
+    return entries == null ? undefined : entries.length === 1 ? entries[0] : entries;
+};
+const encodeJson = (value) => value == null ? undefined : JSON.stringify(value);
+const decodeJson = (value, key) => {
+    if (value == null || value === '') {
+        return undefined;
+    }
+    if (typeof value !== 'string') {
+        return value;
+    }
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        throw new PlanningError(`malformed:query:${key}`);
+    }
+};
+const decodeNumber = (value, key) => {
+    if (value == null || value === '') {
+        return undefined;
+    }
+    const number = typeof value === 'number' ? value : Number(value);
+    if (Number.isNaN(number)) {
+        throw new PlanningError(`malformed:query:${key}`);
+    }
+    return number;
+};
+const decodeBoolean = (value) => value == null || value === '' ? undefined : value === true || value === 'true' || value === '1';
+const decodeText = (value) => value == null || value === '' ? undefined : `${Array.isArray(value) ? value[0] : value}`;
+/** `[{ field: 'order' }, { field: 'updatedAt', order: 'desc' }]` ⇄ `order,-updatedAt`. */
+export const encodeSort = (sort) => sort == null || sort.length === 0 ? undefined : sort.map(entry => typeof entry === 'string'
+    ? entry
+    : `${entry.order === 'desc' ? '-' : ''}${entry.field}`).join(',');
+export const decodeSort = (value) => {
+    if (value == null || value === '') {
+        return undefined;
+    }
+    const entries = Array.isArray(value) ? value : typeof value === 'string' ? value.split(',') : [value];
+    const sort = entries.flatMap((entry) => {
+        if (typeof entry !== 'string') {
+            return entry != null && typeof entry === 'object' && 'field' in entry ? [entry] : [];
+        }
+        const field = entry.trim();
+        if (field === '' || field === '-') {
+            return [];
+        }
+        return field.startsWith('-')
+            ? [{ field: field.slice(1), order: 'desc' }]
+            : [field];
+    });
+    return sort.length > 0 ? sort : undefined;
+};
+const encodeListOptions = (query) => clean({
+    page: query?.page,
+    size: query?.size,
+    sort: encodeSort(query?.sort),
+});
+const decodeListOptions = (wire) => clean({
+    page: decodeNumber(wire.page, 'page'),
+    size: decodeNumber(wire.size, 'size'),
+    sort: decodeSort(wire.sort),
+});
+const asRecord = (wire) => wire != null && typeof wire === 'object' ? wire : {};
+export const encodeWorkcardQuery = (query) => clean({
+    ...encodeListOptions(query),
+    kind: encodeList(query?.kind),
+    type: encodeList(query?.type),
+    parent: query?.parent,
+    within: query?.within,
+    status: encodeList(query?.status),
+    intrinsic: encodeList(query?.intrinsic),
+    flow: encodeJson(query?.flow),
+    labels: encodeList(query?.labels),
+    code: encodeList(query?.code),
+    ids: encodeList(query?.ids),
+    fields: query?.fields != null && Object.keys(query.fields).length > 0 ? encodeJson(query.fields) : undefined,
+    q: query?.q,
+    category: encodeList(query?.category),
+    updatedSince: query?.updatedSince,
+});
+/** @throws {PlanningError} `malformed:query:<key>` for a value that does not decode */
+export const decodeWorkcardQuery = (wire) => {
+    const value = asRecord(wire);
+    return clean({
+        ...decodeListOptions(value),
+        kind: decodeOneOrMany(value.kind, 'kind'),
+        type: decodeOneOrMany(value.type, 'type'),
+        parent: decodeText(value.parent),
+        within: decodeText(value.within),
+        status: decodeOneOrMany(value.status, 'status'),
+        intrinsic: decodeOneOrMany(value.intrinsic, 'intrinsic'),
+        flow: decodeJson(value.flow, 'flow'),
+        labels: decodeList(value.labels, 'labels'),
+        code: decodeOneOrMany(value.code, 'code'),
+        ids: decodeList(value.ids, 'ids'),
+        fields: decodeJson(value.fields, 'fields'),
+        q: decodeText(value.q),
+        category: decodeOneOrMany(value.category, 'category'),
+        updatedSince: decodeText(value.updatedSince),
+    });
+};
+export const encodeSummaryQuery = (query) => clean({
+    parents: encodeList(query.parents) ?? '',
+    kind: query.kind,
+    type: encodeList(query.type),
+});
+export const decodeSummaryQuery = (wire) => {
+    const value = asRecord(wire);
+    return clean({
+        parents: decodeList(value.parents, 'parents') ?? [],
+        kind: decodeText(value.kind),
+        type: decodeOneOrMany(value.type, 'type'),
+    });
+};
+export const encodeTransitionQuery = (query) => clean({
+    ...encodeListOptions(query),
+    card: query?.card,
+    project: query?.project,
+    sinceSeq: query?.sinceSeq,
+    action: encodeList(query?.action),
+    state: query?.state,
+});
+export const decodeTransitionQuery = (wire) => {
+    const value = asRecord(wire);
+    return clean({
+        ...decodeListOptions(value),
+        card: decodeText(value.card),
+        project: decodeText(value.project),
+        sinceSeq: decodeNumber(value.sinceSeq, 'sinceSeq'),
+        action: decodeOneOrMany(value.action, 'action'),
+        state: decodeText(value.state),
+    });
+};
+export const encodeSpecificationQuery = (query) => clean({
+    ...encodeListOptions(query),
+    category: encodeList(query?.category),
+    all: query?.all,
+});
+export const decodeSpecificationQuery = (wire) => {
+    const value = asRecord(wire);
+    return clean({
+        ...decodeListOptions(value),
+        category: decodeOneOrMany(value.category, 'category'),
+        all: decodeBoolean(value.all),
+    });
+};
+export const encodeRelationshipQuery = (query) => clean({
+    ...encodeListOptions(query),
+    from: encodeList(query?.from),
+    to: encodeList(query?.to),
+    type: encodeList(query?.type),
+});
+export const decodeRelationshipQuery = (wire) => {
+    const value = asRecord(wire);
+    return clean({
+        ...decodeListOptions(value),
+        from: decodeOneOrMany(value.from, 'from'),
+        to: decodeOneOrMany(value.to, 'to'),
+        type: decodeOneOrMany(value.type, 'type'),
+    });
+};
+//# sourceMappingURL=query.js.map

package/build/helpers/query.js.map

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

package/build/helpers/specification.d.ts

@@ -0,0 +1,21 @@
+import type { AnyTypeSchema, PlanningSchemaRegistry, Specification, SpecificationSlot, Workcard } from '../types.js';
+/** The slot a parent type declares for a category. */
+export declare const slotOf: (type: AnyTypeSchema, category: string) => SpecificationSlot | undefined;
+export declare const isRevisioned: (slot?: SpecificationSlot | null) => boolean;
+export declare const bodyCharsOf: (body?: string | null) => number | undefined;
+/** The revision a write lands as: 1 for a new document, current + 1 after, none when unrevisioned. */
+export declare const nextRevision: (current: Pick<Specification, 'revision'> | null | undefined, slot?: SpecificationSlot | null) => number | undefined;
+/**
+ * The current document of a category among a parent's specifications: the highest revision, then
+ * the most recently updated. `null` when the category has none.
+ */
+export declare const currentSpecification: (specs: Workcard[], category: string) => Specification | null;
+/**
+ * The specification type a new document of a slot is created with: the slot's own `type`, else
+ * the only registered specification type, else the one sharing the parent type's prefix
+ * (`viable:project` → `viable:spec`).
+ *
+ * @throws {UnknownWorkcardType} when none or several candidates remain
+ */
+export declare const specificationTypeOf: (registry: Pick<PlanningSchemaRegistry, 'types'>, parentType: string, slot?: SpecificationSlot | null) => string;
+//# sourceMappingURL=specification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"specification.d.ts","sourceRoot":"","sources":["../../src/helpers/specification.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EAAE,sBAAsB,EAAE,aAAa,EAAE,iBAAiB,EAAE,QAAQ,EAClF,MAAM,aAAa,CAAA;AAEpB,sDAAsD;AACtD,eAAO,MAAM,MAAM,SAAU,aAAa,YAAY,MAAM,KAAG,iBAAiB,GAAG,SACrB,CAAA;AAE9D,eAAO,MAAM,YAAY,UAAW,iBAAiB,GAAG,IAAI,KAAG,OAAoC,CAAA;AAEnG,eAAO,MAAM,WAAW,UAAW,MAAM,GAAG,IAAI,KAAG,MAAM,GAAG,SAAmD,CAAA;AAE/G,sGAAsG;AACtG,eAAO,MAAM,YAAY,YACd,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,SAAS,iBAAiB,GAAG,IAAI,KAC3F,MAAM,GAAG,SAA0E,CAAA;AAEtF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,UACxB,QAAQ,EAAE,YAAY,MAAM,KAClC,aAAa,GAAG,IAYT,CAAA;AAIV;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,aACpB,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC,cAAc,MAAM,SAAS,iBAAiB,GAAG,IAAI,KACnG,MAcF,CAAA"}

package/build/helpers/specification.js

@@ -0,0 +1,48 @@
+import { WorkcardKind } from '../consts.js';
+import { UnknownWorkcardType } from '../errors.js';
+/** The slot a parent type declares for a category. */
+export const slotOf = (type, category) => type.specifications.find(slot => slot.category === category);
+export const isRevisioned = (slot) => slot?.revisioned === true;
+export const bodyCharsOf = (body) => body == null ? undefined : body.length;
+/** The revision a write lands as: 1 for a new document, current + 1 after, none when unrevisioned. */
+export const nextRevision = (current, slot) => isRevisioned(slot) ? (current?.revision ?? 0) + 1 : undefined;
+/**
+ * The current document of a category among a parent's specifications: the highest revision, then
+ * the most recently updated. `null` when the category has none.
+ */
+export const currentSpecification = (specs, category) => specs
+    .filter((spec) => spec.kind === WorkcardKind.Specification
+    && spec.category === category)
+    .reduce((best, spec) => {
+    if (best == null) {
+        return spec;
+    }
+    const byRevision = (spec.revision ?? 0) - (best.revision ?? 0);
+    if (byRevision !== 0) {
+        return byRevision > 0 ? spec : best;
+    }
+    return (spec.updatedAt ?? spec.createdAt) > (best.updatedAt ?? best.createdAt) ? spec : best;
+}, null);
+const prefixOf = (type) => type.includes(':') ? type.slice(0, type.lastIndexOf(':')) : '';
+/**
+ * The specification type a new document of a slot is created with: the slot's own `type`, else
+ * the only registered specification type, else the one sharing the parent type's prefix
+ * (`viable:project` → `viable:spec`).
+ *
+ * @throws {UnknownWorkcardType} when none or several candidates remain
+ */
+export const specificationTypeOf = (registry, parentType, slot) => {
+    if (slot?.type != null) {
+        return slot.type;
+    }
+    const candidates = registry.types().filter(type => type.kind === WorkcardKind.Specification);
+    if (candidates.length === 1) {
+        return candidates[0].type;
+    }
+    const prefixed = candidates.filter(type => prefixOf(type.type) === prefixOf(parentType));
+    if (prefixed.length === 1) {
+        return prefixed[0].type;
+    }
+    throw new UnknownWorkcardType(`specification:${parentType}:${slot?.category ?? ''}`);
+};
+//# sourceMappingURL=specification.js.map

package/build/helpers/specification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specification.js","sourceRoot":"","sources":["../../src/helpers/specification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAKlD,sDAAsD;AACtD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAmB,EAAE,QAAgB,EAAiC,EAAE,CAC7F,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAA;AAE9D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAA+B,EAAW,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAA;AAEnG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAoB,EAAsB,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAA;AAE/G,sGAAsG;AACtG,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,OAA2D,EAAE,IAA+B,EACxE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAEtF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,KAAiB,EAAE,QAAgB,EACb,EAAE,CAAC,KAAK;KAC7B,MAAM,CAAC,CAAC,IAAI,EAAyB,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,aAAa;OAC3E,IAAsB,CAAC,QAAQ,KAAK,QAAQ,CAAC;KAClD,MAAM,CAAuB,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;IAC3C,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACjB,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAA;IAC9D,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;IACrC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AAC9F,CAAC,EAAE,IAAI,CAAC,CAAA;AAEV,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAEzG;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,QAA+C,EAAE,UAAkB,EAAE,IAA+B,EAC5F,EAAE;IACV,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;IACD,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,aAAa,CAAC,CAAA;IAC5F,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC3B,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAA;IACxF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACzB,CAAC;IAED,MAAM,IAAI,mBAAmB,CAAC,iBAAiB,UAAU,IAAI,IAAI,EAAE,QAAQ,IAAI,EAAE,EAAE,CAAC,CAAA;AACtF,CAAC,CAAA"}

package/build/helpers/status.d.ts

@@ -0,0 +1,44 @@
+import { IntrinsicStatus } from '../consts.js';
+import type { AnyTypeSchema, PlanningSchemaRegistry, StatusDefinition, StatusFlowSchema, StatusTransitionRule } from '../types.js';
+type FlowLookup = Pick<PlanningSchemaRegistry, 'flow'>;
+/** The primary flow id of a type — `flows[0]`. @throws {UnknownStatusFlow} when it declares none */
+export declare const primaryFlowOf: (type: AnyTypeSchema) => string;
+export declare const flowIdsOf: (type: AnyTypeSchema) => string[];
+export declare const statusDefinitionOf: (flow: StatusFlowSchema, status: string) => StatusDefinition | undefined;
+/** The intrinsic state a status maps onto, or `undefined` for a status the flow does not declare. */
+export declare const intrinsicOf: (flow: StatusFlowSchema, status: string) => IntrinsicStatus | undefined;
+/** The status marked `initial`, else the first one. @throws {PlanningError} for a flow with none */
+export declare const initialStatusOf: (flow: StatusFlowSchema) => string;
+export declare const isTerminal: (flow: StatusFlowSchema, status: string) => boolean;
+/**
+ * The rule a named transition follows from a status.
+ *
+ * A name may be declared several times with different `from` sets; the rule naming the status
+ * explicitly wins, and a `'*'` rule of that name answers only when none does.
+ */
+export declare const ruleOf: (flow: StatusFlowSchema, transition: string, from: string) => StatusTransitionRule | undefined;
+export declare const canTransit: (flow: StatusFlowSchema, transition: string, from: string) => boolean;
+/**
+ * Every transition available from a status, one rule per name (the one `ruleOf` would pick), in
+ * declaration order. `explicit: true` keeps only the rules offered to a person.
+ */
+export declare const transitionsFrom: (flow: StatusFlowSchema, status: string, opts?: {
+    explicit?: boolean;
+}) => StatusTransitionRule[];
+/**
+ * A new card's status per flow: every flow's initial status, with the primary one overridden by
+ * `status` when the draft names one.
+ *
+ * @throws {UnknownStatusFlow}
+ */
+export declare const initialFlowsOf: (type: AnyTypeSchema, registry: FlowLookup, status?: string) => Record<string, string>;
+/**
+ * The card's intrinsic state over its flows. {@link IntrinsicPolicy.Primary} reads the primary
+ * flow; {@link IntrinsicPolicy.All} takes the least advanced flow. A status the flow does not
+ * declare reads as planned.
+ *
+ * @throws {UnknownStatusFlow}
+ */
+export declare const resolveIntrinsic: (type: AnyTypeSchema, flows: Record<string, string>, registry: FlowLookup) => IntrinsicStatus;
+export {};
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/helpers/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,eAAe,EAAE,MAAM,cAAc,CAAA;AAE5F,OAAO,KAAK,EACV,aAAa,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAChG,MAAM,aAAa,CAAA;AAEpB,KAAK,UAAU,GAAG,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAA;AAEtD,oGAAoG;AACpG,eAAO,MAAM,aAAa,SAAU,aAAa,KAAG,MAOnD,CAAA;AAED,eAAO,MAAM,SAAS,SAAU,aAAa,KAAG,MAAM,EAAqB,CAAA;AAE3E,eAAO,MAAM,kBAAkB,SAAU,gBAAgB,UAAU,MAAM,KAAG,gBAAgB,GAAG,SAClC,CAAA;AAE7D,qGAAqG;AACrG,eAAO,MAAM,WAAW,SAAU,gBAAgB,UAAU,MAAM,KAAG,eAAe,GAAG,SAC1C,CAAA;AAE7C,oGAAoG;AACpG,eAAO,MAAM,eAAe,SAAU,gBAAgB,KAAG,MAOxD,CAAA;AAED,eAAO,MAAM,UAAU,SAAU,gBAAgB,UAAU,MAAM,KAAG,OACf,CAAA;AAKrD;;;;;GAKG;AACH,eAAO,MAAM,MAAM,SACX,gBAAgB,cAAc,MAAM,QAAQ,MAAM,KACvD,oBAAoB,GAAG,SAKzB,CAAA;AAED,eAAO,MAAM,UAAU,SAAU,gBAAgB,cAAc,MAAM,QAAQ,MAAM,KAAG,OAC9C,CAAA;AAExC;;;GAGG;AACH,eAAO,MAAM,eAAe,SACpB,gBAAgB,UAAU,MAAM,SAAS;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,KACpE,oBAAoB,EAMtB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,SACnB,aAAa,YAAY,UAAU,WAAW,MAAM,KACzD,MAAM,CAAC,MAAM,EAAE,MAAM,CAMvB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,SACrB,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,UAAU,KACvE,eAgBF,CAAA"}