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

package/dist/client/kit/plans/plan-text.js

@@ -0,0 +1,96 @@
+/**
+ * Plans in words, shared by the card, the editor and the confirmation: the tones of statuses and risk flags, what a
+ * row is about, where a plan comes from, a row's error, and a plan's title and description as the reader sees them.
+ */
+import { ApiClientError } from '@nocobase/app-client';
+import { useTranslation } from '@nocobase/i18n/client';
+import { createContext, useCallback, useContext, useMemo, } from 'react';
+import { ACCESS_NAMESPACE } from '../../../shared/access.js';
+import { errorText } from '../../hooks/use-notify.js';
+import { createdTitle, planObjectLabel as objectLabel, refOf, } from './model.js';
+export { FLAG_TONE, PLAN_STATUS_TONE } from './tones.js';
+/** An issue target as words: an earlier row by its title, the checked target, or the id as written. */
+export function targetLabel(value, views, t, checked) {
+    const ref = refOf(value);
+    if (ref) {
+        const row = views.find((view) => view.row.ref === ref);
+        return (row && createdTitle(row.params)) || ref;
+    }
+    return (objectLabel(checked) ??
+        (typeof value === 'string' ? value : t('plans.unknownIssue')));
+}
+/** What a row is about, as its heading. */
+export function rowTitle(view, views, t) {
+    const { params, row } = view;
+    // What the target looked like before the plan: a rehearsal's own target already carries the change.
+    const target = row.check?.baseline?.target ??
+        row.result?.target ??
+        row.check?.target ??
+        null;
+    switch (row.op) {
+        case 'issue.create':
+        case 'project.create':
+            return createdTitle(params) || t('plans.untitled');
+        case 'dependency':
+            return t(params.action === 'remove'
+                ? 'plans.dependencyRemove'
+                : 'plans.dependsOn', {
+                issue: targetLabel(params.issue, views, t),
+                dependsOn: targetLabel(params.dependsOn, views, t),
+            });
+        case 'issue.update':
+        case 'comment.create':
+            return targetLabel(params.issue, views, t, target);
+        default:
+            return objectLabel(target) ?? t('plans.unknownIssue');
+    }
+}
+/** What a row is about, as its heading, in this plugin's words wherever it is rendered. */
+export function usePlanRowTitle() {
+    const { t } = useTranslation(ACCESS_NAMESPACE);
+    return useCallback((view, views) => rowTitle(view, views, t), [t]);
+}
+export function usePlanErrorText() {
+    const { t } = useTranslation(ACCESS_NAMESPACE);
+    return useMemo(() => ({
+        request: (error, fallback) => errorText(t, error, fallback ?? t('common.requestFailed')),
+        row: (error) => error
+            ? t(`errors.${error.code}`, {
+                defaultValue: error.message || error.code,
+            })
+            : null,
+    }), [t]);
+}
+/** The reason of a failed API request (`REVISION_CONFLICT`, `UNDO_STALE`, …), or null for any other error. */
+export function planErrorReason(error) {
+    return error instanceof ApiClientError ? (error.reason ?? null) : null;
+}
+/** A row's error, in words: a known code by its translation, else the server's message. */
+export function useRowError() {
+    const { t } = useTranslation();
+    return (error) => error
+        ? t(`errors.${error.code}`, { defaultValue: error.message || error.code })
+        : null;
+}
+/** Where a plan comes from, in words. */
+export function usePlanSource() {
+    const { t } = useTranslation();
+    return (plan) => t(`plans.source.${plan.source.kind}`, {
+        defaultValue: t('plans.source.other', { kind: plan.source.kind }),
+    });
+}
+export const PlanWordingContext = createContext(null);
+/** A plan's title and description as the reader sees them (`PlanWordingContext`, else as stored). */
+export function usePlanWording() {
+    const worder = useContext(PlanWordingContext);
+    return (plan) => {
+        const wording = worder?.(plan) ?? null;
+        return {
+            title: wording?.title ?? plan.title,
+            description: wording && wording.description !== undefined
+                ? wording.description
+                : plan.description,
+        };
+    };
+}
+//# sourceMappingURL=plan-text.js.map

package/dist/client/kit/plans/plan-text.js.map

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

package/dist/client/kit/plans/plan-undo.d.ts

@@ -0,0 +1,9 @@
+import type { ReactElement } from 'react';
+import type { Plan } from '../../../shared/plans.js';
+export declare function PlanUndoDialog({ plan, open, onOpenChange, onUndone, }: {
+    readonly plan: Plan;
+    readonly open: boolean;
+    readonly onOpenChange: (open: boolean) => void;
+    readonly onUndone?: (plan: Plan) => void;
+}): ReactElement;
+//# sourceMappingURL=plan-undo.d.ts.map

