@chance722/dsh-inbox 0.1.0 → 0.2.1

package/lib/index.js

@@ -3,7 +3,7 @@ import { defineTool as defineTool2 } from "@deepseek-ai/dsh-tools";
 
 // src/shared/constants.ts
 var PACKAGE_NAME = "@chance722/dsh-inbox";
-var VERSION = true ? "0.1.0" : "0.0.0-dev";
+var VERSION = true ? "0.2.1" : "0.0.0-dev";
 var DEFAULT_USER_AGENT = "dsh-inbox";
 
 // src/shared/vocabulary.ts

package/lib/types/cli.d.ts

@@ -10,7 +10,9 @@
  * README that half its readers will skim past — so this does it.
  *
  * What it does, in order, and it is safe to run twice:
- *   0. with `--create-profile`, create a missing profile first (off by default:
+ *   0. decide which profile to install into — `--profile` when it was named,
+ *      otherwise the one this machine already starts (`web`, or the only one);
+ *      with `--create-profile`, create a missing profile first (off by default:
  *      a typo in a profile name should say so, not conjure a profile)
  *   1. `dsh plugin --profile <profile> add <package>` (pnpm is idempotent)
  *   2. copy the shipped `standard` preset into `<DSH_HOME>/.agent-presets/<id>`
@@ -39,7 +41,8 @@ export interface PresetRowOutcome {
  */
 export declare function ensurePresetRow(body: string): PresetRowOutcome;
 export interface Options {
-    profile: string;
+    /** Profile named with `--profile`; undefined asks the installer to pick one. */
+    profile: string | undefined;
     preset: string;
     source: string;
     defaultPreset: boolean;
@@ -47,3 +50,71 @@ export interface Options {
     createProfile: boolean;
 }
 export declare function parse(argv: readonly string[]): Options | undefined;
+/**
+ * The profiles this machine has, in a stable order.
+ *
+ * A directory counts as a profile when it carries the `package.json` dsh writes
+ * there; `profiles/node_modules` is a package store, not a profile. A missing
+ * `profiles` directory is the fresh-machine case, not an error.
+ *
+ * @param home - `<DSH_HOME>`.
+ * @returns profile names, sorted.
+ */
+export declare function listProfiles(home: string): string[];
+/** What to do about the profile, and how to describe the choice. */
+export type ProfileChoice = {
+    kind: 'use';
+    profile: string;
+    label: string;
+} | {
+    kind: 'refuse';
+    message: string;
+};
+/**
+ * Pick the profile to install into when the user did not name one.
+ *
+ * `dsh web` is `dsh --profile web`, so the profile people already start is the
+ * one the plugin belongs in — naming it by hand was a step the README had to
+ * teach, and the reason a fresh machine needed a second command at all. Guessing
+ * stops at the first ambiguity: several profiles and no `web` means asking, not
+ * serving someone the wrong one.
+ *
+ * @param options - `--profile` (if given) and `--create-profile`.
+ * @param existing - what {@link listProfiles} found.
+ * @returns the profile to use, or the refusal to print.
+ */
+export declare function chooseProfile(options: Pick<Options, 'profile' | 'createProfile'>, existing: readonly string[]): ProfileChoice;
+/**
+ * Whether this module is the program being run.
+ *
+ * `import.meta.url` carries the **real** path — Node resolves symlinks — while
+ * `process.argv[1]` keeps the path the caller typed. Comparing the URLs
+ * directly therefore fails for a copy reached through a pnpm
+ * `node_modules/@chance722/dsh-inbox/...` junction or any symlink, and the
+ * failure is silent: the installer does nothing, prints nothing, exits 0.
+ * Resolve both sides first; an unresolvable path is not us.
+ *
+ * @param moduleUrl - `import.meta.url` of this module.
+ * @param entry - `process.argv[1]`, or undefined when node has no script.
+ * @returns true when `entry` is this very file.
+ */
+export declare function isEntryPoint(moduleUrl: string, entry: string | undefined): boolean;
+/**
+ * The commands that can create a missing profile, in the order to try them.
+ *
+ * A *shipped* template cannot be the target of `--from-default-profile`: dsh
+ * refuses with `profile "web" is shipped and cannot be a custom profile target;
+ * omit --from-default-profile to use it`. `init --profile web --create-profile`
+ * on a machine that has never run dsh is exactly that case — and since choosing
+ * `web` is what this installer now does by default, that would have been the
+ * *first* thing a new user hit (measured 2026-09-20, on a fresh `%DSH_HOME%`,
+ * before 0.2.0 shipped). The bare form is also the one that initializes a
+ * shipped profile at all, so it is the fallback rather than the first choice.
+ *
+ * Both forms are tried instead of special-casing `web`: `headless` is shipped
+ * too, and a future template should not need this file to change.
+ *
+ * @param profile - the profile to create.
+ * @returns argv lists for `dsh`, most specific first.
+ */
+export declare function profileCreationAttempts(profile: string): readonly (readonly string[])[];

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

@@ -0,0 +1,109 @@
+/**
+ * How the panel follows dsh's language.
+ *
+ * dsh ships a locale service (`@deepseek-ai/dsh-client-locale`): the user picks
+ * a language under 设置 → 常规, the host persists it, and the page's `<html
+ * lang>` follows it. The panel does not invent a switch of its own — it
+ * registers its copy as a dictionary in that service and reads back whatever
+ * language is active, which is also why a language pack we have never heard of
+ * (say `ja` falling back to English) still reads correctly.
+ *
+ * Two paths, in this order:
+ *
+ * 1. **The locale service**, when the composition has one. Our namespace is
+ *    registered for both shipped locales, and the active id is read from the
+ *    service's own snapshot — so the panel switches the moment the user does.
+ * 2. **The document**, when it does not. `<html lang>` is the host's own
+ *    statement of the active language and `navigator` covers the rest, so a
+ *    bare composition still reads in the reader's language rather than
+ *    defaulting to Chinese. This is the same seam `scheme.ts` uses for colour.
+ *
+ * `t()` reads the active language at call time, and `useLocaleRevision()`
+ * re-renders a tree when it changes, so no memoised copy outlives a switch.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Category, CategorySource, Kind } from '../shared/vocabulary.js';
+import { type MessageKey } from './messages.js';
+/** The namespace our copy registers under; nothing else may claim it. */
+export declare const MESSAGES_NS = "dsh-inbox";
+/** Translation parameters, substituted into `{name}` placeholders. */
+export type TranslationParams = Record<string, string | number>;
+/** Subscribe to language changes; `useSyncExternalStore` drives the panel. */
+export declare function subscribeToLocale(listener: () => void): () => void;
+/** A counter that changes whenever the active language does. */
+export declare function localeRevision(): number;
+/**
+ * Re-render a tree when the language changes.
+ *
+ * The panel, the dock and the conversation cards are three separate React trees
+ * (three slots), so each one subscribes — a tree that skipped this would keep
+ * the language it first rendered in. The returned number is the revision, and is
+ * only there so React has something that changes to compare.
+ *
+ * @returns the current locale revision.
+ */
+export declare function useLocaleRevision(): number;
+/**
+ * Narrow a BCP 47 tag to one of the two dictionaries we carry.
+ *
+ * `zh`, `zh-CN`, `zh-Hant` are Chinese; everything else reads English, which is
+ * what dsh itself falls back to. Pure, so the rule is testable without a DOM.
+ *
+ * @param tag - a language tag, or undefined when nothing named one.
+ * @returns which dictionary to read.
+ */
+export declare function resolveLanguage(tag: string | undefined): 'zh' | 'en';
+/** Which language the panel is reading right now. */
+export declare function activeLanguage(): 'zh' | 'en';
+/**
+ * Translate one key.
+ *
+ * Falls back from the active dictionary to English to the key itself, so a key
+ * that lost its translation reads as a visible key rather than as an empty
+ * string.
+ *
+ * @param key - a key of the shipped dictionary.
+ * @param params - values for the `{name}` placeholders.
+ * @returns the copy for the active language.
+ */
+export declare function t(key: MessageKey, params?: TranslationParams): string;
+/**
+ * The panel's word for a record kind.
+ *
+ * The host half has its own labels for the same four kinds (`vocabulary.ts`),
+ * and they stay Chinese on purpose: they travel into tool results and into the
+ * readable copy the vault writes to the cloud, where the reader is the model or
+ * another device rather than this browser. The cast is the price of building a
+ * key from a value; `test/i18n.test.ts` checks that all four resolve.
+ *
+ * @param kind - the record's kind.
+ * @returns the label in the active language.
+ */
+export declare function kindLabel(kind: Kind): string;
+/** The panel's word for a category; see {@link kindLabel} for the why. */
+export declare function categoryLabel(category: Category): string;
+/** The panel's badge for who judged a category (规则判定 / 模型判定 / 手动判定). */
+export declare function sourceLabel(source: CategorySource): string;
+/** One sentence explaining what that badge implies. */
+export declare function sourceHint(source: CategorySource): string;
+/**
+ * Why a link never got a name.
+ *
+ * The host stores a machine-readable code (`http:403`, `no-title`, …) — never a
+ * sentence, and deliberately not in the host's language — so the panel can say
+ * it in the reader's.
+ *
+ * @param code - the stored `linkTitleError`, or undefined when there is none.
+ * @returns a sentence, or undefined when there is nothing to explain.
+ */
+export declare function titleMissReason(code: string | undefined): string | undefined;
+/**
+ * Hook the panel's copy up to dsh's language.
+ *
+ * Called once from the browser half's `apply`, before any panel renders.
+ *
+ * @param ctx - the browser plugin context.
+ */
+export declare function installLocale(ctx: Context): void;
+/** Whether the host's locale service took our dictionaries (for diagnostics). */
+export declare function localeServiceBound(): boolean;