@remotedraw/cli 0.1.3 → 0.2.1

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:
@@ -178,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
@@ -186,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

@@ -2,6 +2,8 @@ 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.2.0";
+export declare const REMOTEDRAW_CLI_RANGE = "^0.2.0";
 export type CliResult = {
     exitCode: number;
     stdout: string;
@@ -35,10 +37,10 @@ export type CliRuntime = CloudRuntime & UpdateRuntime & {
     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"];
-declare const presetChoices: readonly ["signature", "initials", "approval", "sketch", "photoMarkup", "pdfMarkup", "mapMarkup", "screenMarkup", "designReview", "pointer"];
+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 ["approval", "sketch", "photoMarkup", "pdfMarkup", "mapMarkup", "screenMarkup", "designReview", "pointer"];
 declare const packageManagerChoices: readonly ["npm", "pnpm", "yarn", "bun"];
 type TargetChoice = (typeof targetChoices)[number];
 type SenderChoice = (typeof senderChoices)[number];
@@ -72,35 +74,12 @@ type PayloadOptions = {
 export declare function createSessionPayload(options: PayloadOptions): {
     expiresInMs?: number;
     externalId: string;
-    markupPreset: "signature" | "initials" | "approval" | "sketch" | "photoMarkup" | "pdfMarkup" | "mapMarkup" | "screenMarkup" | "designReview" | "pointer";
+    markupPreset: "approval" | "sketch" | "photoMarkup" | "pdfMarkup" | "mapMarkup" | "screenMarkup" | "designReview" | "pointer";
     target: {
+        kind: string;
+        label: string;
         metadata: {
             descriptor: {
-                version: number;
-                privacy: string;
-                surfaceRole: string;
-                inputIntent: "signature" | "initials";
-                label: string;
-                components: {
-                    id: "signature" | "initials";
-                    role: string;
-                    inputIntent: "signature" | "initials";
-                    required: boolean;
-                    bounds: {
-                        minX: number;
-                        minY: number;
-                        maxX: number;
-                        maxY: number;
-                    };
-                }[];
-                phoneHints: {
-                    preferredLayout: string;
-                    preferredTool: string;
-                    primaryActionLabel: string;
-                    showUndo: boolean;
-                    showClear: boolean;
-                };
-            } | {
                 version: number;
                 privacy: string;
                 surfaceRole: string;
@@ -113,7 +92,6 @@ export declare function createSessionPayload(options: PayloadOptions): {
                     showUndo?: never;
                     showClear?: never;
                 };
-                components?: never;
             } | {
                 version: number;
                 privacy: string;
@@ -127,18 +105,16 @@ export declare function createSessionPayload(options: PayloadOptions): {
                     showUndo: boolean;
                     showClear: boolean;
                 };
-                components?: never;
             };
         };
-        inputMapping?: "surface";
-        coordinateSpace?: {
-            width: number;
-            height: number;
-        };
-        kind: string;
-        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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"}