package/dist/client/kit/plans/plan-undo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-undo.d.ts","sourceRoot":"","sources":["../../../../client/kit/plans/plan-undo.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,0BAA0B,CAAC;AAiBrE,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,IAAI,EACJ,YAAY,EACZ,QAAQ,GACT,EAAE;IACD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CAC1C,GAAG,YAAY,CA0If"}

package/dist/client/kit/plans/plan-undo.js

@@ -0,0 +1,67 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Undoing an executed plan in one step: the dialog first asks the server what undoing would do now (`dryRun`), lists
+ * what will be reverted and what is left alone because someone changed it since, with why, and confirming undoes it
+ * at once. Nothing else is created: there is no separate plan to execute afterwards.
+ */
+import { ApiClientError } from '@nocobase/app-client';
+import { useTranslation } from '@nocobase/i18n/client';
+import { Undo2Icon } from 'lucide-react';
+import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, } from '../../components/ui/alert-dialog.js';
+import { Skeleton } from '../../components/ui/skeleton.js';
+import { Spinner } from '../../components/ui/spinner.js';
+import { useNotify } from '../../hooks/use-notify.js';
+import { planObjectLabel as label } from './model.js';
+import { usePlanMutations, usePlanUndoPreview } from './use-plan.js';
+export function PlanUndoDialog({ plan, open, onOpenChange, onUndone, }) {
+    const { t } = useTranslation();
+    const notify = useNotify();
+    const mutations = usePlanMutations();
+    const preview = usePlanUndoPreview(plan.id, open);
+    const revert = preview.data?.revert ?? [];
+    const skipped = preview.data?.skipped ?? [];
+    const what = (row) => {
+        const target = label(row.target) ?? t('plans.unknownIssue');
+        if (row.op === 'issue.update') {
+            const fields = Object.keys(row.restore ?? {})
+                .map((field) => t(`plans.fields.${field}`, { defaultValue: field }))
+                .join(t('plans.undoPreview.separator'));
+            return t('plans.undoPreview.restore', { target, fields });
+        }
+        return t(`plans.undoPreview.ops.${row.op}`, {
+            target,
+            defaultValue: target,
+        });
+    };
+    const confirm = () => void mutations
+        .undo(plan)
+        .then((next) => {
+        notify.success(t('plans.undoDone'));
+        onOpenChange(false);
+        onUndone?.(next);
+    })
+        .catch((error) => {
+        notify.error(error);
+        if (error instanceof ApiClientError && error.reason === 'UNDO_STALE')
+            void preview.refetch();
+        else
+            onOpenChange(false);
+    });
+    return (_jsx(AlertDialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(AlertDialogContent, { "data-testid": 'plan-undo-dialog', children: [_jsxs(AlertDialogHeader, { children: [_jsx(AlertDialogTitle, { children: t('plans.undoPreview.title') }), _jsx(AlertDialogDescription, { children: t('plans.undoPreview.description') })] }), preview.isPending && open ? (_jsxs("div", { className: 'space-y-2', children: [_jsx(Skeleton, { className: 'h-4 w-3/4' }), _jsx(Skeleton, { className: 'h-4 w-1/2' })] })) : preview.isError ? (_jsx("p", { className: 'text-sm text-destructive', children: preview.error instanceof ApiClientError
+                        ? t(`errors.${preview.error.reason ?? ''}`, {
+                            defaultValue: preview.error.message,
+                        })
+                        : t('plans.undoPreview.failed') })) : (_jsxs("div", { className: 'max-h-80 space-y-3 overflow-y-auto text-sm', children: [revert.length > 0 ? (_jsxs("section", { className: 'space-y-1', children: [_jsx("h3", { className: 'font-medium', children: t('plans.undoPreview.revertTitle', {
+                                        count: revert.length,
+                                    }) }), _jsx("ul", { className: 'list-disc space-y-0.5 pl-5', "data-testid": 'plan-undo-revert', children: revert.map((row) => (_jsx("li", { className: 'wrap-anywhere', children: what(row) }, `${row.rowId}:${row.op}`))) })] })) : (_jsx("p", { className: 'text-muted-foreground', children: t('plans.undoPreview.nothing') })), skipped.length > 0 ? (_jsxs("section", { className: 'space-y-1', children: [_jsx("h3", { className: 'font-medium', children: t('plans.undoPreview.skippedTitle', {
+                                        count: skipped.length,
+                                    }) }), _jsx("ul", { className: 'list-disc space-y-0.5 pl-5 text-muted-foreground', "data-testid": 'plan-undo-skipped', children: skipped.map((skip) => (_jsx("li", { className: 'wrap-anywhere', children: t('plans.undoPreview.skippedRow', {
+                                            position: skip.position + 1,
+                                            reason: t(`plans.skipped.${skip.reason}`),
+                                        }) }, skip.rowId))) })] })) : null] })), _jsxs(AlertDialogFooter, { children: [_jsx(AlertDialogCancel, { disabled: mutations.busy, children: t('actions.cancel') }), _jsxs(AlertDialogAction, { variant: 'destructive', disabled: mutations.busy || preview.isPending || revert.length === 0, "data-testid": 'plan-undo-confirm', onClick: (event) => {
+                                // Stay open until the server answered.
+                                event.preventDefault();
+                                confirm();
+                            }, children: [mutations.busy ? (_jsx(Spinner, { "data-icon": 'inline-start' })) : (_jsx(Undo2Icon, { "data-icon": 'inline-start' })), t('plans.undoPreview.confirm')] })] })] }) }));
+}
+//# sourceMappingURL=plan-undo.js.map

