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

package/dist/client/lib/format.js

@@ -0,0 +1,103 @@
+import { useLocale } from '@nocobase/i18n/client';
+import { enUS, zhCN } from 'date-fns/locale';
+import { useMemo } from 'react';
+const UNITS = [
+    ['year', 365 * 24 * 3600],
+    ['month', 30 * 24 * 3600],
+    ['week', 7 * 24 * 3600],
+    ['day', 24 * 3600],
+    ['hour', 3600],
+    ['minute', 60],
+    ['second', 1],
+];
+/** Formatters that follow the interface language (created per locale, not per render). */
+export function usePmFormatters() {
+    const { locale } = useLocale();
+    return useMemo(() => {
+        const dateTime = new Intl.DateTimeFormat(locale, {
+            dateStyle: 'medium',
+            timeStyle: 'short',
+        });
+        const time = new Intl.DateTimeFormat(locale, { timeStyle: 'medium' });
+        const day = new Intl.DateTimeFormat(locale, { dateStyle: 'medium' });
+        const relative = new Intl.RelativeTimeFormat(locale, { numeric: 'auto' });
+        const parse = (iso) => {
+            if (!iso)
+                return null;
+            const date = new Date(iso);
+            return Number.isNaN(date.getTime()) ? null : date;
+        };
+        // A date-only value ("2026-10-01") is a calendar day, not UTC midnight: read it in local time so it does not
+        // show as the previous day west of Greenwich.
+        const parseDay = (iso) => {
+            if (iso && /^\d{4}-\d{2}-\d{2}$/u.test(iso)) {
+                const [year, month, dayOfMonth] = iso.split('-').map(Number);
+                return new Date(year, month - 1, dayOfMonth);
+            }
+            return parse(iso);
+        };
+        return {
+            dateTime: (iso) => {
+                const date = parse(iso);
+                return date ? dateTime.format(date) : '—';
+            },
+            date: (iso) => {
+                const date = parseDay(iso);
+                return date ? day.format(date) : '—';
+            },
+            time: (iso) => {
+                const date = parse(iso);
+                return date ? time.format(date) : '—';
+            },
+            relative: (iso) => {
+                const date = parse(iso);
+                if (!date)
+                    return '—';
+                const seconds = Math.round((date.getTime() - Date.now()) / 1000);
+                for (const [unit, size] of UNITS) {
+                    if (Math.abs(seconds) >= size || unit === 'second') {
+                        return relative.format(Math.round(seconds / size), unit);
+                    }
+                }
+                return relative.format(0, 'second');
+            },
+        };
+    }, [locale]);
+}
+/** Seconds between two instants as "1m 05s" style text, or null when either end is missing. */
+export function durationText(from, to) {
+    if (!from || !to)
+        return null;
+    const ms = new Date(to).getTime() - new Date(from).getTime();
+    if (!Number.isFinite(ms) || ms < 0)
+        return null;
+    const total = Math.round(ms / 1000);
+    const minutes = Math.floor(total / 60);
+    const seconds = total % 60;
+    return minutes > 0
+        ? `${minutes}m ${String(seconds).padStart(2, '0')}s`
+        : `${seconds}s`;
+}
+/** A calendar day as the `YYYY-MM-DD` string the API stores for start and due dates. */
+export function toDateOnly(date) {
+    if (!date)
+        return null;
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    return `${date.getFullYear()}-${month}-${day}`;
+}
+/** The inverse of `toDateOnly`, also accepting a full ISO timestamp. */
+export function fromDateOnly(value) {
+    if (!value)
+        return undefined;
+    const match = /^(\d{4})-(\d{2})-(\d{2})/u.exec(value);
+    if (!match)
+        return undefined;
+    return new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3]));
+}
+/** The `date-fns` locale for the interface language, for `DatePicker` and `format`. */
+export function useDateFnsLocale() {
+    const { locale } = useLocale();
+    return locale.startsWith('zh') ? zhCN : enUS;
+}
+//# sourceMappingURL=format.js.map

