actual-css 0.3.1 → 0.4.1

package/docs/pages/utilities/spacing.md

@@ -4,25 +4,25 @@ Semantic step helpers for gap, padding, and margin — the most common inline-st
 
 ## Class reference
 
-| Class | Kind | Description |
-|---|---|---|
-| `.gap-none` | Utility | `gap: 0` on the element itself. |
-| `.py` | Utility | Block (vertical) padding at the current density step. |
-| `.px` | Utility | Inline (horizontal) padding at the current density step. |
-| `.mbs` | Utility | Block-start margin at the current density step. |
-| `.mbe` | Utility | Block-end margin at the current density step. |
-| `.gap-sm` | Utility | `gap: var(--space-20)` — denser row rhythm. Optional layer. |
-| `.gap-md` | Utility | `gap: var(--space-40)` — default row rhythm. Optional layer. |
-| `.gap-lg` | Utility | `gap: var(--space-50)` — roomier row rhythm. Optional layer. |
-| `.padding-context` | Utility | All-side padding at the current density step. Optional layer. |
-| `.gap-context` | Utility | `gap: var(--gap)`. Optional layer. |
-| `.row-gap-context` | Utility | `row-gap: var(--gap)`. Optional layer. |
-| `.column-gap-context` | Utility | `column-gap: var(--gap)`. Optional layer. |
-| `.margin-inline-auto` | Utility | Horizontally centers a block. Optional layer. |
-| `.margin-inline-start-auto` | Utility | Pushes a block toward the inline end. Optional layer. |
-| `.margin-inline-end-auto` | Utility | Pushes a block toward the inline start. Optional layer. |
-| `.margin-block-start-auto` | Utility | Pushes content toward the block end. Optional layer. |
-| `.margin-block-end-auto` | Utility | Pushes content toward the block start. Optional layer. |
+| Class                       | Kind    | Description                                                   |
+|-----------------------------|---------|---------------------------------------------------------------|
+| `.gap-none`                 | Utility | `gap: 0` on the element itself.                               |
+| `.py`                       | Utility | Block (vertical) padding at the current density step.         |
+| `.px`                       | Utility | Inline (horizontal) padding at the current density step.      |
+| `.mbs`                      | Utility | Block-start margin at the current density step.               |
+| `.mbe`                      | Utility | Block-end margin at the current density step.                 |
+| `.gap-sm`                   | Utility | `gap: var(--space-20)` — denser row rhythm. Optional layer.   |
+| `.gap-md`                   | Utility | `gap: var(--space-40)` — default row rhythm. Optional layer.  |
+| `.gap-lg`                   | Utility | `gap: var(--space-50)` — roomier row rhythm. Optional layer.  |
+| `.padding-context`          | Utility | All-side padding at the current density step. Optional layer. |
+| `.gap-context`              | Utility | `gap: var(--gap)`. Optional layer.                            |
+| `.row-gap-context`          | Utility | `row-gap: var(--gap)`. Optional layer.                        |
+| `.column-gap-context`       | Utility | `column-gap: var(--gap)`. Optional layer.                     |
+| `.margin-inline-auto`       | Utility | Horizontally centers a block. Optional layer.                 |
+| `.margin-inline-start-auto` | Utility | Pushes a block toward the inline end. Optional layer.         |
+| `.margin-inline-end-auto`   | Utility | Pushes a block toward the inline start. Optional layer.       |
+| `.margin-block-start-auto`  | Utility | Pushes content toward the block end. Optional layer.          |
+| `.margin-block-end-auto`    | Utility | Pushes content toward the block start. Optional layer.        |
 
 Spacing helpers follow the density context. The default step is
 `--space-40` (1rem); the `.sm` context tightens it to `--space-20` (0.5rem)
@@ -76,4 +76,4 @@ No `mbs-none` / `mbe-none` — use `margin: 0` via `.list-reset` for lists, or a
 ## CSS hooks
 
 - `--density-space` — the step every padding and margin helper reads; `.sm` sets it to `--space-20`, default to `--space-40`, `.lg` to `--space-50`.
-- `--gap` — base gap of layout primitives; read by the optional `.gap-context`, `.row-gap-context`, and `.column-gap-context` helpers.
+- `--gap` — base gap of layout primitives; read by the optional `.gap-context`, `.row-gap-context`, and `.column-gap-context` helpers.

