@stone-js/starters 0.8.4 → 0.8.6

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

@@ -1,26 +1,171 @@
-body {
-  margin: 0;
-  padding: 0;
-  color: #333;
-  font-size: 14px;
-  line-height: 1.5;
-  background-color: #fff;
-  font-family: 'Roboto', sans-serif;
+/**
+ * Stone.js starter — brand welcome screen.
+ * Identity: "Obsidienne & Braise" — obsidian ground, ember (braise) accent, the Portal mark.
+ * Theme-aware: dark by default, light under prefers-color-scheme: light.
+ */
+:root {
+  --ink: #14100E;
+  --ink-2: #1E1815;
+  --cream: #F4EFE6;
+  --cream-dim: #B8AE9E;
+  --ember-1: #FFC46B;
+  --ember-2: #FF5A1F;
+  --line: rgba(244, 239, 230, 0.10);
+  --card: rgba(244, 239, 230, 0.04);
+  --bg: radial-gradient(1200px 600px at 50% -10%, #241C17 0%, var(--ink) 55%);
 }
-.h1 {
+
+@media (prefers-color-scheme: light) {
+  :root {
+    --ink: #F4EFE6;
+    --ink-2: #ffffff;
+    --cream: #1B1613;
+    --cream-dim: #6B6154;
+    --line: rgba(27, 22, 19, 0.10);
+    --card: rgba(27, 22, 19, 0.03);
+    --bg: radial-gradient(1200px 600px at 50% -10%, #FFFFFF 0%, #F1E9DC 60%);
+  }
+}
+
+* { box-sizing: border-box; }
+
+body {
   margin: 0;
-  font-weight: 500;
-  font-size: 3rem;
-  font-weight: bold;
+  min-height: 100vh;
+  color: var(--cream);
+  background: var(--ink);
+  font-family: ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;
+  -webkit-font-smoothing: antialiased;
 }
-.container {
-  width: 100vw;
+
+.stone-welcome {
+  position: relative;
+  min-height: 100vh;
   display: flex;
+  flex-direction: column;
+  align-items: center;
   justify-content: center;
+  padding: 48px 24px;
+  background: var(--bg);
+  overflow: hidden;
+}
+
+/* Ember glow behind the mark. */
+.stone-welcome .glow {
+  position: absolute;
+  top: 8%;
+  left: 50%;
+  width: 520px;
+  height: 520px;
+  transform: translateX(-50%);
+  background: radial-gradient(circle, rgba(255, 90, 31, 0.22) 0%, rgba(255, 90, 31, 0) 68%);
+  filter: blur(8px);
+  pointer-events: none;
+  z-index: 0;
 }
-.text-center {
+
+.stone-welcome .hero {
+  position: relative;
+  z-index: 1;
+  width: 100%;
+  max-width: 680px;
   text-align: center;
+  animation: rise 0.7s cubic-bezier(0.2, 0.7, 0.2, 1) both;
+}
+
+.stone-welcome .mark {
+  width: 104px;
+  height: 104px;
+  filter: drop-shadow(0 8px 28px rgba(255, 90, 31, 0.35));
+}
+
+.stone-welcome .eyebrow {
+  margin: 22px 0 0;
+  font-size: 12px;
+  font-weight: 600;
+  letter-spacing: 0.28em;
+  text-transform: uppercase;
+  color: var(--cream-dim);
+}
+
+.stone-welcome .title {
+  margin: 8px 0 0;
+  font-size: clamp(44px, 8vw, 76px);
+  font-weight: 800;
+  letter-spacing: -0.03em;
+  line-height: 1.02;
+  background: linear-gradient(92deg, var(--ember-1), var(--ember-2));
+  -webkit-background-clip: text;
+  background-clip: text;
+  color: transparent;
+}
+
+.stone-welcome .lead {
+  margin: 18px auto 0;
+  font-size: 20px;
+  font-weight: 600;
+  color: var(--cream);
+}
+
+.stone-welcome .tagline {
+  margin: 10px auto 0;
+  max-width: 46ch;
+  font-size: 16px;
+  line-height: 1.6;
+  color: var(--cream-dim);
+}
+
+.stone-welcome .links {
+  margin-top: 34px;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 12px;
+  justify-content: center;
+}
+
+.stone-welcome .links a,
+.stone-welcome .links .edit {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  padding: 11px 18px;
+  border: 1px solid var(--line);
+  border-radius: 12px;
+  background: var(--card);
+  color: var(--cream);
+  font-size: 14px;
+  font-weight: 600;
+  text-decoration: none;
+  transition: border-color 0.2s, transform 0.2s, background 0.2s;
+}
+
+.stone-welcome .links a:hover {
+  transform: translateY(-2px);
+  border-color: rgba(255, 90, 31, 0.6);
+  background: rgba(255, 90, 31, 0.08);
+}
+
+.stone-welcome .links .edit {
+  font-family: ui-monospace, 'SF Mono', Menlo, Monaco, Consolas, monospace;
+  color: var(--cream-dim);
+}
+.stone-welcome .links .edit b { color: var(--ember-1); font-weight: 700; }
+
+.stone-welcome .brand {
+  position: relative;
+  z-index: 1;
+  margin-top: 56px;
+  font-size: 13px;
+  letter-spacing: 0.02em;
+  color: var(--cream-dim);
+}
+.stone-welcome .brand .dot { color: var(--ember-2); }
+
+@keyframes rise {
+  from { opacity: 0; transform: translateY(14px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .stone-welcome .hero { animation: none; }
 }
-.mt-64 {
-  margin-top: 64px;
-}

package/standard-react-imperative/package.json

@@ -20,23 +20,26 @@
   "dependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@stone-js/use-react": "^0.8.4",
-    "@stone-js/browser-adapter": "^0.8.4",
-    "@stone-js/pipeline": "^0.8.4",
-    "@stone-js/http-core": "^0.8.4",
-    "@stone-js/node-http-adapter": "^0.8.4",
-    "@stone-js/router": "^0.8.4",
-    "@stone-js/core": "^0.8.4"
+    "@stone-js/use-react": "^0.8.6",
+    "@stone-js/browser-adapter": "^0.8.6",
+    "@stone-js/pipeline": "^0.8.6",
+    "@stone-js/http-core": "^0.8.6",
+    "@stone-js/node-http-adapter": "^0.8.6",
+    "@stone-js/router": "^0.8.6",
+    "@stone-js/core": "^0.8.6"
   },
   "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.4",
+    "@stone-js/cli": "^0.8.6",
     "@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"
+  },
+  "overrides": {
+    "glob": "^13.0.0"
   }
 }

package/standard-react-imperative/tests/WelcomePage.spec.ts

@@ -47,5 +47,7 @@ describe('WelcomePage', () => {
     // Assert
     expect(response).toContain('/logo.svg')
     expect(response).toContain('alt="Stone.js"')
+    expect(response).toContain('Welcome')
+    expect(response).toContain('Stone.js')
   })
 })

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

@@ -1,5 +1,5 @@
 import { EventHandler, Get } from '@stone-js/router'
-import { WelcomeService } from '../services/WelcomeService'
+import { WelcomeService, WelcomeResponse } from '../services/WelcomeService'
 import { IncomingHttpEvent, JsonHttpResponse } from '@stone-js/http-core'
 
 /**
@@ -39,7 +39,7 @@ export class WelcomeEventHandler {
   */
   @Get('/:name?')
   @JsonHttpResponse(200)
-  welcome (event: IncomingHttpEvent): { message: string } {
+  welcome (event: IncomingHttpEvent): WelcomeResponse {
     return this.welcomeService.welcome(event.get<string>('name', 'World'))
   }
 }

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

@@ -7,6 +7,24 @@ export interface WelcomeServiceOptions {
   logger: ILogger
 }
 
+/**
+ * Framework information carried by the welcome payload.
+*/
+export interface FrameworkInfo {
+  name: string
+  tagline: string
+  docs: string
+  github: string
+}
+
+/**
+ * The branded welcome payload returned to the client.
+*/
+export interface WelcomeResponse {
+  message: string
+  framework: FrameworkInfo
+}
+
 /**
  * Welcome Service
  *
@@ -31,8 +49,16 @@ export class WelcomeService {
    * @param name - The name
    * @returns A welcome message
    */
-  welcome (name: string): { message: string } {
+  welcome (name: string): WelcomeResponse {
     this.logger.info(`Welcome ${name}`)
-    return { message: `Hello ${name}!` }
+    return {
+      message: `Hello ${name}! Welcome to Stone.js.`,
+      framework: {
+        name: 'Stone.js',
+        tagline: 'The continuum framework',
+        docs: 'https://stonejs.dev',
+        github: 'https://github.com/stone-foundation/stone-js-framework'
+      }
+    }
   }
 }

package/standard-service-declarative/package.json

@@ -18,19 +18,22 @@
     "test:cvg": "npm run test -- --coverage"
   },
   "dependencies": {
-    "@stone-js/pipeline": "^0.8.4",
-    "@stone-js/http-core": "^0.8.4",
-    "@stone-js/node-http-adapter": "^0.8.4",
-    "@stone-js/router": "^0.8.4",
-    "@stone-js/core": "^0.8.4"
+    "@stone-js/pipeline": "^0.8.6",
+    "@stone-js/http-core": "^0.8.6",
+    "@stone-js/node-http-adapter": "^0.8.6",
+    "@stone-js/router": "^0.8.6",
+    "@stone-js/core": "^0.8.6"
   },
   "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.4",
+    "@stone-js/cli": "^0.8.6",
     "@types/node": "^24.0.7",
     "@vitest/coverage-v8": "^3.0.9",
     "vitest": "^3.0.9"
+  },
+  "overrides": {
+    "glob": "^13.0.0"
   }
 }

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

