stonyx 0.2.3-alpha.4 → 0.2.3-alpha.40

package/dist/cli.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import serve from './cli/serve.js';
+import test from './cli/test.js';
+import help from './cli/help.js';
+import newCommand from './cli/new.js';
+import loadModuleCommands from './cli/load-commands.js';
+import { importConfig } from './util/import-config.js';
+try {
+    process.loadEnvFile();
+}
+catch { /* no .env file */ }
+const aliases = { s: 'serve', t: 'test', h: 'help', n: 'new' };
+const builtInCommands = {
+    serve: { description: 'Bootstrap Stonyx and run the app', run: serve },
+    test: { description: 'Bootstrap Stonyx in test mode and run tests', run: test },
+    new: { description: 'Scaffold a new Stonyx project', run: newCommand },
+    help: { description: 'Show available commands', run: help }
+};
+const args = process.argv.slice(2);
+const commandName = aliases[args[0]] || args[0];
+const commandArgs = args.slice(1);
+async function main() {
+    if (!commandName || commandName === 'help') {
+        await help({ args: commandArgs, builtInCommands, loadModuleCommands });
+        return;
+    }
+    const builtIn = builtInCommands[commandName];
+    if (builtIn) {
+        await builtIn.run({ args: commandArgs });
+        return;
+    }
+    // Search module commands
+    const moduleCommands = await loadModuleCommands();
+    const moduleCommand = moduleCommands[commandName];
+    if (moduleCommand) {
+        const cwd = process.cwd();
+        if (moduleCommand.bootstrap) {
+            const config = await importConfig(`${cwd}/config/environment`);
+            const { default: Stonyx } = await import('./main.js');
+            new Stonyx(config, cwd);
+            await Stonyx.ready;
+        }
+        await moduleCommand.run({ args: commandArgs, cwd });
+        return;
+    }
+    console.error(`Unknown command: ${args[0]}\n`);
+    await help({ args: [], builtInCommands, loadModuleCommands });
+    process.exit(1);
+}
+main().catch(error => {
+    console.error(error);
+    process.exit(1);
+});

package/dist/exports/config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("stonyx").StoynxConfig;
+export default _default;

package/dist/exports/config.js

@@ -0,0 +1,2 @@
+import Stonyx from 'stonyx';
+export default Stonyx.config;

package/dist/exports/log.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("@stonyx/logs").default;
+export default _default;

package/{src → dist}/exports/log.js

@@ -1,3 +1,2 @@
 import Stonyx from 'stonyx';
-
-export default Stonyx.log;
+export default Stonyx.log;

package/dist/exports/test-helpers.d.ts

@@ -0,0 +1,5 @@
+interface TestHooks {
+    before(fn: () => Promise<void>): void;
+}
+export declare function setupIntegrationTests(hooks: TestHooks): void;
+export {};

package/dist/exports/test-helpers.js

@@ -0,0 +1,7 @@
+import Stonyx from 'stonyx';
+export function setupIntegrationTests(hooks) {
+    hooks.before(async function () {
+        await Stonyx.ready;
+        console.log('Stonyx ready');
+    });
+}

package/dist/lifecycle.d.ts

@@ -0,0 +1,7 @@
+export interface StoynxModule {
+    init?(): Promise<void>;
+    startup?(): Promise<void>;
+    shutdown?(): Promise<void>;
+}
+export declare function runStartupHooks(modules: StoynxModule[]): Promise<void>;
+export declare function runShutdownHooks(modules: StoynxModule[]): Promise<void>;

package/dist/lifecycle.js

@@ -0,0 +1,18 @@
+export async function runStartupHooks(modules) {
+    for (const module of modules) {
+        if (typeof module.startup === 'function')
+            await module.startup();
+    }
+}
+export async function runShutdownHooks(modules) {
+    for (const module of [...modules].reverse()) {
+        if (typeof module.shutdown === 'function') {
+            try {
+                await module.shutdown();
+            }
+            catch (error) {
+                console.error('Error during module shutdown:', error);
+            }
+        }
+    }
+}