package/docs/pages/utilities/text.md

@@ -4,15 +4,15 @@ Lightweight helpers for muted or secondary text without a full color scale.
 
 ## Class reference
 
-| Class | Kind | Description |
-|---|---|---|
-| `.muted` | Utility | Secondary text color. |
-| `.text-start` | Utility | Logical start-aligned text; sets `--text-align`. |
-| `.text-center` | Utility | Centered text; sets `--text-align`. |
-| `.text-end` | Utility | Logical end-aligned text; sets `--text-align`. |
-| `.text-balance` | Utility | Balanced line wrapping (`text-wrap: balance`). |
-| `.text-pretty` | Utility | Pretty line wrapping (`text-wrap: pretty`). |
-| `.lead` | Utility | Slightly larger, relaxed reading-introduction paragraph. |
+| Class           | Kind    | Description                                              |
+|-----------------|---------|----------------------------------------------------------|
+| `.muted`        | Utility | Secondary text color.                                    |
+| `.text-start`   | Utility | Logical start-aligned text; sets `--text-align`.         |
+| `.text-center`  | Utility | Centered text; sets `--text-align`.                      |
+| `.text-end`     | Utility | Logical end-aligned text; sets `--text-align`.           |
+| `.text-balance` | Utility | Balanced line wrapping (`text-wrap: balance`).           |
+| `.text-pretty`  | Utility | Pretty line wrapping (`text-wrap: pretty`).              |
+| `.lead`         | Utility | Slightly larger, relaxed reading-introduction paragraph. |
 
 ## Muted
 
@@ -40,4 +40,4 @@ Use `.text-start`, `.text-center`, or `.text-end` when a component or layout pri
 
 ## Lead
 
-`.lead` is a slightly larger, more relaxed reading-introduction paragraph (`1.125em`, `--line-height-relaxed`). Use it for introductory text in editorial surfaces. For fluid headline sizing, use `src/css/optional/typography-fluid.css`.
+`.lead` is a slightly larger, more relaxed reading-introduction paragraph (`1.125em`, `--line-height-relaxed`). Use it for introductory text in editorial surfaces. For fluid headline sizing, use `src/css/typography/fluid.css`.

package/llms.txt

@@ -10,14 +10,56 @@ Actual CSS uses a small public grammar: `.component [intent] [variant] [size] [m
 
 ## Package Entrypoints
 
-`package.json#exports` is the canonical package surface. Use `actual-css` for the
-full CSS framework and `actual-css/js` for the complete runtime. The composition
-guides in [README](README.md) and [Progressive Enhancements](docs/pages/enhancements/overview.md)
+`package.json#exports` is the canonical package surface.
+
+- `actual-css` — the minimal core: tokens, theme contract, reset, base elements, and universal variants. Components and layout primitives are NOT included.
+- `actual-css/full` — the complete framework: core plus every component, form, layout, typography, effect, and utility family.
+- `actual-css/js` — the enhancement loader only; it discovers `data-enhance` markers and loads enhancers on demand.
+- `actual-css/js/full` — the complete runtime with all built-in enhancers pre-registered.
+- `actual-css/reserved-classes.json` — machine-readable list of every class name the framework can generate. Use it to validate class usage in HTML (an "unknown class" checker) instead of guessing names from other frameworks.
+- Individual families and modules are importable separately (`actual-css/css/components`, `actual-css/css/layout/grid`, `actual-css/js/dialog`, …); see [README](README.md) and [Modular imports](docs/pages/guides/modular-import.md).
+
+The composition guides in [README](README.md) and [Progressive Enhancements](docs/pages/enhancements/overview.md)
 show supported CSS modules and individual enhancer imports without duplicating
 the full export list here.
 
-In 0.2, presentation (`class`) and behavior (`data-enhance`) are separate layers.
+Presentation (`class`) and behavior (`data-enhance`) are separate layers.
 Behaviour primitives (`enhance`, `floating`, `surface`, `keys`, `menu`, `focus`,
 `events`) are independently importable for building custom widgets.
 See [enhancement contract](docs/design-notes/enhancement-contract.md) and
 [widget primitives](docs/design-notes/widget-primitives.md).