@@ -43,12 +43,19 @@ describe('WelcomeService', () => {
     service = new WelcomeService({ logger: mockedLogger })
   })
 
-  it('should build a welcome message for the given name', () => {
+  it('should build a branded welcome message for the given name', () => {
     // Act
     const response = service.welcome('Stone')
 
     // Assert
-    expect(response).toHaveProperty('message', 'Hello Stone!')
+    expect(response.message).toBe('Hello Stone! Welcome to Stone.js.')
+    expect(response.framework.name).toBe('Stone.js')
+    expect(response.framework).toMatchObject({
+      name: 'Stone.js',
+      tagline: 'The continuum framework',
+      docs: 'https://stonejs.dev',
+      github: 'https://github.com/stone-foundation/stone-js-framework'
+    })
     expect(mockedLogger.info).toHaveBeenCalledWith('Welcome Stone')
   })
 })
@@ -73,7 +80,8 @@ describe('WelcomeEventHandler', () => {
     const response = handler.welcome(event)
 
     // Assert
-    expect(response.message).toBe('Hello World!')
+    expect(response.message).toBe('Hello World! Welcome to Stone.js.')
+    expect(response.framework.name).toBe('Stone.js')
     expect(mockedLogger.info).toHaveBeenCalledWith('Welcome World')
   })
 
