@flowscripter/dynamic-cli-framework 1.4.18 → 1.5.0

package/tests/terminal/supportsHyperlinks.test.ts

@@ -1,149 +0,0 @@
-import { afterEach, beforeEach, describe, expect, test } from "bun:test";
-import supportsHyperlinks from "../../src/terminal/supportsHyperlinks.ts";
-import type { WriteStream } from "node:tty";
-
-const envKeys = [
-  "CI",
-  "CURSOR_TRACE_ID",
-  "FORCE_HYPERLINK",
-  "TEAMCITY_VERSION",
-  "TERM_PROGRAM",
-  "TERM_PROGRAM_VERSION",
-  "VTE_VERSION",
-  "TERM",
-  "WT_SESSION",
-];
-
-let savedEnv: Record<string, string | undefined>;
-
-function ttyStream(): WriteStream {
-  return { isTTY: true } as WriteStream;
-}
-
-function nonTtyStream(): WriteStream {
-  return { isTTY: false } as WriteStream;
-}
-
-beforeEach(() => {
-  savedEnv = {};
-  for (const key of envKeys) {
-    savedEnv[key] = process.env[key];
-    delete process.env[key];
-  }
-});
-
-afterEach(() => {
-  for (const key of envKeys) {
-    if (savedEnv[key] === undefined) {
-      delete process.env[key];
-    } else {
-      process.env[key] = savedEnv[key];
-    }
-  }
-});
-
-describe("supportsHyperlinks", () => {
-  test("returns false for non-TTY stream", () => {
-    expect(supportsHyperlinks(nonTtyStream())).toBe(false);
-  });
-
-  test("returns false for unknown terminal", () => {
-    expect(supportsHyperlinks(ttyStream())).toBe(false);
-  });
-
-  test("FORCE_HYPERLINK=1 overrides to true", () => {
-    process.env.FORCE_HYPERLINK = "1";
-    expect(supportsHyperlinks(ttyStream())).toBe(true);
-  });
-
-  test("FORCE_HYPERLINK=0 overrides to false", () => {
-    process.env.FORCE_HYPERLINK = "0";
-    expect(supportsHyperlinks(ttyStream())).toBe(false);
-  });
-
-  test("FORCE_HYPERLINK=1 works even for non-TTY", () => {
-    process.env.FORCE_HYPERLINK = "1";
-    expect(supportsHyperlinks(nonTtyStream())).toBe(true);
-  });
-
-  test("returns true for Windows Terminal", () => {
-    process.env.WT_SESSION = "some-session-id";
-    expect(supportsHyperlinks(ttyStream())).toBe(true);
-  });
-
-  test("returns true for iTerm.app >= 3.1", () => {
-    process.env.TERM_PROGRAM = "iTerm.app";
-    process.env.TERM_PROGRAM_VERSION = "3.1.0";
-    expect(supportsHyperlinks(ttyStream())).toBe(true);
-  });
-
-  test("returns false for iTerm.app < 3.1", () => {
-    process.env.TERM_PROGRAM = "iTerm.app";
-    process.env.TERM_PROGRAM_VERSION = "3.0.0";
-    expect(supportsHyperlinks(ttyStream())).toBe(false);
-  });
-
-  test("returns true for vscode >= 1.72", () => {
-    process.env.TERM_PROGRAM = "vscode";
-    process.env.TERM_PROGRAM_VERSION = "1.72.0";
-    expect(supportsHyperlinks(ttyStream())).toBe(true);
-  });
-
-  test("returns false for vscode < 1.72", () => {
-    process.env.TERM_PROGRAM = "vscode";
-    process.env.TERM_PROGRAM_VERSION = "1.71.0";
-    expect(supportsHyperlinks(ttyStream())).toBe(false);
-  });
-
-  test("returns true for Cursor (vscode + CURSOR_TRACE_ID)", () => {
-    process.env.TERM_PROGRAM = "vscode";
-    process.env.CURSOR_TRACE_ID = "some-id";
-    expect(supportsHyperlinks(ttyStream())).toBe(true);
-  });
-
-  test("returns true for ghostty", () => {
-    process.env.TERM_PROGRAM = "ghostty";
-    expect(supportsHyperlinks(ttyStream())).toBe(true);
-  });
-
-  test("returns true for zed", () => {
-    process.env.TERM_PROGRAM = "zed";
-    expect(supportsHyperlinks(ttyStream())).toBe(true);
-  });
-
-  test("returns true for WezTerm", () => {
-    process.env.TERM_PROGRAM = "WezTerm";
-    process.env.TERM_PROGRAM_VERSION = "20200620";
-    expect(supportsHyperlinks(ttyStream())).toBe(true);
-  });
-
-  test("returns true for VTE >= 0.50 (excluding 0.50.0)", () => {
-    process.env.VTE_VERSION = "0.50.1";
-    expect(supportsHyperlinks(ttyStream())).toBe(true);
-  });
-
-  test("returns false for VTE 0.50.0 (segfault bug)", () => {
-    process.env.VTE_VERSION = "0.50.0";
-    expect(supportsHyperlinks(ttyStream())).toBe(false);
-  });
-
-  test("returns true for alacritty", () => {
-    process.env.TERM = "alacritty";
-    expect(supportsHyperlinks(ttyStream())).toBe(true);
-  });
-
-  test("returns true for xterm-kitty", () => {
-    process.env.TERM = "xterm-kitty";
-    expect(supportsHyperlinks(ttyStream())).toBe(true);
-  });
-
-  test("returns false in CI", () => {
-    process.env.CI = "true";
-    expect(supportsHyperlinks(ttyStream())).toBe(false);
-  });
-
-  test("returns false for TeamCity", () => {
-    process.env.TEAMCITY_VERSION = "2023.1";
-    expect(supportsHyperlinks(ttyStream())).toBe(false);
-  });
-});

