@aurodesignsystem/auro-library 5.14.0 → 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.0",
+  "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/runtime/floatingUI.mjs

@@ -8,6 +8,7 @@ import {
   offset,
   shift,
 } from "@floating-ui/dom";
+import { generateUUID } from "./generateUUID/index.mjs";
 
 const MAX_CONFIGURATION_COUNT = 10;
 
@@ -1025,7 +1026,7 @@ export default class AuroFloatingUI {
 
     this.id = element.getAttribute("id");
     if (!this.id) {
-      this.id = window.crypto.randomUUID();
+      this.id = generateUUID();
       element.setAttribute("id", this.id);
     }
 

package/scripts/runtime/generateUUID/generateUUID.mjs

@@ -0,0 +1,41 @@
+/**
+ * Generates a v4 UUID with a three-tier fallback for insecure contexts.
+ *
+ * Tier 1 (secure contexts): crypto.randomUUID() — native, fully random.
+ * Tier 2 (insecure contexts): crypto.getRandomValues() — available on all
+ *   modern browsers regardless of secure-context status.
+ * Tier 3 (last resort, no crypto API): new Date().getTime() — lower entropy,
+ *   but sufficient for element IDs where collision risk is negligible.
+ *
+ * See: https://w3c.github.io/webcrypto/#dom-crypto-randomuuid (secure-context restriction)
+ */
+export function generateUUID() {
+  let uuid;
+
+  if (
+    typeof crypto !== "undefined" &&
+    typeof crypto.randomUUID === "function"
+  ) {
+    uuid = crypto.randomUUID();
+  } else if (
+    typeof crypto !== "undefined" &&
+    typeof crypto.getRandomValues === "function"
+  ) {
+    const bytes = new Uint8Array(16);
+    crypto.getRandomValues(bytes);
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = Array.from(bytes).map((b) => b.toString(16).padStart(2, "0"));
+    uuid = `${hex.slice(0, 4).join("")}-${hex.slice(4, 6).join("")}-${hex.slice(6, 8).join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10).join("")}`;
+  } else {
+    let d = new Date().getTime();
+    uuid = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+      const r = (d % 16) | 0;
+      d = (d - r) / 16 || new Date().getTime();
+      return (c === "x" ? r : (r & 0x3) | 0x8).toString(16);
+    });
+  }
+
+  // CSS selectors require IDs starting with a letter; replace a leading digit with 'a'.
+  return /^[0-9]/.test(uuid) ? `a${uuid.slice(1)}` : uuid;
+}

package/scripts/runtime/generateUUID/index.mjs

@@ -0,0 +1 @@
+export * from "./generateUUID.mjs";