@aurodesignsystem/auro-library 5.14.1 → 5.14.2

package/dist/build/processors/defaultDocsProcessor.mjs

@@ -0,0 +1,16 @@
+import{createRequire as __auroCreateRequire}from'node:module';const require=__auroCreateRequire(import.meta.url);
+import {
+  defaultDocsProcessorConfig,
+  fileConfigs,
+  processDocFiles
+} from "../../_chunks/chunk-H7YO7ERJ.mjs";
+import "../../_chunks/chunk-UY4SIQT6.mjs";
+import "../../_chunks/chunk-RKBXVLA5.mjs";
+import "../../_chunks/chunk-2MOEVVSZ.mjs";
+import "../../_chunks/chunk-V7YBXHAI.mjs";
+import "../../_chunks/chunk-TDFKN2EP.mjs";
+export {
+  defaultDocsProcessorConfig,
+  fileConfigs,
+  processDocFiles
+};

package/dist/build/processors/defaultDotGithubSync.mjs

@@ -0,0 +1,12 @@
+import{createRequire as __auroCreateRequire}from'node:module';const require=__auroCreateRequire(import.meta.url);
+import {
+  syncGithubFiles
+} from "../../_chunks/chunk-JLCAYVRX.mjs";
+import "../../_chunks/chunk-UY4SIQT6.mjs";
+import "../../_chunks/chunk-RKBXVLA5.mjs";
+import "../../_chunks/chunk-2MOEVVSZ.mjs";
+import "../../_chunks/chunk-V7YBXHAI.mjs";
+import "../../_chunks/chunk-TDFKN2EP.mjs";
+export {
+  syncGithubFiles
+};

package/dist/build/syncGithubFiles.mjs

@@ -0,0 +1,18 @@
+import{createRequire as __auroCreateRequire}from'node:module';const require=__auroCreateRequire(import.meta.url);
+import {
+  syncGithubFiles
+} from "../_chunks/chunk-JLCAYVRX.mjs";
+import "../_chunks/chunk-UY4SIQT6.mjs";
+import "../_chunks/chunk-RKBXVLA5.mjs";
+import {
+  Logger
+} from "../_chunks/chunk-2MOEVVSZ.mjs";
+import "../_chunks/chunk-V7YBXHAI.mjs";
+import "../_chunks/chunk-TDFKN2EP.mjs";
+
+// src/build/syncGithubFiles.mjs
+syncGithubFiles().then(() => {
+  Logger.log("Docs processed successfully");
+}).catch((err) => {
+  Logger.error(`Error processing docs: ${err.message}`);
+});

package/dist/utils/auroTemplateFiller.mjs

@@ -0,0 +1,8 @@
+import{createRequire as __auroCreateRequire}from'node:module';const require=__auroCreateRequire(import.meta.url);
+import {
+  AuroTemplateFiller
+} from "../_chunks/chunk-RKBXVLA5.mjs";
+import "../_chunks/chunk-TDFKN2EP.mjs";
+export {
+  AuroTemplateFiller
+};

package/dist/utils/sharedFileProcessorUtils.mjs