package/dist/client/kit/plans/plan-undo.js.map

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

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

@@ -0,0 +1,8 @@
+/** The hues of a plan's statuses and risk flags, as the projects plugin's tags show them. */
+import type { PlanRiskFlag, PlanStatus } from '../../../shared/plans.js';
+import type { PmTone } from '../../components/pm-tones.js';
+/** The hue of a plan's status or a risk flag: `grey`, `blue`, `violet`, `amber`, `green`, `slate`, `red` or `orange`. */
+export type PlanTone = PmTone;
+export declare const PLAN_STATUS_TONE: Readonly<Record<PlanStatus, PlanTone>>;
+export declare const FLAG_TONE: Readonly<Record<PlanRiskFlag, PlanTone>>;
+//# sourceMappingURL=tones.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tones.d.ts","sourceRoot":"","sources":["../../../../client/kit/plans/tones.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D,yHAAyH;AACzH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CASnE,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAM9D,CAAC"}

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

@@ -0,0 +1,18 @@
+export const PLAN_STATUS_TONE = {
+    pending: 'amber',
+    executing: 'blue',
+    executed: 'green',
+    failed: 'red',
+    stale: 'orange',
+    voided: 'slate',
+    expired: 'slate',
+    undone: 'slate',
+};
+export const FLAG_TONE = {
+    startsRun: 'violet',
+    finalStatus: 'red',
+    ownerChange: 'amber',
+    createsProject: 'amber',
+    agentExecutor: 'violet',
+};
+//# sourceMappingURL=tones.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tones.js","sourceRoot":"","sources":["../../../../client/kit/plans/tones.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,gBAAgB,GAA2C;IACtE,OAAO,EAAE,OAAO;IAChB,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,OAAO;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAA6C;IACjE,SAAS,EAAE,QAAQ;IACnB,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,OAAO;IACpB,cAAc,EAAE,OAAO;IACvB,aAAa,EAAE,QAAQ;CACxB,CAAC"}

package/dist/client/kit/plans/use-plan.d.ts

@@ -0,0 +1,24 @@
+import { type UseQueryResult } from '@tanstack/react-query';
+import type { EditPlanRequest, Plan, PlanRowCheck, PlanUndoPreview } from '../../../shared/plans.js';
+export type PlanAction = 'execute' | 'retry' | 'void';
+export interface PlanMutations {
+    readonly busy: boolean;
+    act(action: PlanAction, plan: Plan): Promise<Plan>;
+    edit(plan: Plan, request: EditPlanRequest): Promise<Plan>;
+    /** Undoes it at once (after the person saw the preview); answers it, undone. */
+    undo(plan: Plan): Promise<Plan>;
+}
+export declare function usePlanQuery(planId: string, initial?: Plan): UseQueryResult<Plan>;
+/**
+ * What undoing `plan` would do now (`POST /plans/{planId}/undo` with `dryRun`), asked afresh each time `enabled`
+ * turns on and never cached.
+ */
+export declare function usePlanUndoPreview(planId: string, enabled: boolean): UseQueryResult<PlanUndoPreview>;
+/**
+ * The plan actions as mutations: each puts the plan the server answers into the cache, an execution or an undo
+ * refreshes issues and projects, and a conflict (someone acted meanwhile) reloads the plan.
+ */
+export declare function usePlanMutations(): PlanMutations;
+/** The per-row checks of a refused plan (`PLAN_INVALID` with `metadata.rows`), in row order, or null for any other error. */
+export declare function invalidRows(error: unknown): readonly PlanRowCheck[] | null;
+//# sourceMappingURL=use-plan.d.ts.map

package/dist/client/kit/plans/use-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-plan.d.ts","sourceRoot":"","sources":["../../../../client/kit/plans/use-plan.ts"],"names":[],"mappings":"AAMA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EACV,eAAe,EACf,IAAI,EACJ,YAAY,EACZ,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAclC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,gFAAgF;IAChF,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,IAAI,GACb,cAAc,CAAC,IAAI,CAAC,CAQtB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,GACf,cAAc,CAAC,eAAe,CAAC,CAUjC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAkDhD;AAED,6HAA6H;AAC7H,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,YAAY,EAAE,GAAG,IAAI,CAK1E"}