package/dist/client/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../client/lib/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAe,IAAI,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAahC,MAAM,KAAK,GAAqD;IAC9D,CAAC,MAAM,EAAE,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC;IACzB,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACzB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IACvB,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC;IAClB,CAAC,MAAM,EAAE,IAAI,CAAC;IACd,CAAC,QAAQ,EAAE,EAAE,CAAC;IACd,CAAC,QAAQ,EAAE,CAAC,CAAC;CACd,CAAC;AAEF,0FAA0F;AAC1F,MAAM,UAAU,eAAe;IAC7B,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;IAC/B,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE;YAC/C,SAAS,EAAE,QAAQ;YACnB,SAAS,EAAE,OAAO;SACnB,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;QACtE,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrE,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1E,MAAM,KAAK,GAAG,CAAC,GAA8B,EAAe,EAAE;YAC5D,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC;YACtB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3B,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,CAAC,CAAC;QACF,6GAA6G;QAC7G,8CAA8C;QAC9C,MAAM,QAAQ,GAAG,CAAC,GAA8B,EAAe,EAAE;YAC/D,IAAI,GAAG,IAAI,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5C,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC7D,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;YAC/C,CAAC;YACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC,CAAC;QACF,OAAO;YACL,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;gBAChB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;gBACxB,OAAO,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAC5C,CAAC;YACD,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;gBACZ,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC3B,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YACvC,CAAC;YACD,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;gBACZ,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;gBACxB,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YACxC,CAAC;YACD,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;gBAChB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;gBACxB,IAAI,CAAC,IAAI;oBAAE,OAAO,GAAG,CAAC;gBACtB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;gBACjE,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;oBACjC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;wBACnD,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;oBAC3D,CAAC;gBACH,CAAC;gBACD,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YACtC,CAAC;SACF,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AACf,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,YAAY,CAC1B,IAA+B,EAC/B,EAA6B;IAE7B,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,KAAK,GAAG,EAAE,CAAC;IAC3B,OAAO,OAAO,GAAG,CAAC;QAChB,CAAC,CAAC,GAAG,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG;QACpD,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC;AACpB,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,IAAsB;IAC/C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;AACjD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,YAAY,CAC1B,KAAgC;IAEhC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,KAAK,GAAG,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,gBAAgB;IAC9B,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;IAC/B,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC"}

package/dist/client/lib/intake-wait.d.ts

@@ -0,0 +1,16 @@
+/**
+ * How a queued request to AI says why it waits, given by the application. The organiser reports a reason code and the
+ * values its words need (`IntakeAiProgress.waitReason`, `waitParams`) and this plugin knows none of them: an
+ * application with the agents plugin passes that plugin's `formatRunWait` with the page's `t`. Without it, a request
+ * reads as waiting, naming the code.
+ */
+import { type Context, type ReactNode } from 'react';
+/** A wait as the organiser reports it. */
+export interface IntakeWait {
+    readonly reason: string;
+    readonly params?: Readonly<Record<string, string | number | readonly string[]>>;
+}
+export type IntakeWaitFormat = (wait: IntakeWait) => ReactNode;
+export declare const IntakeWaitFormatContext: Context<IntakeWaitFormat | null>;
+export declare function useIntakeWaitFormat(): IntakeWaitFormat | null;
+//# sourceMappingURL=intake-wait.d.ts.map

package/dist/client/lib/intake-wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake-wait.d.ts","sourceRoot":"","sources":["../../../client/lib/intake-wait.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAA6B,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEhF,0CAA0C;AAC1C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CACxB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CACpD,CAAC;CACH;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS,CAAC;AAE/D,eAAO,MAAM,uBAAuB,EAAE,OAAO,CAAC,gBAAgB,GAAG,IAAI,CACvB,CAAC;AAE/C,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAE7D"}

package/dist/client/lib/intake-wait.js

@@ -0,0 +1,12 @@
+/**
+ * How a queued request to AI says why it waits, given by the application. The organiser reports a reason code and the
+ * values its words need (`IntakeAiProgress.waitReason`, `waitParams`) and this plugin knows none of them: an
+ * application with the agents plugin passes that plugin's `formatRunWait` with the page's `t`. Without it, a request
+ * reads as waiting, naming the code.
+ */
+import { createContext, useContext } from 'react';
+export const IntakeWaitFormatContext = createContext(null);
+export function useIntakeWaitFormat() {
+    return useContext(IntakeWaitFormatContext);
+}
+//# sourceMappingURL=intake-wait.js.map

