@avantf/dsh-mem 0.1.0

package/lib/types/client/domains.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The 知识域 picker's option list.
+ *
+ * The host's `kbDomains` returns `knowledge.domains` (the configured allowlist) ∪ the domains the
+ * library already holds. The union is the point: a historical name that the allowlist would not
+ * accept as NEW must stay selectable, or the tab offers a value the store then refuses.
+ * `restricted` mirrors "the allowlist is non-empty" — then the control is a closed `<select>` and
+ * a new domain is a config change, not a second spelling of an existing one. An explicitly empty
+ * allowlist means no restriction, so the control stays a free input.
+ */
+export interface DomainCatalog {
+    domains: string[];
+    restricted: boolean;
+}
+/** One `<option>`: `value` is what the form sends, `label` is what the user reads. */
+export interface DomainOption {
+    value: string;
+    label: string;
+}
+/** The empty choice first, then every catalog domain in the host's order. */
+export declare function domainOptions(catalog: DomainCatalog | null, emptyLabel: string): DomainOption[];
+/**
+ * `'select'` when the allowlist is active (non-empty) — the control must not offer free input, or
+ * two spellings of one domain can still be created. `'input'` when it is empty (no restriction),
+ * and also while the catalog is not loaded yet: the form stays usable and the store is the final
+ * guard either way.
+ */
+export declare function domainPickerMode(catalog: DomainCatalog | null): 'select' | 'input';
+/**
+ * What the 「+」 draft means, so the form and the store agree on the rules BEFORE a round-trip.
+ *
+ * `existing` is not an error: a name the picker already offers is a SELECTION (the user typed the
+ * option instead of choosing it), and writing it a second time would only produce a duplicate list
+ * entry. `invalid` is the case that must never reach the store: a `/` or `\` would become one level
+ * of the managed path (`docs/<domain>/<source>/<title>.md`), and `sanitizeSegment` rewrites it — so
+ * the picker would show a name that is not the directory name.
+ */
+export type NewDomainCheck = {
+    kind: 'empty';
+} | {
+    kind: 'invalid';
+    reason: string;
+} | {
+    kind: 'existing';
+    name: string;
+} | {
+    kind: 'new';
+    name: string;
+};
+/** Classify one 「+」 draft against the domains the picker currently offers. */
+export declare function checkNewDomain(raw: string, existing: readonly string[]): NewDomainCheck;
+//# sourceMappingURL=domains.d.ts.map

package/lib/types/client/domains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../../src/client/domains.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,sFAAsF;AACtF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAG/F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,CAElF;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjC,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CAOvF"}

package/lib/types/client/domains.js

@@ -0,0 +1,25 @@
+/** The empty choice first, then every catalog domain in the host's order. */
+export function domainOptions(catalog, emptyLabel) {
+    const domains = catalog === null ? [] : catalog.domains;
+    return [{ value: '', label: emptyLabel }, ...domains.map(domain => ({ value: domain, label: domain }))];
+}
+/**
+ * `'select'` when the allowlist is active (non-empty) — the control must not offer free input, or
+ * two spellings of one domain can still be created. `'input'` when it is empty (no restriction),
+ * and also while the catalog is not loaded yet: the form stays usable and the store is the final
+ * guard either way.
+ */
+export function domainPickerMode(catalog) {
+    return catalog !== null && catalog.restricted ? 'select' : 'input';
+}
+/** Classify one 「+」 draft against the domains the picker currently offers. */
+export function checkNewDomain(raw, existing) {
+    const name = raw.trim();
+    if (name === '')
+        return { kind: 'empty' };
+    if (name.includes('/') || name.includes('\\')) {
+        return { kind: 'invalid', reason: '知识域不能包含 “/” 或 “\\”' };
+    }
+    return existing.includes(name) ? { kind: 'existing', name } : { kind: 'new', name };
+}
+//# sourceMappingURL=domains.js.map

package/lib/types/client/domains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.js","sourceRoot":"","sources":["../../../src/client/domains.ts"],"names":[],"mappings":"AAqBA,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,OAA6B,EAAE,UAAkB;IAC7E,MAAM,OAAO,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAA;IACvD,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;AACzG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA6B;IAC5D,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAA;AACpE,CAAC;AAiBD,8EAA8E;AAC9E,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,QAA2B;IACrE,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;IACvB,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IACzC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAA;IAC1D,CAAC;IACD,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AACrF,CAAC"}

package/lib/types/client/index.d.ts

@@ -0,0 +1,35 @@
+/** The slice of the client Context this plugin uses. */
+interface ClientContext {
+    slots: {
+        inject(name: string, register: () => void): void;
+        register(options: {
+            name: string;
+            id: string;
+            order: number;
+            label: () => string;
+        }, component: () => unknown): void;
+    };
+    remote: {
+        /** Mount this package's own Remote contribution (see `./remote.ts`). */
+        $mount(contribution: unknown): Promise<() => Promise<void>>;
+    };
+    /**
+     * Cordis service lookup. Required here because `ctx.remote.avantfMem` is
+     * guarded: a dotted property read demands that exact key in the plugin's own
+     * `inject`, which would park this entry before it can mount the namespace.
+     * `get()` has no such requirement and returns the mounted service object.
+     */
+    get(name: string): unknown;
+}
+/** Client cordis-plugin name shown in boot diagnostics. */
+export declare const name = "avantf-mem-client";
+/**
+ * Services required to render the two tabs. `remote` (not `remote.avantfMem`)
+ * on purpose: a missing namespace must not leave this entry pending, because
+ * the client boot rejects the whole tree when any entry is pending.
+ */
+export declare const inject: string[];
+/** Contribute the two `conversation.view` tabs, mounting this package's Remote namespace first. */
+export declare function apply(ctx: ClientContext): Promise<void>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AA+FA,wDAAwD;AACxD,UAAU,aAAa;IACrB,KAAK,EAAE;QACL,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;QAChD,QAAQ,CACN,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,MAAM,CAAA;SAAE,EACzE,SAAS,EAAE,MAAM,OAAO,GACvB,IAAI,CAAA;KACR,CAAA;IACD,MAAM,EAAE;QACN,wEAAwE;QACxE,MAAM,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;KAC5D,CAAA;IACD;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3B;AAm7CD,2DAA2D;AAC3D,eAAO,MAAM,IAAI,sBAAsB,CAAA;AAEvC;;;;GAIG;AACH,eAAO,MAAM,MAAM,UAAsB,CAAA;AAEzC,mGAAmG;AACnG,wBAAsB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC7D"}