+
+## Choosing a layout primitive
+
+Pick from the relationship between children, not the number of children in one mockup:
+
+- Responsive collection of cards/items where an incomplete final row is acceptable → `.grid`
+- Known structural density, at most N columns → `.grid-N`
+- Peer regions that must switch together → `.switcher`
+- Main content plus a secondary region (content + aside) → `.sidebar-layout`
+- Fixed media followed by flexible content → `.media`
+- Explicit region placement on a shared 12-column canvas → `.column-layout`
+- Vertical flow → `.stack`; wrapping inline items → `.cluster`
+
+Use `--grid-columns` on `.grid` for exact track templates that do not match a
+built-in layout contract: arbitrary structural counts (seven calendar days),
+asymmetric fractional tracks, or mixed intrinsic/flexible tracks. See
+[Choosing a layout](docs/pages/layout/choosing.md).
+
+`.status-bar` is transient feedback only; persistent metrics or application
+state belong in normal content such as cards, badges and alerts.
+
+## Before generating application CSS
+
+Read [Building with Actual CSS](docs/pages/guides/integrating-actual-css.md)
+before writing application styles.
+
+1. Start with Actual's vocabulary: theme tokens, then layout primitives, then components, then their public hooks, then small utilities, then application CSS.
+2. Choose layout primitives by relationship, not item count.
+3. Prefer component/layout hooks over replacement rules (tune before replacing).
+4. Search the class manifest before inventing generic utilities.
+5. Keep literal palette colors inside the theme/token block; derive decorative colors from tokens.
+6. Use application CSS for genuinely product-specific styling — brand marks, unusual geometry, bespoke animation.
+
+The goal is no duplicated framework behavior and no palette literals outside the
+token layer, not zero application CSS.

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "actual-css",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Plain CSS component framework with semantic classes, universal variants, small tokens, theme hooks, and progressive enhancements.",
   "type": "module",
-  "packageManager": "bun@1.3.14",
+  "packageManager": "bun@1.4.0",
   "license": "MIT",
   "author": "Thomas <thomas@lekoala.be>",
   "repository": {
@@ -27,19 +27,32 @@
   ],
   "exports": {
     ".": "./dist/actual.min.css",
+    "./full": "./dist/actual.full.min.css",
     "./css": "./src/css/actual.css",
-    "./css/layer": "./src/css/actual.layer.css",
     "./css/components": "./src/css/components/index.css",
-    "./css/forms": "./src/css/forms/index.css",
-    "./css/optional": "./dist/optional.min.css",
+    "./css/components/*": "./src/css/components/*.css",
+    "./css/effects": "./src/css/effects/index.css",
+    "./css/effects/*": "./src/css/effects/*.css",
+    "./css/forms": "./src/css/forms/base.css",
+    "./css/forms/all": "./src/css/forms/index.css",
+    "./css/forms/*": "./src/css/forms/*.css",
+    "./css/full": "./src/css/actual.full.css",
+    "./css/layer": "./src/css/actual.layer.css",
+    "./css/layout": "./src/css/layout/index.css",
+    "./css/layout/*": "./src/css/layout/*.css",
     "./css/themes": null,
     "./css/themes/*": null,
-    "./css/*": "./src/css/*.css",
+    "./css/typography": "./src/css/typography/index.css",
+    "./css/typography/*": "./src/css/typography/*.css",
+    "./css/utilities": "./src/css/utilities/index.css",
+    "./css/utilities/*": "./src/css/utilities/*.css",
     "./js": "./src/js/index.js",
+    "./js/full": "./src/js/full.js",
     "./js/command": "./src/js/command.js",
     "./js/context-menu": "./src/js/context-menu.js",
     "./js/dialog": "./src/js/dialog.js",
     "./js/dismiss": "./src/js/dismiss.js",
+    "./js/escape": "./src/js/escape.js",
     "./js/enhance": "./src/js/enhance.js",
     "./js/enhancement-loader": "./src/js/enhancement-loader.js",
     "./js/parse-config": "./src/js/parse-config.js",
@@ -61,8 +74,12 @@
     "./js/validation": "./src/js/validation.js",
     "./js/status": "./src/js/status.js",
     "./js/surface": "./src/js/surface.js",
+    "./reserved-classes.json": "./scripts/reserved-classes.json",
     "./package.json": "./package.json"
   },