package/dist/client/lib/intake-wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake-wait.js","sourceRoot":"","sources":["../../../client/lib/intake-wait.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAgC,MAAM,OAAO,CAAC;AAYhF,MAAM,CAAC,MAAM,uBAAuB,GAClC,aAAa,CAA0B,IAAI,CAAC,CAAC;AAE/C,MAAM,UAAU,mBAAmB;IACjC,OAAO,UAAU,CAAC,uBAAuB,CAAC,CAAC;AAC7C,CAAC"}

package/dist/client/lib/kind-order.d.ts

@@ -0,0 +1,4 @@
+/** People first, other registered kinds next, the system last. */
+export declare function orderKinds(keys: Iterable<string>): string[];
+export declare function isBuiltInKind(key: string): boolean;
+//# sourceMappingURL=kind-order.d.ts.map

package/dist/client/lib/kind-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-order.d.ts","sourceRoot":"","sources":["../../../client/lib/kind-order.ts"],"names":[],"mappings":"AAGA,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAM3D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD"}

package/dist/client/lib/kind-order.js

@@ -0,0 +1,11 @@
+/** Ordering and built-in checks for kinds (`shared/kinds.ts`), without hooks; `lib/kinds.ts` adds the hooks. */
+import { BUILTIN_KINDS, SYSTEM_KIND, USER_KIND } from '../../shared/kinds.js';
+/** People first, other registered kinds next, the system last. */
+export function orderKinds(keys) {
+    const rank = (key) => key === USER_KIND ? 0 : key === SYSTEM_KIND ? 2 : 1;
+    return [...new Set(keys)].sort((a, b) => rank(a) - rank(b) || a.localeCompare(b));
+}
+export function isBuiltInKind(key) {
+    return BUILTIN_KINDS.includes(key);
+}
+//# sourceMappingURL=kind-order.js.map

package/dist/client/lib/kind-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-order.js","sourceRoot":"","sources":["../../../client/lib/kind-order.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAChH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE9E,kEAAkE;AAClE,MAAM,UAAU,UAAU,CAAC,IAAsB;IAC/C,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE,CAC3B,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAC5B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAClD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC"}

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

@@ -0,0 +1,13 @@
+import { type KindInfo } from '../../shared/kinds.js';
+import type { ExecutorOption } from '../components/pm-executor-select.js';
+export { isBuiltInKind, orderKinds } from './kind-order.js';
+/** The registered kinds, built-in ones first; the built-in two until the viewer has loaded. */
+export declare function useKinds(): readonly KindInfo[];
+/** A kind's name: the built-in ones from this plugin's locale (`actor.*`), the others from their registered title. */
+export declare function useKindLabel(): (key: string) => string;
+/**
+ * The executors of other kinds the viewer may give work to (agents, when the agents plugin registers them), for
+ * `PmExecutorSelect`'s `others`: each with a note when nothing can run its work now, or how much it is doing.
+ */
+export declare function useExecutorOptions(enabled?: boolean): readonly ExecutorOption[];
+//# sourceMappingURL=kinds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../../../client/lib/kinds.ts"],"names":[],"mappings":"AAUA,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAM1E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAO5D,+FAA+F;AAC/F,wBAAgB,QAAQ,IAAI,SAAS,QAAQ,EAAE,CAE9C;AAED,sHAAsH;AACtH,wBAAgB,YAAY,IAAI,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAWtD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,UAAO,GAAG,SAAS,cAAc,EAAE,CA4B5E"}

package/dist/client/lib/kinds.js

