@brightspot/ui-builder 1.0.0

package/configs/eslint.config.mjs

@@ -0,0 +1,26 @@
+import js from '@eslint/js'
+import prettier from 'eslint-plugin-prettier/recommended'
+import globals from 'globals'
+import ts from 'typescript-eslint'
+
+/** @type {import('eslint').Linter.Config[]} */
+export default [
+  { name: '@brightspot/ui-builder/globals', languageOptions: { globals: globals.browser } },
+  { name: '@brightspot/ui-builder/js', ...js.configs.recommended },
+  ...ts.configs.recommended.map(c => ({ ...c, name: `@brightspot/ui-builder/${c.name ?? 'ts'}` })),
+  {
+    name: '@brightspot/ui-builder/rules',
+    rules: {
+      semi: ['error', 'never'],
+      'no-empty': 'off',
+      'no-prototype-builtins': 'off',
+      '@typescript-eslint/no-empty-function': 'off',
+      '@typescript-eslint/no-this-alias': 'off',
+      '@typescript-eslint/no-var-requires': 'off',
+      '@typescript-eslint/no-unused-vars': 'off',
+      '@typescript-eslint/no-require-imports': 'off',
+      '@typescript-eslint/no-explicit-any': 'warn',
+    },
+  },
+  prettier,
+]

package/configs/prettier.config.mjs

@@ -0,0 +1,19 @@
+/** @type {import('prettier').Config} */
+export default {
+  arrowParens: 'avoid',
+  bracketSpacing: true,
+  htmlWhitespaceSensitivity: 'css',
+  insertPragma: false,
+  bracketSameLine: false,
+  jsxSingleQuote: false,
+  printWidth: 120,
+  proseWrap: 'preserve',
+  quoteProps: 'as-needed',
+  requirePragma: false,
+  semi: false,
+  singleQuote: true,
+  tabWidth: 2,
+  useTabs: false,
+  organizeImportsSkipDestructiveCodeActions: true,
+  plugins: ['prettier-plugin-organize-imports'],
+}

package/configs/tsconfig.base.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true
+  }
+}

package/dist/commands/build.d.ts

@@ -0,0 +1 @@
+export declare function build(): Promise<void>;

package/dist/commands/build.js

@@ -0,0 +1,11 @@
+import { build as viteBuild } from 'vite';
+import { log } from '../lib/logger.js';
+import { resolveConfig } from '../lib/resolve-config.js';
+import { createBuildConfig } from '../vite/vite-config.js';
+export async function build() {
+    log.info('Building IIFE bundle...');
+    const { basePath } = resolveConfig();
+    const config = createBuildConfig(basePath);
+    await viteBuild(config);
+    log.success('Build complete — output in dist/');
+}

package/dist/commands/dev.d.ts

@@ -0,0 +1,6 @@
+interface DevOptions {
+    port?: number;
+    url?: string;
+}
+export declare function dev(opts: DevOptions): Promise<void>;
+export {};

package/dist/commands/dev.js

@@ -0,0 +1,14 @@
+import { createServer } from 'vite';
+import { log } from '../lib/logger.js';
+import { resolveConfig } from '../lib/resolve-config.js';
+import { resolveTarget } from '../lib/resolve-target.js';
+import { createDevConfig } from '../vite/vite-config.js';
+export async function dev(opts) {
+    const { basePath } = resolveConfig();
+    const target = opts.url ?? resolveTarget();
+    const config = createDevConfig({ target, port: opts.port, basePath });
+    const server = await createServer(config);
+    await server.listen();
+    server.printUrls();
+    log.success('Dev server running — proxying to ' + target);
+}

package/dist/commands/init.d.ts

