@stone-js/starters 0.8.3

package/basic-react-imperative/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "basic-react-imperative",
+  "private": true,
+  "version": "1.0.0",
+  "description": "Stone.js's basic starter to create react app using imperative API.",
+  "author": "Mr. Stone <evensstone@gmail.com>",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "dev": "stone dev",
+    "build": "stone build",
+    "preview": "stone preview",
+    "typings": "stone typings",
+    "test": "vitest run",
+    "test:cvg": "npm run test -- --coverage"
+  },
+  "dependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@stone-js/core": "^0.8.3",
+    "@stone-js/use-react": "^0.8.3",
+    "@stone-js/browser-adapter": "^0.8.3",
+    "@stone-js/node-cli-adapter": "^0.8.3"
+  },
+  "devDependencies": {
+    "@babel/plugin-proposal-decorators": "^7.25.9",
+    "@babel/preset-env": "^7.26.9",
+    "@babel/preset-typescript": "^7.27.0",
+    "@stone-js/cli": "^0.8.3",
+    "@types/node": "^24.0.7",
+    "@types/react": "^19.0.7",
+    "@types/react-dom": "^19.0.3",
+    "@vitest/coverage-v8": "^3.0.9",
+    "vitest": "^3.0.9"
+  }
+}

package/basic-react-imperative/tests/Application.spec.ts

@@ -0,0 +1,80 @@
+import { renderToString } from 'react-dom/server'
+import { ILogger, IncomingEvent } from '@stone-js/core'
+import { FactoryHandler, AppConfig } from '../app/Application'
+
+vi.mock('@stone-js/core', async (mod) => {
+  const actual: any = await mod()
+  return {
+    ...actual,
+    isNotEmpty: vi.fn(() => true),
+    defineConfig: (config: any) => config
+  }
+})
+
+describe('Application', () => {
+  let app: any
+  let mockedLogger: ILogger
+
+  beforeEach(() => {
+    mockedLogger = {
+      info: vi.fn(),
+    } as unknown as ILogger
+
+    app = FactoryHandler({ logger: mockedLogger })
+  })
+
+  it('should create an application instance', () => {
+    // Assert
+    expect(app).toBeInstanceOf(Object)
+  })
+
+  it('get head values', async () => {
+    // Arrange
+    const expectedMessage = 'Hello World!'
+    const event = { get: () => 'World' } as unknown as IncomingEvent
+
+    // Act
+    const head = await app.head({ event })
+
+    // Assert
+    expect(head).toHaveProperty('metas')
+    expect(head.title).toBe(expectedMessage)
+    expect(head).toHaveProperty('description')
+  })
+
+  it('should handle incoming events', () => {
+    // Arrange
+    const expectedMessage = 'Hello World!'
+    const event = { get: () => 'World' } as unknown as IncomingEvent
+
+    // Act
+    const response = app.handle(event) as { message: string }
+
+    // Assert
+    expect(response.message).toBe(expectedMessage)
+    expect(mockedLogger.info).toHaveBeenCalledWith(expectedMessage)
+  })
+
+  it('should render component', () => {
+    // Arrange
+    const message = 'Hello World!'
+
+    // Act
+    const response = renderToString(app.render({ data: { message } } as any))
+
+    // Assert
+    expect(response).toMatchSnapshot()
+  })
+
+  it('should get config', () => {
+    // Arrange
+    const config: any = AppConfig
+    const blueprint: any = { is: () => true, set: vi.fn() }
+
+    // Act
+    config.afterConfigure(blueprint)
+
+    // Assert
+    expect(blueprint.set).toHaveBeenCalled()
+  })
+})

package/basic-react-imperative/tests/__snapshots__/Application.spec.ts.snap

@@ -0,0 +1,3 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`Application > should render component 1`] = `"<section class="container"><h1 class="h1 text-center mt-64">Hello World!</h1></section>"`;

package/basic-react-imperative/tsconfig.json

@@ -0,0 +1,33 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "skipLibCheck": true,
+    "experimentalDecorators": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "resolveJsonModule": true,
+
+    /* Linting */
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true,
+
+    "types": ["node", "vite/client", "vitest/globals"],
+  },
+  "include": [
+    "app",
+    "tests",
+    "vitest.config.ts"
+  ]
+}

