@nocobase/app-plugin-projects 0.0.0-stage → 0.1.0-beta.10

package/dist/client/kit/page-slots.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The provider that collects what pages register (`page-context.ts`), and the slot an application fills with an
+ * assistant's button. It renders nothing unless its context is filled.
+ */
+import { type PropsWithChildren, type ReactElement } from 'react';
+import { type IntakeAgentSlotProps, type PageContextStore } from './page-context.js';
+/** Collects what the pages under it register; read it with `usePageContextEntries`. */
+export declare function PageContextProvider({ children, store: given, }: PropsWithChildren<{
+    readonly store?: PageContextStore;
+}>): ReactElement;
+/** "Let an agent organize", when the application fills the slot; nothing otherwise. */
+export declare function IntakeAgentSlot(props: IntakeAgentSlotProps): ReactElement | null;
+//# sourceMappingURL=page-slots.d.ts.map

package/dist/client/kit/page-slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-slots.d.ts","sourceRoot":"","sources":["../../../client/kit/page-slots.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,OAAO,CAAC;AAEf,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAE3B,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,KAAK,EAAE,KAAK,GACb,EAAE,iBAAiB,CAAC;IACnB,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;CACnC,CAAC,GAAG,YAAY,CAUhB;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAC7B,KAAK,EAAE,oBAAoB,GAC1B,YAAY,GAAG,IAAI,CAGrB"}

package/dist/client/kit/page-slots.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The provider that collects what pages register (`page-context.ts`), and the slot an application fills with an
+ * assistant's button. It renders nothing unless its context is filled.
+ */
+import { useContext, useState, } from 'react';
+import { IntakeAgentSlotContext, PageContextSinkContext, PageContextStoreContext, createPageContextStore, } from './page-context.js';
+/** Collects what the pages under it register; read it with `usePageContextEntries`. */
+export function PageContextProvider({ children, store: given, }) {
+    const [own] = useState(createPageContextStore);
+    const store = given ?? own;
+    return (_jsx(PageContextStoreContext.Provider, { value: store, children: _jsx(PageContextSinkContext.Provider, { value: store, children: children }) }));
+}
+/** "Let an agent organize", when the application fills the slot; nothing otherwise. */
+export function IntakeAgentSlot(props) {
+    const fill = useContext(IntakeAgentSlotContext);
+    return fill ? _jsx(fill.Organize, { ...props }) : null;
+}
+//# sourceMappingURL=page-slots.js.map

package/dist/client/kit/page-slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-slots.js","sourceRoot":"","sources":["../../../client/kit/page-slots.tsx"],"names":[],"mappings":";AAAA;;;GAGG;AACH,OAAO,EACL,UAAU,EACV,QAAQ,GAGT,MAAM,OAAO,CAAC;AAEf,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,GAGvB,MAAM,mBAAmB,CAAC;AAE3B,uFAAuF;AACvF,MAAM,UAAU,mBAAmB,CAAC,EAClC,QAAQ,EACR,KAAK,EAAE,KAAK,GAGZ;IACA,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,sBAAsB,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,KAAK,IAAI,GAAG,CAAC;IAC3B,OAAO,CACL,KAAC,uBAAuB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC5C,KAAC,sBAAsB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC1C,QAAQ,GACuB,GACD,CACpC,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAC7B,KAA2B;IAE3B,MAAM,IAAI,GAAG,UAAU,CAAC,sBAAsB,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,CAAC,CAAC,KAAC,IAAI,CAAC,QAAQ,OAAK,KAAK,GAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC"}