package/dist/client/kit/plans/use-plan.js

@@ -0,0 +1,102 @@
+/**
+ * One plan, read and acted on: the query, and the actions as mutations that put the plan the server answers into
+ * the cache. Acting on a plan can change issues and projects, so those are refreshed too; a conflict (someone acted
+ * meanwhile) reloads the plan.
+ */
+import { ApiClientError } from '@nocobase/app-client';
+import { useMutation, useQuery, useQueryClient, } from '@tanstack/react-query';
+import { pmKeys } from '../../api/keys.js';
+import { planKeys, usePlanApi } from './api.js';
+import { errorMetadata } from '../../hooks/use-notify.js';
+/** Codes after which the plan shown is out of date. */
+const RELOAD_CODES = new Set([
+    'REVISION_CONFLICT',
+    'PLAN_NOT_OPEN',
+    'PLAN_EXPIRED',
+    'UNDO_EXPIRED',
+    'NOTHING_TO_UNDO',
+]);
+export function usePlanQuery(planId, initial) {
+    const api = usePlanApi();
+    return useQuery({
+        queryKey: planKeys.plan(planId),
+        queryFn: () => api.plan(planId),
+        enabled: planId !== '',
+        ...(initial ? { initialData: initial } : {}),
+    });
+}
+/**
+ * What undoing `plan` would do now (`POST /plans/{planId}/undo` with `dryRun`), asked afresh each time `enabled`
+ * turns on and never cached.
+ */
+export function usePlanUndoPreview(planId, enabled) {
+    const api = usePlanApi();
+    return useQuery({
+        queryKey: [...planKeys.plan(planId), 'undo-preview'],
+        queryFn: () => api.previewUndo(planId),
+        enabled,
+        staleTime: 0,
+        gcTime: 0,
+        retry: false,
+    });
+}
+/**
+ * The plan actions as mutations: each puts the plan the server answers into the cache, an execution or an undo
+ * refreshes issues and projects, and a conflict (someone acted meanwhile) reloads the plan.
+ */
+export function usePlanMutations() {
+    const api = usePlanApi();
+    const queryClient = useQueryClient();
+    const store = (plan) => {
+        queryClient.setQueryData(planKeys.plan(plan.id), plan);
+        void queryClient.invalidateQueries({
+            queryKey: [...planKeys.all, 'list'],
+        });
+    };
+    const failed = (plan) => (error) => {
+        if (error instanceof ApiClientError && RELOAD_CODES.has(error.reason ?? ''))
+            void queryClient.invalidateQueries({
+                queryKey: planKeys.plan(plan.id),
+            });
+    };
+    const changedWork = () => {
+        for (const queryKey of [pmKeys.issues, ['pm', 'issue'], pmKeys.projects])
+            void queryClient.invalidateQueries({ queryKey });
+    };
+    const act = useMutation({
+        mutationFn: ({ action, plan }) => api.act(plan.id, action, plan.revision),
+        onSuccess: (next, { action }) => {
+            store(next);
+            if (action === 'execute')
+                changedWork();
+        },
+        onError: (error, { plan }) => failed(plan)(error),
+    });
+    const edit = useMutation({
+        mutationFn: ({ plan, request }) => api.edit(plan.id, request),
+        onSuccess: store,
+        onError: (error, { plan }) => failed(plan)(error),
+    });
+    const undo = useMutation({
+        mutationFn: (plan) => api.undo(plan.id),
+        onSuccess: (next) => {
+            store(next);
+            changedWork();
+        },
+        onError: (error, plan) => failed(plan)(error),
+    });
+    return {
+        busy: act.isPending || edit.isPending || undo.isPending,
+        act: (action, plan) => act.mutateAsync({ action, plan }),
+        edit: (plan, request) => edit.mutateAsync({ plan, request }),
+        undo: (plan) => undo.mutateAsync(plan),
+    };
+}
+/** The per-row checks of a refused plan (`PLAN_INVALID` with `metadata.rows`), in row order, or null for any other error. */
+export function invalidRows(error) {
+    if (!(error instanceof ApiClientError) || error.reason !== 'PLAN_INVALID')
+        return null;
+    const rows = errorMetadata(error)?.rows;
+    return Array.isArray(rows) ? rows : null;
+}
+//# sourceMappingURL=use-plan.js.map