package/basic-react-imperative/vitest.config.ts

@@ -0,0 +1,24 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['./tests/**/*.{test,spec}.?(c|m)[jt]s?(x)'],
+    coverage: {
+      provider: 'v8',
+      include: ['app/**/*.ts', 'app/**/*.tsx'],
+      reporter: ['text', 'html'],
+      reportsDirectory: './coverage',
+      thresholds: {
+        100: true
+      },
+      watermarks: {
+        statements: [60, 80],
+        functions: [60, 80],
+        branches: [60, 80],
+        lines: [60, 80]
+      }
+    },
+  }
+});

package/basic-service-declarative/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright © 2026 Stone Foundation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/basic-service-declarative/README.md

@@ -0,0 +1,39 @@
+# Stone.js - Basic starter
+
+Stone.js's basic starter to create web app using declarative API.
+
+## Project Setup
+
+```sh
+npm install
+```
+
+### Compile and Hot-Reload for Development
+
+```sh
+npm run dev
+```
+
+### Compile and Bundle for Production
+
+```sh
+npm run build
+```
+
+### Run the Production build
+
+```sh
+npm run preview
+```
+
+### Run tests
+
+```sh
+npm run test
+```
+
+### Run tests with coverage
+
+```sh
+npm run test:cvg
+```

package/basic-service-declarative/app/Application.ts

@@ -0,0 +1,56 @@
+import { NodeHttp } from '@stone-js/node-http-adapter'
+import { NodeConsole } from '@stone-js/node-cli-adapter'
+import { IncomingEvent, IEventHandler, ILogger, LogLevel, StoneApp } from '@stone-js/core'
+
+/**
+ * Application
+ *
+ * This is the main application entry point.
+ *
+ * @NodeHttp() is used to enable the Node HTTP adapter.
+ * @StoneApp() is used to enable the Stone application, it is required.
+ */
+@NodeConsole()
+@NodeHttp({ default: true })
+@StoneApp({ logger: { level: LogLevel.INFO } })
+export class Application implements IEventHandler<IncomingEvent> {
+  /**
+   * Logger is a service for logging.
+  */
+  private readonly logger: ILogger
+
+  /**
+   * Create a new instance of Application
+   * At this point, all the dependencies are resolved and injected.
+   * You can access the container and all the services.
+   *
+   * @param logger - Logger service.
+  */
+  constructor ({ logger }: { logger: ILogger }) {
+    this.logger = logger
+  }
+
+  /**
+   * Handle incoming events
+   *
+   * @param event Incoming event
+   * @returns response
+  */
+  handle (event: IncomingEvent): ResponseData {
+    // Get the name from the event
+    const message = `Hello ${String(event.get<string>('name', 'World'))}!`
+
+    // Log a message
+    this.logger.info(message)
+
+    // Return a JSON response
+    return { message }
+  }
+}
+
+/**
+ * Response data
+ */
+export interface ResponseData {
+  message: string
+}

package/basic-service-declarative/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "basic-service-declarative",
+  "private": true,
+  "version": "1.0.0",
+  "description": "Stone.js's basic starter to create web app using declarative API.",
+  "author": "Mr. Stone <evensstone@gmail.com>",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "dev": "stone dev",
+    "build": "stone build",
+    "preview": "stone preview dist/server.mjs",
+    "typings": "stone typings",
+    "test": "vitest run",
+    "test:cvg": "npm run test -- --coverage"
+  },
+  "dependencies": {
+    "@stone-js/core": "^0.8.3",
+    "@stone-js/node-cli-adapter": "^0.8.3",
+    "@stone-js/node-http-adapter": "^0.8.3"
+  },
+  "devDependencies": {
+    "@babel/plugin-proposal-decorators": "^7.25.9",
+    "@babel/preset-env": "^7.26.9",
+    "@babel/preset-typescript": "^7.27.0",
+    "@stone-js/cli": "^0.8.3",
+    "@types/node": "^24.0.7",
+    "@vitest/coverage-v8": "^3.0.9",
+    "vitest": "^3.0.9"
+  }
+}

package/basic-service-declarative/tests/Application.spec.ts