@@ -0,0 +1,69 @@
+/**
+ * The kinds of principal the server knows (`shared/kinds.ts`, `GET /api/projects/me`): `user` and `system` built in, more
+ * when another plugin registers them. Pages render actors, executors and mentions from this list rather than a fixed
+ * set; a kind the list lacks still shows, by its key.
+ */
+import { useTranslation } from '@nocobase/i18n/client';
+import { ACCESS_NAMESPACE } from '../../shared/access.js';
+import { useQuery } from '@tanstack/react-query';
+import { SYSTEM_KIND, USER_KIND } from '../../shared/kinds.js';
+import { pmKeys } from '../api/keys.js';
+import { usePmApi } from '../hooks/use-pm-api.js';
+import { useViewer } from '../hooks/use-viewer.js';
+import { isBuiltInKind } from './kind-order.js';
+import { usePrincipalName } from './principal-name.js';
+export { isBuiltInKind, orderKinds } from './kind-order.js';
+const BUILT_IN = [
+    { key: USER_KIND, title: null, executor: true, mentionable: true },
+    { key: SYSTEM_KIND, title: null, executor: false, mentionable: false },
+];
+/** The registered kinds, built-in ones first; the built-in two until the viewer has loaded. */
+export function useKinds() {
+    return useViewer()?.kinds ?? BUILT_IN;
+}
+/** A kind's name: the built-in ones from this plugin's locale (`actor.*`), the others from their registered title. */
+export function useKindLabel() {
+    const { t } = useTranslation(ACCESS_NAMESPACE);
+    const kinds = useKinds();
+    return (key) => {
+        if (isBuiltInKind(key))
+            return t(`actor.${key}`);
+        const title = kinds.find((kind) => kind.key === key)?.title;
+        if (!title)
+            return key;
+        return typeof title === 'string'
+            ? title
+            : t(title.key, { ns: title.ns, defaultValue: key });
+    };
+}
+/**
+ * The executors of other kinds the viewer may give work to (agents, when the agents plugin registers them), for
+ * `PmExecutorSelect`'s `others`: each with a note when nothing can run its work now, or how much it is doing.
+ */
+export function useExecutorOptions(enabled = true) {
+    const { t } = useTranslation(ACCESS_NAMESPACE);
+    const nameOf = usePrincipalName();
+    const api = usePmApi();
+    const hasOthers = useKinds().some((kind) => kind.executor && !isBuiltInKind(kind.key));
+    const candidates = useQuery({
+        queryKey: pmKeys.executors,
+        queryFn: () => api.executors(),
+        enabled: enabled && hasOthers,
+        staleTime: 30_000,
+    });
+    return (candidates.data ?? []).map((candidate) => {
+        const note = candidate.online === false
+            ? t('executor.offline')
+            : candidate.busy
+                ? t('executor.busy', { count: candidate.busy })
+                : undefined;
+        return {
+            type: candidate.type,
+            id: candidate.id,
+            name: nameOf(candidate),
+            ...(note ? { note } : {}),
+            ...(candidate.isDefault ? { isDefault: true } : {}),
+        };
+    });
+}
+//# sourceMappingURL=kinds.js.map

package/dist/client/lib/kinds.js.map

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

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

@@ -0,0 +1,25 @@
+/**
+ * Mentions in Markdown text: `[@Name](mention://<kind>/<id>)` names a principal of a kind (`lib/kinds.ts`), such as
+ * `mention://user/<id>` for a member, the same markup the server reads (`server/kernel/mentions.ts`).
+ */
+/** A kind's key. */
+export type MentionKind = string;
+/** The `<kind>` part of a mention URL. */
+export declare const MENTION_KIND_PATTERN = "[a-z][a-z0-9_]{1,31}";
+export interface MentionQuery {
+    /** Index of the `@` that opened the query. */
+    readonly start: number;
+    /** Text typed after the `@`, up to the caret. */
+    readonly query: string;
+}
+/**
+ * The `@query` the caret is completing, or null. An `@` opens a query only at the start of the text or after
+ * whitespace or an opening bracket, so an email address does not open the picker; whitespace ends it.
+ */
+export declare function findMentionQuery(text: string, caret: number): MentionQuery | null;
+/** Parses `mention://<kind>/<id>`, or null for any other URL. */
+export declare function parseMentionHref(href: string | undefined): {
+    readonly kind: MentionKind;
+    readonly id: string;
+} | null;
+//# sourceMappingURL=mentions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.d.ts","sourceRoot":"","sources":["../../../client/lib/mentions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAoB;AACpB,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,YAAY,GAAG,IAAI,CASrB;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAS5D"}

package/dist/client/lib/mentions.js

