better-commits 1.23.2 → 1.23.3

package/dist/chunk-GAAS3VS3.js

@@ -0,0 +1,922 @@
+// src/valibot-state.ts
+import * as v2 from "valibot";
+
+// src/valibot-consts.ts
+import * as v from "valibot";
+var CUSTOM_SCOPE_KEY = "custom";
+var FOOTER_OPTION_VALUES = [
+  "closes",
+  "trailer",
+  "breaking-change",
+  "deprecated",
+  "custom"
+];
+var V_BRANCH_ACTIONS = v.picklist(["branch", "worktree"]);
+var V_FOOTER_OPTIONS = v.picklist([
+  "closes",
+  "trailer",
+  "breaking-change",
+  "deprecated",
+  "custom"
+]);
+var V_BRANCH_FIELDS = v.picklist([
+  "user",
+  "version",
+  "type",
+  "scope",
+  "ticket",
+  "description"
+]);
+var V_BRANCH_CONFIG_FIELDS = v.picklist([
+  "branch_user",
+  "branch_version",
+  "branch_type",
+  "branch_scope",
+  "branch_ticket",
+  "branch_description"
+]);
+var BRANCH_ORDER_DEFAULTS = [
+  "user",
+  "version",
+  "type",
+  "ticket",
+  "scope",
+  "description"
+];
+var DEFAULT_SCOPE_OPTIONS = [
+  { value: "app", label: "app" },
+  { value: "shared", label: "shared" },
+  { value: "server", label: "server" },
+  { value: "tools", label: "tools" },
+  { value: "", label: "none" }
+];
+var DEFAULT_TYPE_OPTIONS = [
+  {
+    value: "feat",
+    label: "feat",
+    hint: "A new feature",
+    emoji: "\u{1F31F}",
+    trailer: "Changelog: feature"
+  },
+  {
+    value: "fix",
+    label: "fix",
+    hint: "A bug fix",
+    emoji: "\u{1F41B}",
+    trailer: "Changelog: fix"
+  },
+  {
+    value: "docs",
+    label: "docs",
+    hint: "Documentation only changes",
+    emoji: "\u{1F4DA}",
+    trailer: "Changelog: documentation"
+  },
+  {
+    value: "refactor",
+    label: "refactor",
+    hint: "A code change that neither fixes a bug nor adds a feature",
+    emoji: "\u{1F528}",
+    trailer: "Changelog: refactor"
+  },
+  {
+    value: "perf",
+    label: "perf",
+    hint: "A code change that improves performance",
+    emoji: "\u{1F680}",
+    trailer: "Changelog: performance"
+  },
+  {
+    value: "test",
+    label: "test",
+    hint: "Adding missing tests or correcting existing tests",
+    emoji: "\u{1F6A8}",
+    trailer: "Changelog: test"
+  },
+  {
+    value: "build",
+    label: "build",
+    hint: "Changes that affect the build system or external dependencies",
+    emoji: "\u{1F6A7}",
+    trailer: "Changelog: build"
+  },
+  {
+    value: "ci",
+    label: "ci",
+    hint: "Changes to our CI configuration files and scripts",
+    emoji: "\u{1F916}",
+    trailer: "Changelog: ci"
+  },
+  {
+    value: "chore",
+    label: "chore",
+    hint: "Other changes that do not modify src or test files",
+    emoji: "\u{1F9F9}",
+    trailer: "Changelog: chore"
+  },
+  { value: "", label: "none" }
+];
+
+// src/valibot-state.ts
+var CommitTypeConfig = v2.pipe(
+  v2.optional(
+    v2.object({
+      enable: v2.optional(v2.boolean(), true),
+      initial_value: v2.optional(v2.string(), "feat"),
+      max_items: v2.optional(v2.pipe(v2.number(), v2.minValue(1)), 20),
+      infer_type_from_branch: v2.optional(v2.boolean(), true),
+      append_emoji_to_label: v2.optional(v2.boolean(), false),
+      append_emoji_to_commit: v2.optional(v2.boolean(), false),
+      emoji_commit_position: v2.optional(
+        v2.picklist(["Start", "After-Colon"]),
+        "Start"
+      ),
+      autocomplete: v2.optional(v2.boolean(), true),
+      options: v2.optional(
+        v2.array(
+          v2.object({
+            value: v2.string(),
+            label: v2.optional(v2.string()),
+            hint: v2.optional(v2.string()),
+            emoji: v2.optional(v2.pipe(v2.string(), v2.emoji())),
+            trailer: v2.optional(v2.string())
+          })
+        ),
+        DEFAULT_TYPE_OPTIONS
+      )
+    }),
+    {}
+  ),
+  v2.rawCheck(({ dataset, addIssue }) => {
+    if (dataset.typed && !dataset.value.options.some(
+      (option) => option.value === dataset.value.initial_value
+    )) {
+      addIssue({
+        message: `Type: initial_value "${dataset.value.initial_value}" must exist in options`
+      });
+    }
+  }),
+  v2.transform((value) => ({
+    ...value,
+    options: value.options.map((option) => ({
+      ...option,
+      label: option.emoji && value.append_emoji_to_label ? `${option.emoji} ${option.label}` : option.label
+    }))
+  }))
+);
+var CommitScopeConfig = v2.pipe(
+  v2.optional(
+    v2.object({
+      enable: v2.optional(v2.boolean(), true),
+      custom_scope: v2.optional(v2.boolean(), false),
+      max_items: v2.optional(v2.pipe(v2.number(), v2.minValue(1)), 20),
+      initial_value: v2.optional(v2.string(), "app"),
+      infer_scope_from_branch: v2.optional(v2.boolean(), true),
+      autocomplete: v2.optional(v2.boolean(), true),
+      options: v2.optional(
+        v2.array(
+          v2.object({
+            value: v2.string(),
+            label: v2.optional(v2.string()),
+            hint: v2.optional(v2.string())
+          })
+        ),
+        DEFAULT_SCOPE_OPTIONS
+      )
+    }),
+    {}
+  ),
+  v2.rawCheck(({ dataset, addIssue }) => {
+    if (!dataset.typed)
+      return;
+    const option_values = dataset.value.options.map((option) => option.value);
+    if (dataset.value.custom_scope)
+      option_values.push(CUSTOM_SCOPE_KEY);
+    if (!option_values.includes(dataset.value.initial_value)) {
+      addIssue({
+        message: `Scope: initial_value "${dataset.value.initial_value}" must exist in options`
+      });
+    }
+  }),
+  v2.transform((value) => {
+    const option_values = value.options.map((option) => option.value);
+    if (value.custom_scope && !option_values.includes(CUSTOM_SCOPE_KEY)) {
+      return {
+        ...value,
+        options: [
+          ...value.options,
+          {
+            label: CUSTOM_SCOPE_KEY,
+            value: CUSTOM_SCOPE_KEY,
+            hint: "Write a custom scope"
+          }
+        ]
+      };
+    }
+    return value;
+  })
+);
+var Config = v2.object({
+  check_status: v2.optional(v2.boolean(), true),
+  check_status_autocomplete: v2.optional(v2.boolean(), true),
+  commit_type: CommitTypeConfig,
+  commit_scope: CommitScopeConfig,
+  check_ticket: v2.optional(
+    v2.object({
+      infer_ticket: v2.optional(v2.boolean(), true),
+      confirm_ticket: v2.optional(v2.boolean(), true),
+      add_to_title: v2.optional(v2.boolean(), true),
+      append_hashtag: v2.optional(v2.boolean(), false),
+      prepend_hashtag: v2.optional(
+        v2.picklist(["Never", "Always", "Prompt"]),
+        "Never"
+      ),
+      surround: v2.optional(v2.picklist(["", "()", "[]", "{}"]), ""),
+      title_position: v2.optional(
+        v2.picklist(["start", "end", "before-colon", "beginning"]),
+        "start"
+      )
+    }),
+    {}
+  ),
+  commit_title: v2.optional(
+    v2.object({
+      max_size: v2.optional(v2.pipe(v2.number(), v2.minValue(1)), 70)
+    }),
+    {}
+  ),
+  commit_body: v2.optional(
+    v2.object({
+      enable: v2.optional(v2.boolean(), true),
+      required: v2.optional(v2.boolean(), false),
+      split_by_period: v2.optional(v2.boolean(), false)
+    }),
+    {}
+  ),
+  commit_footer: v2.optional(
+    v2.object({
+      enable: v2.optional(v2.boolean(), true),
+      initial_value: v2.optional(v2.array(V_FOOTER_OPTIONS), []),
+      options: v2.optional(v2.array(V_FOOTER_OPTIONS), FOOTER_OPTION_VALUES)
+    }),
+    {}
+  ),
+  breaking_change: v2.optional(
+    v2.object({
+      add_exclamation_to_title: v2.optional(v2.boolean(), true)
+    }),
+    {}
+  ),
+  cache_last_value: v2.optional(v2.boolean(), true),
+  confirm_with_editor: v2.optional(v2.boolean(), false),
+  confirm_commit: v2.optional(v2.boolean(), true),
+  print_commit_output: v2.optional(v2.boolean(), true),
+  branch_pre_commands: v2.optional(v2.array(v2.string()), []),
+  branch_post_commands: v2.optional(v2.array(v2.string()), []),
+  worktree_pre_commands: v2.optional(v2.array(v2.string()), []),
+  worktree_post_commands: v2.optional(v2.array(v2.string()), []),
+  branch_user: v2.optional(
+    v2.object({
+      enable: v2.optional(v2.boolean(), true),
+      required: v2.optional(v2.boolean(), false),
+      separator: v2.optional(v2.picklist(["/", "-", "_"]), "/")
+    }),
+    {}
+  ),
+  branch_type: v2.optional(
+    v2.object({
+      enable: v2.optional(v2.boolean(), true),
+      separator: v2.optional(v2.picklist(["/", "-", "_"]), "/"),
+      autocomplete: v2.optional(v2.boolean(), true)
+    }),
+    {}
+  ),
+  branch_scope: v2.optional(
+    v2.object({
+      enable: v2.optional(v2.boolean(), true),
+      separator: v2.optional(v2.picklist(["/", "-", "_"]), "-"),
+      autocomplete: v2.optional(v2.boolean(), true)
+    }),
+    {}
+  ),
+  branch_version: v2.optional(
+    v2.object({
+      enable: v2.optional(v2.boolean(), false),
+      required: v2.optional(v2.boolean(), false),
+      separator: v2.optional(v2.picklist(["/", "-", "_"]), "/")
+    }),
+    {}
+  ),
+  branch_ticket: v2.optional(
+    v2.object({
+      enable: v2.optional(v2.boolean(), true),
+      required: v2.optional(v2.boolean(), false),
+      separator: v2.optional(v2.picklist(["/", "-", "_"]), "-")
+    }),
+    {}
+  ),
+  branch_description: v2.optional(
+    v2.object({
+      max_length: v2.optional(v2.pipe(v2.number(), v2.minValue(1)), 70),
+      separator: v2.optional(v2.picklist(["", "/", "-", "_"]), "")
+    }),
+    {}
+  ),
+  branch_action_default: v2.optional(V_BRANCH_ACTIONS, "branch"),
+  branch_order: v2.optional(v2.array(V_BRANCH_FIELDS), BRANCH_ORDER_DEFAULTS),
+  enable_worktrees: v2.optional(v2.boolean(), true),
+  worktrees: v2.optional(
+    v2.object({
+      enable: v2.optional(v2.boolean(), true),
+      base_path: v2.optional(v2.string(), ".."),
+      folder_template: v2.optional(
+        v2.string(),
+        "{{repo_name}}-{{ticket}}-{{branch_description}}"
+      )
+    }),
+    {}
+  ),
+  overrides: v2.optional(
+    v2.object({
+      shell: v2.optional(v2.string())
+    }),
+    {}
+  )
+});
+var COMMIT_STATE_ENTRIES = {
+  type: v2.optional(v2.string(), ""),
+  scope: v2.optional(v2.string(), ""),
+  title: v2.optional(v2.string(), ""),
+  body: v2.optional(v2.string(), ""),
+  closes: v2.optional(v2.string(), ""),
+  ticket: v2.optional(v2.string(), ""),
+  breaking_title: v2.optional(v2.string(), ""),
+  breaking_body: v2.optional(v2.string(), ""),
+  deprecates: v2.optional(v2.string(), ""),
+  deprecates_title: v2.optional(v2.string(), ""),
+  deprecates_body: v2.optional(v2.string(), ""),
+  custom_footer: v2.optional(v2.string(), ""),
+  trailer: v2.optional(v2.string(), "")
+};
+var CommitState = v2.optional(v2.object(COMMIT_STATE_ENTRIES), {});
+var BRANCH_STATE_ENTRIES = {
+  user: v2.optional(v2.string(), ""),
+  type: v2.optional(v2.string(), ""),
+  scope: v2.optional(v2.string(), ""),
+  ticket: v2.optional(v2.string(), ""),
+  description: v2.optional(v2.string(), ""),
+  version: v2.optional(v2.string(), ""),
+  checkout: v2.optional(V_BRANCH_ACTIONS, "branch")
+};
+var BranchState = v2.optional(v2.object(BRANCH_STATE_ENTRIES), {});
+
+// src/args.ts
+import { parse } from "@bomb.sh/args";
+var COMMIT_OPTIONS = [
+  "type",
+  "scope",
+  "title",
+  "body",
+  "ticket",
+  "closes",
+  "trailer",
+  "breaking-title",
+  "breaking-body",
+  "deprecates-title",
+  "deprecates-body",
+  "custom-footer"
+];
+var GIT_OPTIONS = ["git-dir", "work-tree"];
+var BOOLEAN_FLAGS = [
+  "interactive",
+  "dry-run",
+  "help",
+  "version"
+];
+var Flags = class {
+  #runtime;
+  constructor(runtime) {
+    this.#runtime = runtime;
+  }
+  get git_args() {
+    return this.#runtime.git_args;
+  }
+  get interactive() {
+    return !this.#runtime.no_interactive;
+  }
+  get dry_run() {
+    return this.#runtime.dry_run;
+  }
+  get help() {
+    return this.#runtime.help;
+  }
+  get version() {
+    return this.#runtime.version;
+  }
+  get commit_state() {
+    return this.#runtime.commit_state;
+  }
+};
+var flags = new Flags(parse_runtime_flags(process.argv.slice(2)));
+function parse_runtime_flags(argv) {
+  const parsed = parse(argv, {
+    alias: { h: "help", v: "version" },
+    boolean: BOOLEAN_FLAGS,
+    string: [...COMMIT_OPTIONS, ...GIT_OPTIONS]
+  });
+  const commit_state = {};
+  COMMIT_OPTIONS.forEach((value) => {
+    const cli_value = parsed[value];
+    const normalized_value = normalize_commit_flag(value, cli_value);
+    if (normalized_value !== void 0) {
+      const str = value.replace("-", "_");
+      commit_state[str] = normalized_value;
+    }
+  });
+  return {
+    help: parsed["help"] === true,
+    version: parsed["version"] === true,
+    git_args: get_git_args(parsed["git-dir"], parsed["work-tree"]),
+    no_interactive: parsed.interactive === false,
+    dry_run: parsed["dry-run"] === true,
+    commit_state
+  };
+}
+function normalize_commit_flag(option, value) {
+  if (value === void 0)
+    return void 0;
+  if (option !== "closes")
+    return value;
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "false") {
+    return void 0;
+  }
+  if (value === "" || normalized) {
+    return "Closes:";
+  }
+  return void 0;
+}
+function get_git_args(git_dir, work_tree) {
+  return `${git_dir ? `--git-dir=${git_dir}` : ""} ${work_tree ? `--work-tree=${work_tree}` : ""}`.trim();
+}
+
+// src/default-config-template.ts
+var DEFAULT_CONFIG_TEMPLATE = `{
+  // Run interactive \`git status\` before composing a commit
+  "check_status": true,
+  "check_status_autocomplete": true,
+
+  /* COMMIT FIELDS */
+  "commit_type": {
+    "enable": true,
+
+    // Default selected type from options
+    "initial_value": "feat",
+
+    "max_items": 20,
+
+    // Infer type from the current branch name: user/TYPE/my-branch
+    "infer_type_from_branch": true,
+
+    // Include emoji in prompt label
+    "append_emoji_to_label": false,
+
+    // Include emoji from prompt label in commit message
+    "append_emoji_to_commit": false,
+
+    // "Start" | "After-Colon"
+    "emoji_commit_position": "Start",
+
+    "autocomplete": true,
+
+    "options": [
+      {
+        "value": "feat",
+        "label": "feat",
+        "hint": "A new feature",
+        "emoji": "\u{1F31F}",
+        "trailer": "Changelog: feature"
+      },
+      {
+        "value": "fix",
+        "label": "fix",
+        "hint": "A bug fix",
+        "emoji": "\u{1F41B}",
+        "trailer": "Changelog: fix"
+      },
+      {
+        "value": "docs",
+        "label": "docs",
+        "hint": "Documentation only changes",
+        "emoji": "\u{1F4DA}",
+        "trailer": "Changelog: documentation"
+      },
+      {
+        "value": "refactor",
+        "label": "refactor",
+        "hint": "A code change that neither fixes a bug nor adds a feature",
+        "emoji": "\u{1F528}",
+        "trailer": "Changelog: refactor"
+      },
+      {
+        "value": "perf",
+        "label": "perf",
+        "hint": "A code change that improves performance",
+        "emoji": "\u{1F680}",
+        "trailer": "Changelog: performance"
+      },
+      {
+        "value": "test",
+        "label": "test",
+        "hint": "Adding missing tests or correcting existing tests",
+        "emoji": "\u{1F6A8}",
+        "trailer": "Changelog: test"
+      },
+      {
+        "value": "build",
+        "label": "build",
+        "hint": "Changes that affect the build system or external dependencies",
+        "emoji": "\u{1F6A7}",
+        "trailer": "Changelog: build"
+      },
+      {
+        "value": "ci",
+        "label": "ci",
+        "hint": "Changes to our CI configuration files and scripts",
+        "emoji": "\u{1F916}",
+        "trailer": "Changelog: ci"
+      },
+      {
+        "value": "chore",
+        "label": "chore",
+        "hint": "Other changes that do not modify src or test files",
+        "emoji": "\u{1F9F9}",
+        "trailer": "Changelog: chore"
+      },
+      {
+        "value": "",
+        "label": "none"
+      }
+    ]
+  },
+
+  "commit_scope": {
+    "enable": true,
+
+    // If true, users can type a scope not listed in options
+    "custom_scope": false,
+
+    // Default selected scope from options
+    "initial_value": "app",
+
+    // Infer scope from the current branch name: user/type/ticket-SCOPE-my-branch
+    "infer_scope_from_branch": true,
+
+    "max_items": 20,
+    "autocomplete": true,
+    "options": [
+      { "value": "app", "label": "app" },
+      { "value": "shared", "label": "shared" },
+      { "value": "server", "label": "server" },
+      { "value": "tools", "label": "tools" },
+      { "value": "", "label": "none" }
+    ]
+  },
+
+  "check_ticket": {
+    // Infer ticket / issue from the branch name - user/type/TICKET-my-branch
+    "infer_ticket": true,
+
+    // Prompt for confirmation / edit before using an inferred ticket
+    "confirm_ticket": true,
+
+    // Add the ticket to the commit title - feat(app): TICKET my commit title
+    "add_to_title": true,
+
+    // Deprecated, prefer \`prepend_hashtag\`
+    "append_hashtag": false,
+
+    // "Never" | "Prompt" | "Always" - 12345 --> #12345
+    "prepend_hashtag": "Never",
+
+    // Wrap the ticket in the commit title: "" | "[]" | "()" | "{}"
+    "surround": "",
+
+    // "start" | "end" | "before-colon" | "beginning"
+    "title_position": "start"
+  },
+
+  "commit_title": {
+    // Includes total size of title + type + scope + ticket
+    "max_size": 70
+  },
+
+  "commit_body": {
+    "enable": true,
+    "required": false,
+
+    // Split sentences into multiple lines automatically
+    "split_by_period": false
+  },
+
+  "commit_footer": {
+    "enable": true,
+    "initial_value": [],
+
+    // "closes", "trailer", "breaking-change", "deprecated", "custom"
+    "options": ["closes", "trailer", "breaking-change", "deprecated", "custom"]
+  },
+
+  "breaking_change": {
+    // Adds \`!\` to the commit title when a breaking change is selected
+    "add_exclamation_to_title": true
+  },
+
+  // Confirm / edit with $GIT_EDITOR or $EDITOR
+  "confirm_with_editor": false,
+
+  // Show a final confirmation prompt before running git commit
+  "confirm_commit": true,
+
+  // Reuse the last known value from a previous canceled or failed commit
+  "cache_last_value": true,
+
+  // Pretty-print the final commit preview before execution
+  "print_commit_output": true,
+
+  /* BRANCH FIELDS */
+  // Optional shell commands to run before / after creating branches or worktrees
+  "branch_pre_commands": [],
+  "branch_post_commands": [],
+  "worktree_pre_commands": [],
+  "worktree_post_commands": [],
+
+  "branch_user": {
+    "enable": true,
+    "required": false,
+
+    // "/" | "-" | "_" - user/feat/my-branch
+    "separator": "/"
+  },
+
+  "branch_type": {
+    "enable": true,
+    "separator": "/",
+    "autocomplete": true,
+  },
+
+  "branch_scope": {
+    "enable": true,
+    "separator": "-",
+    "autocomplete": true,
+  },
+
+  "branch_ticket": {
+    "enable": true,
+    "required": false,
+    "separator": "-"
+  },
+
+  "branch_version": {
+    "enable": false,
+    "required": false,
+    "separator": "/"
+  },
+
+  "branch_description": {
+    // Maximum length for the description segment of the branch name
+    "max_length": 70,
+
+    // Allowed values: "" | "/" | "-" | "_"
+    "separator": ""
+  },
+
+  // "branch" | "worktree"
+  "branch_action_default": "branch",
+
+  // Order of values in the final branch name
+  "branch_order": ["user", "version", "type", "ticket", "scope", "description"],
+
+  // Deprecated, prefer \`worktrees.enable\`
+  "enable_worktrees": true,
+
+  "worktrees": {
+    // If false, always create a branch instead of prompting for a worktree
+    "enable": true,
+
+    // Directory where worktrees are created
+    "base_path": "..",
+
+    // Available template variables include:
+    // {{repo_name}}, {{branch_description}}, {{user}}, {{type}}, {{scope}}, {{ticket}}, {{version}}
+    "folder_template": "{{repo_name}}-{{ticket}}-{{branch_description}}"
+  },
+
+  /* OTHER FIELDS */
+  "overrides": {
+    // Useful on Windows or for shells with different multiline behavior
+    "shell": "/bin/sh"
+  }
+}
+`;
+
+// src/utils.ts
+import * as p from "@clack/prompts";
+import { execSync } from "child_process";
+import fs from "fs";
+import { homedir } from "os";
+import { parse as parse_jsonc } from "jsonc-parser";
+import color from "picocolors";
+import { ValiError, parse as parse2 } from "valibot";
+var CONFIG_FILE_NAMES = [
+  ".better-commits.jsonc",
+  ".better-commits.json"
+];
+var CONFIG_FILE_NAME = CONFIG_FILE_NAMES[0];
+var COMMIT_FOOTER_OPTIONS = [
+  {
+    value: "closes",
+    label: "closes <issue/ticket>",
+    hint: "Attempts to infer ticket from branch"
+  },
+  {
+    value: "trailer",
+    label: "trailer",
+    hint: "Appends trailer based on commit type"
+  },
+  {
+    value: "breaking-change",
+    label: "breaking change",
+    hint: "Add breaking change"
+  },
+  { value: "deprecated", label: "deprecated", hint: "Add deprecated change" },
+  { value: "custom", label: "custom", hint: "Add a custom footer" }
+];
+var BRANCH_ACTION_OPTIONS = [
+  { value: "branch", label: "Branch" },
+  { value: "worktree", label: "Worktree" }
+];
+var NOOP_PROMPT_CACHE = {
+  get: () => "",
+  set: (key, value) => {
+  },
+  clear: () => {
+  }
+};
+function load_setup(cli_name = " better-commits ", git_args = flags.git_args) {
+  console.clear();
+  p.intro(`${color.bgCyan(color.black(cli_name))}`);
+  let global_config = null;
+  const home_path = get_default_config_path();
+  if (fs.existsSync(home_path)) {
+    global_config = read_config_from_path(home_path);
+  }
+  const root = get_git_root(git_args);
+  const root_path = get_repository_config_path(root);
+  if (root_path) {
+    p.log.step("Reading from Repository Config");
+    const repo_config = read_config_from_path(root_path);
+    return {
+      config: global_config ? {
+        ...repo_config,
+        overrides: global_config.overrides.shell ? global_config.overrides : repo_config.overrides,
+        confirm_with_editor: global_config.confirm_with_editor,
+        cache_last_value: global_config.cache_last_value
+      } : repo_config,
+      config_source: "repository"
+    };
+  }
+  if (global_config) {
+    p.log.step("Reading from Global Config");
+    return {
+      config: global_config,
+      config_source: "global"
+    };
+  }
+  const default_config = parse2(Config, {});
+  p.log.step(
+    `Config not found. Generating default ${CONFIG_FILE_NAME} at $HOME`
+  );
+  fs.writeFileSync(home_path, DEFAULT_CONFIG_TEMPLATE);
+  return {
+    config: default_config,
+    config_source: "none"
+  };
+}
+function read_config_from_path(config_path) {
+  let res = null;
+  try {
+    res = parse_jsonc(fs.readFileSync(config_path, "utf8"));
+  } catch (err) {
+    p.log.error(
+      `Invalid JSON/JSONC config file at ${config_path}. Exiting.
+` + err
+    );
+    process.exit(0);
+  }
+  return validate_config(res);
+}
+function validate_config(config) {
+  try {
+    return parse2(Config, config);
+  } catch (err) {
+    if (err instanceof ValiError) {
+      const first_issue_path = err.issues[0].path ?? [];
+      const dot_path = first_issue_path.map((item) => item.key).filter(
+        (key) => typeof key === "string" || typeof key === "number"
+      ).join(".");
+      p.log.error(
+        `Invalid Configuration: ${color.red(dot_path)}
+` + err.message
+      );
+    }
+    process.exit(0);
+  }
+}
+function get_git_root(git_args = flags.git_args) {
+  let path = ".";
+  try {
+    path = execSync(`git ${git_args} rev-parse --show-toplevel`).toString().trim();
+  } catch (err) {
+    p.log.warn(
+      "Could not find git root. If in a --bare repository, ignore this warning."
+    );
+  }
+  return path;
+}
+function get_default_config_path() {
+  return get_config_path(homedir()) ?? homedir() + "/" + CONFIG_FILE_NAME;
+}
+function get_repository_config_path(root) {
+  return get_config_path(root);
+}
+function get_config_path(base_path) {
+  for (const file_name of CONFIG_FILE_NAMES) {
+    const config_path = `${base_path}/${file_name}`;
+    if (fs.existsSync(config_path))
+      return config_path;
+  }
+  return null;
+}
+function get_package_version() {
+  try {
+    const package_json = JSON.parse(
+      fs.readFileSync(new URL("../package.json", import.meta.url), "utf8")
+    );
+    return package_json.version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+function addNewLine(arr, i) {
+  return i === arr.length - 1 ? "" : "\n";
+}
+function clean_commit_title(title) {
+  const title_trimmed = title.trim();
+  const remove_period = title_trimmed.endsWith(".");
+  if (remove_period) {
+    return title_trimmed.substring(0, title_trimmed.length - 1).trim();
+  }
+  return title.trim();
+}
+function get_value_from_cache(config_store, key) {
+  try {
+    return config_store.get(key) ?? "";
+  } catch (err) {
+    p.log.warn(
+      `Could not access ${key} from cache. Check that "~/.config" exists. Set "cache_last_value" to false to disable.`
+    );
+  }
+  return "";
+}
+function set_value_cache(config_store, key, value) {
+  try {
+    config_store.set(key, value);
+  } catch (err) {
+    p.log.warn(
+      `Could not access ${key} from cache. Check that "~/.config" exists. Set "cache_last_value" to false to disable.`
+    );
+  }
+}
+
+export {
+  CUSTOM_SCOPE_KEY,
+  COMMIT_STATE_ENTRIES,
+  CommitState,
+  BRANCH_STATE_ENTRIES,
+  BranchState,
+  flags,
+  DEFAULT_CONFIG_TEMPLATE,
+  CONFIG_FILE_NAME,
+  COMMIT_FOOTER_OPTIONS,
+  BRANCH_ACTION_OPTIONS,
+  NOOP_PROMPT_CACHE,
+  load_setup,
+  get_git_root,
+  get_repository_config_path,
+  get_package_version,
+  addNewLine,
+  clean_commit_title,
+  get_value_from_cache,
+  set_value_cache
+};