package/dist/main.d.ts

@@ -0,0 +1,22 @@
+import Chronicle from '@stonyx/logs';
+import type { StoynxModule } from './lifecycle.js';
+import type { StoynxConfig } from './modules.js';
+export default class Stonyx {
+    static initialized: boolean;
+    static modulePromises: Record<string, unknown>;
+    static instance: Stonyx;
+    static ready: Promise<void>;
+    config: StoynxConfig;
+    chronicle: Chronicle;
+    modules: StoynxModule[];
+    constructor(config: StoynxConfig, rootPath: string);
+    start(config: StoynxConfig, rootPath: string): Promise<void>;
+    /**
+     * Allows users to define their own log for any extra class via environment config
+     */
+    configureUserLogs(): void;
+    static get log(): Chronicle;
+    static get config(): StoynxConfig;
+}
+export { waitForModule } from './modules.js';
+export type { StoynxConfig } from './modules.js';

package/dist/main.js

@@ -0,0 +1,98 @@
+/*
+ * Copyright 2025 Stone Costa
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import Chronicle from '@stonyx/logs';
+import loadModules from './modules.js';
+import { mergeObject } from '@stonyx/utils/object';
+import { importConfig } from './util/import-config.js';
+import { resolveModuleName } from './util/resolve-module-name.js';
+export default class Stonyx {
+    static initialized = false;
+    static modulePromises = {};
+    static instance;
+    static ready;
+    config;
+    chronicle;
+    modules;
+    constructor(config, rootPath) {
+        if (Stonyx.instance)
+            return Stonyx.instance;
+        Stonyx.instance = this;
+        Stonyx.ready = this.start(config, rootPath);
+    }
+    async start(config, rootPath) {
+        if (!config)
+            throw new Error('Stonyx requires full environment configuration on startup');
+        if (!rootPath)
+            throw new Error('Stonyx requires root project\'s path on startup');
+        // Transform config from stonyx-modules running as a standalone.
+        // Signal is the consumer's `package.json#name` (see resolveModuleName);
+        // this replaces the brittle `rootPath.includes('stonyx-')` heuristic so
+        // non-canonical rootPaths (worktrees, forks, renames) still work.
+        const moduleName = resolveModuleName(rootPath);
+        if (moduleName) {
+            const flatConfig = config;
+            const siblingModules = flatConfig.modules || {};
+            config = { [moduleName]: config, ...siblingModules };
+            delete config.modules;
+        }
+        this.config = config;
+        this.chronicle = new Chronicle({ additionalLogs: { title: 'green' } });
+        Stonyx.initialized = true;
+        // Auto-merge test environment overrides (after initialized flag, before modules load)
+        // Uses in-place mutation to preserve existing references (e.g. stonyx/config export cache)
+        if (process.env.NODE_ENV === 'test') {
+            try {
+                const testOverrides = await importConfig(`${rootPath}/test/config/environment`);
+                const merged = mergeObject(config, testOverrides);
+                Object.assign(config, merged);
+            }
+            catch (err) {
+                // Missing test override is non-fatal; re-throw import errors that aren't "not found"
+                if (!(err instanceof Error) || !err.message.startsWith('Config not found:'))
+                    throw err;
+            }
+        }
+        this.modules = await loadModules(config, rootPath, this.chronicle);
+        this.configureUserLogs();
+    }
+    /**
+     * Allows users to define their own log for any extra class via environment config
+     */
+    configureUserLogs() {
+        const { chronicle } = this;
+        for (const [className, config] of Object.entries(this.config)) {
+            if (!config || typeof config !== 'object')
+                continue;
+            if (className in chronicle)
+                continue;
+            const { logColor, logMethod, logTimestamp } = config;
+            if (!logColor)
+                continue;
+            chronicle.defineType(logMethod || className, logColor, { logTimestamp: !!logTimestamp });
+        }
+    }
+    static get log() {
+        if (!Stonyx.initialized)
+            throw new Error('Stonyx has not been initialized yet');
+        return Stonyx.instance.chronicle;
+    }
+    static get config() {
+        if (!Stonyx.initialized)
+            throw new Error('Stonyx has not been initialized yet');
+        return Stonyx.instance.config;
+    }
+}
+export { waitForModule } from './modules.js';

