@hydranium/cli 1.0.0-next.37 → 1.0.0-next.370

package/src/commands/init-hosts.ts

@@ -0,0 +1,51 @@
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+
+/**
+ * The host applications `init` can emit around the server: each holds the
+ * clients of the heads it runs, in a sibling package of its own.
+ */
+
+import type { InitHead } from './init.js';
+
+/** The hosts a scaffold can emit, in the order a workspace lists them. */
+export const INIT_HOSTS = ['browser', 'vscode', 'theia-browser', 'theia-electron'] as const;
+
+/** One host application — see {@link INIT_HOSTS}. */
+export type InitHost = (typeof INIT_HOSTS)[number];
+
+/**
+ * The heads a host needs at least one of: those whose client edits and saves
+ * the files. The browser page has no filesystem of its own, so it saves through
+ * the LSP head's editor or the GLSP head's diagram. VS Code and Theia own the
+ * files and reach the server through a language client, so they need the LSP
+ * head. Every other head is optional, and a head the host does not know is left
+ * unused.
+ */
+const EDITING_HEADS: Record<InitHost, readonly InitHead[]> = {
+   browser: ['lsp', 'glsp'],
+   vscode: ['lsp'],
+   'theia-browser': ['lsp'],
+   'theia-electron': ['lsp']
+};
+
+/** True for a string naming one of {@link INIT_HOSTS}. */
+export function isInitHost(value: string): value is InitHost {
+   return (INIT_HOSTS as readonly string[]).includes(value);
+}
+
+/** True for a host that is a Theia application, which runs the Theia extension. */
+export function isTheiaHost(host: InitHost): boolean {
+   return host === 'theia-browser' || host === 'theia-electron';
+}
+
+/** The heads {@link host} needs at least one of in the composition. */
+export function editingHeads(host: InitHost): readonly InitHead[] {
+   return EDITING_HEADS[host];
+}

package/src/commands/init-prompt.ts

@@ -66,7 +66,7 @@ export interface PromptPort {
       readonly choices: ReadonlyArray<PromptChoice<Value>>;
       readonly initialValue?: Value;
    }) => Promise<Value>;
-   /** Ask for any number of several choices, including none. */
+   /** Ask for at least one of several choices. */
    readonly multiselect: <Value extends string>(options: {
       readonly message: string;
       readonly choices: ReadonlyArray<PromptChoice<Value>>;
@@ -78,8 +78,9 @@ export interface PromptPort {
    readonly outro: (message: string) => void;
 }
 
-/** The optional heads, as a checkbox list. `lsp` is not offered — see `askHeads`. */
-export const OPTIONAL_HEAD_CHOICES: ReadonlyArray<PromptChoice<Exclude<InitHead, 'lsp'>>> = [
+/** The heads, as a checkbox list. */
+export const HEAD_CHOICES: ReadonlyArray<PromptChoice<InitHead>> = [
+   { value: 'lsp', label: 'lsp', hint: 'text editing in an LSP client' },
    { value: 'data', label: 'data', hint: 'typed JSON-RPC for forms, trees and code-gen' },
    { value: 'glsp', label: 'glsp', hint: 'graphical editing; adds a scaffolded diagram' }
 ];
@@ -138,9 +139,7 @@ export async function createClackPrompt(): Promise<PromptPort> {
                message: options.message,
                options: toOptions(options.choices),
                initialValues: options.initialValues ? [...options.initialValues] : [],
-               // Legal and meaningful: an `lsp`-only project is a plain LSP
-               // server, so an empty selection must not be rejected.
-               required: false
+               required: true
             })
          ),
       confirm: async options => unwrap(await clack.confirm({ message: options.message, initialValue: options.initialValue })),