@omega.js/extension 0.1.0

package/dist/assets/css/omega-extension.scss

@@ -0,0 +1,43 @@
+// ============================================
+// Browser Extension Manager - Main Entry
+// ============================================
+// This is the main SCSS entry point for Browser Extension Manager
+// Import this in your extension components using:
+// @use 'omega-extension' as * with ($primary: #2563EB);
+
+// App shell mechanics (#111) — the .omega-shell grid, region geometry and the
+// collapse/drawer states, vendored from @omega.js/web alongside the theme's
+// shell SKIN. Loaded BEFORE the theme (Sass emits a module's CSS at its first
+// load, @forward included) so the skin layers OVER the mechanics, exactly as
+// web's core/css/main.scss orders them.
+@use 'shell/index' as omega-shell;
+
+// Forward the theme (allows consuming project to configure it)
+@forward 'theme';
+
+// Core design tokens (C4) — the cross-target `--omega-*` contract, vendored
+// from @omega.js/web at prepare (package.json `omega.vendorAssets`). Emitted
+// BEFORE the theme so theme rules can override at equal specificity.
+@use 'tokens/index' as omega-tokens;
+
+@use 'theme' as *;
+
+// Import core extension styles
+@use 'core/_initialize' as *;
+@use 'core/_utilities' as *;
+@use 'core/_animations' as *;
+
+// Icon presentation (#183): the square glyph-centered box, the size scale and
+// the spin/bounce/beat utilities, vendored VERBATIM from @omega.js/web's one
+// icon sheet at prepare (package.json `omega.vendorAssets`), same channel as
+// the tokens and shell sheets above. Never hand-written here.
+@use 'core/_fontawesome' as *;
+
+// Import component-specific styles
+@use '_component-specific' as *;
+
+// First cross-target token consumer: native controls pick up the brand accent.
+// The full component migration onto tokens lands with the D10 skin (C4 cp109).
+body {
+  accent-color: var(--omega-accent);
+}

package/dist/assets/css/shell/_index.scss