@@ -85,7 +93,8 @@ describe('WelcomeEventHandler', () => {
     const response = handler.welcome(event)
 
     // Assert
-    expect(response.message).toBe('Hello World!')
+    expect(response.message).toBe('Hello World! Welcome to Stone.js.')
+    expect(response.framework.name).toBe('Stone.js')
     expect(mockedLogger.info).toHaveBeenCalledWith('Welcome World')
   })
 })

package/standard-service-imperative/app/handlers/welcomeEventHandler.ts

@@ -1,5 +1,5 @@
 import { IncomingHttpEvent } from '@stone-js/http-core'
-import { WelcomeService } from '../services/welcomeService'
+import { WelcomeService, WelcomeResponse } from '../services/welcomeService'
 import { defineRoute, FactoryEventHandler, FunctionalEventHandler } from '@stone-js/router'
 
 /**
@@ -12,9 +12,7 @@ export interface WelcomeEventHandlerOptions {
 /**
  * Response data
  */
-export interface ResponseData {
-  message: string
-}
+export type ResponseData = WelcomeResponse
 
 /**
  * Welcome

package/standard-service-imperative/app/services/welcomeService.ts

@@ -7,6 +7,24 @@ export interface WelcomeServiceOptions {
   logger: ILogger
 }
 
+/**
+ * Framework information carried by the welcome payload.
+*/
+export interface FrameworkInfo {
+  name: string
+  tagline: string
+  docs: string
+  github: string
+}
+
+/**
+ * The branded welcome payload returned to the client.
+*/
+export interface WelcomeResponse {
+  message: string
+  framework: FrameworkInfo
+}
+
 /**
  * Welcome Service Type
  */