package/tests/util/configHelper.test.ts

@@ -1,193 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import {
-  getGlobalCommandArgumentConfigurationKey,
-  getSubCommandArgumentConfigurationKey,
-} from "../../src/util/configHelper.ts";
-import { getCLIConfig } from "../fixtures/CLIConfig.ts";
-import {
-  getGlobalCommand,
-  getSubCommandWithComplexOptions,
-  getSubCommandWithOption,
-  getSubCommandWithPositional,
-} from "../fixtures/Command.ts";
-import { ArgumentValueTypeName } from "../../src/api/argument/ArgumentValueTypes.ts";
-import type ComplexOption from "../../src/api/argument/ComplexOption.ts";
-import type Option from "../../src/api/argument/Option.ts";
-import type SubCommandArgument from "../../src/api/argument/SubCommandArgument.ts";
-
-describe("configHelper tests", () => {
-  test("getConfigurationKey works for global argument", () => {
-    let command = getGlobalCommand("blah", true);
-
-    expect(
-      getGlobalCommandArgumentConfigurationKey(getCLIConfig(), command, command.argument!),
-    ).toBeUndefined();
-
-    command = getGlobalCommand("blah", true, false, true);
-
-    expect(
-      getGlobalCommandArgumentConfigurationKey(getCLIConfig(), command, command.argument!),
-    ).toEqual("FOO_BLAH");
-
-    command = getGlobalCommand("blah", true, false, true, "FOO_BAR");
-
-    expect(
-      getGlobalCommandArgumentConfigurationKey(getCLIConfig(), command, command.argument!),
-      "FOO_BAR",
-    );
-  });
-
-  test("getConfigurationKey works for positional argument", () => {
-    let command = getSubCommandWithPositional("blah", true, true);
-
-    expect(
-      getSubCommandArgumentConfigurationKey(getCLIConfig(), command, [command.positionals![0]!]),
-    ).toBeUndefined();
-
-    command = getSubCommandWithPositional("blah", true, false, ArgumentValueTypeName.BOOLEAN, true);
-
-    expect(
-      getSubCommandArgumentConfigurationKey(getCLIConfig(), command, [command.positionals![0]!]),
-    ).toEqual("FOO_BLAH_FOO");
-
-    command = getSubCommandWithPositional("blah", true, true, ArgumentValueTypeName.BOOLEAN, true);
-
-    expect(
-      getSubCommandArgumentConfigurationKey(getCLIConfig(), command, [command.positionals![0]!]),
-    ).toEqual("FOO_BLAH_FOO[_<index>]");
-
-    command = getSubCommandWithPositional(
-      "blah",
-      true,
-      true,
-      ArgumentValueTypeName.BOOLEAN,
-      true,
-      "FOO_BAR",
-    );
-
-    expect(
-      getSubCommandArgumentConfigurationKey(getCLIConfig(), command, [command.positionals![0]!]),
-    ).toEqual("FOO_BAR[_<index>]");
-  });
-
-  test("getConfigurationKey works for simple option argument", () => {
-    let command = getSubCommandWithOption("blah", true, false, true);
-
-    expect(
-      getSubCommandArgumentConfigurationKey(getCLIConfig(), command, [
-        command.options![0] as Option,
-      ]),
-    ).toBeUndefined();
-
-    command = getSubCommandWithOption(
-      "blah",
-      true,
-      false,
-      false,
-      ArgumentValueTypeName.BOOLEAN,
-      undefined,
-      true,
-    );
-
-    expect(
-      getSubCommandArgumentConfigurationKey(getCLIConfig(), command, [
-        command.options![0] as Option,
-      ]),
-    ).toEqual("FOO_BLAH_FOO");
-
-    command = getSubCommandWithOption(
-      "blah",
-      true,
-      false,
-      true,
-      ArgumentValueTypeName.BOOLEAN,
-      undefined,
-      true,
-    );
-
-    expect(
-      getSubCommandArgumentConfigurationKey(getCLIConfig(), command, [
-        command.options![0] as Option,
-      ]),
-    ).toEqual("FOO_BLAH_FOO[_<index>]");
-
-    command = getSubCommandWithOption(
-      "blah",
-      true,
-      false,
-      true,
-      ArgumentValueTypeName.BOOLEAN,
-      undefined,
-      true,
-      "FOO_BAR",
-    );
-
-    expect(
-      getSubCommandArgumentConfigurationKey(getCLIConfig(), command, [
-        command.options![0] as Option,
-      ]),
-    ).toEqual("FOO_BAR[_<index>]");
-  });
-
-  test("getConfigurationKey works for complex option argument", () => {
-    let command = getSubCommandWithComplexOptions();
-
-    let arg0 = command.options![0] as ComplexOption;
-    let arg1 = arg0.properties[0] as ComplexOption;
-    let arg2 = arg1.properties[0] as Option;
-
-    expect(
-      getSubCommandArgumentConfigurationKey(getCLIConfig(), command, [
-        arg0 as unknown as SubCommandArgument,
-        arg1 as unknown as SubCommandArgument,
-        arg2 as unknown as SubCommandArgument,
-      ]),
-    ).toBeUndefined();
-
-    command = getSubCommandWithComplexOptions(true, true);
-
-    arg0 = command.options![0] as ComplexOption;
-    arg1 = arg0.properties[0] as ComplexOption;
-    arg2 = arg1.properties[0] as Option;
-
-    expect(
-      getSubCommandArgumentConfigurationKey(getCLIConfig(), command, [
-        arg0 as unknown as SubCommandArgument,
-        arg1 as unknown as SubCommandArgument,
-        arg2 as unknown as SubCommandArgument,
-      ]),
-    ).toEqual("FOO_SUBCOMMAND_ALPHA[_<index>]_BETA[_<index>]_GAMMA");
-
-    arg2 = arg1.properties[1] as Option;
-
-    expect(
-      getSubCommandArgumentConfigurationKey(getCLIConfig(), command, [
-        arg0 as unknown as SubCommandArgument,
-        arg1 as unknown as SubCommandArgument,
-        arg2 as unknown as SubCommandArgument,
-      ]),
-    ).toEqual("FOO_SUBCOMMAND_ALPHA[_<index>]_BETA[_<index>]_DELTA[_<index>]");
-
-    arg0 = command.options![1] as ComplexOption;
-    arg1 = arg0.properties[0] as ComplexOption;
-
-    expect(
-      getSubCommandArgumentConfigurationKey(getCLIConfig(), command, [
-        arg0 as unknown as SubCommandArgument,
-        arg1 as unknown as SubCommandArgument,
-      ]),
-    ).toEqual("FOO_SUBCOMMAND_EPSILON_FOO_BAR_A");
-
-    command = getSubCommandWithComplexOptions(true, true, true);
-
-    arg0 = command.options![1] as ComplexOption;
-    arg1 = arg0.properties[1] as ComplexOption;
-
-    expect(
-      getSubCommandArgumentConfigurationKey(getCLIConfig(), command, [
-        arg0 as unknown as SubCommandArgument,
-        arg1 as unknown as SubCommandArgument,
-      ]),
-    ).toEqual("FOO_SUBCOMMAND_EPSILON_FOO_BAR_B[_<index>]");
-  });
-});