@@ -0,0 +1,207 @@
+// OMEGA app shell — structural mechanics for backend/admin surfaces (C3).
+// Layout GEOMETRY only: regions (sidebar / topbar / main / scrim) and
+// STATES (desktop rail collapse, mobile drawer, viewport lock). All paint
+// comes from the token contract (tokens/_index.scss), so a skin restyles by
+// redefining tokens or layering rules — never by fighting these.
+//
+// Markup contract (theme layouts emit this; core/js/core/app-shell.js drives it):
+//
+//   <div class="omega-shell" data-omega-shell>
+//     <aside class="omega-shell__sidebar" id="…">
+//       …pinned head: brand, and any popover-owning module (the selector)…
+//       <div class="omega-shell__sidebar-scroll">
+//         …nav; text that hides in the rail wears .omega-shell__label…
+//       </div>
+//     </aside>
+//     <header class="omega-shell__topbar">
+//       <div class="omega-shell__topbar-start">   (both toggles render only while the page has a rail, #740)
+//         <button data-shell-toggle="drawer" aria-expanded="false" aria-controls="…">…</button>
+//         <button data-shell-toggle="collapse" aria-expanded="true" aria-controls="…">…</button>
+//       </div>
+//       <div class="omega-shell__topbar-end">…</div>
+//     </header>
+//     <button class="omega-shell__drawer-toggle">   (only when the page has a rail and NO topbar, #719)
+//     <main class="omega-shell__main">…</main>
+//     <div class="omega-shell__scrim" data-shell-dismiss></div>
+//   </div>
+//
+// States (stamped on .omega-shell by app-shell.js):
+//   data-shell-collapsed="true" — desktop sidebar → icon rail (persisted)
+//   data-shell-open="true"      — mobile drawer slid in (scrim visible)
+// Variant: .omega-shell--locked — main never scrolls (calendar/studio pages
+// manage their own interior scroll).
+
+// Below this, the sidebar becomes the drawer (matches classy's xl cutover).
+$shell-breakpoint: 1200px;
+
+:root {
+  --omega-shell-sidebar-w: 264px;
+  --omega-shell-rail-w: 68px;
+  --omega-shell-topbar-h: 60px;
+  --omega-shell-pad: 24px;
+}
+
+.omega-shell {
+  display: grid;
+  grid-template-columns: auto minmax(0, 1fr);
+  grid-template-rows: auto minmax(0, 1fr);
+  height: 100dvh;
+  background: var(--omega-ground);
+  color: var(--omega-ink);
+}
+
+// The rail clips NOTHING (#319): a module that opens a popover — the project
+// selector — has to paint outside the 264px box, so the scroll lives one level
+// down on __sidebar-scroll and the rail is merely positioned. Its z-index is
+// the explicit stacking order for those popovers: above sticky page chrome
+// inside the content column (bootstrap's 1020 band), below the drawer/modal
+// layers.
+.omega-shell__sidebar {
+  display: flex;
+  flex-direction: column;
+  grid-row: 1 / -1;
+  position: relative;
+  z-index: 1030;
+  width: var(--omega-shell-sidebar-w);
+  background: var(--omega-surface);
+  border-inline-end: 1px solid var(--omega-line);
+  transition: width var(--omega-speed) var(--omega-ease), transform var(--omega-speed) var(--omega-ease);
+}
+
+// Everything under the pinned head scrolls here — nav plus the bottom slot,
+// which keeps its `mt-auto` push because this region is the flex column now.
+.omega-shell__sidebar-scroll {
+  display: flex;
+  flex: 1;
+  flex-direction: column;
+  min-height: 0;
+  overflow-y: auto;
+}
+
+// A rail popover can now outgrow the viewport (nothing clips it), and the
+// shell page itself never scrolls (100dvh grid) — so a long selector menu
+// caps itself and scrolls internally, keeping the tail reachable on short
+// viewports (#319).
+.omega-shell__sidebar .dropdown-menu {
+  max-height: calc(100dvh - 8rem);
+  overflow-y: auto;
+}
+
+.omega-shell__topbar {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  grid-column: 2;
+  min-height: var(--omega-shell-topbar-h);
+  padding-inline: 12px;
+  background: var(--omega-surface);
+  border-bottom: 1px solid var(--omega-line);
+}
+
+.omega-shell__topbar-start,
+.omega-shell__topbar-end {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.omega-shell__topbar-end {
+  margin-inline-start: auto;
+}
+
+// The row is PINNED, not auto-placed (#741): a page that turns the topbar off
+// would otherwise land main in the `auto` row, size it to its content, and
+// hand the scroll back to the document. An empty `auto` row is zero height,
+// so row 2 is the whole `1fr` with or without a topbar — and the drawer block
+// below re-places only the column, so the pin holds at every width.
+.omega-shell__main {
+  grid-column: 2;
+  grid-row: 2;
+  overflow-y: auto;
+  padding: var(--omega-shell-pad);
+}
+
+// The floating drawer toggle: a page with a rail and no topbar renders it
+// instead of the topbar's copy ([#719]). It sits above main and below the
+// drawer + scrim, so opening the drawer covers it and the scrim takes the
+// next tap. The layout hides it above the cutover with `d-xl-none` (the rail
+// is on screen there), so this block is geometry only.
+.omega-shell__drawer-toggle {
+  position: fixed;
+  inset-block-start: 12px;
+  inset-inline-start: 12px;
+  z-index: 1035;
+  background: var(--omega-surface);
+  border: 1px solid var(--omega-line);
+  border-radius: var(--omega-radius-m);
+}
+
+// Scrim only participates in the mobile drawer state.
+.omega-shell__scrim {
+  display: none;
+  position: fixed;
+  inset: 0;
+  z-index: 1040; // pairs with the drawer below; sits under modal layers (1050+)
+  background: rgb(0 0 0 / 45%);
+}
+
+// ─── Desktop rail collapse ───────────────────────────────────────────────────
+
+.omega-shell[data-shell-collapsed='true'] .omega-shell__sidebar {
+  width: var(--omega-shell-rail-w);
+}
+
+.omega-shell[data-shell-collapsed='true'] .omega-shell__label {
+  display: none;
+}
+
+// ─── Viewport-locked variant ─────────────────────────────────────────────────
+
+.omega-shell--locked .omega-shell__main {
+  overflow: hidden;
+}
+
+// ─── Mobile: sidebar becomes the drawer ──────────────────────────────────────
+
+@media (max-width: ($shell-breakpoint - 0.02px)) {
+  .omega-shell {
+    grid-template-columns: minmax(0, 1fr);
+  }
+
+  .omega-shell__topbar,
+  .omega-shell__main {
+    grid-column: 1;
+  }
+
+  .omega-shell__sidebar {
+    position: fixed;
+    inset-block: 0;
+    inset-inline-start: 0;
+    z-index: 1045;
+    transform: translateX(-100%);
+  }
+
+  // The drawer always shows at full width with labels — desktop rail
+  // collapse has no meaning here.
+  .omega-shell[data-shell-collapsed='true'] .omega-shell__sidebar {
+    width: var(--omega-shell-sidebar-w);
+  }
+
+  .omega-shell[data-shell-collapsed='true'] .omega-shell__label {
+    display: revert;
+  }
+
+  .omega-shell[data-shell-open='true'] .omega-shell__sidebar {
+    transform: translateX(0);
+  }
+
+  .omega-shell[data-shell-open='true'] .omega-shell__scrim {
+    display: block;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .omega-shell__sidebar {
+    transition: none;
+  }
+}

package/dist/assets/css/tokens/_index.scss

@@ -0,0 +1,166 @@
+// OMEGA core design tokens — the runtime contract every theme (and, at C4,
+// every target) consumes. CSS custom properties ONLY: themes restyle by
+// redefining tokens, components read `var(--omega-*)` and never hardcode.
+//
+// VALUES are the classy v2 sheet (docs/web/classy-v2/DIRECTION.md, Ian-approved
+// draft-2 comps): warm-paper light neutrals, de-blued charcoal dark, a single
+// brand accent slot, reserved status hues, and the Manus-split type stacks.
+// The NAMES plus the light/dark/attribute plumbing below are the contract
+// (D2: dual-theme at the token level from day one).
+//
+// The accent family is a BUILD-TIME override surface: when `brand.color`
+// is set, head.html emits inline `:root` ramps from composeBrandTokens
+// (src/brand-tokens.js) — a light ramp AND a dark-variant ramp stamped with
+// this same plumbing — that win the cascade over these placeholders.
+//
+// Theme attribute: `data-bs-theme` is what core/js/core/appearance.js
+// stamps today (Bootstrap-era name; renames alongside the appearance UI
+// when classy retires — keyed here in exactly one place on purpose).
+//
+// Type presets: `data-omega-type` on <html> re-pairs the font tokens
+// (mix is the default pairing — serif marketing display over sans UI).
+//
+// Surface-2 moves in OPPOSITE directions per mode, on purpose (#152): dark
+// elevates by getting lighter (#1d1d1f over the #0d0d0e ground), light
+// elevates with white + shadow and RECESSES by getting darker. It shipped at
+// #f6f6f5, one point off the light ground, so anything painting it directly
+// on the page was invisible in light mode and correct in dark. #ececeb sits
+// between the ground and the hairline in the warm-neutral ramp: a visible well
+// on the ground AND on a white card, still nowhere near --omega-line-strong.
+// Its Bootstrap twins (`$classy-surface-2-light`, `--bs-secondary-bg-rgb` in
+// classy's root bridge) carry the same value and move with it.
+//
+// Status hues ship in PAIRS: `--omega-ok` and `--omega-ok-rgb` (same for
+// warn/danger). Bootstrap's translucency utilities paint from
+// `rgba(var(--bs-success-rgb), …)`, which no var() can feed a hex to, so each
+// theme's root bridge points --bs-success/-warning/-danger and their -rgb
+// companions at these — ONE green for `bg-success`, `.text-success` and every
+// token-painted glyph, in both modes (#13). A theme that re-values a status
+// hue MUST re-value its -rgb twin or the two drift apart again.
+
+@mixin light-tokens {
+  --omega-ground: #f5f5f4;
+  --omega-surface: #ffffff;
+  --omega-surface-2: #ececeb; // the light well: RECESSED off the ground, never a second white
+  --omega-ink: #1a1a19;
+  --omega-ink-muted: #6d6d6c;
+  --omega-ink-faint: #a1a19e;
+  --omega-line: #e8e8e6;
+  --omega-line-strong: #d8d8d5;
+  --omega-accent: #2563eb; // placeholder — brand.color wins at build
+  --omega-accent-hover: #1451d8;
+  --omega-accent-active: #124ac6;
+  --omega-accent-subtle: rgba(37, 99, 235, 0.12);
+  --omega-accent-ink: #ffffff;
+  --omega-accent-ring: rgba(37, 99, 235, 0.35);
+  --omega-ok: #12925c;
+  --omega-ok-rgb: 18, 146, 92;
+  --omega-warn: #c47206;
+  --omega-warn-rgb: 196, 114, 6;
+  --omega-danger: #d92d20;
+  --omega-danger-rgb: 217, 45, 32;
+  --omega-chart-2: #0f8fa9;
+  --omega-chart-3: #7a45b5;
+  --omega-chart-4: #b0416a;
+  --omega-chart-5: #a06a08;
+  --omega-chart-6: #6a7f2b;
+  --omega-shadow-1: 0 1px 2px rgb(24 23 21 / 5%);
+  --omega-shadow-2: 0 18px 44px rgb(24 23 21 / 10%);
+}
+
+@mixin dark-tokens {
+  --omega-ground: #0d0d0e;
+  --omega-surface: #151516;
+  --omega-surface-2: #1d1d1f;
+  --omega-ink: #ebebea;
+  --omega-ink-muted: #9f9fa0;
+  --omega-ink-faint: #6c6c6e;
+  --omega-line: #262628;
+  --omega-line-strong: #333336;
+  --omega-accent: #5484ef; // placeholder — brand.color's dark ramp wins at build
+  --omega-accent-hover: #336dec;
+  --omega-accent-active: #2060eb;
+  --omega-accent-subtle: rgba(84, 132, 239, 0.16);
+  --omega-accent-ink: #111213;
+  --omega-accent-ring: rgba(84, 132, 239, 0.35);
+  --omega-ok: #3ecf8e;
+  --omega-ok-rgb: 62, 207, 142;
+  --omega-warn: #f5a524;
+  --omega-warn-rgb: 245, 165, 36;
+  --omega-danger: #f0574d;
+  --omega-danger-rgb: 240, 87, 77;
+  --omega-chart-2: #1f9fb4;
+  --omega-chart-3: #c09aec;
+  --omega-chart-4: #ee89a8;
+  --omega-chart-5: #e0a33c;
+  --omega-chart-6: #a9c153;
+  --omega-shadow-1: 0 1px 2px rgb(0 0 0 / 30%);
+  --omega-shadow-2: 0 18px 44px rgb(0 0 0 / 45%);
+}
+
+:root {
+  @include light-tokens;
+
+  // scheme-agnostic
+  --omega-radius-xs: 6px;
+  --omega-radius-s: 8px;
+  --omega-radius-m: 10px;
+  --omega-radius-l: 14px;
+  --omega-radius-xl: 20px;
+  --omega-radius-pill: 50rem;
+  --omega-speed: 160ms;
+  --omega-speed-slow: 550ms;
+  --omega-speed-first-paint: 300ms; // the first viewport's reveal, see motion/_index.scss
+  --omega-ease: cubic-bezier(0.25, 0.5, 0.35, 1);
+
+  // Type stacks (D5: system stacks until Ian picks vendored faces — the
+  // token seam makes that swap a values-only change).
+  --omega-font-ui: -apple-system, blinkmacsystemfont, 'Segoe UI', roboto, 'Helvetica Neue', arial, sans-serif;
+  --omega-font-serif: ui-serif, georgia, 'Times New Roman', times, serif;
+  --omega-font-mono: ui-monospace, 'SF Mono', sfmono-regular, menlo, consolas, 'Liberation Mono', monospace;
+
+  // Pairing slots components actually read: marketing display vs app display.
+  // Default = the "mix" pairing (serif marketing, sans app).
+  --omega-font-marketing: var(--omega-font-serif);
+  --omega-font-display: var(--omega-font-ui);
+
+  // Chart series-1 rides the accent; 2–6 are the CVD-validated categorical
+  // ramp above (cool half first, warm half after — what keeps two vocabularies
+  // apart at a glance). It is ONE ramp for two surfaces: a chart series
+  // (core/js/libs/charts.js) and a `.omega-badge-tone` chip read the same slot,
+  // so the same thing is the same color wherever it appears. Muted on purpose
+  // — status is told by a dot and a label, never by color alone.
+  --omega-chart-1: var(--omega-accent);
+}
+
+// Consumer type presets — one attribute (or a token override in main.scss)
+// re-pairs the display faces everywhere.
+:root[data-omega-type='sans'] {
+  --omega-font-marketing: var(--omega-font-ui);
+}
+
+:root[data-omega-type='serif'] {
+  --omega-font-marketing: var(--omega-font-serif);
+  --omega-font-display: var(--omega-font-serif);
+}
+
+:root[data-omega-type='mono'] {
+  --omega-font-marketing: var(--omega-font-mono);
+  --omega-font-display: var(--omega-font-mono);
+}
+
+// OS preference carries when no explicit choice is stamped…
+@media (prefers-color-scheme: dark) {
+  :root {
+    @include dark-tokens;
+  }
+}
+
+// …and the appearance.js stamp beats the OS in BOTH directions.
+:root[data-bs-theme='dark'] {
+  @include dark-tokens;
+}
+
+:root[data-bs-theme='light'] {
+  @include light-tokens;
+}

package/dist/assets/js/core/app-shell.js

@@ -0,0 +1,136 @@
+/**
+ * App Shell Module
+ * Drives the .omega-shell mechanics (core/css/shell/_index.scss): desktop
+ * sidebar collapse (persisted) and the mobile drawer (scrim + Escape dismiss).
+ * Controls are declarative — [data-shell-toggle="collapse|drawer"] and
+ * [data-shell-dismiss] anywhere in the page.
+ */
+import omega from '@omega.js/client';
+
+// Constants
+const STORAGE_KEY = 'shell.collapsed';
+
+// Module
+export default () => {
+  const $shell = document.querySelector('[data-omega-shell]');
+
+  // Create app shell API
+  const shellAPI = {
+    /**
+     * Whether the desktop sidebar is collapsed to the icon rail
+     * @returns {boolean}
+     */
+    isCollapsed: () => $shell?.getAttribute('data-shell-collapsed') === 'true',
+
+    /**
+     * Whether the mobile drawer is open
+     * @returns {boolean}
+     */
+    isOpen: () => $shell?.getAttribute('data-shell-open') === 'true',
+
+    /**
+     * Collapse or expand the desktop sidebar (persisted)
+     * @param {boolean} value
+     */
+    setCollapsed: (value) => {
+      if (!$shell) {
+        return;
+      }
+
+      $shell.setAttribute('data-shell-collapsed', value ? 'true' : 'false');
+      omega.storage().set(STORAGE_KEY, !!value);
+      syncControls(shellAPI);
+    },
+
+    /**
+     * Open or close the mobile drawer (not persisted)
+     * @param {boolean} value
+     */
+    setOpen: (value) => {
+      if (!$shell) {
+        return;
+      }
+
+      $shell.setAttribute('data-shell-open', value ? 'true' : 'false');
+      syncControls(shellAPI);
+    },
+
+    /**
+     * Toggle the desktop sidebar collapse state
+     */
+    toggleCollapsed() {
+      this.setCollapsed(!this.isCollapsed());
+    },
+
+    /**
+     * Toggle the mobile drawer
+     */
+    toggleOpen() {
+      this.setOpen(!this.isOpen());
+    },
+  };
+
+  // Register on the omega library — web's bundle entry creates the container before
+  // this runs; vendored surfaces (desktop/extension renderers) call this
+  // module directly with no such entry, so create it if absent (#111)
+  omega._library = omega._library || {};
+  omega._library.appShell = shellAPI;
+
+  // No shell on this page — the API stays registered but inert
+  if (!$shell) {
+    return;
+  }
+
+  // Restore the persisted collapse state
+  if (String(omega.storage().get(STORAGE_KEY)) === 'true') {
+    $shell.setAttribute('data-shell-collapsed', 'true');
+  }
+
+  // Delegated controls
+  document.addEventListener('click', (event) => {
+    const $control = event.target.closest('[data-shell-toggle], [data-shell-dismiss]');
+
+    if (!$control) {
+      return;
+    }
+
+    event.preventDefault();
+
+    if ($control.hasAttribute('data-shell-dismiss')) {
+      shellAPI.setOpen(false);
+      return;
+    }
+
+    if ($control.getAttribute('data-shell-toggle') === 'collapse') {
+      shellAPI.toggleCollapsed();
+    } else {
+      shellAPI.toggleOpen();
+    }
+  });
+
+  // Escape closes the drawer
+  document.addEventListener('keydown', (event) => {
+    if (event.key === 'Escape' && shellAPI.isOpen()) {
+      shellAPI.setOpen(false);
+    }
+  });
+
+  // Reflect the restored state onto the controls
+  syncControls(shellAPI);
+
+  console.log('App shell module loaded');
+};
+
+/**
+ * Sync aria-expanded on every shell control to the current state
+ * @param {object} shellAPI - The shell API
+ */
+const syncControls = (shellAPI) => {
+  document.querySelectorAll('[data-shell-toggle]').forEach(($el) => {
+    const expanded = $el.getAttribute('data-shell-toggle') === 'collapse'
+      ? !shellAPI.isCollapsed()
+      : shellAPI.isOpen();
+
+    $el.setAttribute('aria-expanded', expanded ? 'true' : 'false');
+  });
+};

package/dist/assets/js/libs/initialize-tooltips.js

@@ -0,0 +1,31 @@
+/**
+ * Initialize Bootstrap Tooltips
+ * Finds all elements with data-bs-toggle="tooltip" and initializes them
+ *
+ * The ONE home ([#99](https://github.com/Omega-JS-Stack/omega/issues/99)):
+ * every theme shipped a byte-identical copy under its own `js/`, so a fix
+ * had to be made three times. Themes import it off the core layer
+ * (`__main_assets__/js/libs/initialize-tooltips.js`) — same lane as the
+ * chart helper beside it — and `window.bootstrap` is already global by the
+ * time a theme's DOM-ready handler calls this.
+ *
+ * @param {ParentNode} [$root] - the subtree to scan; markup injected AFTER the
+ *   page-load pass (the change-plan modal's feature bullets) passes its own
+ *   container so only the new triggers are wired.
+ */
+export default function initializeTooltips($root = document) {
+  const $tooltipTriggers = $root.querySelectorAll('[data-bs-toggle="tooltip"]');
+
+  // If no tooltips found, exit early
+  if ($tooltipTriggers.length === 0) {
+    return;
+  }
+
+  // Log the number of tooltips being initialized
+  console.log(`Initializing ${$tooltipTriggers.length} tooltips`);
+
+  // Initialize each tooltip
+  $tooltipTriggers.forEach(($el) => {
+    new bootstrap.Tooltip($el);
+  });
+}

package/dist/assets/js/libs/recaptcha.js

@@ -0,0 +1,94 @@
+// Shared reCAPTCHA v3 management — lazy script load + token mint for any
+// public form that posts to a recaptcha-gated backend route (checkout
+// payment intent, newsletter capture). Site key: omega.config.captcha.providers.recaptcha.siteKey.
+import omega from '@omega.js/client';
+import { createLogger } from '__main_assets__/js/libs/logger.js';
+
+const logger = createLogger('recaptcha');
+
+let recaptchaReady = false;
+let recaptchaSiteKey = null;
+
+// Initialize reCAPTCHA
+export async function initializeRecaptcha(siteKey) {
+  if (!siteKey) {
+    console.warn('No reCAPTCHA site key provided');
+    return false;
+  }
+
+  recaptchaSiteKey = siteKey;
+
+  // Check if already loaded
+  if (window.grecaptcha) {
+    recaptchaReady = true;
+    return true;
+  }
+
+  try {
+    // Use omega.dom().loadScript()
+    const scriptUrl = `https://www.google.com/recaptcha/api.js?render=${siteKey}`;
+
+    await omega.dom().loadScript({
+      src: scriptUrl,
+      async: true,
+      defer: true,
+      timeout: 30000, // 30 second timeout
+      retries: 2 // Retry twice on failure
+    });
+
+    // Wait for grecaptcha to be ready
+    await new Promise((resolve) => {
+      if (window.grecaptcha && window.grecaptcha.ready) {
+        window.grecaptcha.ready(() => {
+          recaptchaReady = true;
+          console.log('🔐 reCAPTCHA initialized successfully');
+          resolve();
+        });
+      } else {
+        // Fallback timeout if grecaptcha.ready is not available
+        console.warn('grecaptcha.ready not available, using timeout fallback');
+        setTimeout(() => {
+          recaptchaReady = true;
+          resolve();
+        }, 1000);
+      }
+    });
+
+    return true;
+  } catch (error) {
+    console.error('Failed to load reCAPTCHA:', error);
+    return false;
+  }
+}
+
+// Get reCAPTCHA token
+export async function getRecaptchaToken(action = 'submit') {
+  /* @dev-only:start */
+  {
+    const devRecaptcha = new URLSearchParams(window.location.search).get('_dev_recaptcha');
+    if (devRecaptcha === 'invalid') {
+      logger.warn('Sending invalid reCAPTCHA token');
+      return 'invalid-dev-token';
+    }
+    if (devRecaptcha === 'empty') {
+      logger.warn('Sending empty reCAPTCHA token');
+      return '';
+    }
+  }
+  /* @dev-only:end */
+
+  if (!recaptchaReady || !recaptchaSiteKey) {
+    console.warn('reCAPTCHA not initialized');
+    return null;
+  }
+
+  try {
+    console.log('🔐 Getting reCAPTCHA token for action:', action);
+    const token = await grecaptcha.execute(recaptchaSiteKey, { action });
+    console.log('🔐 reCAPTCHA token obtained successfully');
+    return token;
+  } catch (error) {
+    console.error('Failed to get reCAPTCHA token:', error);
+    return null;
+  }
+}

package/dist/assets/js/main.js

@@ -0,0 +1,4 @@
+// const Manager = new (require('@omega.js/client'));
+const Manager = new (require(proccess.cwd() + '/node_modules/@omega.js/client'));
+
+console.log('MAIN.js', Manager);