package/dist/client/kit/plans/use-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-plan.js","sourceRoot":"","sources":["../../../../client/kit/plans/use-plan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,cAAc,GAEf,MAAM,uBAAuB,CAAC;AAQ/B,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,uDAAuD;AACvD,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC;IAChD,mBAAmB;IACnB,eAAe;IACf,cAAc;IACd,cAAc;IACd,iBAAiB;CAClB,CAAC,CAAC;AAYH,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,OAAc;IAEd,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,OAAO,QAAQ,CAAC;QACd,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAC/B,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;QAC/B,OAAO,EAAE,MAAM,KAAK,EAAE;QACtB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAc,EACd,OAAgB;IAEhB,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,OAAO,QAAQ,CAAC;QACd,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;QACpD,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC;QACtC,OAAO;QACP,SAAS,EAAE,CAAC;QACZ,MAAM,EAAE,CAAC;QACT,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,CAAC,IAAU,EAAE,EAAE;QAC3B,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACvD,KAAK,WAAW,CAAC,iBAAiB,CAAC;YACjC,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;SACpC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,IAAU,EAAE,EAAE,CAAC,CAAC,KAAc,EAAE,EAAE;QAChD,IAAI,KAAK,YAAY,cAAc,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;YACzE,KAAK,WAAW,CAAC,iBAAiB,CAAC;gBACjC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;aACjC,CAAC,CAAC;IACP,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,KAAK,MAAM,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;YACtE,KAAK,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrD,CAAC,CAAC;IAEF,MAAM,GAAG,GAAG,WAAW,CAAC;QACtB,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAsC,EAAE,EAAE,CACnE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;QACzC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;YAC9B,KAAK,CAAC,IAAI,CAAC,CAAC;YACZ,IAAI,MAAM,KAAK,SAAS;gBAAE,WAAW,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;KAClD,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,WAAW,CAAC;QACvB,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAA4C,EAAE,EAAE,CAC1E,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;QAC5B,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;KAClD,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,WAAW,CAAC;QACvB,UAAU,EAAE,CAAC,IAAU,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YAClB,KAAK,CAAC,IAAI,CAAC,CAAC;YACZ,WAAW,EAAE,CAAC;QAChB,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;KAC9C,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS;QACvD,GAAG,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACxD,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC5D,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;KACvC,CAAC;AACJ,CAAC;AAED,6HAA6H;AAC7H,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,CAAC,CAAC,KAAK,YAAY,cAAc,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,cAAc;QACvE,OAAO,IAAI,CAAC;IACd,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC;IACxC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAuB,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC"}

package/dist/client/kit.d.ts