package/dist/client/kit/plans/api.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The browser API of `/api/projects/plans` and `/api/projects/intake` (`shared/plans.ts`, `shared/intake.ts`,
+ * `shared/intake-ai.ts`), and their query keys. The keys sit under `['pm', 'plans']`, so the plugin's realtime refresh (domain `plans`) and a refresh of
+ * everything reach them.
+ */
+import { type ApiClient } from '@nocobase/app-client';
+import type { QueryKey } from '@tanstack/react-query';
+import type { Page } from '../../../shared/common.js';
+import type { IntakeAiAvailability, IntakeAiJob, IntakeAiStartRequest } from '../../../shared/intake-ai.js';
+import type { IntakeFile, IntakeSplitRequest, IntakeSplitResult, IntakeTextsResult } from '../../../shared/intake.js';
+import type { CreatePlanRequest, EditPlanRequest, Plan, PlanListQuery, PlanRehearsal, PlanUndoPreview } from '../../../shared/plans.js';
+export declare const planKeys: {
+    all: readonly ["pm", "plans"];
+    plan: (id: string) => QueryKey;
+    list: (query: PlanListQuery) => QueryKey;
+    /** Whether the viewer can ask AI now. */
+    intakeAi: readonly ["pm", "plans", "intake-ai"];
+    intakeJob: (id: string) => QueryKey;
+};
+export declare class PlanApi {
+    private readonly api;
+    constructor(api: ApiClient);
+    plan(planId: string): Promise<Plan>;
+    plans(query?: PlanListQuery): Promise<Page<Plan>>;
+    rehearse(input: CreatePlanRequest): Promise<PlanRehearsal>;
+    create(input: CreatePlanRequest): Promise<Plan>;
+    edit(planId: string, input: EditPlanRequest): Promise<Plan>;
+    act(planId: string, action: 'execute' | 'retry' | 'void', revision: number): Promise<Plan>;
+    /** What undoing `planId` would revert now, and what it would leave alone. */
+    previewUndo(planId: string): Promise<PlanUndoPreview>;
+    /** Undoes `planId` at once; answers it, undone. */
+    undo(planId: string): Promise<Plan>;
+    uploadIntakeFile(file: File, signal?: AbortSignal): Promise<IntakeFile>;
+    removeIntakeFile(fileId: string): Promise<void>;
+    splitIntake(input: IntakeSplitRequest): Promise<IntakeSplitResult>;
+    /** The text of the caller's uploaded files, as the split reads it. */
+    intakeTexts(fileIds: readonly string[]): Promise<IntakeTextsResult>;
+    /** Whether the caller can ask AI to split, revise or break down now. */
+    intakeAiAvailability(): Promise<IntakeAiAvailability>;
+    startIntakeAi(input: IntakeAiStartRequest): Promise<IntakeAiJob>;
+    intakeJob(jobId: string): Promise<IntakeAiJob>;
+    cancelIntakeJob(jobId: string): Promise<IntakeAiJob>;
+    private data;
+}
+export declare function usePlanApi(): PlanApi;
+//# sourceMappingURL=api.d.ts.map

package/dist/client/kit/plans/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../client/kit/plans/api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,KAAK,EACV,oBAAoB,EACpB,WAAW,EACX,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,IAAI,EACJ,aAAa,EACb,aAAa,EACb,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAElC,eAAO,MAAM,QAAQ;;eAER,MAAM,KAAG,QAAQ;kBACd,aAAa,KAAG,QAAQ;IACtC,yCAAyC;;oBAEzB,MAAM,KAAG,QAAQ;CAClC,CAAC;AAIF,qBAAa,OAAO;IACC,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAE3C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7B,KAAK,CAAC,KAAK,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAkB3D,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ1D,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D,GAAG,CACR,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,EACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAQhB,6EAA6E;IACtE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAQ5D,mDAAmD;IAC5C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnC,gBAAgB,CACrB,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC;IAWT,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQzE,sEAAsE;IAC/D,WAAW,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQ1E,wEAAwE;IACjE,oBAAoB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAIrD,aAAa,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IAQhE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI9C,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;YAO7C,IAAI;CAMnB;AAED,wBAAgB,UAAU,IAAI,OAAO,CAGpC"}

package/dist/client/kit/plans/api.js