@@ -23,9 +41,17 @@ export const WelcomeService = ({ logger }: WelcomeServiceOptions): Record<Proper
    * @param name - The name
    * @returns A welcome message
    */
-  welcome (name: string): { message: string } {
+  welcome (name: string): WelcomeResponse {
     logger.info(`Welcome ${name}`)
-    return { message: `Hello ${name}!` }
+    return {
+      message: `Hello ${name}! Welcome to Stone.js.`,
+      framework: {
+        name: 'Stone.js',
+        tagline: 'The continuum framework',
+        docs: 'https://stonejs.dev',
+        github: 'https://github.com/stone-foundation/stone-js-framework'
+      }
+    }
   }
 })
 

package/standard-service-imperative/package.json

@@ -17,19 +17,22 @@
     "test:cvg": "npm run test -- --coverage"
   },
   "dependencies": {
-    "@stone-js/pipeline": "^0.8.4",
-    "@stone-js/http-core": "^0.8.4",
-    "@stone-js/node-http-adapter": "^0.8.4",
-    "@stone-js/router": "^0.8.4",
-    "@stone-js/core": "^0.8.4"
+    "@stone-js/pipeline": "^0.8.6",
+    "@stone-js/http-core": "^0.8.6",
+    "@stone-js/node-http-adapter": "^0.8.6",
+    "@stone-js/router": "^0.8.6",
+    "@stone-js/core": "^0.8.6"
   },
   "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.4",
+    "@stone-js/cli": "^0.8.6",
     "@types/node": "^24.0.7",
     "@vitest/coverage-v8": "^3.0.9",
     "vitest": "^3.0.9"
+  },
+  "overrides": {
+    "glob": "^13.0.0"
   }
 }

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

@@ -20,7 +20,14 @@ describe('WelcomeService', () => {
     const response = service.welcome('Stone')
 
     // Assert
-    expect(response).toHaveProperty('message', 'Hello Stone!')
+    expect(response.message).toBe('Hello Stone! Welcome to Stone.js.')
+    expect(response.framework.name).toBe('Stone.js')
+    expect(response.framework).toMatchObject({
+      name: 'Stone.js',
+      tagline: 'The continuum framework',
+      docs: 'https://stonejs.dev',
+      github: 'https://github.com/stone-foundation/stone-js-framework'
+    })
     expect(mockedLogger.info).toHaveBeenCalledWith('Welcome Stone')
   })
 })
@@ -55,7 +62,8 @@ describe('WelcomeEventHandler', () => {
     const response = handler(event)
 
     // Assert
-    expect(response.message).toBe('Hello World!')
+    expect(response.message).toBe('Hello World! Welcome to Stone.js.')
+    expect(response.framework.name).toBe('Stone.js')
     expect(mockedLogger.info).toHaveBeenCalledWith('Welcome World')
   })
 
@@ -69,7 +77,8 @@ describe('WelcomeEventHandler', () => {
     const response = handler(event)
 
     // Assert
-    expect(response.message).toBe('Hello World!')
+    expect(response.message).toBe('Hello World! Welcome to Stone.js.')
+    expect(response.framework.name).toBe('Stone.js')
     expect(mockedLogger.info).toHaveBeenCalledWith('Welcome World')
   })
 })