+  "bin": {
+    "actual-css": "./src/cli/actual-css.js"
+  },
   "main": "./dist/actual.js",
   "style": "./dist/actual.min.css",
   "unpkg": "./dist/actual.min.css",
@@ -71,11 +88,17 @@
   "files": [
     "dist",
     "src/css/*.css",
-    "src/css/components",
+    "src/css/core",
+    "src/css/layout",
+    "src/css/typography",
     "src/css/forms",
-    "src/css/optional",
-    "src/css/themes",
+    "src/css/components",
+    "src/css/effects",
+    "src/css/utilities",
+    "src/cli",
     "src/js",
+    "src/tooling",
+    "scripts/reserved-classes.json",
     "docs",
     "CHANGELOG.md",
     "llms.txt",
@@ -83,20 +106,26 @@
     "README.md"
   ],
   "engines": {
-    "bun": ">=1.3.14"
+    "bun": ">=1.4.0",
+    "node": ">=18"
   },
   "scripts": {
     "lint": "biome check",
     "lint:fix": "biome check --write",
-    "build:docs": "bun scripts/build-docs.js",
-    "watch:docs": "bun scripts/build-docs.js --watch",
+    "build:docs": "bun run build:themes && bun scripts/build-docs.js",
+    "watch:docs": "bun run build:themes && bun scripts/build-docs.js --watch",
     "check:docs": "bun scripts/check-docs.js",
+    "check:doc-classes": "bun scripts/check-doc-classes.js",
     "check:compat": "bun scripts/check-compat.js",
     "check:css-api": "bun scripts/check-css-api.js",
+    "check:color-space": "bun scripts/check-color-space.js",
+    "check:architecture": "bun scripts/check-css-architecture.js",
     "build:dist": "bun scripts/build-dist.js",
     "build:js": "bun scripts/build-js.js",
+    "build:themes": "bun scripts/build-themes.js",
     "build:size": "bun scripts/build-size.js",
     "check:enhance": "bun run scripts/check-enhance.js",
+    "generate:reserved": "bun scripts/generate-reserved-classes.js",
     "check:reserved": "bun scripts/check-reserved.js",
     "check:links": "bun scripts/check-doc-links.js",
     "check:templates": "bun scripts/check-templates.js",
@@ -106,7 +135,8 @@
     "probe": "bun scripts/probe.js",
     "check:sync": "bun scripts/check-sync.js",
     "test": "bun test",
-    "build:all": "bun run build:dist && bun run build:js && bun run build:docs && bun run check:docs && bun run check:compat && bun run check:css-api && bun run check:enhance && bun run check:reserved && bun run check:sync && bun run check:links && bun run check:templates && bun run test && bun run build:size",
+    "test:changed": "bun test --changed=master",
+    "build:all": "bun run lint && bun run build:dist && bun run build:js && bun run build:docs && bun run check:docs && bun run check:doc-classes && bun run check:compat && bun run check:css-api && bun run check:color-space && bun run check:architecture && bun run check:enhance && bun run generate:reserved && bun run check:reserved && bun run check:sync && bun run check:links && bun run check:templates && bun run test && bun run build:size",
     "prepublishOnly": "bun run build:all"
   },
   "devDependencies": {

package/scripts/reserved-classes.json

@@ -0,0 +1,278 @@
+[
+  "accordion",
+  "actions",
+  "admonition",
+  "alert",
+  "alert-body",
+  "alert-dismiss",
+  "alert-icon",
+  "alert-title",
+  "align-self-center",
+  "align-self-end",
+  "align-self-start",
+  "app-layout",
+  "app-main",
+  "app-nav",
+  "app-shell",
+  "aura",
+  "aura-glow",
+  "avatar",
+  "avatar-stack",
+  "background-raised",
+  "background-subtle",
+  "background-surface",
+  "badge",
+  "bleed",
+  "block-size-full",
+  "border-block-end",
+  "border-block-start",
+  "border-context",
+  "border-inline-end",
+  "border-inline-start",
+  "bottom",
+  "breadcrumb",
+  "btn",
+  "callout",
+  "card",
+  "center",
+  "chat",
+  "chat-avatar",
+  "chat-bubble",
+  "chat-end",
+  "chat-footer",
+  "chat-header",
+  "chat-start",
+  "check",
+  "choice",
+  "choice-card",
+  "circle",
+  "cluster",
+  "color",
+  "column-gap-context",
+  "column-layout",
+  "column-span-1",
+  "column-span-10",
+  "column-span-11",
+  "column-span-12",
+  "column-span-2",
+  "column-span-3",
+  "column-span-4",
+  "column-span-5",
+  "column-span-6",
+  "column-span-7",
+  "column-span-8",
+  "column-span-9",
+  "column-start-1",
+  "column-start-10",
+  "column-start-11",
+  "column-start-12",
+  "column-start-2",
+  "column-start-3",
+  "column-start-4",
+  "column-start-5",
+  "column-start-6",
+  "column-start-7",
+  "column-start-8",
+  "column-start-9",
+  "compact",
+  "complete",
+  "container-query",
+  "cursor-pointer",
+  "danger",
+  "dialog-close",
+  "dialog-confirmation",
+  "dialog-icon",
+  "display-block",
+  "display-flex",
+  "display-grid",
+  "display-inline",
+  "display-inline-block",
+  "display-inline-flex",
+  "display-none",
+  "dot",
+  "drawer",
+  "drawer-close",
+  "fab",
+  "fab-action",
+  "fab-actions",
+  "fab-label",
+  "field",
+  "field-error",
+  "field-group",
+  "field-help",
+  "field-label",
+  "file",
+  "fit",
+  "flex-nowrap",
+  "flex-wrap",
+  "floating-field",
+  "flyout",
+  "flyout-trigger",
+  "font-weight-bold",
+  "font-weight-medium",
+  "font-weight-normal",
+  "font-weight-strong",
+  "form-actions",
+  "frame",
+  "gap-context",
+  "gap-lg",
+  "gap-md",
+  "gap-none",
+  "gap-sm",
+  "ghost",
+  "grid",
+  "grid-2",
+  "grid-3",
+  "grid-4",
+  "grid-6",
+  "grow",
+  "had-scrollbar",
+  "has-modal-open",
+  "icon-only",
+  "indicator",
+  "indicator-item",
+  "inline-size-full",
+  "input",
+  "input-icon",
+  "inverted",
+  "is-open",
+  "is-sheet",
+  "is-static",
+  "items-center",
+  "items-end",
+  "items-start",
+  "join",
+  "join-addon",
+  "justify-content-center",
+  "justify-content-end",
+  "justify-content-space-between",
+  "justify-content-start",
+  "key",
+  "lead",
+  "lg",
+  "link",
+  "link-muted",
+  "link-plain",
+  "list",
+  "list-item",
+  "list-item-content",
+  "list-item-text",
+  "list-item-title",
+  "list-item-trailing",
+  "list-reset",
+  "margin-block-end-auto",
+  "margin-block-start-auto",
+  "margin-inline-auto",
+  "margin-inline-end-auto",
+  "margin-inline-start-auto",
+  "max-inline-size-none",
+  "mbe",
+  "mbs",
+  "measure",
+  "media",
+  "menu",
+  "menu-item",
+  "menu-item-end",
+  "menu-item-icon",
+  "menu-item-text",
+  "menu-label",
+  "menu-separator",
+  "meter",
+  "min-block-size-0",
+  "min-inline-size-0",
+  "modal",
+  "muted",
+  "native",
+  "nav-link",
+  "nav-list",
+  "navbar",
+  "navbar-brand",
+  "navbar-nav",
+  "needs-validation",
+  "neutral",
+  "otp",
+  "outline",
+  "overflow-auto",
+  "overflow-clip",
+  "overflow-hidden",
+  "overflow-x-auto",
+  "overflow-y-auto",
+  "overline",
+  "padding-context",
+  "pagination",
+  "pill",
+  "pointer-events-none",
+  "position-absolute",
+  "position-fixed",
+  "position-relative",
+  "position-sticky",
+  "primary",
+  "progress",
+  "prose",
+  "px",
+  "py",
+  "radio",
+  "radius-context",
+  "radius-lg-context",
+  "radius-sm-context",
+  "raised",
+  "range",
+  "rating",
+  "required-mark",
+  "reverse",
+  "row-gap-context",
+  "scroll-snap",
+  "scroll-target",
+  "scrollable",
+  "scroller",
+  "scrollspy",
+  "secondary",
+  "select",
+  "shadow-context",
+  "shadow-popout-context",
+  "sidebar-layout",
+  "skeleton",
+  "sm",
+  "soft",
+  "solid",
+  "spinner",
+  "sr-only",
+  "stable-gutter",
+  "stack",
+  "start",
+  "status-bar",
+  "steps",
+  "sticky",
+  "stretch",
+  "subtle",
+  "success",
+  "surface-backdrop",
+  "switch",
+  "switcher",
+  "tab",
+  "table",
+  "table-wrap",
+  "tabs",
+  "text-balance",
+  "text-break",
+  "text-capitalize",
+  "text-center",
+  "text-display",
+  "text-end",
+  "text-lead",
+  "text-lowercase",
+  "text-nowrap",
+  "text-pretty",
+  "text-start",
+  "text-title",
+  "text-uppercase",
+  "textarea",
+  "tooltip",
+  "topbar",
+  "truncate",
+  "user-select-none",
+  "visibility-hidden",
+  "warning",
+  "was-validated",
+  "white-space-normal"
+]

package/src/cli/actual-css.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { inlineImports, minifyCss } from "../tooling/css-bundle.js";
+
+function usage() {
+  return [
+    "actual-css bundle INPUT --out FILE [--minify]",
+    "",
+    "  -o, --out FILE   write the bundle to FILE (required)",
+    "      --minify     collapse comments and whitespace",
+    "  -h, --help       show this message",
+    "      --version    print the actual-css version",
+    "",
+    "Bundle plain CSS @import chains from relative files and actual-css/css/* subpaths.",
+    "A layer or layer(name) import is flattened into the @layer block it stands for.",
+    "Remote imports are kept and hoisted to the top of the bundle.",
+    "Leaves modern CSS syntax untouched; this is a bundler, not a transpiler.",
+  ].join("\n");
+}
+
+async function version() {
+  const pkg = await readFile(new URL("../../package.json", import.meta.url), "utf8");
+  return JSON.parse(pkg).version;
+}
+
+function parseArgs(argv) {
+  const [command, ...rest] = argv;
+
+  if (!command || command === "--help" || command === "-h") {
+    return { help: true };
+  }
+
+  if (command === "--version" || command === "-v") {
+    return { version: true };
+  }
+
+  if (command !== "bundle") {
+    throw new Error(`Unknown command: ${command}`);
+  }
+
+  let input = "";
+  let out = "";
+  let minify = false;
+
+  for (let i = 0; i < rest.length; i += 1) {
+    const arg = rest[i];
+
+    if (arg === "--help" || arg === "-h") {
+      return { help: true };
+    }
+
+    if (arg === "--minify") {
+      minify = true;
+      continue;
+    }
+
+    if (arg === "--out" || arg === "-o") {
+      const value = rest[i + 1];
+
+      if (!value) {
+        throw new Error("Missing value for --out.");
+      }
+
+      out = value;
+      i += 1;
+      continue;
+    }
+
+    if (arg.startsWith("-")) {
+      throw new Error(`Unknown option: ${arg}`);
+    }
+
+    if (input) {
+      throw new Error(`Unexpected extra argument: ${arg}`);
+    }
+
+    input = arg;
+  }
+
+  if (!input) {
+    throw new Error("Missing input file.");
+  }
+
+  if (!out) {
+    throw new Error("Missing required --out FILE option.");
+  }
+
+  return { help: false, input, out, minify };
+}
+
+async function bundle({ input, out, minify }) {
+  const inputPath = resolve(input);
+  const outputPath = resolve(out);
+  const css = await inlineImports(inputPath);
+  const code = minify ? minifyCss(css) : css;
+
+  await mkdir(dirname(outputPath), { recursive: true });
+  await writeFile(outputPath, code);
+
+  console.log(`Bundled ${inputPath} -> ${outputPath}${minify ? " (minified)" : ""}`);
+}
+
+async function main() {
+  let args;
+
+  try {
+    args = parseArgs(process.argv.slice(2));
+  } catch (error) {
+    console.error(error.message);
+    console.error("");
+    console.error(usage());
+    process.exit(1);
+  }
+
+  if (args.help) {
+    console.log(usage());
+    return;
+  }
+
+  if (args.version) {
+    console.log(await version());
+    return;
+  }
+
+  await bundle(args);
+}
+
+main().catch((error) => {
+  console.error(error.message);
+  process.exit(1);
+});