@remotedraw/cli 0.1.2 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AxioSozo Services B.V.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -39,6 +39,59 @@ To see the available integration paths without starting the wizard:
 remotedraw guide
 ```
 
+## Language
+
+The first interactive run asks which language the CLI should speak, listing each
+language under its own name:
+
+```text
+? Language / Taal
+❯ ◉ English    en
+  ○ Nederlands nl
+```
+
+The answer is stored once in your user config directory and reused by every
+later command, so the question is asked once per machine rather than once per
+run. Change it at any time:
+
+```sh
+remotedraw language        # pick interactively, or list the current setting
+remotedraw language nl     # set it directly
+```
+
+Non-interactive callers never see the prompt. A run without a stored choice, a
+TTY, or an override speaks English. To force a language for one command or for a
+whole CI job:
+
+```sh
+remotedraw doctor --language nl
+REMOTEDRAW_LANGUAGE=nl remotedraw doctor
+```
+
+Precedence is `--language` (or `--lang`), then `REMOTEDRAW_LANGUAGE` /
+`REMOTEDRAW_LANG`, then the stored choice, then English. An unrecognized code
+fails with the list of supported languages rather than guessing.
+
+Machine-readable output is **always English** regardless of the stored
+language: `--format json` on any command, and `create-input --json`. It is a
+data interchange format for CI and coding agents, not chrome for the operator,
+and enum `value`s are identifiers that are never translated. Passing
+`--language <code>` on that same invocation is a deliberate request and does
+localize the human-readable `label`, `summary`, and `explanation` fields; a
+stored choice or an environment variable does not. JSON `error.code` values are
+declared at the point the error is raised, so they never change with language.
+
+Localization covers CLI chrome only: prompts, help, summaries, doctor output,
+and error messages. **Everything the CLI writes into your project stays
+English** — generated code, comments, README files, `package.json` fields, and
+API request payloads. Those artifacts are committed, reviewed, diffed, and read
+by teammates and coding agents who may not share your CLI language, and they sit
+next to English API identifiers and documentation.
+
+Currently shipping English and Dutch. A language is added by dropping one
+catalog file into `src/locales/` and registering it in `src/locales/index.ts`;
+no call site changes, and anything a catalog omits falls back to English.
+
 ## Create a new app
 
 Start the interactive project creator:
@@ -88,7 +141,29 @@ remotedraw doctor
 ```
 
 It checks the project configuration, installed packages, environment values,
-and—when credentials are available—the RemoteDraw API connection.
+the installed CLI version, and—when credentials are available—the RemoteDraw
+API connection.
+
+Without an override, commands talk to `https://api.remotedraw.com`. Doctor
+prints the API base URL it resolved and where that value came from, so a
+`.env.local` pointing at a non-production deployment is visible rather than
+silent.
+
+## Update the CLI
+
+`npm install -g` pins the version it installed and never revisits it, so a
+global RemoteDraw CLI stays on whatever release you first installed:
+
+```sh
+remotedraw update           # install the latest published version
+remotedraw update --check   # report it without installing
+```
+
+`update` detects whether the binary came from npm, pnpm, yarn, or bun and runs
+that package manager. Other commands check the registry at most once a day and
+print a one-line notice when a newer version exists; that notice only appears on
+an interactive terminal, and `REMOTEDRAW_CLI_NO_UPDATE_CHECK=1`, `CI`, or
+`NO_UPDATE_NOTIFIER` disable it.
 
 Useful account commands:
 
@@ -156,7 +231,8 @@ The CLI can also print or install the RemoteDraw skill for coding agents:
 
 ```sh
 remotedraw agent --print-skill
-remotedraw agent --path ~/.codex/skills/remotedraw --force
+remotedraw agent --path .agents/skills/remotedraw --force
+remotedraw agent --path .claude/skills/remotedraw --force
 ```
 
 ## Command reference
@@ -164,6 +240,7 @@ remotedraw agent --path ~/.codex/skills/remotedraw --force
 ```text
 guide          Choose an integration path and SDK.
 options        Print setup choices and compatibility metadata.
+language       Choose the language of this CLI.
 login          Authorize this computer through the dashboard.
 logout         Revoke and remove this computer's CLI credential.
 whoami         Show the signed-in RemoteDraw account.

package/dist/cli.d.ts

@@ -1,6 +1,9 @@
 import { type WizardDefinition, type WizardTerminal } from "./setup-wizard.js";
 import { type CloudRuntime } from "./cloud.js";
+import { type UpdateRuntime } from "./update.js";
 export declare const CLI_VERSION: string;
+export declare const REMOTEDRAW_SDK_RANGE = "^0.1.0";
+export declare const REMOTEDRAW_CLI_RANGE = "^0.2.0";
 export type CliResult = {
     exitCode: number;
     stdout: string;
@@ -27,14 +30,16 @@ export type CliPrompter = {
     text: (options: TextPromptOptions) => Promise<string>;
     select: <T extends string>(options: SelectPromptOptions<T>) => Promise<T>;
 };
-export type CliRuntime = CloudRuntime & {
+export type CliRuntime = CloudRuntime & UpdateRuntime & {
     cwd: string;
+    /** Absolute path of the running binary; drives update-command detection. */
+    binPath?: string;
     prompts?: CliPrompter;
     wizardTerminal?: WizardTerminal | undefined;
 };
-declare const targetChoices: readonly ["web", "desktop", "ios", "headless"];
-declare const senderChoices: readonly ["remotedraw-ios", "embedded-web", "own-ios", "headless"];
-declare const sdkChoices: readonly ["react", "svelte", "js", "swift", "headless"];
+export declare const targetChoices: readonly ["web", "desktop", "ios", "headless"];
+export declare const senderChoices: readonly ["remotedraw-ios", "embedded-web", "own-ios", "headless"];
+export declare const sdkChoices: readonly ["react", "svelte", "js", "swift", "headless"];
 declare const presetChoices: readonly ["signature", "initials", "approval", "sketch", "photoMarkup", "pdfMarkup", "mapMarkup", "screenMarkup", "designReview", "pointer"];
 declare const packageManagerChoices: readonly ["npm", "pnpm", "yarn", "bun"];
 type TargetChoice = (typeof targetChoices)[number];
@@ -136,6 +141,12 @@ export declare function createSessionPayload(options: PayloadOptions): {
         label: string;
     };
 };
+/**
+ * The skill a coding agent installs is the same file this repository
+ * documents. `docs/agents/remotedraw/SKILL.md` is the single source; the
+ * module below is generated from it by `bun run generate:skill`, and
+ * tests/agent-skill.test.ts fails if the two drift apart again.
+ */
 export declare function agentSkillMarkdown(): string;
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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