@@ -0,0 +1,31 @@
+import{createRequire as __auroCreateRequire}from'node:module';const require=__auroCreateRequire(import.meta.url);
+import {
+  MD_MAGIC_CONFIG,
+  auroLibraryUtils,
+  fromAuroComponentRoot,
+  generateReadmeUrl,
+  generateWCGeneratorUrl,
+  nonEsmComponents,
+  optionallyCopyFile,
+  processContentForFile,
+  retrieveRemoteFileCopy,
+  runMarkdownMagicOnFile,
+  templateFiller
+} from "../_chunks/chunk-UY4SIQT6.mjs";
+import "../_chunks/chunk-RKBXVLA5.mjs";
+import "../_chunks/chunk-2MOEVVSZ.mjs";
+import "../_chunks/chunk-V7YBXHAI.mjs";
+import "../_chunks/chunk-TDFKN2EP.mjs";
+export {
+  MD_MAGIC_CONFIG,
+  auroLibraryUtils,
+  fromAuroComponentRoot,
+  generateReadmeUrl,
+  generateWCGeneratorUrl,
+  nonEsmComponents,
+  optionallyCopyFile,
+  processContentForFile,
+  retrieveRemoteFileCopy,
+  runMarkdownMagicOnFile,
+  templateFiller
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aurodesignsystem/auro-library",
-  "version": "5.14.1",
+  "version": "5.14.2",
   "description": "This repository holds shared scripts, utilities, and workflows utilized across repositories along the Auro Design System.",
   "repository": {
     "type": "git",
@@ -15,12 +15,10 @@
     "generateDocs": "./bin/generateDocs.mjs"
   },
   "dependencies": {
-    "handlebars": "^4.7.8",
-    "markdown-magic": "^2.6.1",
     "@floating-ui/dom": "^1.7.4"
   },
   "devDependencies": {
-    "@aurodesignsystem/auro-cli": "^3.5.1",
+    "@aurodesignsystem/auro-cli": "^3.7.1",
     "@aurodesignsystem/auro-config": "^1.3.1",
     "@commitlint/cli": "^18.5.0",
     "@commitlint/config-conventional": "^18.5.0",
@@ -28,7 +26,11 @@
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/npm": "^13.0.0",
+    "esbuild": "^0.24.2",
+    "glob": "^11.0.3",
+    "handlebars": "^4.7.8",
     "husky": "^9.1.7",
+    "markdown-magic": "^2.6.1",
     "npm-run-all": "^4.1.5",
     "semantic-release": "^25.0.0",
     "sinon": "^20.0.0",
@@ -74,10 +76,13 @@
     "provenance": true
   },
   "scripts": {
-    "prepare": "husky install",
+    "prepare": "husky install && npm run build:bundles",
+    "prepack": "npm run build:bundles",
     "lint": "biome check --no-errors-on-unmatched",
     "lint:fix": "biome check --fix --no-errors-on-unmatched",
+    "build:bundles": "node build/bundleDocsScripts.mjs",
     "build:docs": "node scripts/build/generateReadme.mjs",
+    "pretest:vitest": "npm run build:bundles",
     "test:vitest": "vitest  --run",
     "test:vitest:watch": "vitest",
     "test:auro": "auro test --files 'scripts/**/*.test.js'",

package/scripts/build/generateDocs.mjs

@@ -1,24 +1,4 @@
-// ------------------------------------------------------
-// Docs Generation
-// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-//
-// This script will generate the docs for the component
-// based on example HTML, markdown files, and more.
-//
-// The actions in this file live in:
-// scripts/build/processors/defaultDocsProcessor.mjs
-//
-// This script is intended to be run AS-IS without modification.
-// To run a different processor, please see the defaultDocsProcessor.mjs file
-// and re-create in your repo OR add a new processor file.
-// ------------------------------------------------------
-
-import {Logger} from "../utils/logger.mjs";
-import {processDocFiles} from "./processors/defaultDocsProcessor.mjs";
-
-processDocFiles().then(() => {
-  Logger.log('Docs processed successfully');
-}).
-  catch((err) => {
-    Logger.error(`Error processing docs: ${err.message}`);
-  });
+// Shim for the pre-compiled build. Do not edit.
+// Generated by build/bundleDocsScripts.mjs from src/build/generateDocs.mjs.
+// Edit that file, then run `npm run build:bundles`.
+import "../../dist/build/generateDocs.mjs";

package/scripts/build/generateReadme.mjs

@@ -1,60 +1,4 @@
-import markdownMagic from 'markdown-magic';
-import * as fs from 'fs';
-
-const dirDocs = './docs';
-const readmeFilePath = dirDocs + '/README.md';
-
-import AuroLibraryUtils from "../utils/auroLibraryUtils.mjs";
-
-const auroLibraryUtils = new AuroLibraryUtils();
-
-/**
- * Compiles `./docs/README.md` -> `./README.md`
- */
-
-function processReadme() {
-  const callback = function() {
-
-    if (fs.existsSync('./README.md')) {
-      fs.readFile('./README.md', 'utf8', function(err, data) {
-        auroLibraryUtils.formatFileContents(data, './README.md');
-      });
-    } else {
-      console.log('ERROR: ./README.md file is missing');
-    }
-  };
-
-  const config = {
-    matchWord: 'AURO-GENERATED-CONTENT',
-    outputDir: './'
-  };
-
-  const markdownPath = './docs/README.md';
-
-  markdownMagic(markdownPath, config, callback);
-
-  fs.copyFileSync(readmeFilePath, './README.md');
-}
-
-/**
- * Copy README.md template from static source
- * */
-
-function copyReadmeLocally() {
-
-  if (!fs.existsSync(dirDocs)){
-    fs.mkdirSync(dirDocs);
-  }
-
-  if (!fs.existsSync(readmeFilePath)) {
-    fs.writeFile(readmeFilePath, '', function(err) {
-      if(err) {
-        console.log('ERROR: Unable to create README.md file.', err);
-      }
-    });
-  }
-
-  processReadme();
-}
-
-copyReadmeLocally();
+// Shim for the pre-compiled build. Do not edit.
+// Generated by build/bundleDocsScripts.mjs from src/build/generateReadme.mjs.
+// Edit that file, then run `npm run build:bundles`.
+import "../../dist/build/generateReadme.mjs";

package/scripts/build/generateWcaComponent.mjs

@@ -1,43 +1,4 @@
-import fs from 'fs';
-import path from 'path';
-import glob from 'glob';
-import util from 'util';
-import getTemplatedComponentCode from './prepWcaCompatibleCode.mjs';
-
-const promisifiedGlob = util.promisify(glob);
-
-const WAC_DIR = path.resolve(process.cwd(), './scripts/wca');
-
-async function globPath(sources) {
-  try {
-    const fileArrays = await Promise.all(
-      sources.map(source => promisifiedGlob(source))
-    );
-    return fileArrays.flat();
-  } catch (err) {
-    console.error('Error processing glob patterns:', err);
-    throw err; // Re-throw to handle failure at caller
-  }
-}
-
-async function createExtendsFile(filePaths) {
-  if (!fs.existsSync(WAC_DIR)) {
-    await fs.promises.mkdir(WAC_DIR, { recursive: true });
-  }
-
-  for (const filePath of filePaths) {
-    const resolvedPath = path.resolve(process.cwd(), filePath);
-    const fileContent = await fs.promises.readFile(resolvedPath, 'utf-8',);
-    const newPath = path.resolve(WAC_DIR, `${path.basename(filePath)}`);
-    const newCode = getTemplatedComponentCode(fileContent, path.relative(WAC_DIR, filePath));
-    await fs.promises.writeFile(newPath, newCode);
-  }
-}
-
-async function main() {
-  // files to analyze
-  const filePaths = await globPath(process.argv.slice(2));
-  await createExtendsFile(filePaths);
-}
-
-main();
+// Shim for the pre-compiled build. Do not edit.
+// Generated by build/bundleDocsScripts.mjs from src/build/generateWcaComponent.mjs.
+// Edit that file, then run `npm run build:bundles`.
+import "../../dist/build/generateWcaComponent.mjs";

package/scripts/build/postinstall.mjs

@@ -1,14 +1,12 @@
-'use strict';
-
-import chalk from 'chalk';
-import { createRequire } from 'node:module';
-import { resolve } from 'path';
-
+import { createRequire } from "node:module";
+import { resolve } from "path";
+import { hex } from "../utils/ansiColors.mjs";
 
 const require = createRequire(import.meta.url);
-const pjson = require(resolve(process.cwd(), 'package.json'));
+const pjson = require(resolve(process.cwd(), "package.json"));
 
-console.log(chalk.hex('#f26135')(`
+console.log(
+  hex("#f26135")(`
 
  _______                   __           __ __
 |     __|.---.-.--.--.    |  |--.-----.|  |  |.-----.
@@ -24,8 +22,10 @@ console.log(chalk.hex('#f26135')(`
 ╭ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ──────────────────────────────╮
 
         Thanks for installing the latest version
-        of `) + chalk.hex('#ffd200').bold(`${pjson.name} v${pjson.version}.`) + chalk.hex('#f26135')(`
+        of `) +
+    hex("#ffd200").bold(`${pjson.name} v${pjson.version}.`) +
+    hex("#f26135")(`
 
 ╰─────────────────────────────── ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─╯
-`)
+`),
 );

package/scripts/build/pre-commit.mjs

@@ -1,17 +1,23 @@
 /* eslint-disable no-console */
 
-import chalk from 'chalk';
+import { hex } from "../utils/ansiColors.mjs";
 
-console.log(chalk.hex('#ffd200')(`
+console.log(
+  hex("#ffd200")(`
 
-╭ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ──────────────────────────────╮`) + chalk.hex('#f26135')(`
+╭ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ──────────────────────────────╮`) +
+    hex("#f26135")(`
 
     Are you familiar with Auro's Definition of Done?
 
-                Please be sure to review`) + chalk.hex('#ffd200')(`
-      https://auro.alaskaair.com/definition-of-done`) + chalk.hex('#f26135')(`
+                Please be sure to review`) +
+    hex("#ffd200")(`
+      https://auro.alaskaair.com/definition-of-done`) +
+    hex("#f26135")(`
             before submitting your pull request
-             to ensure that you are compliant.`) + chalk.hex('#ffd200')(`
+             to ensure that you are compliant.`) +
+    hex("#ffd200")(`
 
 ╰─────────────────────────────── ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─╯
-`));
+`),
+);

package/scripts/build/processors/defaultDocsProcessor.mjs

@@ -1,83 +1,4 @@
-import {Logger} from "../../utils/logger.mjs";
-import {
-  fromAuroComponentRoot,
-  generateReadmeUrl,
-  processContentForFile,
-  templateFiller
-} from "../../utils/sharedFileProcessorUtils.mjs";
-
-/**
- * Processor config object.
- * @typedef {Object} ProcessorConfig
- * @property {boolean} [overwriteLocalCopies=true] - The release version tag to use instead of master.
- * @property {string} [remoteReadmeVersion="master"] - The release version tag to use instead of master.
- * @property {string} [remoteReadmeVariant=""] - The variant string to use for the README source.
- * (like "_esm" to make README_esm.md).
- */
-
-
-/**
- * @param {ProcessorConfig} config - The configuration for this processor.
- */
-export const defaultDocsProcessorConfig = {
-  overwriteLocalCopies: true,
-  remoteReadmeVersion: "master",
-  // eslint-disable-next-line no-warning-comments
-  // TODO: remove this variant when all components are updated to use latest auro-library
-  // AND the default README.md is updated to use the new paths
-  remoteReadmeVariant: "_updated_paths"
-};
-
-/**
- * @param {ProcessorConfig} config - The configuration for this processor.
- * @returns {import('../utils/sharedFileProcessorUtils').FileProcessorConfig[]}
- */
-export const fileConfigs = (config) => [
-  // README.md
-  {
-    identifier: 'README.md',
-    input: {
-      remoteUrl: generateReadmeUrl(config.remoteReadmeVersion, config.remoteReadmeVariant),
-      fileName: fromAuroComponentRoot(`/docTemplates/README.md`),
-      overwrite: config.overwriteLocalCopies
-    },
-    output: fromAuroComponentRoot("/README.md")
-  },
-  // index.md
-  {
-    identifier: 'index.md',
-    input: fromAuroComponentRoot("/docs/partials/index.md"),
-    output: fromAuroComponentRoot("/demo/index.md"),
-    mdMagicConfig: {
-      output: {
-        directory: fromAuroComponentRoot("/demo")
-      }
-    }
-  },
-  // api.md
-  {
-    identifier: 'api.md',
-    input: fromAuroComponentRoot("/docs/partials/api.md"),
-    output: fromAuroComponentRoot("/demo/api.md"),
-    preProcessors: [templateFiller.formatApiTable],
-  }
-];
-
-/**
- *
- * @param {ProcessorConfig} config - The configuration for this processor.
- * @return {Promise<void>}
- */
-export async function processDocFiles(config = defaultDocsProcessorConfig) {
-  // setup
-  await templateFiller.extractNames();
-
-  for (const fileConfig of fileConfigs(config)) {
-    try {
-      // eslint-disable-next-line no-await-in-loop
-      await processContentForFile(fileConfig);
-    } catch (err) {
-      Logger.error(`Error processing ${fileConfig.identifier}: ${err.message}`);
-    }
-  }
-}
+// Shim for the pre-compiled build. Do not edit.
+// Generated by build/bundleDocsScripts.mjs from src/build/processors/defaultDocsProcessor.mjs.
+// Edit that file, then run `npm run build:bundles`.
+export * from "../../../dist/build/processors/defaultDocsProcessor.mjs";

package/scripts/build/processors/defaultDotGithubSync.mjs

@@ -1,83 +1,4 @@
-import {Logger} from "../../utils/logger.mjs";
-import {
-  fromAuroComponentRoot,
-  generateWCGeneratorUrl,
-  processContentForFile,
-  templateFiller
-} from "../../utils/sharedFileProcessorUtils.mjs";
-
-/**
- * Processor config object.
- * @typedef {Object} ProcessorConfig
- * @property {boolean} [overwriteLocalCopies=true] - The release version tag to use instead of master.
- * @property {string} [generatorTemplateVersion="master"] - The release version tag to use instead of master.
- * (like "_esm" to make README_esm.md).
- */
-
-const DOT_GITHUB_PATH = '.github';
-const ISSUE_TEMPLATE_PATH = `${DOT_GITHUB_PATH}/ISSUE_TEMPLATE`;
-
-/**
- * @type {ProcessorConfig} config - The default configuration for this processor.
- */
-const defaultGitHubSyncConfig = {
-  overwriteLocalCopies: true,
-  generatorTemplateVersion: "master",
-};
-
-/**
- * @param {ProcessorConfig} config - The configuration for this processor.
- * @returns {import('../utils/sharedFileProcessorUtils').FileProcessorConfig[]}
- */
-const defaultGitHubTemplateFiles = (config = defaultGitHubSyncConfig) => [
-  // bug_report.yml
-  {
-    identifier: 'bug_report.yml',
-    input: {
-      remoteUrl: generateWCGeneratorUrl(config.generatorTemplateVersion, `templates/${ISSUE_TEMPLATE_PATH}/bug_report.yml`),
-      fileName: fromAuroComponentRoot(`docTemplates/${ISSUE_TEMPLATE_PATH}/bug_report.yml`),
-      overwrite: config.overwriteLocalCopies
-    },
-    output: fromAuroComponentRoot(`${ISSUE_TEMPLATE_PATH}/bug_report.yml`)
-  },
-  // config.yml
-  {
-    identifier: 'config.yml',
-    input: {
-      remoteUrl: generateWCGeneratorUrl(config.generatorTemplateVersion, `templates/${ISSUE_TEMPLATE_PATH}/config.yml`),
-      fileName: fromAuroComponentRoot(`docTemplates/${ISSUE_TEMPLATE_PATH}/config.yml`),
-      overwrite: config.overwriteLocalCopies
-    },
-    output: fromAuroComponentRoot(`${ISSUE_TEMPLATE_PATH}/config.yml`)
-  },
-  // PULL_REQUEST_TEMPLATE.md
-  {
-    identifier: 'PULL_REQUEST_TEMPLATE.md',
-    input: {
-      remoteUrl: generateWCGeneratorUrl(config.generatorTemplateVersion, `templates/${DOT_GITHUB_PATH}/PULL_REQUEST_TEMPLATE.md`),
-      fileName: fromAuroComponentRoot(`docTemplates/${DOT_GITHUB_PATH}/PULL_REQUEST_TEMPLATE.md`),
-      overwrite: config.overwriteLocalCopies
-    },
-    output: fromAuroComponentRoot(`${DOT_GITHUB_PATH}/PULL_REQUEST_TEMPLATE.md`)
-  },
-];
-
-/**
- *
- * @param {ProcessorConfig} config - The configuration for this processor.
- * @return {Promise<void>}
- */
-export async function syncGithubFiles(config = defaultGitHubSyncConfig) {
-  // setup
-  await templateFiller.extractNames();
-
-  for (const file of defaultGitHubTemplateFiles(config)) {
-    try {
-      Logger.log(`Processing file: ${file.identifier}`);
-      // eslint-disable-next-line no-await-in-loop
-      await processContentForFile(file);
-    } catch (error) {
-      Logger.error(`Error processing file: ${file.identifier}, ${error.message}`);
-    }
-  }
-}
+// Shim for the pre-compiled build. Do not edit.
+// Generated by build/bundleDocsScripts.mjs from src/build/processors/defaultDotGithubSync.mjs.
+// Edit that file, then run `npm run build:bundles`.
+export * from "../../../dist/build/processors/defaultDotGithubSync.mjs";

package/scripts/build/syncGithubFiles.mjs

@@ -1,25 +1,4 @@
-// ------------------------------------------------------
-// GitHub Config Sync
-// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-//
-// This script will synchronize shared GitHub config
-// files to the local repo (eventually, anything that lives
-// in the .github directory).
-//
-// The actions in this file live in:
-// scripts/build/processors/defaultDotGithubSync.mjs
-//
-// This script is intended to be run AS-IS without modification.
-// To run a different processor, please see the defaultDotGithubSync.mjs file
-// and re-create in your repo OR add a new processor file.
-// ------------------------------------------------------
-
-import {syncGithubFiles} from "./processors/defaultDotGithubSync.mjs";
-import {Logger} from "../utils/logger.mjs";
-
-syncGithubFiles().then(() => {
-  Logger.log('Docs processed successfully');
-}).
-  catch((err) => {
-    Logger.error(`Error processing docs: ${err.message}`);
-  });
+// Shim for the pre-compiled build. Do not edit.
+// Generated by build/bundleDocsScripts.mjs from src/build/syncGithubFiles.mjs.
+// Edit that file, then run `npm run build:bundles`.
+import "../../dist/build/syncGithubFiles.mjs";

package/scripts/utils/ansiColors.mjs

@@ -0,0 +1,119 @@
+// Minimal stand-in for the slice of `chalk` this package used: `hex(color)(text)`
+// and `hex(color).bold(text)`.
+//
+// auro-library is a runtime dependency of nearly every Auro component, so
+// anything imported by a published script is installed into every downstream
+// project. `chalk` was never actually declared as a dependency -- it only ever
+// resolved by accident when a consumer happened to hoist one -- so these two
+// helpers replace it rather than shipping a package for four call sites.
+//
+// Output is byte-identical to chalk for both supported forms, including
+// chalk's decision about *when* to emit escapes at all.
+
+const ESC = "\u001B";
+const RESET_COLOR = `${ESC}[39m`;
+const BOLD_ON = `${ESC}[1m`;
+const BOLD_OFF = `${ESC}[22m`;
+
+/**
+ * Whether to emit ANSI escapes, following the same precedence chalk uses:
+ * FORCE_COLOR wins, then NO_COLOR, then a dumb terminal, then TTY detection.
+ * Notably this means piped and CI output is plain text, which is what chalk
+ * already did here.
+ * @returns {boolean} True when escapes should be emitted.
+ */
+function colorEnabled() {
+  const { FORCE_COLOR, NO_COLOR, TERM } = process.env;
+
+  if (FORCE_COLOR !== undefined) {
+    // An explicit `0`/`false` is a force-*off* in chalk's `supports-color`, not
+    // an absence of opinion -- it short-circuits ahead of TTY detection, so
+    // setting it yields plain text even on a terminal. A set-but-empty value is
+    // a force-*on*, which is why this tests the two off values rather than
+    // truthiness.
+    return FORCE_COLOR !== "0" && FORCE_COLOR !== "false";
+  }
+
+  if (NO_COLOR) {
+    return false;
+  }
+
+  if (TERM === "dumb") {
+    return false;
+  }
+
+  return Boolean(process.stdout?.isTTY);
+}
+
+/**
+ * Parse `#rgb` or `#rrggbb` into 8-bit channels.
+ * @param {string} hexColor - Hex color string, with or without a leading `#`.
+ * @returns {[number, number, number] | null} Channels, or null if unparseable.
+ */
+function toRgb(hexColor) {
+  if (typeof hexColor !== "string") {
+    return null;
+  }
+
+  const raw = hexColor.replace(/^#/u, "");
+  const expanded =
+    raw.length === 3
+      ? raw
+          .split("")
+          .map((channel) => channel + channel)
+          .join("")
+      : raw;
+
+  if (!/^[0-9a-f]{6}$/iu.test(expanded)) {
+    return null;
+  }
+
+  return [
+    Number.parseInt(expanded.slice(0, 2), 16),
+    Number.parseInt(expanded.slice(2, 4), 16),
+    Number.parseInt(expanded.slice(4, 6), 16),
+  ];
+}
+
+/**
+ * Build a colorizer for a hex color.
+ *
+ * Unlike `chalk.hex`, an unparseable or missing color returns the text
+ * unchanged instead of throwing -- `Logger.auroLogger` reaches this path
+ * whenever it is handed a status it does not recognize.
+ * @param {string} hexColor - Hex color string, e.g. `#0096FF`.
+ * @returns {((text: string) => string) & {bold: (text: string) => string}} Colorizer with a `.bold` variant.
+ */
+export function hex(hexColor) {
+  const rgb = toRgb(hexColor);
+
+  /**
+   * @param {string} text - Text to wrap.
+   * @param {boolean} bold - Whether to also apply bold.
+   * @returns {string} The wrapped text.
+   */
+  const paint = (text, bold) => {
+    const body = `${text}`;
+
+    // chalk short-circuits empty input rather than emitting a bare open/close
+    // pair, and every banner here is built by concatenating segments.
+    if (!rgb || body === "" || !colorEnabled()) {
+      return body;
+    }
+
+    const color = `${ESC}[38;2;${rgb[0]};${rgb[1]};${rgb[2]}m`;
+    const open = bold ? `${color}${BOLD_ON}` : color;
+    const close = bold ? `${BOLD_OFF}${RESET_COLOR}` : RESET_COLOR;
+
+    // Re-open the style after every line break, the way chalk does, so the
+    // color survives anything that processes output line by line. The ASCII
+    // banners and the boxed `section` logs all rely on this.
+    return `${open}${body.replace(/(\r?\n)/gu, `${close}$1${open}`)}${close}`;
+  };
+
+  const colorize = (text) => paint(text, false);
+
+  colorize.bold = (text) => paint(text, true);
+
+  return colorize;
+}