package/dist/modules.d.ts

@@ -0,0 +1,5 @@
+import type { StoynxModule } from './lifecycle.js';
+import type Chronicle from '@stonyx/logs';
+export type StoynxConfig = Record<string, Record<string, unknown> | unknown>;
+export default function loadModules(config: StoynxConfig, rootPath: string, chronicle: Chronicle): Promise<StoynxModule[]>;
+export declare function waitForModule(moduleName: string): Promise<void>;

package/dist/modules.js

@@ -0,0 +1,98 @@
+/**
+ * Validates and initializes stonyx modules
+ * TODO: Refactor into a ModuleLoader class (good coding exercise)
+ */
+import { readFile } from '@stonyx/utils/file';
+import { kebabCaseToCamelCase } from '@stonyx/utils/string';
+import { mergeObject } from '@stonyx/utils/object';
+import { importModuleConfig } from './util/import-module-config.js';
+const modulePromises = {};
+// Configure module-specific logging
+function configureLog(chronicle, module, config) {
+    const { logColor, logMethod, logTimestamp } = config;
+    if (!logColor)
+        return;
+    chronicle.defineType(logMethod || module, logColor, { logTimestamp: !!logTimestamp });
+}
+function initializeModule(moduleName, moduleClass, modules, initPromises) {
+    const moduleInstance = new moduleClass();
+    modules.push(moduleInstance);
+    if (!moduleInstance.init)
+        return;
+    initPromises.push((async () => {
+        await moduleInstance.init();
+        modulePromises[moduleName]?.resolve();
+    })());
+}
+export default async function loadModules(config, rootPath, chronicle) {
+    const modules = [];
+    const initPromises = [];
+    const rootPackage = await readFile(`${rootPath}/package.json`, { json: true });
+    const dependencies = (rootPackage.devDependencies || {});
+    const projectName = typeof rootPackage.name === 'string' ? rootPackage.name : '';
+    // Expose rootPath to public configuration
+    config.rootPath = rootPath;
+    const moduleDependencies = Object.keys(dependencies).filter((moduleName) => moduleName.startsWith('@stonyx/'));
+    // Setup module promises prior to initialization
+    for (const moduleName of moduleDependencies) {
+        const promise = {};
+        modulePromises[moduleName] = promise;
+        promise.ready = new Promise(resolve => promise.resolve = resolve);
+    }
+    // Standalone module configuration
+    if (Array.isArray(rootPackage.keywords) && rootPackage.keywords.includes('stonyx-module')) {
+        configureLog(chronicle, projectName, config);
+        const entryPoint = typeof rootPackage.main === 'string' ? rootPackage.main : '';
+        const { default: moduleClass } = await import(`${rootPath}/${entryPoint}`);
+        initializeModule(projectName, moduleClass, modules, initPromises);
+    }
+    for (const moduleName of moduleDependencies) {
+        const modulePackage = await readFile(`${rootPath}/node_modules/${moduleName}/package.json`, { json: true, missingFileCallback: (_filePath) => {
+                console.warn(`Warning: Could not locate stonyx module: "${moduleName}". Module was not loaded`);
+                return '';
+            } });
+        if (!modulePackage)
+            continue;
+        const keywords = Array.isArray(modulePackage.keywords) ? modulePackage.keywords : [];
+        if (!keywords.includes('stonyx-module')) {
+            console.warn(`Warning: Stonyx modules must contain the "stonyx-module" keyword. Module was not loaded`);
+            continue;
+        }
+        if (!keywords.includes('stonyx-async')) {
+            modulePromises[moduleName].resolve();
+            continue;
+        }
+        try {
+            // Load & Configure Async Modules
+            // MODULE-OWNED: `.js` only, always. Routing this to the app-owned
+            // `importConfig` re-ships abofs/stonyx-orm#118 — Node refuses to
+            // type-strip inside `node_modules`. See abofs/stonyx#90.
+            const moduleConfig = await importModuleConfig(`${rootPath}/node_modules/${moduleName}/config/environment`);
+            const module = kebabCaseToCamelCase(moduleName.split('/').pop() ?? moduleName);
+            const userConfig = config[module] || {};
+            const finalConfig = mergeObject(moduleConfig, userConfig);
+            config[module] = finalConfig;
+            // Configure module-specific logging
+            configureLog(chronicle, module, finalConfig);
+            const entryPoint = modulePackage.main;
+            const { default: moduleClass } = await import(`${rootPath}/node_modules/${moduleName}/${entryPoint}`);
+            initializeModule(moduleName, moduleClass, modules, initPromises);
+        }
+        catch (error) {
+            console.error(error);
+            throw new Error('Stonyx modules with async loading must ship a config/environment.js with default configurations. ' +
+                'Module configs resolve as .js only — never .ts, because Node refuses to type-strip inside node_modules. ' +
+                `Module "${moduleName}" failed to load.`);
+        }
+    }
+    // Wait until all modules are initialized
+    await Promise.all(initPromises);
+    return modules;
+}
+export async function waitForModule(moduleName) {
+    const fullName = `@stonyx/${moduleName}`;
+    const modulePromise = modulePromises[fullName];
+    if (!modulePromise)
+        throw new Error(`Could wait for module: ${fullName}. Module was not registered in project dependencies`);
+    await modulePromises[fullName].ready;
+}

