@stone-js/starters 0.8.3

package/standard-react-declarative/app/services/WelcomeService.ts

@@ -0,0 +1,38 @@
+import { ILogger, Service } from '@stone-js/core'
+
+/**
+ * Welcome Service Options
+*/
+export interface WelcomeServiceOptions {
+  logger: ILogger
+}
+
+/**
+ * Welcome Service
+ *
+ * @Service() decorator is used to define a new service
+ * @Service() is an alias of @Stone() decorator.
+ * The alias is required to get benefits of desctructuring Dependency Injection.
+*/
+@Service({ alias: 'welcomeService' })
+export class WelcomeService {
+  private readonly logger: ILogger
+
+  /**
+   * Create a new Welcome Service
+  */
+  constructor ({ logger }: WelcomeServiceOptions) {
+    this.logger = logger
+  }
+
+  /**
+   * Welcome
+   *
+   * @param name - The name
+   * @returns A welcome message
+   */
+  welcome (name: string): { message: string } {
+    this.logger.info(`Welcome ${name}`)
+    return { message: `Hello ${name}!` }
+  }
+}

package/standard-react-declarative/assets/css/index.css

@@ -0,0 +1,26 @@
+body {
+  margin: 0;
+  padding: 0;
+  color: #333;
+  font-size: 14px;
+  line-height: 1.5;
+  background-color: #fff;
+  font-family: 'Roboto', sans-serif;
+}
+.h1 {
+  margin: 0;
+  font-weight: 500;
+  font-size: 3rem;
+  font-weight: bold;
+}
+.container {
+  width: 100vw;
+  display: flex;
+  justify-content: center;
+}
+.text-center {
+  text-align: center;
+}
+.mt-64 {
+  margin-top: 64px;
+}

package/standard-react-declarative/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "standard-react-declarative",
+  "private": true,
+  "version": "1.0.0",
+  "description": "Stone.js's standard starter to create react 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",
+    "typings": "stone typings",
+    "test": "vitest run",
+    "test:cvg": "npm run test -- --coverage"
+  },
+  "dependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@stone-js/use-react": "^0.8.3",
+    "@stone-js/browser-adapter": "^0.8.3",
+    "@stone-js/pipeline": "^0.8.3",
+    "@stone-js/http-core": "^0.8.3",
+    "@stone-js/node-http-adapter": "^0.8.3",
+    "@stone-js/router": "^0.8.3",
+    "@stone-js/core": "^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/standard-react-declarative/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/standard-react-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', 'app/**/*.tsx'],
+      reporter: ['text', 'html'],
+      reportsDirectory: './coverage',
+      thresholds: {
+        100: true
+      },
+      watermarks: {
+        statements: [60, 80],
+        functions: [60, 80],
+        branches: [60, 80],
+        lines: [60, 80]
+      }
+    },
+  }
+});

package/standard-react-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/standard-react-imperative/README.md

@@ -0,0 +1,39 @@
+# Stone.js - Standard starter
+
+Stone.js's standard starter to create react 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/standard-react-imperative/app/Application.ts

@@ -0,0 +1,41 @@
+import { routerBlueprint } from '@stone-js/router'
+import { defineStoneReactApp } from '@stone-js/use-react'
+import { browserAdapterBlueprint } from '@stone-js/browser-adapter'
+import { nodeHttpAdapterBlueprint } from '@stone-js/node-http-adapter'
+import { AdapterHookListenerContext, LogLevel, Logger, defineHookListener } from '@stone-js/core'
+
+/**
+ * Run before the application starts
+ *
+ * @param blueprint - The blueprint
+ */
+export function onStartHandler ({ blueprint }: AdapterHookListenerContext): void {
+  Logger.log(`${String(blueprint.get('stone.name', 'Stone App'))} is starting...`)
+}
+
+/**
+ * Run just before the application stops
+ *
+ * @param blueprint - The blueprint
+ */
+export function onStopHandler ({ blueprint }: AdapterHookListenerContext): void {
+  Logger.log(`${String(blueprint.get('stone.name', 'Stone App'))} is stopping...`)
+}
+
+/**
+ * Define Stone Application.
+ */
+export const Application = defineStoneReactApp(
+  { name: 'MyApp', logger: { level: LogLevel.INFO } },
+  [
+    routerBlueprint,
+    browserAdapterBlueprint,
+    nodeHttpAdapterBlueprint
+  ]
+)
+
+/**
+ * Application hooks blueprint.
+ */
+export const onStop = defineHookListener(onStopHandler, { name: 'onStop' })
+export const onStart = defineHookListener(onStartHandler, { name: 'onStart' })