@@ -0,0 +1,137 @@
+/**
+ * The browser API of `/api/projects/plans` and `/api/projects/intake` (`shared/plans.ts`, `shared/intake.ts`,
+ * `shared/intake-ai.ts`), and their query keys. The keys sit under `['pm', 'plans']`, so the plugin's realtime refresh (domain `plans`) and a refresh of
+ * everything reach them.
+ */
+import { useApiClient } from '@nocobase/app-client';
+import { useMemo } from 'react';
+export const planKeys = {
+    all: ['pm', 'plans'],
+    plan: (id) => ['pm', 'plans', 'one', id],
+    list: (query) => ['pm', 'plans', 'list', query],
+    /** Whether the viewer can ask AI now. */
+    intakeAi: ['pm', 'plans', 'intake-ai'],
+    intakeJob: (id) => ['pm', 'plans', 'intake-ai', 'job', id],
+};
+const id = (value) => encodeURIComponent(value);
+export class PlanApi {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    plan(planId) {
+        return this.data({ path: `projects/plans/${id(planId)}` });
+    }
+    async plans(query = {}) {
+        const { cursor, limit, ...filters } = query;
+        const { data, meta } = await this.api.request({
+            path: 'projects/plans',
+            query: Object.fromEntries(Object.entries({
+                ...filters,
+                pageSize: limit,
+                pageToken: cursor,
+            }).filter(([, value]) => value !== undefined)),
+        });
+        return { data, nextCursor: meta?.nextPageToken ?? null };
+    }
+    rehearse(input) {
+        return this.data({
+            path: 'projects/plans/rehearse',
+            method: 'POST',
+            json: input,
+        });
+    }
+    create(input) {
+        return this.data({ path: 'projects/plans', method: 'POST', json: input });
+    }
+    edit(planId, input) {
+        return this.data({
+            path: `projects/plans/${id(planId)}`,
+            method: 'PATCH',
+            json: input,
+        });
+    }
+    act(planId, action, revision) {
+        return this.data({
+            path: `projects/plans/${id(planId)}/${action}`,
+            method: 'POST',
+            json: { revision },
+        });
+    }
+    /** What undoing `planId` would revert now, and what it would leave alone. */
+    previewUndo(planId) {
+        return this.data({
+            path: `projects/plans/${id(planId)}/undo`,
+            method: 'POST',
+            json: { dryRun: true },
+        });
+    }
+    /** Undoes `planId` at once; answers it, undone. */
+    undo(planId) {
+        return this.data({
+            path: `projects/plans/${id(planId)}/undo`,
+            method: 'POST',
+            json: {},
+        });
+    }
+    uploadIntakeFile(file, signal) {
+        const body = new FormData();
+        body.append('file', file);
+        return this.data({
+            path: 'projects/intake/files',
+            method: 'POST',
+            body,
+            ...(signal ? { signal } : {}),
+        });
+    }
+    async removeIntakeFile(fileId) {
+        await this.api.request({
+            path: `projects/intake/files/${id(fileId)}`,
+            method: 'DELETE',
+        });
+    }
+    splitIntake(input) {
+        return this.data({
+            path: 'projects/intake/split',
+            method: 'POST',
+            json: input,
+        });
+    }
+    /** The text of the caller's uploaded files, as the split reads it. */
+    intakeTexts(fileIds) {
+        return this.data({
+            path: 'projects/intake/extractTexts',
+            method: 'POST',
+            json: { fileIds },
+        });
+    }
+    /** Whether the caller can ask AI to split, revise or break down now. */
+    intakeAiAvailability() {
+        return this.data({ path: 'projects/intake/aiAvailability' });
+    }
+    startIntakeAi(input) {
+        return this.data({
+            path: 'projects/intake/aiJobs',
+            method: 'POST',
+            json: input,
+        });
+    }
+    intakeJob(jobId) {
+        return this.data({ path: `projects/intake/aiJobs/${id(jobId)}` });
+    }
+    cancelIntakeJob(jobId) {
+        return this.data({
+            path: `projects/intake/aiJobs/${id(jobId)}/cancel`,
+            method: 'POST',
+        });
+    }
+    async data(options) {
+        const { data } = await this.api.request(options);
+        return data;
+    }
+}
+export function usePlanApi() {
+    const api = useApiClient();
+    return useMemo(() => new PlanApi(api), [api]);
+}
+//# sourceMappingURL=api.js.map

package/dist/client/kit/plans/api.js.map

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

package/dist/client/kit/plans/lookup.d.ts