@@ -0,0 +1,68 @@
+export { StatusEventsContext, type StatusEventUI, } from './lib/status-events.js';
+/** How a queued request to AI says why it waits, such as with the agents plugin's `formatRunWait`. */
+export { IntakeWaitFormatContext, type IntakeWait, type IntakeWaitFormat, } from './lib/intake-wait.js';
+import { DataTable as BaseDataTable } from './components/data-table.js';
+import { PmExpandableTextarea as BaseExpandableTextarea } from './components/pm-expandable-textarea.js';
+import { PmStatusBadge as BaseStatusBadge } from './components/pm-badges.js';
+import { PmMultiSelect as BaseMultiSelect } from './components/pm-multi-select.js';
+import { PmDetailSkeleton as BaseDetailSkeleton, PmEmpty as BaseEmpty, PmListSkeleton as BaseListSkeleton, PmLoadError as BaseLoadError } from './components/pm-states.js';
+import { PmTag as BaseTag } from './components/pm-tag.js';
+import { PmApiKeyTag as BaseApiKeyTag } from './components/pm-api-key-tag.js';
+import { UnsavedChangesBoundary as BaseUnsavedChangesBoundary } from './components/unsaved-changes.js';
+import { InvitationsSection as BaseInvitations } from './pages/config/members/invitations-section.js';
+import { InviteDialog as BaseInviteDialog } from './pages/config/members/invite-dialog.js';
+import { PlanListItem as BasePlanListItem } from './kit/plans/plan-list-item.js';
+import { SectionHeading as BaseSectionHeading } from './pages/config/section-heading.js';
+import { SettingsPageHeader as BaseSettingsPageHeader } from './pages/config/settings-page-header.js';
+import { NewIssueButton as BaseNewIssueButton } from './pages/issues/new-issue-button.js';
+import { PmShortcuts as BasePmShortcuts } from './components/pm-shortcuts.js';
+export declare const DataTable: typeof BaseDataTable;
+/** A compact text area for long text that expands on demand. */
+export declare const PmExpandableTextarea: typeof BaseExpandableTextarea;
+export declare const PmMultiSelect: typeof BaseMultiSelect;
+export declare const PmStatusBadge: typeof BaseStatusBadge;
+export declare const PmDetailSkeleton: typeof BaseDetailSkeleton;
+export declare const PmEmpty: typeof BaseEmpty;
+export declare const PmListSkeleton: typeof BaseListSkeleton;
+export declare const PmLoadError: typeof BaseLoadError;
+export declare const PmTag: typeof BaseTag;
+/** "API key", beside the name of an actor that is an organization's API key. */
+export declare const PmApiKeyTag: typeof BaseApiKeyTag;
+export declare const SectionHeading: typeof BaseSectionHeading;
+/** A settings page's `h1`, description and actions, with the read-only notice when the viewer may not change it. */
+export declare const SettingsPageHeader: typeof BaseSettingsPageHeader;
+export declare const InvitationsSection: typeof BaseInvitations;
+export declare const InviteDialog: typeof BaseInviteDialog;
+export declare const UnsavedChangesBoundary: typeof BaseUnsavedChangesBoundary;
+/** One plan in a list: title, status, source, proposer and time, linking to its page or selecting it. */
+export declare const PlanListItem: typeof BasePlanListItem;
+/** "New issue": opens the `new` dialog under `/issues`, with the AI and manual tabs. */
+export declare const NewIssueButton: typeof BaseNewIssueButton;
+/** The issues pages' keyboard shortcuts (`C` new issue, ⌘K search) and their help. */
+export declare const PmShortcuts: typeof BasePmShortcuts;
+export { useNewIssueShortcut } from './components/use-new-issue-shortcut.js';
+export type { PlanListItemProps } from './kit/plans/plan-list-item.js';
+/**
+ * Operation plans, headless: the UI Library's `plan-card` block draws the card, the confirmation, the undo preview
+ * and the editor over these. Reading and acting (`usePlanQuery`, `usePlanMutations`, `usePlanUndoPreview`), the names
+ * and choices a plan needs (`usePlanLookup`, `usePlanIssue`, `useCreateLabel`), and the words this plugin keeps for it
+ * (`usePlanRowTitle`, `usePlanValueText`, `usePlanErrorText`, `usePlanWording`). The plan as pure data is
+ * `client/plan-model`, re-exported here.
+ */
+export * from './plan-model.js';
+export { PlanApi, planKeys, usePlanApi } from './kit/plans/api.js';
+export { invalidRows, usePlanMutations, usePlanQuery, usePlanUndoPreview, type PlanAction, type PlanMutations, } from './kit/plans/use-plan.js';
+export { executorOf, useCreateLabel, usePlanIssue, usePlanLookup, usePlanValueText, type PlanLookup, } from './kit/plans/lookup.js';
+export type { ExecutorOption } from './components/pm-executor-select.js';
+export { PlanWordingContext, planErrorReason, rowTitle, usePlanErrorText, usePlanRowTitle, usePlanWording, type PlanErrorText, type PlanWorder, type PlanWording, } from './kit/plans/plan-text.js';
+export { IntakeAgentSlotContext, PageContextSinkContext, createPageContextStore, usePageContextEntries, usePageContextSource, type IntakeAgentSlotFill, type IntakeAgentSlotProps, type PageContextEntry, type PageContextKind, type PageContextSink, type PageContextStore, } from './kit/page-context.js';
+export { IntakeAgentSlot, PageContextProvider } from './kit/page-slots.js';
+export { useViewer } from './hooks/use-viewer.js';
+export { canManageProject, canUseSetting } from './lib/permissions.js';
+export { pmKeys } from './api/keys.js';
+export { announcedIssueIds, changedIssueSegments, isIssueRead, } from './api/changed-issues.js';
+export { usePmApi } from './hooks/use-pm-api.js';
+export { useApiKeyActors } from './hooks/use-api-key-actors.js';
+export { PmDescriptionImage } from './components/pm-description-image.js';
+export { IntakeDraftProvider, useIntakeDraft, emptyIntakeDraft, } from './kit/intake-draft.js';
+//# sourceMappingURL=kit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../../client/kit.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAC;AAChC,sGAAsG;AACtG,OAAO,EACL,uBAAuB,EACvB,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,oBAAoB,IAAI,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACxG,OAAO,EAAE,aAAa,IAAI,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,aAAa,IAAI,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,EACL,gBAAgB,IAAI,kBAAkB,EACtC,OAAO,IAAI,SAAS,EACpB,cAAc,IAAI,gBAAgB,EAClC,WAAW,IAAI,aAAa,EAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,IAAI,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,IAAI,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AACvG,OAAO,EAAE,kBAAkB,IAAI,eAAe,EAAE,MAAM,+CAA+C,CAAC;AACtG,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3F,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACzF,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACtG,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC1F,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAK9E,eAAO,MAAM,SAAS,EAAE,OAAO,aAAoC,CAAC;AACpE,gEAAgE;AAChE,eAAO,MAAM,oBAAoB,EAAE,OAAO,sBAEzC,CAAC;AACF,eAAO,MAAM,aAAa,EAAE,OAAO,eAAwC,CAAC;AAC5E,eAAO,MAAM,aAAa,EAAE,OAAO,eAAwC,CAAC;AAC5E,eAAO,MAAM,gBAAgB,EAAE,OAAO,kBACX,CAAC;AAC5B,eAAO,MAAM,OAAO,EAAE,OAAO,SAA4B,CAAC;AAC1D,eAAO,MAAM,cAAc,EAAE,OAAO,gBAA0C,CAAC;AAC/E,eAAO,MAAM,WAAW,EAAE,OAAO,aAAoC,CAAC;AACtE,eAAO,MAAM,KAAK,EAAE,OAAO,OAAwB,CAAC;AACpD,gFAAgF;AAChF,eAAO,MAAM,WAAW,EAAE,OAAO,aAAoC,CAAC;AACtE,eAAO,MAAM,cAAc,EAAE,OAAO,kBACT,CAAC;AAC5B,oHAAoH;AACpH,eAAO,MAAM,kBAAkB,EAAE,OAAO,sBAEvC,CAAC;AACF,eAAO,MAAM,kBAAkB,EAAE,OAAO,eAChB,CAAC;AACzB,eAAO,MAAM,YAAY,EAAE,OAAO,gBAA0C,CAAC;AAC7E,eAAO,MAAM,sBAAsB,EAAE,OAAO,0BAE3C,CAAC;AACF,yGAAyG;AACzG,eAAO,MAAM,YAAY,EAAE,OAAO,gBAA0C,CAAC;AAC7E,wFAAwF;AACxF,eAAO,MAAM,cAAc,EAAE,OAAO,kBACT,CAAC;AAC5B,sFAAsF;AACtF,eAAO,MAAM,WAAW,EAAE,OAAO,eAAwC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC7E,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE;;;;;;GAMG;AACH,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,KAAK,UAAU,GAChB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,GACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE1E,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,gBAAgB,GACjB,MAAM,uBAAuB,CAAC"}

