@omega.js/extension 0.1.0

package/dist/defaults/.github/workflows/publish.yml

@@ -0,0 +1,86 @@
+# Deliberate deploys (D13): commits never auto-publish — save = commit,
+# publish = an explicit dispatch (`omega deploy`, the CMS publish action, or
+# a plain HTTP workflow_dispatch/repository_dispatch call).
+name: Build and Publish Extension
+
+on:
+  workflow_dispatch:
+  repository_dispatch:
+    types: [omega-deploy]
+
+concurrency:
+  group: ${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  NODE_VERSION: '[versions.node]'
+  OMEGA_BUILD_MODE: 'true'
+  OMEGA_IS_PUBLISH: 'true'
+
+  # Every CI-delivered key of the env schema, GENERATED (#627): one
+  # `KEY: ${{ secrets.KEY }}` line per `delivery: { extension: 'ci' | 'bake' }`
+  # entry (@omega.js/config's env-delivery.js), re-rendered by every verb's
+  # scaffold. A dispatched run has no `.env`, so this block is the ONLY way the
+  # store credentials and the Measurement Protocol secret the build bakes into
+  # every bundle (OMEGA_BUILD_JSON) reach the runner. Add a key to the schema, not to this file.
+  [ githubSecrets ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Setup git config
+        run: |
+          git config --global user.email "$GITHUB_ACTOR@users.noreply.github.com"
+          git config --global user.name "$GITHUB_ACTOR"
+
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+
+      - name: Install Socket Firewall
+        run: npm install -g sfw
+
+      - name: Install dependencies
+        run: sfw npm install
+
+      - name: Log dependency versions
+        run: |
+          echo "Node: $(node -v)"
+          echo "NPM: $(npm -v)"
+          echo "Framework: $(npx omega-extension version)"
+          echo ""
+          echo "NPM Dependencies:"
+          npm list --depth=0 || echo ""
+
+      - name: Build and publish extension
+        run: |
+          npm run build
+
+      # Artifact channel = GitHub releases (D9 addendum 2) — the same channel
+      # desktop distributes from, and where CMS download links point. Store
+      # uploads happen in the build step when credentials are present; the zips
+      # here are the durable, downloadable fallback for manual store uploads.
+      # The build writes one per browser target (packaged/<target>/extension.zip);
+      # a release asset is named by its basename, so each is copied to a
+      # target-stamped name before upload instead of clobbering the others.
+      - name: Upload packages to GitHub release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          VERSION=$(node -p "require('./package.json').version")
+          TAG="extension-v$VERSION"
+          gh release view "$TAG" >/dev/null 2>&1 \
+            || gh release create "$TAG" --title "Extension v$VERSION" --notes "Browser extension package for v$VERSION (built from ${{ github.sha }})."
+          for zip in packaged/*/extension.zip; do
+            target=$(basename "$(dirname "$zip")")
+            cp "$zip" "packaged/extension-$target.zip"
+            gh release upload "$TAG" "packaged/extension-$target.zip" --clobber
+          done

package/dist/defaults/.nvmrc

@@ -0,0 +1 @@
+v{{ versions.node }}/*

package/dist/defaults/.vscode/settings.json

@@ -0,0 +1,8 @@
+// Workspace settings
+{
+    // The following will hide certian files from the file explorer
+    "files.exclude": {
+      // Hide any files with /master/ in the path
+      // "**/master/**": true,
+    }
+}

package/dist/defaults/AGENTS.md

@@ -0,0 +1,113 @@
+# ========== Default Values ==========
+# OMEGA Extension (@omega.js/extension) consumer project
+
+<!-- MAINTAINERS (framework repo): this consumer template is MIRRORED across all OMEGA framework consumer templates (src/defaults/AGENTS.md ×N; web's lives at scaffold/AGENTS.md).
+  Same sections in the same order: framework-specific extras may be inserted; canonical sections are never reordered/renamed. Edit every framework consumer template together.
+  The mirroring rule lives in each framework guide's Doc-update parity section (docs/<framework>/index.md) -->
+
+## Framework
+
+This project consumes **OMEGA Extension** (`@omega.js/extension`), a comprehensive framework for building modern cross-browser extensions (Chrome, Firefox, Edge, Opera, Brave).
+- The framework provides one-line bootstrap per extension context, a component-based architecture (view + styles + script per context), and a multi-browser build/release pipeline that produces store-uploadable zips.
+- It also carries cross-context auth synchronization and a built-in four-layer test framework.
+
+## 🚨 READ THE FRAMEWORK DOCS FIRST
+
+**Before doing ANY work on this codebase, the agent MUST read the framework documentation: that is where the architecture, conventions, APIs, and gotchas live. Skipping these will result in solutions that conflict with framework patterns.**
+
+**Required reading:**
+- **`node_modules/@omega.js/AGENTS.md`**: the OMEGA map, the one agent entry into the framework docs; follow it to `docs/extension/index.md` (the @omega.js/extension guide: identity, architecture, conventions)
+- **`node_modules/@omega.js/extension/docs/`**: subsystem deep references (read the relevant ones for the task at hand)
+
+## 🚨 READ @omega.js/client TOO
+
+**OMEGA Extension ships `@omega.js/client` as a runtime singleton across every extension context (background service worker, popup, options, sidepanel, content scripts).**
+- It powers auth, Firebase, reactive `data-omega-bind` directives, analytics, error tracking, and utilities (`escapeHTML`, etc.).
+- Any task that touches auth flows, Firestore reads/writes, subscription resolution, push notifications, or DOM bindings means you are working with @omega.js/client as much as with the extension framework.
+
+**Required reading:**
+- **`node_modules/@omega.js/AGENTS.md`** → `docs/client/index.md`, the @omega.js/client guide: identity, module list, conventions
+- **`node_modules/@omega.js/client/docs/`**: module deep references (Auth, Bindings, Firestore, Notifications, etc.)
+
+## Quick start
+
+```bash
+npm start                   # dev with live reload (gulp → esbuild → serve)
+npm run build               # production build → dist/ + packaged/<browser>/raw/ + .zip per browser
+OMEGA_IS_PUBLISH=true npm run build   # build + auto-upload to Chrome / Firefox / Edge stores
+npx omega test                # run YOUR project's test suites (bare runs never include the framework corpus)
+npx omega test build/config         # bare path: run project tests matching a path (full:<path> for both sources)
+npx omega test project:             # run ONLY your project tests (project:<path> to narrow)
+npx omega test mgr:                 # run ONLY framework tests (extension: / framework: are equivalent aliases)
+npx omega test extension:build/config     # run only framework tests matching a path
+# Positional target selects which test FILES run; --filter=<substring> matches test NAMES within them
+npx omega test --extended           # also run tests that hit REAL external services (off by default; TEST_EXTENDED_MODE=true is the env equivalent, a shared name across all OMEGA frameworks)
+# (output is teed to logs/: dev.log on `npm start`, build.log on `npm run build`, test.log on `npx omega test`; cat instead of scrolling scrollback)
+npx omega install dev         # use LOCAL @omega.js/extension source (to test framework edits)
+npx omega install live        # restore the published @omega.js/extension from npm
+```
+
+> Editing the framework source while working here? Run `npx omega install dev` so this project picks up your uncommitted framework changes (it otherwise uses its installed `node_modules/@omega.js/extension`). Run `npx omega install live` to switch back.
+
+Load the unpacked extension in Chrome: point chrome://extensions → "Load unpacked" at `packaged/chromium/raw/`.
+
+## Where things live
+
+- `config/omega.json5`: the single OMEGA config (JSON5), with shared sections (brand, cloud, analytics, monitoring, theme) at the top level + `targets.extension` for extension-specific settings. `Manager.getConfig()` returns it RESOLVED (target section overlaid onto the top level). Secrets never live here; they go in `.env` (e.g. `GOOGLE_ANALYTICS_SECRET`).
+- `config/messages.json`: i18n source. Auto-translated at build time to the languages in `translation.languages` (omega.json5); only missing keys regenerated, cache committed under `translations/`.
+- `config/description.md`: store-listing description (used by the publish step).
+- `src/manifest.json`: extension manifest. The framework merges its defaults in at build time; you only need to declare what's specific to your extension.
+  - Anything you DO declare wins outright — an array you write replaces the framework's, and an empty one ships nothing.
+  - The firefox artifact needs `browser_specific_settings.gecko.id` (packaging fails without it) and gets `side_panel` translated to `sidebar_action` automatically.
+- `src/assets/images/`: static images. They copy to `dist/` as-is — no hook, no imagemin step.
+- `src/views/<context>/index.html`: per-context HTML (popup / options / sidepanel / pages).
+- `src/assets/js/components/<context>/index.js`: per-context script entry. One-line bootstrap of `@omega.js/extension/<context>`.
+- `src/assets/css/components/<context>/index.scss`: per-context styles.
+- `src/assets/js/components/background.js`: MV3 service worker entry. Source of truth for auth + messaging.
+- `hooks/build/{pre,post}.js`: optional lifecycle hooks.
+- `test/**/*.js`: your project test suites (framework auto-runs them alongside its own).
+
+## Per-context imports
+
+```js
+// src/assets/js/components/popup/index.js
+import Manager from '@omega.js/extension/popup';
+await new Manager().initialize();
+
+// src/assets/js/components/background.js  (service worker)
+import Manager from '@omega.js/extension/background';
+await new Manager().initialize();
+
+// Same shape for options / sidepanel / content / page / offscreen
+```
+
+## Available APIs at runtime
+
+After `initialize()`, every Manager exposes:
+- `manager.extension`: cross-browser `chrome.*` / `browser.*` / `window.*` wrapper
+- `manager.logger`: timestamped per-context logger
+- `manager.omega`: Web Manager singleton (Firebase, auth, analytics, reactive `data-omega-bind` directives)
+- `manager.messenger`: `chrome.runtime.onMessage` listener wired automatically
+- `manager.isDevelopment()` / `isProduction()` / `isTesting()` / `getVersion()`: cross-context helpers. `getEnvironment()` returns `'development' | 'testing' | 'production'` (mutually exclusive; testing wins). Gate side effects on the intentional check (`isProduction()` for prod-only; `isDevelopment() || isTesting()` for local-or-test), never `!isDevelopment()`.
+
+Auth UI is declarative: add `.omega-signin` / `.omega-signout` / `.omega-account` to buttons; the framework wires them. Show/hide based on auth state via `data-omega-bind="@show auth.user"`.
+
+## Dependency resolution
+
+- **Do NOT install framework dependencies directly** (`firebase`, `@omega.js/client`, etc.). The framework's bundler resolves them through the framework's own `node_modules/`. If something doesn't resolve, the issue is in the framework's declared dependencies, not your `package.json`.
+- **@omega.js/client owns Firebase.** Never `import firebase from 'firebase/app'`. Use `import omega from '@omega.js/client'` → `omega.auth()`, `omega.firestore()`.
+- **`Manager.require(name)`** resolves from the framework's module context at runtime for unbundled code (gulp tasks, test fixtures).
+
+## Testing
+
+Every feature ships with tests at every layer it has a surface in: **logic** (`test/build/`, `test/background/`), **UI** (`test/view/`: real events on the real DOM), and **end-to-end** (`test/boot/`).
+- Skip a layer only when the feature genuinely has no surface there; "the logic test covers it" does not excuse the UI test.
+- See `test/README.md` and `node_modules/@omega.js/extension/docs/test-framework.md`.
+
+<!-- Everything above this marker is owned by the framework and rewritten by every omega verb. Add your project-specific notes below — they are preserved. -->
+
+# ========== Custom Values ==========
+
+## Project-specific notes
+
+Add anything specific to THIS project here. Edits below this line are preserved across framework re-syncs.

package/dist/defaults/CHANGELOG.md

@@ -0,0 +1,15 @@
+# CHANGELOG
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## Changelog Categories
+
+- `BREAKING` for breaking changes.
+- `Added` for new features.
+- `Changed` for changes in existing functionality.
+- `Deprecated` for soon-to-be removed features.
+- `Removed` for now removed features.
+- `Fixed` for any bug fixes.
+- `Security` in case of vulnerabilities.

package/dist/defaults/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/dist/defaults/_.gitignore

@@ -0,0 +1,75 @@
+# ========== Default Values ==========
+# macOS
+.DS_Store
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+firebase-debug.log*
+
+# Firebase cache
+.firebase/
+
+# Firebase config
+.firebaserc
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage
+.grunt
+
+# Bower dependency directory
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons
+build/Release
+
+# Dependency directories
+node_modules/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+
+# Custom
+/dist
+/packaged
+/.temp
+/.cache
+/_legacy
+
+# ========== Custom Values ==========
+# ...

package/dist/defaults/config/description.md

@@ -0,0 +1,46 @@
+🚀 Enhance Your Browsing Experience Instantly
+🧠 Smart Features That Work in the Background
+⚡ One-Click Setup — No Configuration Needed
+🎯 Customizable Settings — Your Browser, Your Rules
+💡 Lightweight, Fast, Zero Bloat
+
+{{ brand.name }} is your all-in-one browser companion that makes the web work better for you. No more frustrating browsing experiences. No more wasting time on repetitive tasks. No more settling for a browser that doesn't do enough.
+If you want a smarter, faster, and more enjoyable browsing experience — {{ brand.name }} was made for you.
+
+🔍 How it works
+{{ brand.name }} runs quietly in the background, enhancing your browsing experience automatically.
+
+🧠 Smart Detection: Knows when to activate and when to stay out of the way
+🔧 Powerful Tools: Access everything you need from a simple popup
+⚙️ Customizable: Tailor the extension to fit your browsing habits
+🌐 Works Everywhere: Compatible with all your favorite websites
+
+Click the icon, adjust your settings, and browse better. Everything else just works.
+No complicated setup. No learning curve. Just a better browsing experience, instantly.
+
+✨ Why {{ brand.name }} is a game changer
+
+Save time: Automate repetitive tasks and get more done with less effort.
+Stay in control: Customize every aspect of the extension to match your preferences.
+Browse smarter: Intelligent features that adapt to how you use the web.
+Clean and fast: Minimal footprint — no slowdowns, no clutter, no unnecessary bloat.
+Private and secure: No cloud accounts required. No tracking. Everything runs locally and respects your privacy.
+
+🧠 The {{ brand.name }} Difference
+Most people either:
+
+Settle for a bare-bones browser with no enhancements
+Install a dozen separate extensions that slow everything down
+
+{{ brand.name }} gives you a better option: one powerful extension that does it all — cleanly, efficiently, and without getting in your way.
+Think of it as a supercharger for your browser ⚡
+Whether you're working, researching, shopping, or just casually browsing — {{ brand.name }} makes every session better.
+
+🔥 Install {{ brand.name }} now and upgrade the way you browse.
+Stop settling for a basic browser. Start browsing smarter.
+
+💸 Bonus:
+While you're browsing, the extension also finds and applies shopping deals from top partners like Amazon, Capital One, and NordVPN. Get discounts and bonuses without lifting a finger. When you buy through links on our extension, we may earn an affiliate commission.
+
+🔐 Your privacy is respected — we do not sell or misuse your data. By using our extension, you agree to our terms of service and privacy policy.
+When you buy through links on our extension, we may earn an affiliate commission.

package/dist/defaults/config/messages.json

@@ -0,0 +1,20 @@
+{
+  appName: {
+    message: '[ extension.name ]',
+    description: 'The name of the extension.',
+  },
+  appNameShort: {
+    message: '[ extension.name ]',
+    description: 'The short name of the extension.',
+  },
+  appDescription: {
+    // Seeded from brand.description when it fits the 200-character store cap,
+    // otherwise 'The official <brand> browser extension.'
+    message: '[ extension.description ]',
+    description: 'The description of the extension.',
+  },
+  btnTooltip: {
+    message: '[ extension.name ]',
+    description: 'Tooltip for the button.',
+  },
+}

package/dist/defaults/config/omega.json5

@@ -0,0 +1,64 @@
+// config/omega.json5 — the single OMEGA config file (JSON5: comments + trailing commas OK).
+//
+// Shape: SHARED sections at the top level (identical spelling in every OMEGA project
+// type — website, backend, extension, desktop), then a `targets` object whose KEY
+// PRESENCE says which targets this brand enables and whose values hold target-scoped
+// settings. Any shared key may also appear inside a target entry to override it for
+// that surface only (e.g. an extension-specific monitoring.providers.sentry.dsn
+// under targets.extension).
+//
+// Secrets NEVER live here — they live in .env. The validator hard-fails on
+// secret-shaped keys (…Secret, …privateKey).
+{
+  brand: {
+    id: 'my-brand',
+    name: 'My Brand',
+    url: 'https://example.com',
+    contact: {
+      email: 'support@example.com',
+    },
+  },
+
+  monitoring: {
+    providers: {
+      sentry: {
+        dsn: '',
+      },
+    },
+  },
+
+  // GA4 analytics. Measurement ID lives in config (not secret); the API secret
+  // lives in `process.env.GOOGLE_ANALYTICS_SECRET` (.env — matches @omega.js/backend/EM convention)
+  // and is baked into the build snapshot (OMEGA_BUILD_JSON, in every bundle) at build time.
+  analytics: {
+    providers: {
+      google: {
+        id: '',
+      },
+    },
+  },
+
+  // Firebase web-app config (public client keys — real secrets stay in .env).
+  // Fill from Firebase console → Project settings → your web app.
+  cloud: {
+    provider: 'firebase',
+    config: {
+      apiKey: '',
+      authDomain: '',
+      projectId: '',
+      storageBucket: '',
+      messagingSenderId: '',
+      appId: '',
+    },
+  },
+
+  theme: {
+    id: 'classy',
+  },
+
+  // KEY PRESENCE = enabled. `extension: {}` = enabled with defaults (the extension
+  // target section is near-empty by design — extension-specific settings land here).
+  targets: {
+    extension: {},
+  },
+}

package/dist/defaults/docs/README.md

@@ -0,0 +1,17 @@
+# Project docs
+
+Per-subsystem deep references live here. Keep `AGENTS.md` short — it should read as a **table of contents** that points at files in this directory.
+
+## Pattern
+
+When you find yourself adding more than a paragraph to `AGENTS.md`, create a new `docs/<topic>.md` instead and link to it from `AGENTS.md`. Goal: the project's `AGENTS.md` stays under ~250 lines (`CLAUDE.md` is only the one-line `@AGENTS.md` pointer).
+
+Examples of good `docs/*.md` topics:
+- Subsystem deep-dives (one per area of the codebase)
+- Architectural decisions / "why we built it this way"
+- Defaults tables, behavior matrices, edge cases
+- Setup walkthroughs that don't belong in `README.md`
+
+## See also
+
+The framework's own docs follow this same pattern — browse `node_modules/@omega.js/extension/docs/` for the canonical examples.

package/dist/defaults/gulpfile.js

@@ -0,0 +1,6 @@
+// Consumer gulpfile — the framework's gulp pipeline, resolved through the
+// require climb so it works wherever npm hoists the framework (brand-root
+// node_modules in a monorepo, local node_modules standalone). The old
+// scripts hardcoded ./node_modules/@omega.js/extension/... and broke under
+// workspace hoisting (dogfood friction #14).
+module.exports = require('@omega.js/extension/gulp');

package/dist/defaults/hooks/build/post.js

@@ -0,0 +1,8 @@
+// Libraries
+const Manager = new (require('@omega.js/extension/build'));
+const logger = Manager.logger('build:post');
+
+// Hook
+module.exports = async ({ projectRoot, mode }) => {
+  logger.log(`Running in ${mode} mode from ${projectRoot}`);
+}

package/dist/defaults/hooks/build/pre.js

@@ -0,0 +1,8 @@
+// Libraries
+const Manager = new (require('@omega.js/extension/build'));
+const logger = Manager.logger('build:pre');
+
+// Hook
+module.exports = async ({ projectRoot, mode }) => {
+  logger.log(`Running in ${mode} mode from ${projectRoot}`);
+}

package/dist/defaults/src/assets/css/components/content/index.scss

@@ -0,0 +1,11 @@
+// ============================================
+// Content Script Component
+// ============================================
+
+// Import default content script component styles
+@use 'components/content' as *;
+
+// ============================================
+// Custom Content Script Styles
+// ============================================
+// Add your project-specific content script CSS below...

package/dist/defaults/src/assets/css/components/offscreen/index.scss

@@ -0,0 +1,4 @@
+// ============================================
+// Offscreen Component Styles
+// ============================================
+// Offscreen documents are invisible, minimal styling needed

package/dist/defaults/src/assets/css/components/options/index.scss

@@ -0,0 +1,14 @@
+// ============================================
+// Custom Options Component Override
+// ============================================
+
+// Import the default options component styles first
+@use 'components/options' as *;
+
+// ============================================
+// Project-Specific Options Customization
+// ============================================
+body {
+  min-width: 400px;
+  max-width: 100%;
+}

package/dist/defaults/src/assets/css/components/pages/index.scss

@@ -0,0 +1,10 @@
+// ============================================
+// Index Page (Main Extension Page)
+// ============================================
+
+// Import the default index page component styles first
+@use 'components/pages/index' as *;
+
+// ============================================
+// Project-Specific Index Page Customization
+// ============================================

package/dist/defaults/src/assets/css/components/popup/index.scss

@@ -0,0 +1,10 @@
+// ============================================
+// Custom Popup Component Override
+// ============================================
+
+// Import the default popup component styles first
+@use 'components/popup' as *;
+
+// ============================================
+// Project-Specific Popup Customization
+// ============================================

package/dist/defaults/src/assets/css/components/sidepanel/index.scss

@@ -0,0 +1,6 @@
+// ============================================
+// Sidepanel Component Styles
+// ============================================
+// Default styles for the sidepanel view
+
+// Add your sidepanel-specific styles here

package/dist/defaults/src/assets/css/main.scss

@@ -0,0 +1,32 @@
+// ============================================
+// Theme Configuration
+// ============================================
+
+// Customize OMEGA Extension theme variables here
+@use 'omega-extension' as * with (
+  // ============================================
+  // Brand Colors
+  // ============================================
+  $primary: #2563EB,
+  // $secondary: #6C757D,
+
+  // ============================================
+  // Typography (uncomment to customize)
+  // ============================================
+  // $font-family-base: 'Inter', -apple-system, sans-serif,
+
+  // ============================================
+  // Borders (uncomment to customize)
+  // ============================================
+  // $border-radius: 0.5rem,
+
+  // ============================================
+  // Add more customizations below
+  // See theme.scss for all customizable variables
+  // ============================================
+);
+
+// ============================================
+// Custom Global Styles
+// ============================================
+// Add your project-specific global CSS below that applies everywhere...

package/dist/defaults/src/assets/js/components/background/index.js

@@ -0,0 +1,25 @@
+// ============================================
+// Background Component (Service Worker)
+// ============================================
+
+// Import OMEGA Extension
+import Manager from '@omega.js/extension/background';
+
+// Create instance
+const manager = new Manager();
+
+// Init service worker
+const serviceWorker = self;
+
+// Initialize
+manager.initialize()
+.then(() => {
+  // Shortcuts
+  const { extension, logger, omega } = manager;
+
+  // Add your project-specific background logic here
+  // ...
+
+  // Log the initialization
+  logger.log('Background initialized!');
+});

package/dist/defaults/src/assets/js/components/content/index.js

@@ -0,0 +1,22 @@
+// ============================================
+// Content Script Component
+// ============================================
+
+// Import OMEGA Extension
+import Manager from '@omega.js/extension/content';
+
+// Create instance
+const manager = new Manager();
+
+// Initialize
+manager.initialize()
+.then(() => {
+  // Shortcuts
+  const { extension, messenger, logger } = manager;
+
+  // Add your project-specific content script logic here
+  // ...
+
+  // Log the initialization
+  logger.log('Content script initialized!');
+});