@@ -0,0 +1,27 @@
+import { type UseQueryResult } from '@tanstack/react-query';
+import type { Executor, IssueDetail, StatusDefinition } from '../../../shared/issues.js';
+import type { Label } from '../../../shared/labels.js';
+import type { Member } from '../../../shared/members.js';
+import type { ProjectListItem } from '../../../shared/projects.js';
+import type { ExecutorOption } from '../../components/pm-executor-select.js';
+export interface PlanLookup {
+    readonly members: readonly Member[];
+    readonly labels: readonly Label[];
+    readonly projects: readonly ProjectListItem[];
+    readonly executors: readonly ExecutorOption[];
+}
+export declare function usePlanLookup(): PlanLookup;
+export declare function executorOf(value: unknown): Executor | null;
+/**
+ * Formats a field's value as the pages show it, in this plugin's words wherever it is rendered: names for ids,
+ * translated priorities, and a status by its name in `statuses` (the fixed statuses) when given.
+ */
+export declare function usePlanValueText(lookup: PlanLookup): (field: string, value: unknown, statuses?: readonly StatusDefinition[]) => string;
+/**
+ * An existing issue a plan names, from the cached issue detail the issue pages read: for its identifier and title, and
+ * the fixed statuses. Disabled while `issueId` is null.
+ */
+export declare function usePlanIssue(issueId: string | null): UseQueryResult<IssueDetail>;
+/** Creates a label by name (the caller may create labels: `pm.labels`), coloured by its name, and adds it to the cached list. */
+export declare function useCreateLabel(): (name: string) => Promise<Label>;
+//# sourceMappingURL=lookup.d.ts.map

package/dist/client/kit/plans/lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../../../client/kit/plans/lookup.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAK/B,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EACX,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAM7E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;CAC/C;AAED,wBAAgB,aAAa,IAAI,UAAU,CAoB1C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAK1D;AASD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,UAAU,GACjB,CACD,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,SAAS,gBAAgB,EAAE,KACnC,MAAM,CAuDV;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,cAAc,CAAC,WAAW,CAAC,CAS7B;AASD,iIAAiI;AACjI,wBAAgB,cAAc,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,CAejE"}

package/dist/client/kit/plans/lookup.js

@@ -0,0 +1,136 @@
+/**
+ * What the card and the editor need to show ids as names and to offer choices: members, labels, projects and the
+ * executors of other kinds, from the same cached lists the rest of the pages read.
+ */
+import { useTranslation } from '@nocobase/i18n/client';
+import { useQuery, useQueryClient, } from '@tanstack/react-query';
+import { useCallback } from 'react';
+import { ACCESS_NAMESPACE } from '../../../shared/access.js';
+import { COLORS } from '../../../shared/common.js';
+import { pmKeys } from '../../api/keys.js';
+import { usePmApi } from '../../hooks/use-pm-api.js';
+import { statusName } from '../../lib/status.js';
+import { useExecutorOptions } from '../../pages/issues/use-executor-options.js';
+import { asRecord } from './model.js';
+export function usePlanLookup() {
+    const api = usePmApi();
+    const members = useQuery({
+        queryKey: pmKeys.members,
+        queryFn: () => api.members(),
+    });
+    const labels = useQuery({
+        queryKey: pmKeys.labels,
+        queryFn: () => api.labels(),
+    });
+    const projects = useQuery({
+        queryKey: pmKeys.projects,
+        queryFn: () => api.projects(),
+    });
+    return {
+        members: members.data ?? [],
+        labels: labels.data ?? [],
+        projects: projects.data ?? [],
+        executors: useExecutorOptions(),
+    };
+}
+export function executorOf(value) {
+    const record = asRecord(value);
+    return typeof record.type === 'string' && typeof record.id === 'string'
+        ? { type: record.type, id: record.id }
+        : null;
+}
+/** A value as text: strings and numbers as they are, anything else as JSON. */
+function plain(value) {
+    return typeof value === 'string' || typeof value === 'number'
+        ? String(value)
+        : (JSON.stringify(value) ?? '');
+}
+/**
+ * Formats a field's value as the pages show it, in this plugin's words wherever it is rendered: names for ids,
+ * translated priorities, and a status by its name in `statuses` (the fixed statuses) when given.
+ */
+export function usePlanValueText(lookup) {
+    const { t } = useTranslation(ACCESS_NAMESPACE);
+    const person = (id) => lookup.members.find((member) => member.userId === id)?.name ??
+        (typeof id === 'string' ? id : '—');
+    return (field, value, statuses) => {
+        if (value === undefined || value === null || value === '')
+            return '—';
+        switch (field) {
+            case 'statusKey':
+                if (statuses && typeof value === 'string')
+                    return statusName(t, statuses, value);
+                // Without the statuses at hand, a fixed status by its translated name, any other by its key.
+                return t(`status.${plain(value)}`, { defaultValue: plain(value) });
+            case 'priority':
+                return t(`priority.${plain(value)}`, { defaultValue: plain(value) });
+            case 'ownerUserId':
+            case 'leadUserId':
+                return person(value);
+            case 'executor': {
+                const executor = executorOf(value);
+                if (!executor)
+                    return t('executor.none');
+                if (executor.type === 'user')
+                    return person(executor.id);
+                return (lookup.executors.find((option) => option.type === executor.type && option.id === executor.id)?.name ?? executor.id);
+            }
+            case 'labelIds':
+                return Array.isArray(value)
+                    ? value
+                        .map((id) => lookup.labels.find((label) => label.id === id)?.name ??
+                        plain(id))
+                        .join(', ') || '—'
+                    : '—';
+            case 'projectId': {
+                const ref = asRecord(value).ref;
+                if (typeof ref === 'string')
+                    return t('plans.newProject');
+                return (lookup.projects.find((project) => project.id === value)?.name ??
+                    plain(value));
+            }
+            case 'visibility':
+                return t(`plans.visibility.${plain(value)}`, {
+                    defaultValue: plain(value),
+                });
+            default:
+                return plain(value);
+        }
+    };
+}
+/**
+ * An existing issue a plan names, from the cached issue detail the issue pages read: for its identifier and title, and
+ * the fixed statuses. Disabled while `issueId` is null.
+ */
+export function usePlanIssue(issueId) {
+    const api = usePmApi();
+    return useQuery({
+        queryKey: pmKeys.issue(issueId ?? ''),
+        queryFn: () => api.issue(issueId ?? ''),
+        enabled: issueId !== null && issueId !== '',
+        retry: false,
+        staleTime: 30_000,
+    });
+}
+/** A colour for a new label, spread over the palette by name so labels created in a row differ. */
+function colorFor(name) {
+    let hash = 0;
+    for (const char of name)
+        hash = (hash * 31 + char.charCodeAt(0)) >>> 0;
+    return COLORS[hash % COLORS.length] ?? 'gray';
+}
+/** Creates a label by name (the caller may create labels: `pm.labels`), coloured by its name, and adds it to the cached list. */
+export function useCreateLabel() {
+    const api = usePmApi();
+    const queryClient = useQueryClient();
+    return useCallback(async (name) => {
+        const label = await api.createLabel({ name, color: colorFor(name) });
+        queryClient.setQueryData(pmKeys.labels, (current) => [
+            ...(current ?? []),
+            label,
+        ]);
+        void queryClient.invalidateQueries({ queryKey: pmKeys.labels });
+        return label;
+    }, [api, queryClient]);
+}
+//# sourceMappingURL=lookup.js.map