package/dist/client/kit.js

@@ -0,0 +1,74 @@
+/**
+ * Components and hooks the application reuses on its own pages (such as an application's members, roles and inbox), so they look and behave
+ * like the plugin's. Components that translate their own text are bound to this plugin's namespace; the text an
+ * application passes in stays its own.
+ */
+import { withNamespace } from '@nocobase/i18n/client';
+export { StatusEventsContext, } from './lib/status-events.js';
+/** How a queued request to AI says why it waits, such as with the agents plugin's `formatRunWait`. */
+export { IntakeWaitFormatContext, } from './lib/intake-wait.js';
+import { ACCESS_NAMESPACE } from '../shared/access.js';
+import { DataTable as BaseDataTable } from './components/data-table.js';
+import { PmExpandableTextarea as BaseExpandableTextarea } from './components/pm-expandable-textarea.js';
+import { PmStatusBadge as BaseStatusBadge } from './components/pm-badges.js';
+import { PmMultiSelect as BaseMultiSelect } from './components/pm-multi-select.js';
+import { PmDetailSkeleton as BaseDetailSkeleton, PmEmpty as BaseEmpty, PmListSkeleton as BaseListSkeleton, PmLoadError as BaseLoadError, } from './components/pm-states.js';
+import { PmTag as BaseTag } from './components/pm-tag.js';
+import { PmApiKeyTag as BaseApiKeyTag } from './components/pm-api-key-tag.js';
+import { UnsavedChangesBoundary as BaseUnsavedChangesBoundary } from './components/unsaved-changes.js';
+import { InvitationsSection as BaseInvitations } from './pages/config/members/invitations-section.js';
+import { InviteDialog as BaseInviteDialog } from './pages/config/members/invite-dialog.js';
+import { PlanListItem as BasePlanListItem } from './kit/plans/plan-list-item.js';
+import { SectionHeading as BaseSectionHeading } from './pages/config/section-heading.js';
+import { SettingsPageHeader as BaseSettingsPageHeader } from './pages/config/settings-page-header.js';
+import { NewIssueButton as BaseNewIssueButton } from './pages/issues/new-issue-button.js';
+import { PmShortcuts as BasePmShortcuts } from './components/pm-shortcuts.js';
+const bound = (component) => withNamespace(ACCESS_NAMESPACE, component);
+export const DataTable = bound(BaseDataTable);
+/** A compact text area for long text that expands on demand. */
+export const PmExpandableTextarea = bound(BaseExpandableTextarea);
+export const PmMultiSelect = bound(BaseMultiSelect);
+export const PmStatusBadge = bound(BaseStatusBadge);
+export const PmDetailSkeleton = bound(BaseDetailSkeleton);
+export const PmEmpty = bound(BaseEmpty);
+export const PmListSkeleton = bound(BaseListSkeleton);
+export const PmLoadError = bound(BaseLoadError);
+export const PmTag = bound(BaseTag);
+/** "API key", beside the name of an actor that is an organization's API key. */
+export const PmApiKeyTag = bound(BaseApiKeyTag);
+export const SectionHeading = bound(BaseSectionHeading);
+/** A settings page's `h1`, description and actions, with the read-only notice when the viewer may not change it. */
+export const SettingsPageHeader = bound(BaseSettingsPageHeader);
+export const InvitationsSection = bound(BaseInvitations);
+export const InviteDialog = bound(BaseInviteDialog);
+export const UnsavedChangesBoundary = bound(BaseUnsavedChangesBoundary);
+/** One plan in a list: title, status, source, proposer and time, linking to its page or selecting it. */
+export const PlanListItem = bound(BasePlanListItem);
+/** "New issue": opens the `new` dialog under `/issues`, with the AI and manual tabs. */
+export const NewIssueButton = bound(BaseNewIssueButton);
+/** The issues pages' keyboard shortcuts (`C` new issue, ⌘K search) and their help. */
+export const PmShortcuts = bound(BasePmShortcuts);
+export { useNewIssueShortcut } from './components/use-new-issue-shortcut.js';
+/**
+ * Operation plans, headless: the UI Library's `plan-card` block draws the card, the confirmation, the undo preview
+ * and the editor over these. Reading and acting (`usePlanQuery`, `usePlanMutations`, `usePlanUndoPreview`), the names
+ * and choices a plan needs (`usePlanLookup`, `usePlanIssue`, `useCreateLabel`), and the words this plugin keeps for it
+ * (`usePlanRowTitle`, `usePlanValueText`, `usePlanErrorText`, `usePlanWording`). The plan as pure data is
+ * `client/plan-model`, re-exported here.
+ */
+export * from './plan-model.js';
+export { PlanApi, planKeys, usePlanApi } from './kit/plans/api.js';
+export { invalidRows, usePlanMutations, usePlanQuery, usePlanUndoPreview, } from './kit/plans/use-plan.js';
+export { executorOf, useCreateLabel, usePlanIssue, usePlanLookup, usePlanValueText, } from './kit/plans/lookup.js';
+export { PlanWordingContext, planErrorReason, rowTitle, usePlanErrorText, usePlanRowTitle, usePlanWording, } from './kit/plans/plan-text.js';
+export { IntakeAgentSlotContext, PageContextSinkContext, createPageContextStore, usePageContextEntries, usePageContextSource, } from './kit/page-context.js';
+export { IntakeAgentSlot, PageContextProvider } from './kit/page-slots.js';
+export { useViewer } from './hooks/use-viewer.js';
+export { canManageProject, canUseSetting } from './lib/permissions.js';
+export { pmKeys } from './api/keys.js';
+export { announcedIssueIds, changedIssueSegments, isIssueRead, } from './api/changed-issues.js';
+export { usePmApi } from './hooks/use-pm-api.js';
+export { useApiKeyActors } from './hooks/use-api-key-actors.js';
+export { PmDescriptionImage } from './components/pm-description-image.js';
+export { IntakeDraftProvider, useIntakeDraft, emptyIntakeDraft, } from './kit/intake-draft.js';
+//# sourceMappingURL=kit.js.map