package/tests/util/envVarHelper.test.ts

@@ -1,254 +0,0 @@
-import process from "node:process";
-import { describe, expect, test } from "bun:test";
-import { getCLIConfig } from "../fixtures/CLIConfig.ts";
-import {
-  getGlobalCommand,
-  getGlobalModifierCommandWithArgument,
-  getSubCommandWithComplexOptions,
-  getSubCommandWithOption,
-  getSubCommandWithPositional,
-} from "../fixtures/Command.ts";
-import {
-  getGlobalCommandValueFromEnvVars,
-  getSubCommandValuesFromEnvVars,
-} from "../../src/util/envVarHelper.ts";
-import { ArgumentValueTypeName } from "../../src/api/argument/ArgumentValueTypes.ts";
-
-describe("envVarHelper tests", () => {
-  test("getGlobalCommandValuesFromEnvVars works", () => {
-    try {
-      let command = getGlobalCommand("blah", true);
-
-      expect(getGlobalCommandValueFromEnvVars(getCLIConfig(), command)).toBeUndefined();
-
-      command = getGlobalCommand("blah", true, false, true);
-
-      expect(getGlobalCommandValueFromEnvVars(getCLIConfig(), command)).toBeUndefined();
-
-      process.env["FOO_BLAH"] = "foo";
-
-      expect(getGlobalCommandValueFromEnvVars(getCLIConfig(), command)).toEqual("foo");
-
-      command = getGlobalCommand("blah", true, false, true, "FOO_BAR");
-
-      expect(getGlobalCommandValueFromEnvVars(getCLIConfig(), command)).toBeUndefined();
-
-      process.env["FOO_BAR"] = "foo";
-
-      expect(getGlobalCommandValueFromEnvVars(getCLIConfig(), command)).toEqual("foo");
-
-      command = getGlobalModifierCommandWithArgument(
-        "FOO_BAR",
-        "m",
-        1,
-        {
-          type: ArgumentValueTypeName.BOOLEAN,
-          configurationKey: "FOO_BAR",
-        },
-        true,
-      );
-
-      // any env var value should set boolean option to true
-      process.env["FOO_BAR"] = "foo";
-
-      expect(getGlobalCommandValueFromEnvVars(getCLIConfig(), command)).toEqual("true");
-
-      // empty env var value should set boolean option to false
-      process.env["FOO_BAR"] = "";
-
-      expect(getGlobalCommandValueFromEnvVars(getCLIConfig(), command)).toEqual("false");
-
-      // no env var value should not set boolean option to false
-      delete process.env["FOO_BAR"];
-
-      expect(getGlobalCommandValueFromEnvVars(getCLIConfig(), command)).toBeUndefined();
-    } finally {
-      delete process.env["FOO_BLAH_VALUE"];
-      delete process.env["FOO_BAR"];
-    }
-  });
-
-  test("getSubCommandValuesFromEnvVars works for simple option", () => {
-    try {
-      let command = getSubCommandWithOption("blah", true, false);
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toBeUndefined();
-
-      command = getSubCommandWithOption(
-        "blah",
-        true,
-        false,
-        false,
-        ArgumentValueTypeName.STRING,
-        undefined,
-        true,
-      );
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toBeUndefined();
-
-      process.env["FOO_BLAH_FOO"] = "bar";
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toEqual({
-        foo: "bar",
-      });
-
-      command = getSubCommandWithOption(
-        "blah",
-        true,
-        false,
-        false,
-        ArgumentValueTypeName.STRING,
-        undefined,
-        true,
-        "FOO_BAR",
-      );
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toBeUndefined();
-
-      process.env["FOO_BAR"] = "bar";
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toEqual({
-        foo: "bar",
-      });
-
-      command = getSubCommandWithOption(
-        "blah",
-        true,
-        false,
-        false,
-        ArgumentValueTypeName.BOOLEAN,
-        undefined,
-        true,
-        "FOO_BAR",
-      );
-
-      // any env var value should set boolean option to true
-      process.env["FOO_BAR"] = "foo";
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toEqual({
-        foo: "true",
-      });
-
-      // empty env var value should set boolean option to false
-      process.env["FOO_BAR"] = "";
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toEqual({
-        foo: "false",
-      });
-
-      delete process.env["FOO_BAR"];
-
-      // no env var value should not set boolean option to false
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toBeUndefined();
-    } finally {
-      delete process.env["FOO_BLAH_FOO"];
-      delete process.env["FOO_BAR"];
-    }
-  });
-
-  test("getSubCommandValuesFromEnvVars works for positional", () => {
-    try {
-      let command = getSubCommandWithPositional("blah", true, false);
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toBeUndefined();
-
-      command = getSubCommandWithPositional(
-        "blah",
-        true,
-        false,
-        ArgumentValueTypeName.STRING,
-        true,
-      );
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toBeUndefined();
-
-      process.env["FOO_BLAH_FOO"] = "bar";
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toEqual({
-        foo: "bar",
-      });
-
-      command = getSubCommandWithPositional(
-        "blah",
-        true,
-        false,
-        ArgumentValueTypeName.STRING,
-        true,
-        "FOO_BAR",
-      );
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toBeUndefined();
-
-      process.env["FOO_BAR"] = "bar";
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toEqual({
-        foo: "bar",
-      });
-
-      command = getSubCommandWithPositional(
-        "blah",
-        true,
-        false,
-        ArgumentValueTypeName.BOOLEAN,
-        true,
-        "FOO_BAR",
-      );
-
-      // any env var value should set boolean option to true
-      process.env["FOO_BAR"] = "foo";
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toEqual({
-        foo: "true",
-      });
-
-      // empty env var value should set boolean option to false
-      process.env["FOO_BAR"] = "";
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toEqual({
-        foo: "false",
-      });
-
-      // no env var value should not set boolean option to false
-      delete process.env["FOO_BAR"];
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toBeUndefined();
-    } finally {
-      delete process.env["FOO_BLAH_FOO"];
-      delete process.env["FOO_BAR"];
-    }
-  });
-
-  test("getSubCommandValuesFromEnvVars works for complex option", () => {
-    try {
-      const command = getSubCommandWithComplexOptions(true, true);
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toBeUndefined();
-
-      process.env["FOO_SUBCOMMAND_ALPHA_0_BETA_0_GAMMA"] = "bar1";
-      process.env["FOO_SUBCOMMAND_ALPHA_0_BETA_0_DELTA_0"] = "bar2";
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toEqual({
-        alpha: [{ beta: [{ delta: ["bar2"], gamma: "bar1" }] }],
-      });
-    } finally {
-      delete process.env["FOO_SUBCOMMAND_ALPHA_0_BETA_0_GAMMA"];
-      delete process.env["FOO_SUBCOMMAND_ALPHA_0_BETA_0_DELTA_0"];
-    }
-  });
-
-  test("getSubCommandValuesFromEnvVars ignores partially matched complex option", () => {
-    try {
-      const command = getSubCommandWithComplexOptions(true);
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toBeUndefined();
-
-      process.env["FOO_SUBCOMMAND_ALPHA_0_BETA_0_GAMMA"] = "bar1";
-      process.env["FOO_SUBCOMMAND_ALPHA_0_BETA_0_DELTA_0"] = "bar2";
-
-      expect(getSubCommandValuesFromEnvVars(getCLIConfig(), command)).toBeUndefined();
-    } finally {
-      delete process.env["FOO_SUBCOMMAND_ALPHA_0_BETA_0_GAMMA"];
-      delete process.env["FOO_SUBCOMMAND_ALPHA_0_BETA_0_DELTA_0"];
-    }
-  });
-});