package/standard-react-imperative/app/pages/welcome/WelcomePage.tsx

@@ -0,0 +1,50 @@
+import { JSX } from 'react'
+import { WelcomeService } from '../../services/WelcomeService'
+import { definePage, IPage, PageRenderContext, ReactIncomingEvent } from '@stone-js/use-react'
+
+/**
+ * WelcomePage Options
+*/
+export interface WelcomePageOptions {
+  welcomeService: WelcomeService
+}
+
+/**
+ * Response data
+ */
+export interface ResponseData {
+  message: string
+}
+
+/**
+ * WelcomePage
+ */
+export const WelcomePage = ({ welcomeService }: WelcomePageOptions): IPage<ReactIncomingEvent> => ({
+  /**
+   * Handle the incoming event.
+   *
+   * @param event - The incoming event.
+   * @returns A welcome message
+  */
+  handle (event: ReactIncomingEvent): ResponseData {
+    return welcomeService.welcome(event.get<string>('name', 'World'))
+  },
+
+  /**
+   * Render the component.
+   *
+   * @returns The rendered component.
+   */
+  render ({ data }: PageRenderContext<ResponseData>): JSX.Element {
+    return (
+      <section className='container'>
+        <h1 className='h1 text-center mt-64'>{data?.message}</h1>
+      </section>
+    )
+  }
+})
+
+/**
+ * WelcomePage Blueprint
+ */
+export const WelcomePageBlueprint = definePage(WelcomePage, { path: '/:name?' })

package/standard-react-imperative/app/services/WelcomeService.ts

@@ -0,0 +1,38 @@
+import { defineService, ILogger } from '@stone-js/core'
+
+/**
+ * Welcome Service Options
+*/
+export interface WelcomeServiceOptions {
+  logger: ILogger
+}
+
+/**
+ * Welcome Service Type
+ */
+export type WelcomeService = ReturnType<typeof WelcomeService>
+
+/**
+ * Welcome Service
+ */
+/* eslint-disable-next-line @typescript-eslint/no-redeclare */
+export const WelcomeService = ({ logger }: WelcomeServiceOptions): Record<PropertyKey, any> => ({
+  /**
+   * Welcome
+   *
+   * @param name - The name
+   * @returns A welcome message
+   */
+  welcome (name: string): { message: string } {
+    logger.info(`Welcome ${name}`)
+    return { message: `Hello ${name}!` }
+  }
+})
+
+/**
+ * Welcome Service Blueprint
+ */
+export const WelcomeServiceBlueprint = defineService(
+  WelcomeService,
+  { alias: 'welcomeService', isFactory: true }
+)

package/standard-react-imperative/assets/css/index.css

@@ -0,0 +1,26 @@
+body {
+  margin: 0;
+  padding: 0;
+  color: #333;
+  font-size: 14px;
+  line-height: 1.5;
+  background-color: #fff;
+  font-family: 'Roboto', sans-serif;
+}
+.h1 {
+  margin: 0;
+  font-weight: 500;
+  font-size: 3rem;
+  font-weight: bold;
+}
+.container {
+  width: 100vw;
+  display: flex;
+  justify-content: center;
+}
+.text-center {
+  text-align: center;
+}
+.mt-64 {
+  margin-top: 64px;
+}

package/standard-react-imperative/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "standard-react-imperative",
+  "private": true,
+  "version": "1.0.0",
+  "description": "Stone.js's standard 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/use-react": "^0.8.3",
+    "@stone-js/browser-adapter": "^0.8.3",
+    "@stone-js/pipeline": "^0.8.3",
+    "@stone-js/http-core": "^0.8.3",
+    "@stone-js/node-http-adapter": "^0.8.3",
+    "@stone-js/router": "^0.8.3",
+    "@stone-js/core": "^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/standard-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/standard-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/standard-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/standard-service-declarative/README.md