package/dist/util/extension-resolution.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared constants for APP-OWNED `{ts,js}` resolution.
+ *
+ * Two resolvers pick an extension for a file in the consuming project's own
+ * tree — `resolveEntryPoint` (`./resolve-entry-point.ts`, since
+ * abofs/stonyx#67) and `importConfig` (`./import-config.ts`, since
+ * abofs/stonyx#90). They must agree on the candidate list, on the preference
+ * order, and on the wording of the dual-extension warning.
+ *
+ * They previously agreed by copy. Each string was pinned by its own suite, so
+ * editing one file left BOTH suites green while the two messages diverged —
+ * which is why this lives here and not at the top of either consumer
+ * (`docs/conventions/index.md` § Universal Rules: constants shared across
+ * files go in a dedicated constants file).
+ *
+ * MODULE-OWNED configs are not in scope: `./import-module-config.ts` resolves
+ * `.js` only, forever, and deliberately shares nothing with this file.
+ */
+/** Candidate extensions in preference order — `.ts` wins over `.js`. */
+export declare const EXTENSIONS: readonly ["ts", "js"];
+/** The warning both app-owned resolvers emit when a `.ts`/`.js` pair exists. */
+export declare function dualExtensionWarning(basePath: string): string;

package/dist/util/extension-resolution.js

@@ -0,0 +1,24 @@
+/**
+ * Shared constants for APP-OWNED `{ts,js}` resolution.
+ *
+ * Two resolvers pick an extension for a file in the consuming project's own
+ * tree — `resolveEntryPoint` (`./resolve-entry-point.ts`, since
+ * abofs/stonyx#67) and `importConfig` (`./import-config.ts`, since
+ * abofs/stonyx#90). They must agree on the candidate list, on the preference
+ * order, and on the wording of the dual-extension warning.
+ *
+ * They previously agreed by copy. Each string was pinned by its own suite, so
+ * editing one file left BOTH suites green while the two messages diverged —
+ * which is why this lives here and not at the top of either consumer
+ * (`docs/conventions/index.md` § Universal Rules: constants shared across
+ * files go in a dedicated constants file).
+ *
+ * MODULE-OWNED configs are not in scope: `./import-module-config.ts` resolves
+ * `.js` only, forever, and deliberately shares nothing with this file.
+ */
+/** Candidate extensions in preference order — `.ts` wins over `.js`. */
+export const EXTENSIONS = ['ts', 'js'];
+/** The warning both app-owned resolvers emit when a `.ts`/`.js` pair exists. */
+export function dualExtensionWarning(basePath) {
+    return `Warning: both ${basePath}.ts and ${basePath}.js exist. Using .ts — delete the .js to silence this warning (it is likely a stale compiled artifact or postinstall stub).`;
+}

package/dist/util/import-config.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Resolve an APP-OWNED config — `<cwd>/config/environment`,
+ * `<rootPath>/test/config/environment` — as `{ts,js}`, preferring `.ts`.
+ * Mirrors `src/util/resolve-entry-point.ts`, which has resolved app-owned
+ * entry points this way since abofs/stonyx#67 — the candidate list and the
+ * dual-extension warning are shared through `./extension-resolution.ts` so
+ * the two cannot drift.
+ *
+ * These paths live in the consuming project's own tree, never inside
+ * `node_modules`, so they load under the app's own loader and Node's type
+ * stripping applies to them.
+ *
+ * MODULE-OWNED configs are NOT this function's business: see
+ * `importModuleConfig` in `./import-module-config.ts`, which resolves `.js`
+ * only. Routing `src/modules.ts` here re-ships abofs/stonyx-orm#118 — Node
+ * refuses to type-strip inside `node_modules`, so a `.ts` module config
+ * crashes every consumer at parse time. See abofs/stonyx#90.
+ *
+ * The "Config not found:" prefix is load-bearing: `src/main.ts` matches on it
+ * to tell an absent optional config from a real import failure.
+ */
+export declare function importConfig<T = unknown>(basePath: string): Promise<T>;

package/dist/util/import-config.js

@@ -0,0 +1,36 @@
+import { existsSync } from 'fs';
+import { pathToFileURL } from 'url';
+import { EXTENSIONS, dualExtensionWarning } from './extension-resolution.js';
+/**
+ * Resolve an APP-OWNED config — `<cwd>/config/environment`,
+ * `<rootPath>/test/config/environment` — as `{ts,js}`, preferring `.ts`.
+ * Mirrors `src/util/resolve-entry-point.ts`, which has resolved app-owned
+ * entry points this way since abofs/stonyx#67 — the candidate list and the
+ * dual-extension warning are shared through `./extension-resolution.ts` so
+ * the two cannot drift.
+ *
+ * These paths live in the consuming project's own tree, never inside
+ * `node_modules`, so they load under the app's own loader and Node's type
+ * stripping applies to them.
+ *
+ * MODULE-OWNED configs are NOT this function's business: see
+ * `importModuleConfig` in `./import-module-config.ts`, which resolves `.js`
+ * only. Routing `src/modules.ts` here re-ships abofs/stonyx-orm#118 — Node
+ * refuses to type-strip inside `node_modules`, so a `.ts` module config
+ * crashes every consumer at parse time. See abofs/stonyx#90.
+ *
+ * The "Config not found:" prefix is load-bearing: `src/main.ts` matches on it
+ * to tell an absent optional config from a real import failure.
+ */
+export async function importConfig(basePath) {
+    const matches = EXTENSIONS.filter(ext => existsSync(`${basePath}.${ext}`));
+    if (matches.length === 0) {
+        throw new Error(`Config not found: ${basePath}.{ts,js}`);
+    }
+    if (matches.length > 1) {
+        console.warn(dualExtensionWarning(basePath));
+    }
+    const path = `${basePath}.${matches[0]}`;
+    const mod = await import(pathToFileURL(path).href);
+    return mod.default;
+}

package/dist/util/import-module-config.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Resolve a MODULE-OWNED config — `node_modules/<mod>/config/environment` — as
+ * `.js` ONLY. There is no `.ts` fallback and there must never be one.
+ *
+ * Node's type-strip loader refuses to process `.ts` files inside
+ * `node_modules`, so a `@stonyx/*` module that ships `config/environment.ts`
+ * crashes every consumer at parse time. That is abofs/stonyx-orm#118, the P0
+ * `4c80c87` was written to prevent, and this function preserves `4c80c87`'s
+ * behaviour byte-for-byte — including the exact `Config not found: <base>.js`
+ * message, which `test/unit/import-config-test.ts` pins as a regression guard.
+ *
+ * App-owned configs resolve `{ts,js}` instead: see `importConfig` in
+ * `./import-config.ts`. The boundary is OWNERSHIP, not extension — see
+ * abofs/stonyx#90 and `docs/conventions/framework-modules.md`.
+ */
+export declare function importModuleConfig<T = unknown>(basePath: string): Promise<T>;

package/dist/util/import-module-config.js

@@ -0,0 +1,25 @@
+import { existsSync } from 'fs';
+import { pathToFileURL } from 'url';
+/**
+ * Resolve a MODULE-OWNED config — `node_modules/<mod>/config/environment` — as
+ * `.js` ONLY. There is no `.ts` fallback and there must never be one.
+ *
+ * Node's type-strip loader refuses to process `.ts` files inside
+ * `node_modules`, so a `@stonyx/*` module that ships `config/environment.ts`
+ * crashes every consumer at parse time. That is abofs/stonyx-orm#118, the P0
+ * `4c80c87` was written to prevent, and this function preserves `4c80c87`'s
+ * behaviour byte-for-byte — including the exact `Config not found: <base>.js`
+ * message, which `test/unit/import-config-test.ts` pins as a regression guard.
+ *
+ * App-owned configs resolve `{ts,js}` instead: see `importConfig` in
+ * `./import-config.ts`. The boundary is OWNERSHIP, not extension — see
+ * abofs/stonyx#90 and `docs/conventions/framework-modules.md`.
+ */
+export async function importModuleConfig(basePath) {
+    const path = `${basePath}.js`;
+    if (!existsSync(path)) {
+        throw new Error(`Config not found: ${path}`);
+    }
+    const mod = await import(pathToFileURL(path).href);
+    return mod.default;
+}

package/dist/util/resolve-entry-point.d.ts

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

package/dist/util/resolve-entry-point.js

@@ -0,0 +1,14 @@
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+import { EXTENSIONS, dualExtensionWarning } from './extension-resolution.js';
+export function resolveEntryPoint(basePath) {
+    const matches = EXTENSIONS.filter(ext => existsSync(resolve(`${basePath}.${ext}`)));
+    if (matches.length === 0) {
+        throw new Error(`Entry point not found: ${basePath}.{ts,js}`);
+    }
+    if (matches.length > 1) {
+        console.warn(dualExtensionWarning(basePath));
+    }
+    const ext = matches[0];
+    return resolve(`${basePath}.${ext}`);
+}

package/dist/util/resolve-module-name.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Resolve a stonyx standalone module's camelCase name from the consumer's
+ * `package.json#name`. Used by the standalone-config transform to wrap a flat
+ * config under the module's key when a stonyx module runs its own tests.
+ *
+ * Recognises:
+ *   - `@stonyx/<kebab>`  → `<camel>`
+ *   - `stonyx-<kebab>`   → `<camel>` (unscoped fallback)
+ *   - Anything else      → `null` (caller should skip the transform)
+ *
+ * Missing or malformed `package.json` returns `null` silently — matches the
+ * fail-safe semantics of the previous `rootPath.includes('stonyx-')` heuristic.
+ */
+export declare function resolveModuleName(rootPath: string): string | null;

package/dist/util/resolve-module-name.js

@@ -0,0 +1,33 @@
+import { readFileSync } from 'fs';
+import { kebabCaseToCamelCase } from '@stonyx/utils/string';
+/**
+ * Resolve a stonyx standalone module's camelCase name from the consumer's
+ * `package.json#name`. Used by the standalone-config transform to wrap a flat
+ * config under the module's key when a stonyx module runs its own tests.
+ *
+ * Recognises:
+ *   - `@stonyx/<kebab>`  → `<camel>`
+ *   - `stonyx-<kebab>`   → `<camel>` (unscoped fallback)
+ *   - Anything else      → `null` (caller should skip the transform)
+ *
+ * Missing or malformed `package.json` returns `null` silently — matches the
+ * fail-safe semantics of the previous `rootPath.includes('stonyx-')` heuristic.
+ */
+export function resolveModuleName(rootPath) {
+    let pkg;
+    try {
+        const raw = readFileSync(`${rootPath}/package.json`, 'utf8');
+        pkg = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    const name = typeof pkg.name === 'string' ? pkg.name : '';
+    if (name.startsWith('@stonyx/')) {
+        return kebabCaseToCamelCase(name.slice('@stonyx/'.length));
+    }
+    if (name.startsWith('stonyx-')) {
+        return kebabCaseToCamelCase(name.slice('stonyx-'.length));
+    }
+    return null;
+}

package/package.json

@@ -1,23 +1,45 @@
 {
   "name": "stonyx",
-  "version": "0.2.3-alpha.4",
+  "version": "0.2.3-alpha.40",
   "description": "Base stonyx framework module",
-  "main": "main.js",
+  "main": "dist/main.js",
+  "types": "dist/main.d.ts",
   "type": "module",
   "bin": {
-    "stonyx": "./src/cli.js"
+    "stonyx": "./dist/cli.js"
   },
   "exports": {
-    ".": "./src/main.js",
-    "./config": "./src/exports/config.js",
-    "./log": "./src/exports/log.js",
-    "./test-helpers": "./src/exports/test-helpers.js",
-    "./lifecycle": "./src/lifecycle.js"
+    ".": {
+      "types": "./dist/main.d.ts",
+      "default": "./dist/main.js"
+    },
+    "./config": {
+      "types": "./dist/exports/config.d.ts",
+      "default": "./dist/exports/config.js"
+    },
+    "./log": {
+      "types": "./dist/exports/log.d.ts",
+      "default": "./dist/exports/log.js"
+    },
+    "./test-helpers": {
+      "types": "./dist/exports/test-helpers.d.ts",
+      "default": "./dist/exports/test-helpers.js"
+    },
+    "./lifecycle": {
+      "types": "./dist/lifecycle.d.ts",
+      "default": "./dist/lifecycle.js"
+    }
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/abofs/stonyx.git"
   },
+  "files": [
+    "dist",
+    "config",
+    "scripts",
+    "README.md"
+  ],
   "publishConfig": {
     "provenance": true
   },
@@ -30,16 +52,25 @@
     "url": "https://github.com/abofs/stonyx/issues"
   },
   "dependencies": {
-    "node-chronicle": "^0.2.0"
+    "@stonyx/utils": "0.2.3-beta.26",
+    "@stonyx/logs": "1.0.1-beta.19"
   },
   "devDependencies": {
-    "@stonyx/utils": "0.2.3-beta.5",
+    "@types/node": "^25.5.2",
+    "@types/qunit": "^2.19.13",
+    "@types/sinon": "^21.0.1",
     "qunit": "^2.24.1",
-    "sinon": "^21.0.0"
+    "sinon": "^21.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.8.3"
   },
   "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
     "start": "node .",
-    "test": "qunit",
+    "test": "pnpm build && node --import tsx node_modules/qunit/bin/qunit.js 'test/**/*-test.ts'",
+    "test:acceptance": "STONYX_ACCEPTANCE=1 node --import tsx node_modules/qunit/bin/qunit.js 'test/acceptance/**/*-test.ts'",
+    "test:acceptance:ratchet": "node scripts/acceptance-ratchet.js",
     "error": "echo \"Error: no error handling\" && exit 1",
     "postinstall": "node scripts/postinstall.js"
   }