package/dist/client/kit/plans/lookup.js.map

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

package/dist/client/kit/plans/model.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Plans as pure data, for the card and the editor: the state a plan is in (an open plan past its expiry reads as
+ * expired), what may be done with it, the rows with the person's unsaved edits applied, the tree the `issue.create`
+ * rows form, moving a row in or out of that tree, which rows ask for a second confirmation, and the `PATCH` body of
+ * the edits.
+ */
+import { type EditPlanRequest, type Plan, type PlanObjectRef, type PlanRiskFlag, type PlanRow, type PlanStatus } from '../../../shared/plans.js';
+/** An unsaved change to one row. */
+export interface RowEdit {
+    /** Replaces the row's params. */
+    readonly params?: Readonly<Record<string, unknown>>;
+    readonly remove?: boolean;
+}
+/** By row id. */
+export type PlanEdits = ReadonlyMap<string, RowEdit>;
+export interface RowView {
+    readonly row: PlanRow;
+    /** The params with the edit applied. */
+    readonly params: Readonly<Record<string, unknown>>;
+    readonly removed: boolean;
+    readonly edited: boolean;
+    /** How deep an `issue.create` row sits under the rows it was created under; 0 otherwise. */
+    readonly depth: number;
+}
+export declare function asRecord(value: unknown): Readonly<Record<string, unknown>>;
+/** The ref an issue or project target names, if it names an earlier row. */
+export declare function refOf(value: unknown): string | null;
+/** A plan's own page. */
+export declare function planHref(planId: string): string;
+/** The state to show: an open plan past its expiry is expired, whatever the server last wrote. */
+export declare function effectiveStatus(plan: Plan, now?: number): PlanStatus;
+export interface PlanAbilities {
+    /** Edit rows (open plans). */
+    readonly edit: boolean;
+    readonly execute: boolean;
+    /** Rehearse a failed or stale plan again. */
+    readonly retry: boolean;
+    readonly void: boolean;
+    /** Within the undo window, for the person who executed it. */
+    readonly undo: boolean;
+}
+export declare function abilitiesOf(plan: Plan, viewerId: string | null, now?: number): PlanAbilities;
+/** Whole hours (at least 1) until `iso`, or 0 once it has passed. */
+export declare function hoursLeft(iso: string | null, now?: number): number;
+export declare function rowViews(rows: readonly PlanRow[], edits?: PlanEdits): RowView[];
+/** The refs that rows still in the plan point at: their rows cannot be removed. */
+export declare function referencedRefs(views: readonly RowView[]): ReadonlySet<string>;
+export declare function canRemove(view: RowView, referenced: ReadonlySet<string>): boolean;
+export declare function canIndent(views: readonly RowView[], index: number): boolean;
+export declare function canOutdent(views: readonly RowView[], index: number): boolean;
+/** The params of row `index` made a sub-issue of the row above it at the same level; null when it cannot be. */
+export declare function indentParams(views: readonly RowView[], index: number): Readonly<Record<string, unknown>> | null;
+/** The params of row `index` lifted one level, to its parent's parent; null when it is at the top. */
+export declare function outdentParams(views: readonly RowView[], index: number): Readonly<Record<string, unknown>> | null;
+/** The `PATCH /plans/:id` body for the edits, or null when there are none. */
+export declare function editRequest(plan: Pick<Plan, 'revision'>, edits: PlanEdits): EditPlanRequest | null;
+/** The rows still in the plan that carry a risk flag; executing asks again for them. */
+export declare function riskyRows(views: readonly RowView[]): RowView[];
+export declare function flagsOf(view: RowView): readonly PlanRiskFlag[];
+/** The rows still in the plan, counted; `issue.create` ones separately for "Create N issues". */
+export declare function counts(views: readonly RowView[]): {
+    readonly rows: number;
+    readonly issues: number;
+};
+/** The title an `issue.create` row's params give, for references to it. */
+export declare function createdTitle(params: Readonly<Record<string, unknown>>): string;
+/** Refs other rows use, apart from sub-issues pointing at their parent (those follow a removed parent up). */
+export declare function blockingRefs(views: readonly RowView[]): ReadonlySet<string>;
+/** The edits that remove `view`: its sub-issues move up to its own parent. */
+export declare function removalEdits(views: readonly RowView[], view: RowView): ReadonlyMap<string, RowEdit>;
+/** The edits with `changes` merged in, row by row. */
+export declare function mergeEdits(current: PlanEdits, changes: ReadonlyMap<string, RowEdit>): PlanEdits;
+/** The edits with `rowId` kept in the plan again (its params edits stay). */
+export declare function restoreEdits(current: PlanEdits, rowId: string): PlanEdits;
+/** `params` with `values` set; a value of `undefined` drops its key. */
+export declare function patchParams(params: Readonly<Record<string, unknown>>, values: Readonly<Record<string, unknown>>): Readonly<Record<string, unknown>>;
+/** A project target as one select value: `ref:<ref>` for a project an earlier row creates, else the id. */
+export declare function encodeProjectTarget(value: unknown): string | null;
+/** The project target a select value (`encodeProjectTarget`) stands for. */
+export declare function decodeProjectTarget(value: string | null): unknown;
+/** What a plan's clock says: hours left to undo it (executed), or until it expires (pending, failed, stale). */
+export interface PlanCountdown {
+    readonly kind: 'undo' | 'expires';
+    readonly hours: number;
+}
+/** The countdown to show beside a plan, or null for none. */
+export declare function planCountdown(plan: Plan, viewerId: string | null, now?: number): PlanCountdown | null;
+/** Where the browser shows an issue or project a row created or acted on. */
+export declare function planObjectHref(ref: PlanObjectRef | null | undefined): string | null;
+/** How an object reads: `PM-12 Title`, or its title; null when it carries neither. */
+export declare function planObjectLabel(ref: PlanObjectRef | null | undefined): string | null;
+/** The status-closed plans (voided, expired, undone), whose rows a card folds by default. */
+export declare function isClosedPlan(status: PlanStatus): boolean;
+//# sourceMappingURL=model.d.ts.map

package/dist/client/kit/plans/model.d.ts.map

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