package/dist/client/kit.js.map

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

package/dist/client/lib/format.d.ts

@@ -0,0 +1,22 @@
+import { type Locale } from 'date-fns/locale';
+export interface PmFormatters {
+    /** Date and time in the current language, or "—" for an empty value. */
+    readonly dateTime: (iso: string | null | undefined) => string;
+    /** Calendar date only, for start and due dates. */
+    readonly date: (iso: string | null | undefined) => string;
+    /** Time of day only, for transcript rows. */
+    readonly time: (iso: string | null | undefined) => string;
+    /** "3 minutes ago" in the current language. */
+    readonly relative: (iso: string | null | undefined) => string;
+}
+/** Formatters that follow the interface language (created per locale, not per render). */
+export declare function usePmFormatters(): PmFormatters;
+/** Seconds between two instants as "1m 05s" style text, or null when either end is missing. */
+export declare function durationText(from: string | null | undefined, to: string | null | undefined): string | null;
+/** A calendar day as the `YYYY-MM-DD` string the API stores for start and due dates. */
+export declare function toDateOnly(date: Date | undefined): string | null;
+/** The inverse of `toDateOnly`, also accepting a full ISO timestamp. */
+export declare function fromDateOnly(value: string | null | undefined): Date | undefined;
+/** The `date-fns` locale for the interface language, for `DatePicker` and `format`. */
+export declare function useDateFnsLocale(): Locale;
+//# sourceMappingURL=format.d.ts.map

package/dist/client/lib/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../client/lib/format.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAc,MAAM,iBAAiB,CAAC;AAG1D,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,MAAM,CAAC;IAC9D,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,MAAM,CAAC;IAC1D,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,MAAM,CAAC;IAC1D,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,MAAM,CAAC;CAC/D;AAYD,0FAA0F;AAC1F,wBAAgB,eAAe,IAAI,YAAY,CAkD9C;AAED,+FAA+F;AAC/F,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC5B,MAAM,GAAG,IAAI,CAUf;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAKhE;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,IAAI,GAAG,SAAS,CAKlB;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC"}