@@ -0,0 +1 @@
+export declare function init(): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,73 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { log } from '../lib/logger.js';
+import { resolveTarget } from '../lib/resolve-target.js';
+const cwd = process.cwd();
+export async function init() {
+    log.info('Initializing Brightspot UI project...');
+    writeTsConfig();
+    writeEslintConfig();
+    patchPackageJson();
+    scaffoldEntryPoint();
+    resolveTarget();
+    log.success('Project initialized. Run `brightspot-ui dev` to start developing.');
+}
+function writeTsConfig() {
+    const tsConfigPath = path.join(cwd, 'tsconfig.json');
+    if (fs.existsSync(tsConfigPath)) {
+        log.warn('tsconfig.json already exists — skipping');
+        return;
+    }
+    const config = {
+        extends: '@brightspot/ui-builder/configs/tsconfig.base.json',
+    };
+    fs.writeFileSync(tsConfigPath, JSON.stringify(config, null, 2) + '\n');
+    log.success('Created tsconfig.json');
+}
+function writeEslintConfig() {
+    const eslintConfigPath = path.join(cwd, 'eslint.config.mjs');
+    if (fs.existsSync(eslintConfigPath)) {
+        log.warn('eslint.config.mjs already exists — skipping');
+        return;
+    }
+    const content = `import config from '@brightspot/ui-builder/configs/eslint.config.mjs'
+
+export default [...config]
+`;
+    fs.writeFileSync(eslintConfigPath, content);
+    log.success('Created eslint.config.mjs');
+}
+function patchPackageJson() {
+    const pkgPath = path.join(cwd, 'package.json');
+    if (!fs.existsSync(pkgPath)) {
+        log.warn('No package.json found — skipping script injection');
+        return;
+    }
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    pkg.scripts = pkg.scripts ?? {};
+    pkg.scripts.dev = 'brightspot-ui dev';
+    pkg.scripts.build = 'brightspot-ui build';
+    pkg.prettier = '@brightspot/ui-builder/configs/prettier.config.mjs';
+    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+    log.success('Patched package.json (scripts + prettier)');
+}
+function scaffoldEntryPoint() {
+    const srcDir = path.join(cwd, 'src');
+    const entryPath = path.join(srcDir, 'index.ts');
+    if (fs.existsSync(entryPath)) {
+        log.warn('src/index.ts already exists — skipping');
+        return;
+    }
+    if (!fs.existsSync(srcDir)) {
+        fs.mkdirSync(srcDir, { recursive: true });
+    }
+    const template = `// Entry point for Brightspot CMS bundle
+// Import your styles:
+// import './styles/main.css'
+
+// Import your modules:
+// import './tour'
+`;
+    fs.writeFileSync(entryPath, template);
+    log.success('Created src/index.ts');
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+program.name('brightspot-ui').description('Zero-config build toolkit for Brightspot CMS front-end development.');
+program
+    .command('init')
+    .description('Scaffold config files for a new Brightspot front-end project')
+    .action(async () => {
+    const { init } = await import('./commands/init.js');
+    await init();
+});
+program
+    .command('dev [url]')
+    .description('Start Vite dev server with HTTPS proxy to Brightspot')
+    .option('--port <port>', 'Dev server port', parseInt)
+    .action(async (url, opts) => {
+    const { dev } = await import('./commands/dev.js');
+    await dev({ ...opts, url });
+});
+program
+    .command('build')
+    .description('Build IIFE bundle for production')
+    .action(async () => {
+    const { build } = await import('./commands/build.js');
+    await build();
+});
+program.parse();

package/dist/lib/logger.d.ts

@@ -0,0 +1,6 @@
+export declare const log: {
+    info(msg: string): void;
+    success(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+};

package/dist/lib/logger.js

@@ -0,0 +1,15 @@
+import pc from 'picocolors';
+export const log = {
+    info(msg) {
+        console.log(pc.cyan('ℹ'), msg);
+    },
+    success(msg) {
+        console.log(pc.green('✔'), msg);
+    },
+    warn(msg) {
+        console.log(pc.yellow('⚠'), msg);
+    },
+    error(msg) {
+        console.error(pc.red('✖'), msg);
+    },
+};

package/dist/lib/resolve-config.d.ts

@@ -0,0 +1,5 @@
+interface BuilderConfig {
+    basePath: string;
+}
+export declare function resolveConfig(): BuilderConfig;
+export {};

package/dist/lib/resolve-config.js

@@ -0,0 +1,25 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { log } from './logger.js';
+const DEFAULT_BASE_PATH = '/_resource/dist/';
+export function resolveConfig() {
+    const pkgPath = path.resolve(process.cwd(), 'package.json');
+    try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        const config = pkg['brightspot-ui'];
+        if (config?.basePath) {
+            const basePath = config.basePath;
+            if (!basePath.startsWith('/') || !basePath.endsWith('/')) {
+                log.warn(`basePath "${basePath}" must start and end with "/" — using default`);
+                return { basePath: DEFAULT_BASE_PATH };
+            }
+            log.info(`basePath: ${basePath}`);
+            return { basePath };
+        }
+    }
+    catch {
+        // package.json not found or unreadable — use defaults
+    }
+    log.info(`basePath: ${DEFAULT_BASE_PATH} (default)`);
+    return { basePath: DEFAULT_BASE_PATH };
+}

package/dist/lib/resolve-target.d.ts

@@ -0,0 +1 @@
+export declare function resolveTarget(): string;

package/dist/lib/resolve-target.js

@@ -0,0 +1,19 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { log } from './logger.js';
+const LOCAL_URL_PATH = path.join(os.homedir(), '.brightspot', 'local-url');
+const DEFAULT_TARGET = 'http://localhost';
+export function resolveTarget() {
+    try {
+        const url = fs.readFileSync(LOCAL_URL_PATH, 'utf8').trim();
+        if (url) {
+            log.info(`Proxy target: ${url}`);
+            return url;
+        }
+    }
+    catch {
+        log.warn(`${LOCAL_URL_PATH} not found — falling back to ${DEFAULT_TARGET}`);
+    }
+    return DEFAULT_TARGET;
+}

package/dist/vite/plugin-html-inject.d.ts

@@ -0,0 +1,7 @@
+import type { Plugin } from 'vite';
+/**
+ * Serves a dev bootstrap script at the bundle.js path so that Vite's
+ * HMR client and the real entry point are loaded as ES modules.
+ * Also serves an empty style.css since Vite injects CSS via JS in dev.
+ */
+export declare function devEntryPlugin(basePath: string, entry: string): Plugin;

package/dist/vite/plugin-html-inject.js

@@ -0,0 +1,28 @@
+/**
+ * Serves a dev bootstrap script at the bundle.js path so that Vite's
+ * HMR client and the real entry point are loaded as ES modules.
+ * Also serves an empty style.css since Vite injects CSS via JS in dev.
+ */
+export function devEntryPlugin(basePath, entry) {
+    const bundlePath = `${basePath}bundle.js`;
+    const cssPath = `${basePath}style.css`;
+    return {
+        name: 'brightspot-dev-entry',
+        configureServer(server) {
+            server.middlewares.use((req, res, next) => {
+                const pathname = req.url?.split('?')[0];
+                if (pathname === bundlePath) {
+                    res.setHeader('Content-Type', 'application/javascript');
+                    res.end(`import('/@vite/client');import('/${entry}');`);
+                    return;
+                }
+                if (pathname === cssPath) {
+                    res.setHeader('Content-Type', 'text/css');
+                    res.end('');
+                    return;
+                }
+                next();
+            });
+        },
+    };
+}

package/dist/vite/vite-config.d.ts

@@ -0,0 +1,10 @@
+import type { InlineConfig } from 'vite';
+interface DevConfigOptions {
+    target: string;
+    port?: number;
+    basePath: string;
+    entry?: string;
+}
+export declare function createDevConfig({ target, port, basePath, entry }: DevConfigOptions): InlineConfig;
+export declare function createBuildConfig(basePath: string): InlineConfig;
+export {};

package/dist/vite/vite-config.js

@@ -0,0 +1,59 @@
+import path from 'node:path';
+import { devEntryPlugin } from './plugin-html-inject.js';
+export function createDevConfig({ target, port, basePath, entry = 'src/index.ts' }) {
+    const cwd = process.cwd();
+    const escaped = basePath.replace(/^\//, '').replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const entryDir = entry.split('/')[0] + '/';
+    return {
+        root: cwd,
+        base: '/',
+        plugins: [mkcertPlugin(), devEntryPlugin(basePath, entry)],
+        resolve: {
+            preserveSymlinks: true,
+        },
+        server: {
+            port,
+            proxy: {
+                [`^/(?!(${escaped}|${entryDir}|@vite|@fs|node_modules))`]: {
+                    target,
+                    autoRewrite: true,
+                    changeOrigin: true,
+                    configure: proxy => {
+                        proxy.on('proxyReq', proxyReq => {
+                            proxyReq.setHeader('x-forwarded-proto', 'https');
+                            proxyReq.setHeader('x-brightspot-dev', '1');
+                        });
+                    },
+                },
+            },
+        },
+    };
+}
+export function createBuildConfig(basePath) {
+    const cwd = process.cwd();
+    return {
+        root: cwd,
+        base: basePath,
+        resolve: {
+            preserveSymlinks: true,
+        },
+        build: {
+            lib: {
+                entry: path.resolve(cwd, 'src/index.ts'),
+                formats: ['iife'],
+                name: 'BrightspotTheme',
+                fileName: () => 'bundle.js',
+            },
+            rollupOptions: {
+                output: {
+                    assetFileNames: () => 'style.css',
+                },
+            },
+            cssCodeSplit: false,
+        },
+    };
+}
+async function mkcertPlugin() {
+    const mkcert = await import('vite-plugin-mkcert');
+    return mkcert.default();
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@brightspot/ui-builder",
+  "version": "1.0.0",
+  "type": "module",
+  "license": "UNLICENSED",
+  "description": "Zero-config build toolkit for Brightspot CMS front-end development.",
+  "bin": {
+    "brightspot-ui": "./dist/index.js"
+  },
+  "exports": {
+    "./configs/tsconfig.base.json": "./configs/tsconfig.base.json",
+    "./configs/eslint.config.mjs": "./configs/eslint.config.mjs",
+    "./configs/prettier.config.mjs": "./configs/prettier.config.mjs"
+  },
+  "files": [
+    "dist/**/*",
+    "configs/**/*"
+  ],
+  "scripts": {
+    "build": "tsc --noEmitOnError && chmod +x ./dist/index.js",
+    "clean": "shx rm -rf ./dist/*"
+  },
+  "dependencies": {
+    "commander": "^13.0.0",
+    "picocolors": "^1.1.0",
+    "vite": "^7.0.0",
+    "vite-plugin-mkcert": "^1.17.0",
+    "eslint": "^9.39.0",
+    "@eslint/js": "^9.23.0",
+    "typescript-eslint": "^8.29.0",
+    "eslint-plugin-prettier": "^5.5.0",
+    "eslint-config-prettier": "^10.0.0",
+    "prettier": "^3.2.0",
+    "prettier-plugin-organize-imports": "^4.3.0",
+    "typescript": "^5.9.0",
+    "autoprefixer": "^10.0.0",
+    "globals": "^16.0.0"
+  },
+  "devDependencies": {
+    "shx": "^0.4.0",
+    "@types/node": "^24.10.0"
+  }
+}