@@ -0,0 +1,60 @@
+import { Application } from '../app/Application'
+import { ILogger, IncomingEvent } from '@stone-js/core'
+
+// We must mock decorators to lighten the test environment
+vi.mock(import("@stone-js/core"), async (importOriginal) => {
+  const actual = await importOriginal()
+  return {
+    ...actual,
+    StoneApp: vi.fn(() => vi.fn()),
+  }
+})
+
+// We must mock decorators to lighten the test environment
+vi.mock(import("@stone-js/node-cli-adapter"), async (importOriginal) => {
+  const actual = await importOriginal()
+  return {
+    ...actual,
+    NodeConsole: vi.fn(() => vi.fn()),
+  }
+})
+
+// We must mock decorators to lighten the test environment
+vi.mock(import("@stone-js/node-http-adapter"), async (importOriginal) => {
+  const actual = await importOriginal()
+  return {
+    ...actual,
+    NodeHttp: vi.fn(() => vi.fn()),
+  }
+})
+
+describe('Application', () => {
+  let app: Application
+  let mockedLogger: ILogger
+
+  beforeEach(() => {
+    mockedLogger = {
+      info: vi.fn(),
+    } as unknown as ILogger
+
+    app = new Application({ logger: mockedLogger })
+  })
+
+  it('should create an application instance', () => {
+    // Assert
+    expect(app).toBeInstanceOf(Application)
+  })
+
+  it('should handle incoming events', () => {
+    // Arrange
+    const expectedMessage = 'Hello World!'
+    const event = { get: () => 'World' } as unknown as IncomingEvent
+
+    // Act
+    const response = app.handle(event) as { message: string }
+
+    // Assert
+    expect(response.message).toBe(expectedMessage)
+    expect(mockedLogger.info).toHaveBeenCalledWith(expectedMessage)
+  })
+})

package/basic-service-declarative/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "include": [
+    "app",
+    "tests",
+    ".stone",
+    "vitest.config.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ],
+  "compilerOptions": {
+    "strict": true,
+    "allowJs": false,
+    "target": "esnext",
+    "module": "ESNext",
+    "sourceMap": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "bundler",
+    "experimentalDecorators": true,
+    "types": ["node", "vitest/globals"],
+  }
+}

package/basic-service-declarative/vitest.config.ts

@@ -0,0 +1,24 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['./tests/**/*.{test,spec}.?(c|m)[jt]s?(x)'],
+    coverage: {
+      provider: 'v8',
+      include: ['app/**/*.ts'],
+      reporter: ['text', 'html'],
+      reportsDirectory: './coverage',
+      thresholds: {
+        100: true
+      },
+      watermarks: {
+        statements: [60, 80],
+        functions: [60, 80],
+        branches: [60, 80],
+        lines: [60, 80]
+      }
+    },
+  }
+});

package/basic-service-imperative/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright © 2026 Stone Foundation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/basic-service-imperative/README.md

@@ -0,0 +1,39 @@
+# Stone.js - Basic starter
+
+Stone.js's basic starter to create web app using imperative API.
+
+## Project Setup
+
+```sh
+npm install
+```
+
+### Compile and Hot-Reload for Development
+
+```sh
+npm run dev
+```
+
+### Compile and Bundle for Production
+
+```sh
+npm run build
+```
+
+### Run the Production build
+
+```sh
+npm run preview
+```
+
+### Run tests
+
+```sh
+npm run test
+```
+
+### Run tests with coverage
+
+```sh
+npm run test:cvg
+```

package/basic-service-imperative/app/Application.ts