@@ -0,0 +1,39 @@
+# Stone.js - Standard starter
+
+Stone.js's standard 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/standard-service-declarative/app/Application.ts

@@ -0,0 +1,39 @@
+import { Routing } from '@stone-js/router'
+import { NodeHttp } from '@stone-js/node-http-adapter'
+import { StoneApp, AdapterHookListenerContext, Hook, LogLevel } from '@stone-js/core'
+
+/**
+ * Application
+ *
+ * This is the main application entry point.
+ *
+ * @StoneApp() is used to enable the Stone application, it is required.
+ * @Routing() is used to enable the routing feature.
+ * @NodeHttp() is used to enable the Node HTTP adapter.
+ *
+ * Lifecycle hooks are used here just for demonstration purposes.
+ */
+@Routing()
+@NodeHttp()
+@StoneApp({ name: 'MyApp', logger: { level: LogLevel.INFO } })
+export class Application {
+  /**
+   * Run before the application starts
+   *
+   * @param blueprint - The blueprint
+   */
+  @Hook('onStart')
+  onStart ({ blueprint }: AdapterHookListenerContext): void {
+    console.log(`${String(blueprint.get('stone.name', 'Stone App'))} is starting...`)
+  }
+
+  /**
+   * Run just before the application stops
+   *
+   * @param blueprint - The blueprint
+   */
+  @Hook('onStop')
+  onStop ({ blueprint }: AdapterHookListenerContext): void {
+    console.log(`${String(blueprint.get('stone.name', 'Stone App'))} is stopping...`)
+  }
+}

package/standard-service-declarative/app/handlers/WelcomeEventHandler.ts

@@ -0,0 +1,45 @@
+import { EventHandler, Get } from '@stone-js/router'
+import { WelcomeService } from '../services/WelcomeService'
+import { IncomingHttpEvent, JsonHttpResponse } from '@stone-js/http-core'
+
+/**
+ * Welcome Event Handler Options
+*/
+export interface WelcomeEventHandlerOptions {
+  welcomeService: WelcomeService
+}
+
+/**
+ * Welcome Event Handler
+ *
+ * @EventHandler() is a decorator that marks a class as a handler.
+ * @EventHandler() think about it as a controller in other frameworks.
+ * Stone.js also provides a @Controller() decorator that is an alias to @EventHandler().
+ * If you are familiar with other frameworks, you can use @Controller() instead of @EventHandler().
+*/
+@EventHandler()
+export class WelcomeEventHandler {
+  private readonly welcomeService: WelcomeService
+
+  /**
+   * Create a new instance of WelcomeEventHandler
+   *
+   * @param welcomeService
+   */
+  constructor ({ welcomeService }: WelcomeEventHandlerOptions) {
+    this.welcomeService = welcomeService
+  }
+
+  /**
+   * Welcome
+   * With explicit json response type.
+   *
+   * @param event - The incoming HTTP event
+   * @returns A welcome message
+  */
+  @Get('/:name?')
+  @JsonHttpResponse(200)
+  welcome (event: IncomingHttpEvent): { message: string } {
+    return this.welcomeService.welcome(event.get<string>('name', 'World'))
+  }
+}

package/standard-service-declarative/app/services/WelcomeService.ts

@@ -0,0 +1,38 @@
+import { ILogger, Service } from '@stone-js/core'
+
+/**
+ * Welcome Service Options
+*/
+export interface WelcomeServiceOptions {
+  logger: ILogger
+}
+
+/**
+ * Welcome Service
+ *
+ * @Service() decorator is used to define a new service
+ * @Service() is an alias of @Stone() decorator.
+ * The alias is required to get benefits of desctructuring Dependency Injection.
+*/
+@Service({ alias: 'welcomeService' })
+export class WelcomeService {
+  private readonly logger: ILogger
+
+  /**
+   * Create a new Welcome Service
+  */
+  constructor ({ logger }: WelcomeServiceOptions) {
+    this.logger = logger
+  }
+
+  /**
+   * Welcome
+   *
+   * @param name - The name
+   * @returns A welcome message
+   */
+  welcome (name: string): { message: string } {
+    this.logger.info(`Welcome ${name}`)
+    return { message: `Hello ${name}!` }
+  }
+}