@inglorious/ssx 1.3.0 → 1.3.2

package/README.md

@@ -52,13 +52,13 @@ npm install @inglorious/ssx @inglorious/web
 
 ### Create Your First Site
 
-<!-- ```bash
-npx @inglorious/create-app my-site --template ssx
+```bash
+npx @inglorious/create-app my-site --template ssx-js
 cd my-site
 npm run dev
 ```
 
-Or manually: -->
+Or manually:
 
 ### Create Your First Site (TypeScript)
 
@@ -224,7 +224,7 @@ export const about = {
 ```
 
 ```javascript
-// src/entities.js
+// src/store/entities.js
 export const entities = {
   about: {
     type: "about",
@@ -408,7 +408,7 @@ SSX provides a simple CLI for building and developing:
 Builds your static site:
 
 ```bash
-ssx build [options]
+pnpm ssx build [options]
 
 Options:
   -c, --config <file>  Config file (default: "site.config.js")
@@ -418,12 +418,20 @@ Options:
   -f, --force          Force clean build, ignore cache
 ```
 
+### `preview`
+
+Serves the built static site on port 3000 through the `serve` NPM package.
+
+```bash
+pnpm preview
+```
+
 ### `ssx dev`
 
-Starts development server with hot reload:
+Starts the Vite development server on port 3000 with hot reload:
 
 ```bash
-ssx dev [options]
+pnpm ssx dev [options]
 
 Options:
   -c, --config <file>  Config file (default: "site.config.js")
@@ -431,18 +439,6 @@ Options:
   -p, --port <port>    Dev server port (default: 3000)
 ```
 
-### Package.json Scripts
-
-```json
-{
-  "scripts": {
-    "dev": "ssx dev",
-    "build": "ssx build",
-    "preview": "pnpm dlx serve dist"
-  }
-}
-```
-
 ---
 
 ## Project Structure
@@ -456,7 +452,8 @@ my-site/
 │   │   └── posts/
 │   │       ├── index.js    # /posts
 │   │       └── _id.js      # /posts/:id
-│   ├── entities.js     # Entity definitions
+│   ├── store/          # Store configuration
+│   │   └── entities.js     # Entity definitions
 │   └── types/          # Custom entity types (optional)
 ├── dist/               # Build output
 ├── package.json
@@ -575,7 +572,7 @@ export const metadata = {
 Register it in your router:
 
 ```javascript
-// src/entities.js
+// src/store/entities.js
 import { setRoutes } from "@inglorious/web/router"
 
 setRoutes({

package/bin/ssx.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { existsSync } from "node:fs"
 import { readFile } from "node:fs/promises"
 import path from "node:path"
 import { fileURLToPath } from "node:url"
@@ -31,10 +32,12 @@ program
   .option("-p, --port <port>", "dev server port", 3000)
   .action(async (options) => {
     const cwd = process.cwd()
+    const config = resolveConfigFile(options.config)
 
     try {
       await dev({
         ...options,
+        config,
         rootDir: path.resolve(cwd, options.root),
         port: Number(options.port),
       })
@@ -54,10 +57,12 @@ program
   .option("-f, --force", "force clean build (ignore cache)", false)
   .action(async (options) => {
     const cwd = process.cwd()
+    const config = resolveConfigFile(options.config)
 
     try {
       await build({
         ...options,
+        config,
         rootDir: path.resolve(cwd, options.root),
         outDir: path.resolve(cwd, options.out),
         incremental: options.incremental, // Enabled by default
@@ -76,3 +81,15 @@ program
   })
 
 program.parse()
+
+function resolveConfigFile(configFile) {
+  if (configFile === "site.config.js") {
+    const jsPath = path.resolve(process.cwd(), "site.config.js")
+    const tsPath = path.resolve(process.cwd(), "site.config.ts")
+
+    if (!existsSync(jsPath) && existsSync(tsPath)) {
+      return "site.config.ts"
+    }
+  }
+  return configFile
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inglorious/ssx",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Server-Side-X. Xecution? Xperience? Who knows.",
   "author": "IceOnFire <antony.mistretta@gmail.com> (https://ingloriouscoderz.it)",
   "license": "MIT",
@@ -44,14 +44,15 @@
     "fast-xml-parser": "^5.3.3",
     "glob": "^13.0.0",
     "rollup-plugin-minify-template-literals": "^1.1.7",
+    "sharp": "^0.34.5",
+    "svgo": "^4.0.0",
     "vite": "^7.1.3",
-    "@inglorious/web": "4.0.1"
+    "vite-plugin-image-optimizer": "^2.0.3",
+    "@inglorious/web": "4.0.2"
   },
   "devDependencies": {
     "prettier": "^3.6.2",
-    "sharp": "^0.34.5",
-    "svgo": "^4.0.0",
-    "vite-plugin-image-optimizer": "^2.0.3",
+    "serve": "^14.2.1",
     "vitest": "^1.6.1",
     "@inglorious/eslint-config": "1.1.1"
   },
@@ -65,6 +66,6 @@
     "test": "vitest run",
     "dev": "node ./bin/ssx.js dev -r ./src/__fixtures__",
     "build": "node ./bin/ssx.js build -r ./src/__fixtures__",
-    "preview": "pnpm dlx serve dist"
+    "preview": "serve dist"
   }
 }

package/src/build/manifest.js

@@ -57,7 +57,7 @@ export async function hashFile(filePath) {
  * @returns {Promise<string|null>} Hash of entities.js.
  */
 export async function hashEntities(rootDir) {
-  const entitiesPath = path.join(rootDir, "entities.js")
+  const entitiesPath = path.join(rootDir, "store", "entities.js")
   return await hashFile(entitiesPath)
 }
 

package/src/store/index.js

@@ -32,7 +32,7 @@ export async function generateStore(pages = [], options = {}, loader) {
 
   for (const ext of extensions) {
     try {
-      const module = await load(path.join(rootDir, `entities.${ext}`))
+      const module = await load(path.join(rootDir, "store", `entities.${ext}`))
       entities = module.entities
       break
     } catch {

package/src/store/store.test.js

@@ -68,7 +68,11 @@ describe("generateStore", () => {
     await generateStore([page], { rootDir: "src" }, loader)
 
     expect(loader).toHaveBeenCalledWith(page.filePath)
-    expect(loader).toHaveBeenCalledWith(path.join("src", "entities.js"))
-    expect(loader).toHaveBeenCalledWith(path.join("src", "entities.ts"))
+    expect(loader).toHaveBeenCalledWith(
+      path.join("src", "store", "entities.js"),
+    )
+    expect(loader).toHaveBeenCalledWith(
+      path.join("src", "store", "entities.ts"),
+    )
   })
 })