@@ -0,0 +1,60 @@
+import { NODE_HTTP_PLATFORM, nodeHttpAdapterBlueprint } from '@stone-js/node-http-adapter'
+import { defineCommand, NODE_CONSOLE_PLATFORM, nodeConsoleAdapterBlueprint } from '@stone-js/node-cli-adapter'
+import { defineStoneApp, defineConfig, IBlueprint, ILogger, IncomingEvent, FunctionalEventHandler } from '@stone-js/core'
+
+/**
+ * Create an handler using the factory handler.
+ */
+export const FactoryHandler = ({ logger }: AppOptions): FunctionalEventHandler<IncomingEvent, ResponseData> => {
+  return (event: IncomingEvent): ResponseData => {
+    // Get the name from the event
+    const message = `Hello ${String(event.get<string>('name', 'World'))}!`
+
+    // Log a message
+    logger.info(message)
+
+    // Return a JSON response
+    return { message }
+  }
+}
+
+/**
+ * Application factory.
+ *
+ * @param options - The application options.
+ * @returns A function that handles incoming events and returns a response.
+ */
+export const Application = defineStoneApp(
+  FactoryHandler,
+  {
+    debug: true,
+    isFactory: true,
+    adapter: { platform: NODE_HTTP_PLATFORM }
+  },
+  [nodeHttpAdapterBlueprint, nodeConsoleAdapterBlueprint]
+)
+
+/**
+ * Application configuration.
+ */
+export const AppConfig = defineConfig({
+  afterConfigure (blueprint: IBlueprint) {
+    if (blueprint.is('stone.adapter.platform', NODE_CONSOLE_PLATFORM)) {
+      blueprint.set(defineCommand(FactoryHandler, { name: '*', isFactory: true }))
+    }
+  }
+})
+
+/**
+ * Application options.
+ */
+interface AppOptions {
+  logger: ILogger
+}
+
+/**
+ * Response data
+ */
+export interface ResponseData {
+  message: string
+}

package/basic-service-imperative/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "basic-service-imperative",
+  "private": true,
+  "version": "1.0.0",
+  "description": "Stone.js's basic starter to create web app using imperative API.",
+  "author": "Mr. Stone <evensstone@gmail.com>",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "dev": "stone dev",
+    "build": "stone build",
+    "preview": "stone preview dist/server.mjs",
+    "typings": "stone typings",
+    "test": "vitest run",
+    "test:cvg": "npm run test -- --coverage"
+  },
+  "dependencies": {
+    "@stone-js/core": "^0.8.3",
+    "@stone-js/node-cli-adapter": "^0.8.3",
+    "@stone-js/node-http-adapter": "^0.8.3"
+  },
+  "devDependencies": {
+    "@babel/plugin-proposal-decorators": "^7.25.9",
+    "@babel/preset-env": "^7.26.9",
+    "@babel/preset-typescript": "^7.27.0",
+    "@stone-js/cli": "^0.8.3",
+    "@types/node": "^24.0.7",
+    "@vitest/coverage-v8": "^3.0.9",
+    "vitest": "^3.0.9"
+  }
+}

package/basic-service-imperative/tests/Application.spec.ts

@@ -0,0 +1,52 @@
+import { IncomingHttpEvent } from '@stone-js/http-core'
+import { FunctionalEventHandler, ILogger } from '@stone-js/core'
+import { AppConfig, FactoryHandler, ResponseData } from '../app/Application'
+
+vi.mock('@stone-js/core', async (mod) => {
+  const actual: any = await mod()
+  return {
+    ...actual,
+    isNotEmpty: vi.fn(() => true),
+    defineConfig: (config: any) => config
+  }
+})
+
+describe('Application', () => {
+  let mockedLogger: ILogger
+  let app: FunctionalEventHandler<IncomingHttpEvent, ResponseData>
+
+  beforeEach(() => {
+    mockedLogger = {
+      info: vi.fn(),
+    } as unknown as ILogger
+
+    app = FactoryHandler({ logger: mockedLogger })
+  })
+
+  it('should create an event handler instance', () => {
+    // Assert
+    expect(app).toBeTypeOf('function')
+  })
+
+  it('should handle incoming http events', async () => {
+    // Arrange
+    const event = { get: () => 'World' } as unknown as IncomingHttpEvent
+    // Act
+    const response = await app(event)
+    // Assert
+    expect(response.message).toBe('Hello World!')
+    expect(mockedLogger.info).toHaveBeenCalledWith('Hello World!')
+  })
+
+  it('should get config', () => {
+    // Arrange
+    const config: any = AppConfig
+    const blueprint: any = { is: () => true, set: vi.fn() }
+
+    // Act
+    config.afterConfigure(blueprint)
+
+    // Assert
+    expect(blueprint.set).toHaveBeenCalled()
+  })
+})

package/basic-service-imperative/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "include": [
+    "app",
+    "tests",
+    ".stone",
+    "vitest.config.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ],
+  "compilerOptions": {
+    "strict": true,
+    "allowJs": false,
+    "target": "esnext",
+    "module": "ESNext",
+    "sourceMap": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "bundler",
+    "experimentalDecorators": true,
+    "types": ["node", "vitest/globals"],
+  }
+}