@@ -0,0 +1,33 @@
+/**
+ * Mentions in Markdown text: `[@Name](mention://<kind>/<id>)` names a principal of a kind (`lib/kinds.ts`), such as
+ * `mention://user/<id>` for a member, the same markup the server reads (`server/kernel/mentions.ts`).
+ */
+/** The `<kind>` part of a mention URL. */
+export const MENTION_KIND_PATTERN = '[a-z][a-z0-9_]{1,31}';
+/**
+ * The `@query` the caret is completing, or null. An `@` opens a query only at the start of the text or after
+ * whitespace or an opening bracket, so an email address does not open the picker; whitespace ends it.
+ */
+export function findMentionQuery(text, caret) {
+    const before = text.slice(0, caret);
+    const at = before.lastIndexOf('@');
+    if (at < 0)
+        return null;
+    const preceding = at === 0 ? '' : before[at - 1];
+    if (preceding !== '' && !/[\s([]/u.test(preceding ?? ''))
+        return null;
+    const query = before.slice(at + 1);
+    if (/\s/u.test(query) || query.length > 40)
+        return null;
+    return { start: at, query };
+}
+/** Parses `mention://<kind>/<id>`, or null for any other URL. */
+export function parseMentionHref(href) {
+    if (!href)
+        return null;
+    const match = new RegExp(`^mention://(${MENTION_KIND_PATTERN})/([^/?#\\s]+)$`, 'u').exec(href);
+    return match?.[1] && match[2]
+        ? { kind: match[1], id: decodeURIComponent(match[2]) }
+        : null;
+}
+//# sourceMappingURL=mentions.js.map

package/dist/client/lib/mentions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.js","sourceRoot":"","sources":["../../../client/lib/mentions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,0CAA0C;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAS3D;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,KAAa;IAEb,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,EAAE,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,SAAS,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACjD,IAAI,SAAS,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACtE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,IAAI,CAAC;IACxD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAC9B,IAAwB;IAExB,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,KAAK,GAAG,IAAI,MAAM,CACtB,eAAe,oBAAoB,iBAAiB,EACpD,GAAG,CACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QAC3B,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;QACtD,CAAC,CAAC,IAAI,CAAC;AACX,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * The server's rules for who may change what (`server/domains/*\/*.access.ts`), as the browser applies them: to hide
+ * or disable a control the server would refuse. They read the viewer's scope of each business action from
+ * `GET /api/projects/me`: `all` passes on every record, a set of users only where the record relates to one of them, `none`
+ * never. The server enforces every rule itself.
+ */
+import { type Business, type BusinessAction, type Scope, type SettingsAction, type SettingsItem } from '../../shared/access.js';
+import { type IssueComment } from '../../shared/comments.js';
+import type { IssueListItem } from '../../shared/issues.js';
+import type { Me } from '../../shared/members.js';
+import type { ProjectListItem } from '../../shared/projects.js';
+export type Viewer = Me;
+export declare function scopeOf<B extends Business>(viewer: Viewer | undefined, business: B, action: BusinessAction<B>): Scope;
+export declare function canUseSetting<S extends SettingsItem>(viewer: Viewer | undefined, item: S, action: SettingsAction<S>): boolean;
+/** Creating an issue: short of `all`, issues without a project or in a project the viewer sees. */
+export declare function canCreateIssues(viewer: Viewer | undefined): boolean;
+/** Every change to an issue needs `edit`; seeing the issue is its relation. */
+export declare function canEditIssues(viewer: Viewer | undefined): boolean;
+type IssueRelation = Pick<IssueListItem, 'ownerUserId' | 'project'>;
+/** Moving an issue into a `done` or `closed` status. */
+export declare function canCloseIssue(viewer: Viewer | undefined, issue: IssueRelation): boolean;
+export declare function canChangeIssueOwner(viewer: Viewer | undefined, issue: IssueRelation): boolean;
+/** Uploading files: onto an issue (with `edit`) or with a comment (with `comment`). */
+export declare function canUploadAttachments(viewer: Viewer | undefined): boolean;
+/** Writing comments and replies, and resolving threads, on the issues the viewer sees. */
+export declare function canComment(viewer: Viewer | undefined): boolean;
+type CommentAuthor = Pick<IssueComment, 'authorType' | 'authorId' | 'kind'>;
+/** One's own plain comment, written as a person: only its author edits it. */
+export declare function canEditComment(viewer: Viewer | undefined, comment: CommentAuthor & Pick<IssueComment, 'deleted'>): boolean;
+/** Its author, or whoever moderates the issue's comments. */
+export declare function canDeleteComment(viewer: Viewer | undefined, comment: CommentAuthor & Pick<IssueComment, 'deleted'>, issue: IssueRelation): boolean;
+/** Deleting and restoring issues: administrators only. */
+export declare function canDeleteIssues(viewer: Viewer | undefined): boolean;
+export declare function canCreateProjects(viewer: Viewer | undefined): boolean;
+/** Editing a project, its members and resources: `all`, or a user of the viewer's set leads it. */
+export declare function canManageProject(viewer: Viewer | undefined, project: Pick<ProjectListItem, 'leadUserId'>): boolean;
+export declare function canDeleteProjects(viewer: Viewer | undefined): boolean;
+export {};
+//# sourceMappingURL=permissions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../client/lib/permissions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,MAAM,MAAM,GAAG,EAAE,CAAC;AAExB,wBAAgB,OAAO,CAAC,CAAC,SAAS,QAAQ,EACxC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,KAAK,CAEP;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,YAAY,EAClD,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,OAAO,CAET;AAED,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnE;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEjE;AAED,KAAK,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC,CAAC;AAOpE,wDAAwD;AACxD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,aAAa,GACnB,OAAO,CAET;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,aAAa,GACnB,OAAO,CAET;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAExE;AAED,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE9D;AAED,KAAK,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC,CAAC;AAE5E,8EAA8E;AAC9E,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,GACrD,OAAO,CAST;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,EACtD,KAAK,EAAE,aAAa,GACnB,OAAO,CAMT;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAErE;AAED,mGAAmG;AACnG,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,GAC3C,OAAO,CAET;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAErE"}

package/dist/client/lib/permissions.js

@@ -0,0 +1,73 @@
+/**
+ * The server's rules for who may change what (`server/domains/*\/*.access.ts`), as the browser applies them: to hide
+ * or disable a control the server would refuse. They read the viewer's scope of each business action from
+ * `GET /api/projects/me`: `all` passes on every record, a set of users only where the record relates to one of them, `none`
+ * never. The server enforces every rule itself.
+ */
+import { businessKey, reaches, settingsKey, } from '../../shared/access.js';
+import { PLAIN_COMMENT } from '../../shared/comments.js';
+import { USER_KIND } from '../../shared/kinds.js';
+export function scopeOf(viewer, business, action) {
+    return viewer?.permissions.scopes[businessKey(business, action)] ?? 'none';
+}
+export function canUseSetting(viewer, item, action) {
+    return viewer?.permissions.settings[settingsKey(item, action)] ?? false;
+}
+/** Creating an issue: short of `all`, issues without a project or in a project the viewer sees. */
+export function canCreateIssues(viewer) {
+    return scopeOf(viewer, 'pm.issues', 'create') !== 'none';
+}
+/** Every change to an issue needs `edit`; seeing the issue is its relation. */
+export function canEditIssues(viewer) {
+    return scopeOf(viewer, 'pm.issues', 'edit') !== 'none';
+}
+/** `all`, or a user of the viewer's set owns the issue or leads its project. */
+function manages(scope, issue) {
+    return reaches(scope, issue.ownerUserId, issue.project?.leadUserId);
+}
+/** Moving an issue into a `done` or `closed` status. */
+export function canCloseIssue(viewer, issue) {
+    return manages(scopeOf(viewer, 'pm.issues', 'close'), issue);
+}
+export function canChangeIssueOwner(viewer, issue) {
+    return manages(scopeOf(viewer, 'pm.issues', 'change-owner'), issue);
+}
+/** Uploading files: onto an issue (with `edit`) or with a comment (with `comment`). */
+export function canUploadAttachments(viewer) {
+    return scopeOf(viewer, 'pm.attachments', 'upload') !== 'none';
+}
+/** Writing comments and replies, and resolving threads, on the issues the viewer sees. */
+export function canComment(viewer) {
+    return scopeOf(viewer, 'pm.issues', 'comment') !== 'none';
+}
+/** One's own plain comment, written as a person: only its author edits it. */
+export function canEditComment(viewer, comment) {
+    return (!comment.deleted &&
+        canComment(viewer) &&
+        comment.authorType === USER_KIND &&
+        comment.kind === PLAIN_COMMENT &&
+        !!viewer &&
+        comment.authorId === viewer.userId);
+}
+/** Its author, or whoever moderates the issue's comments. */
+export function canDeleteComment(viewer, comment, issue) {
+    if (comment.deleted)
+        return false;
+    return (canEditComment(viewer, comment) ||
+        manages(scopeOf(viewer, 'pm.issues', 'moderate-comments'), issue));
+}
+/** Deleting and restoring issues: administrators only. */
+export function canDeleteIssues(viewer) {
+    return scopeOf(viewer, 'pm.issues', 'delete') === 'all';
+}
+export function canCreateProjects(viewer) {
+    return scopeOf(viewer, 'pm.projects', 'create') !== 'none';
+}
+/** Editing a project, its members and resources: `all`, or a user of the viewer's set leads it. */
+export function canManageProject(viewer, project) {
+    return reaches(scopeOf(viewer, 'pm.projects', 'manage'), project.leadUserId);
+}
+export function canDeleteProjects(viewer) {
+    return scopeOf(viewer, 'pm.projects', 'delete') === 'all';
+}
+//# sourceMappingURL=permissions.js.map

package/dist/client/lib/permissions.js.map

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

package/dist/client/lib/principal-name.d.ts

@@ -0,0 +1,7 @@
+import type { NameText } from '../../shared/kinds.js';
+/** A candidate's name in the viewer's language: its `nameText` when its kind ships one, else its name as stored. */
+export declare function usePrincipalName(): (principal: {
+    readonly name: string;
+    readonly nameText?: NameText;
+}) => string;
+//# sourceMappingURL=principal-name.d.ts.map

package/dist/client/lib/principal-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"principal-name.d.ts","sourceRoot":"","sources":["../../../client/lib/principal-name.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,oHAAoH;AACpH,wBAAgB,gBAAgB,IAAI,CAAC,SAAS,EAAE;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B,KAAK,MAAM,CASX"}

package/dist/client/lib/principal-name.js

@@ -0,0 +1,10 @@
+import { useTranslation } from '@nocobase/i18n/client';
+import { useCallback } from 'react';
+/** A candidate's name in the viewer's language: its `nameText` when its kind ships one, else its name as stored. */
+export function usePrincipalName() {
+    const { t } = useTranslation();
+    return useCallback(({ name, nameText }) => nameText
+        ? t(nameText.key, { ns: nameText.ns, defaultValue: name })
+        : name, [t]);
+}
+//# sourceMappingURL=principal-name.js.map

package/dist/client/lib/principal-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"principal-name.js","sourceRoot":"","sources":["../../../client/lib/principal-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAIpC,oHAAoH;AACpH,MAAM,UAAU,gBAAgB;IAI9B,MAAM,EAAE,CAAC,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,OAAO,WAAW,CAChB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CACrB,QAAQ;QACN,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QAC1D,CAAC,CAAC,IAAI,EACV,CAAC,CAAC,CAAC,CACJ,CAAC;AACJ,CAAC"}

package/dist/client/lib/remark-cjk-autolink.d.ts

@@ -0,0 +1,24 @@
+/**
+ * A remark plugin that ends a GFM autolink literal (a bare `https://…` or `www.…`) at the first CJK character or
+ * full-width punctuation mark, and turns the rest back into text. `remark-gfm` follows GFM, which only stops a bare
+ * URL at whitespace or `<`, so `PR：https://example.com/pull/8（分支 x）` would otherwise link `…/pull/8（分支`. Use it
+ * after `remark-gfm`. Links written as `<https://…>` or `[text](https://…)` are left as they are, so a URL that really
+ * contains CJK characters can still be written that way.
+ */
+interface MdNode {
+    type: string;
+    value?: string;
+    url?: string;
+    children?: MdNode[];
+    position?: {
+        readonly start: {
+            readonly offset?: number;
+        };
+        readonly end: {
+            readonly offset?: number;
+        };
+    };
+}
+export declare function remarkCjkAutolink(): (tree: MdNode) => void;
+export {};
+//# sourceMappingURL=remark-cjk-autolink.d.ts.map

package/dist/client/lib/remark-cjk-autolink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark-cjk-autolink.d.ts","sourceRoot":"","sources":["../../../client/lib/remark-cjk-autolink.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE;QACT,QAAQ,CAAC,KAAK,EAAE;YAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7C,QAAQ,CAAC,GAAG,EAAE;YAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC5C,CAAC;CACH;AA+GD,wBAAgB,iBAAiB,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAE1D"}