package/tests/util/logger.test.ts

@@ -1,56 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import getLogger from "../../src/util/logger.ts";
-
-describe("logger tests", () => {
-  test("Can acquire a logger", () => {
-    const logger = getLogger("logger test");
-
-    logger.debug("foobar");
-  });
-
-  test("Log a string at error level", () => {
-    const logger = getLogger("logger test");
-
-    logger.error("foobar");
-  });
-
-  test("Log an object at error level", () => {
-    const logger = getLogger("logger test");
-
-    logger.error({ foo: "bar" });
-  });
-
-  test("Log result of a function at error level", () => {
-    const logger = getLogger("logger test");
-
-    logger.error(() => "foobar");
-  });
-
-  test("Log a string with formatted args at error level", () => {
-    const logger = getLogger("logger test");
-
-    logger.error("foo: %s %O", "bar", { foo1: "bar1", func: () => "foobar" });
-  });
-
-  test("Logger name padding is updated when a longer name is used", () => {
-    const shortLogger = getLogger("short");
-    const longLogger = getLogger("very-long-logger-name");
-    // Both should be valid logger instances
-    expect(shortLogger).toBeDefined();
-    expect(longLogger).toBeDefined();
-    // Calling all levels to exercise non-debug path
-    shortLogger.trace("trace msg");
-    shortLogger.debug("debug msg");
-    shortLogger.info("info msg");
-    shortLogger.warn("warn msg");
-    shortLogger.error("error msg");
-  });
-
-  test("Logger with same-length name reuses existing padding", () => {
-    // Create two loggers with same length names to hit the else-if branch
-    const logger1 = getLogger("aaa");
-    const logger2 = getLogger("bbb");
-    expect(logger1).toBeDefined();
-    expect(logger2).toBeDefined();
-  });
-});

package/tsconfig.json

@@ -1,32 +0,0 @@
-{
-  "compilerOptions": {
-    // Environment setup & latest features
-    "lib": ["ESNext"],
-    "target": "ESNext",
-    "module": "Preserve",
-    "moduleDetection": "force",
-    "jsx": "react-jsx",
-    "allowJs": true,
-
-    // Bundler mode
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "noEmit": true,
-
-    "types": ["bun", "node"],
-
-    // Best practices
-    "strict": true,
-    "skipLibCheck": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedIndexedAccess": true,
-    "noImplicitOverride": true,
-
-    // Some stricter flags (disabled by default)
-    "noUnusedLocals": false,
-    "noUnusedParameters": false,
-    "noPropertyAccessFromIndexSignature": false
-  },
-  "exclude": ["tests"]
-}