create-gramstax 0.13.1 → 0.14.0

package/dist/src/templates/e2e/{start.test.ts → start/index.test.ts}

@@ -1,5 +1,5 @@
 import {describe, it, expect, beforeEach} from "bun:test"
-import {e2e} from "./setup"
+import {e2e} from "../setup"
 
 const intent = `start`
 const asUser = {user: {id: 2001, username: `testuser`}, chat: {id: 2001}}

package/dist/src/templates/e2e/start/random/index.test.ts

@@ -0,0 +1,28 @@
+import {describe, it, expect, beforeEach} from "bun:test"
+import {e2e} from "../../setup"
+
+const intent = `start/random`
+const asUser = {user: {id: 9001, username: `testuser`}, chat: {id: 9001}}
+
+beforeEach(() => {
+  e2e.clearCalls()
+})
+
+describe(`E2E: StartRandomPage (hub)`, () => {
+  it(`show hub menu when navigating from /start`, async () => {
+    await e2e.sendText(`/start`, asUser)
+    e2e.clearCalls()
+
+    const responses = await e2e.sendCallbackQuery(intent, asUser)
+    const responsesId = await e2e.sendCallbackQuery(intent, {user: {id: 9002, username: `pengguna`, language_code: `id`}, chat: {id: 9002}})
+
+    expect(responses.length).toBeGreaterThan(0)
+    expect(responsesId.length).toBeGreaterThan(0)
+    const edit = responses[0]!
+    const editId = responsesId[0]!
+    expect(edit.body?.rich_message.html).toContain(`Random Generator`)
+    expect(editId.body?.rich_message.html).toContain(`Generator Acak`)
+    expect(e2e.extractButtonLabels(edit)).toEqual(e2e.gkb(intent, `default`, `inline`, {}))
+    expect(e2e.extractButtonLabels(editId)).toEqual(e2e.gkb(intent, `default`, `inline`, {}, `id`))
+  })
+})

package/dist/src/templates/e2e/{random-number.test.ts → start/random/number.test.ts}

@@ -1,20 +1,23 @@
 import {describe, it, expect, beforeEach} from "bun:test"
-import {e2e} from "./setup"
+import {e2e} from "../../setup"
 
-const intent = `random-number`
-const asUser = {user: {id: 2003, username: `testuser`}, chat: {id: 2003}}
+const intent = `start/random/number`
+const asUser = {user: {id: 8001, username: `testuser`}, chat: {id: 8001}}
 
 beforeEach(() => {
   e2e.clearCalls()
 })
 
-describe(`E2E: RandomNumberPage`, () => {
-  it(`show generated random number when navigating from /start`, async () => {
+describe(`E2E: StartRandomNumberPage`, () => {
+  it(`show generated random number when navigating from hub`, async () => {
     await e2e.sendText(`/start`, asUser)
     e2e.clearCalls()
 
+    await e2e.sendCallbackQuery(`start/random`, asUser)
+    e2e.clearCalls()
+
     const responses = await e2e.sendCallbackQuery(intent, asUser)
-    const responsesId = await e2e.sendCallbackQuery(intent, {user: {id: 6001, username: `pengguna`, language_code: `id`}, chat: {id: 6001}})
+    const responsesId = await e2e.sendCallbackQuery(intent, {user: {id: 8002, username: `pengguna`, language_code: `id`}, chat: {id: 8002}})
 
     expect(responses.length).toBeGreaterThan(0)
     expect(responsesId.length).toBeGreaterThan(0)

package/dist/src/templates/e2e/start/random/text.test.ts

@@ -0,0 +1,31 @@
+import {describe, it, expect, beforeEach} from "bun:test"
+import {e2e} from "../../setup"
+
+const intent = `start/random/text`
+const asUser = {user: {id: 10001, username: `testuser`}, chat: {id: 10001}}
+
+beforeEach(() => {
+  e2e.clearCalls()
+})
+
+describe(`E2E: StartRandomTextPage`, () => {
+  it(`show random text when navigating from hub`, async () => {
+    await e2e.sendText(`/start`, asUser)
+    e2e.clearCalls()
+
+    await e2e.sendCallbackQuery(`start/random`, asUser)
+    e2e.clearCalls()
+
+    const responses = await e2e.sendCallbackQuery(intent, asUser)
+    const responsesId = await e2e.sendCallbackQuery(intent, {user: {id: 10002, username: `pengguna`, language_code: `id`}, chat: {id: 10002}})
+
+    expect(responses.length).toBeGreaterThan(0)
+    expect(responsesId.length).toBeGreaterThan(0)
+    const edit = responses[0]!
+    const editId = responsesId[0]!
+    expect(edit.body?.text).toContain(`Random Text`)
+    expect(editId.body?.text).toContain(`Teks Acak`)
+    expect(e2e.extractButtonLabels(edit)).toEqual(e2e.gkb(intent, `default`, `inline`, {}))
+    expect(e2e.extractButtonLabels(editId)).toEqual(e2e.gkb(intent, `default`, `inline`, {}, `id`))
+  })
+})

package/dist/src/templates/e2e/{general-status.test.ts → status.test.ts}

@@ -1,14 +1,14 @@
 import {describe, it, expect, beforeEach} from "bun:test"
 import {e2e} from "./setup"
 
-const intent = `general-status`
+const intent = `status`
 const asUser = {user: {id: 8001, username: `testuser`}, chat: {id: 8001}}
 
 beforeEach(() => {
   e2e.clearCalls()
 })
 
-describe(`E2E: GeneralStatusPage`, () => {
+describe(`E2E: StatusPage`, () => {
   it(`show 'Route not found' for unrecognized callback query`, async () => {
     await e2e.sendText(`/start`, asUser)
     e2e.clearCalls()

package/dist/src/templates/package.json

@@ -38,8 +38,8 @@
     "test:all": "bun test test/ e2e/"
   },
   "dependencies": {
-    "@gramstax/lmdb": "^0.13.0",
-    "gramstax": "^0.13.0",
+    "@gramstax/lmdb": "^0.13.1",
+    "gramstax": "^0.13.1",
     "dayjs": "^1.11.13"
   },
   "peerDependencies": {

package/dist/src/templates/scripts/check-e2e-mirror.ts

@@ -0,0 +1,148 @@
+/**
+ * check-e2e-mirror.ts
+ *
+ * Ensures the e2e/ directory structure mirrors src/pages exactly.
+ *
+ * Convention:
+ *   src/pages/foo.ts       → e2e/foo.test.ts        (same relative path, same name)
+ *   src/pages/foo/bar.ts   → e2e/foo/bar.test.ts    (same relative path)
+ *   src/pages/foo/index.ts → e2e/foo/index.test.ts  (same relative path)
+ *
+ * Usage:
+ *   bun run scripts/check-e2e-mirror.ts
+ *       → Check this project (src/pages vs e2e)
+ *
+ *   bun run scripts/check-e2e-mirror.ts --path ./my-app
+ *       → Check another project (pages: ./my-app/src/pages, e2e: ./my-app/e2e)
+ *
+ *   bun run scripts/check-e2e-mirror.ts --path ./my-app --fix
+ *       → Check + auto-create missing e2e test files
+ *
+ * Exit code: 0 if all OK, 1 if any mismatch.
+ */
+
+import {existsSync, readdirSync, mkdirSync, writeFileSync} from "node:fs"
+import {join, dirname} from "node:path"
+
+// ── Parse CLI ─────────────────────────────────────────────────────────
+
+const args = process.argv.slice(2)
+
+const FIX_MODE = args.includes(`--fix`)
+
+const pathIndex = args.indexOf(`--path`)
+const customPath = pathIndex !== -1 && pathIndex + 1 < args.length ? args[pathIndex + 1]! : null
+
+// ── Helpers ───────────────────────────────────────────────────────────
+
+function walkPages(dir: string, prefix = ``): Array<{rel: string}> {
+  const results: Array<{rel: string}> = []
+  for (const entry of readdirSync(dir, {withFileTypes: true})) {
+    const full = join(dir, entry.name)
+    if (entry.isDirectory()) {
+      results.push(...walkPages(full, prefix ? `${prefix}/${entry.name}` : entry.name))
+    } else if (entry.isFile() && /\.(ts|js)$/.test(entry.name) && !entry.name.endsWith(`.test`)) {
+      results.push({rel: prefix ? `${prefix}/${entry.name}` : entry.name})
+    }
+  }
+  return results
+}
+
+function getTestExt(rel: string): string {
+  return rel.endsWith(`.js`) ? `.test.js` : `.test.ts`
+}
+
+function getSetupImportPrefix(rel: string): string {
+  const depth = rel.split(`/`).length - 1
+  if (depth === 0) return `./`
+  let prefix = ``
+  for (let i = 0; i < depth; i++) prefix += `../`
+  return prefix
+}
+
+function generateTestContent(pageRel: string): string {
+  const baseName = pageRel.replace(/\.(ts|js)$/, ``)
+  const parts = baseName.split(`/`)
+  const pageName = parts[parts.length - 1] || parts[parts.length - 2] || `Page`
+  const className = pageName
+    .split(/[-_]/)
+    .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
+    .join(``) + `Page`
+
+  return [
+    `import {describe, it, expect} from "bun:test"`,
+    `import {bot} from "./setup"`,
+    ``,
+    `describe(\`E2E: ${className}\`, () => {`,
+    `  it(\`load as a registered page in the bot\`, () => {`,
+    `    const allPages = bot.pages.all`,
+    `    expect(allPages[\`${baseName}\`]).toBeDefined()`,
+    `  })`,
+    `})`,
+    ``
+  ].join(`\n`)
+}
+
+function checkProject(label: string, pagesDir: string, e2eDir: string): boolean {
+  if (!existsSync(pagesDir)) {
+    console.log(`  ⏭️  ${label}: pages directory not found at ${pagesDir}`)
+    return true
+  }
+  if (!existsSync(e2eDir)) {
+    console.log(`  ⏭️  ${label}: e2e directory not found at ${e2eDir}`)
+    return true
+  }
+
+  const pages = walkPages(pagesDir)
+  let ok = true
+
+  for (const page of pages) {
+    const ext = getTestExt(page.rel)
+    const expectedE2E = page.rel.replace(/\.(ts|js)$/, ``) + ext
+    const e2ePath = join(e2eDir, expectedE2E)
+
+    if (!existsSync(e2ePath)) {
+      console.log(`  ❌ ${label}: pages/${page.rel} -> e2e/${expectedE2E} MISSING`)
+      ok = false
+
+      if (FIX_MODE) {
+        const content = generateTestContent(page.rel)
+          .replace(`"./setup"`, `"${getSetupImportPrefix(expectedE2E)}setup"`)
+        mkdirSync(dirname(e2ePath), {recursive: true})
+        writeFileSync(e2ePath, content)
+        console.log(`     ✅ Created e2e/${expectedE2E}`)
+      }
+    }
+  }
+
+  if (ok) {
+    console.log(`  ✅ ${label}: ${pages.length} pages, all mirrored`)
+  }
+  return ok
+}
+
+// ── Main ──────────────────────────────────────────────────────────────
+
+let allOk = true
+
+if (customPath) {
+  const label = customPath.replace(/\\/g, `/`).replace(/\/+$/, ``)
+  const pagesDir = join(customPath, `src`, `pages`)
+  const e2eDir = join(customPath, `e2e`)
+  const ok = checkProject(label, pagesDir, e2eDir)
+  if (!ok) allOk = false
+} else {
+  // Default: check this project's own pages and e2e
+  const pagesDir = join(import.meta.dir, `../src/pages`)
+  const e2eDir = join(import.meta.dir, `..`)
+  const ok = checkProject(`this project`, pagesDir, e2eDir)
+  if (!ok) allOk = false
+}
+
+if (!allOk && !FIX_MODE) {
+  console.log(`\nSome e2e tests are missing. Run with --fix to auto-create them.`)
+  process.exit(1)
+} else if (allOk) {
+  console.log(`\nAll OK!`)
+  process.exit(0)
+}

package/dist/src/templates/scripts/generate-e2e-structure.ts

@@ -0,0 +1,220 @@
+/**
+ * generate-e2e-structure.ts
+ *
+ * Auto-create e2e test files for every page file that does not yet have
+ * a matching e2e test. The e2e structure mirrors src/pages exactly.
+ *
+ * Convention:
+ *   src/pages/foo.ts       → e2e/foo.test.ts        (same relative path)
+ *   src/pages/foo/bar.ts   → e2e/foo/bar.test.ts    (same relative path)
+ *   src/pages/foo/index.ts → e2e/foo/index.test.ts  (same relative path)
+ *
+ * Each generated e2e test contains:
+ *   - Import setup with the correct relative path
+ *   - Basic test: "load as a registered page in the bot"
+ *   - Class name derived from the file name (PascalCase)
+ *
+ * Usage:
+ *   bun run scripts/generate-e2e-structure.ts
+ *       → Generate for this project (src/pages → e2e)
+ *
+ *   bun run scripts/generate-e2e-structure.ts --path ./my-app
+ *       → Generate for another project
+ *
+ *   bun run scripts/generate-e2e-structure.ts --path ./my-app --dry-run
+ *       → Preview what would be created without writing files
+ *
+ *   bun run scripts/generate-e2e-structure.ts --path ./my-app --force
+ *       → Overwrite existing e2e tests
+ *
+ *   bun run scripts/generate-e2e-structure.ts --path ./my-app --check
+ *       → Only check, no file creation
+ *
+ * Exit code: 0 if OK, 1 if any errors.
+ */
+
+import {existsSync, readdirSync, mkdirSync, writeFileSync} from "node:fs"
+import {join, dirname} from "node:path"
+
+// ── Parse CLI ─────────────────────────────────────────────────────────
+
+const args = process.argv.slice(2)
+
+const DRY_RUN = args.includes(`--dry-run`)
+const FORCE = args.includes(`--force`)
+const CHECK_ONLY = args.includes(`--check`)
+
+const pathIndex = args.indexOf(`--path`)
+const customPath = pathIndex !== -1 && pathIndex + 1 < args.length ? args[pathIndex + 1]! : null
+
+// ── Helpers ───────────────────────────────────────────────────────────
+
+/** Walk directory recursively, return relative file paths of all pages */
+function walkFiles(dir: string, prefix = ``): string[] {
+  const results: string[] = []
+  for (const entry of readdirSync(dir, {withFileTypes: true})) {
+    const full = join(dir, entry.name)
+    if (entry.isDirectory()) {
+      results.push(...walkFiles(full, prefix ? `${prefix}/${entry.name}` : entry.name))
+    } else if (entry.isFile() && /\.(ts|js)$/.test(entry.name) && !entry.name.endsWith(`.test`)) {
+      results.push(prefix ? `${prefix}/${entry.name}` : entry.name)
+    }
+  }
+  return results
+}
+
+/** Determine test file extension based on page file extension */
+function testExt(rel: string): string {
+  return rel.endsWith(`.js`) ? `.test.js` : `.test.ts`
+}
+
+/** Build correct relative import path from a test file to setup */
+function setupImport(rel: string): string {
+  const depth = rel.split(`/`).length - 1
+  if (depth === 0) return `./`
+  let prefix = ``
+  for (let i = 0; i < depth; i++) prefix += `../`
+  return prefix
+}
+
+/** Convert a filename segment to PascalCase */
+function toClassName(name: string): string {
+  return name
+    .split(/[-_/]/)
+    .filter(Boolean)
+    .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
+    .join(` `)
+    .replace(/\s+/g, ``)
+}
+
+/** Generate the content for an e2e test file */
+function generateTestContent(pageRel: string): string {
+  const baseName = pageRel.replace(/\.(ts|js)$/, ``)
+  const parts = baseName.split(`/`)
+  const fileName = parts[parts.length - 1] || `index`
+  const className = toClassName(fileName) + `Page`
+  const importPath = setupImport(baseName + testExt(pageRel))
+
+  return [
+    `import {describe, it, expect} from "bun:test"`,
+    `import {bot} from "${importPath}setup"`,
+    ``,
+    `describe(\`E2E: ${className}\`, () => {`,
+    `  it(\`load as a registered page in the bot\`, () => {`,
+    `    const allPages = bot.pages.all`,
+    `    expect(allPages[\`${baseName}\`]).toBeDefined()`,
+    `  })`,
+    `})`,
+    ``
+  ].join(`\n`)
+}
+
+// ── Process one project ───────────────────────────────────────────────
+
+function processProject(
+  label: string,
+  pagesDir: string,
+  e2eDir: string
+): {created: number; skipped: number; errors: number} {
+  const result = {created: 0, skipped: 0, errors: 0}
+
+  if (!existsSync(pagesDir)) {
+    console.log(`  ⏭️  ${label}: pages directory not found at ${pagesDir}`)
+    result.errors++
+    return result
+  }
+
+  if (!existsSync(e2eDir)) {
+    if (CHECK_ONLY) {
+      console.log(`  ⏭️  ${label}: e2e directory not found at ${e2eDir}`)
+      result.errors++
+      return result
+    }
+    if (!DRY_RUN) {
+      mkdirSync(e2eDir, {recursive: true})
+      console.log(`  📁 ${label}: created e2e directory`)
+    } else {
+      console.log(`  📁 ${label}: would create e2e directory`)
+    }
+  }
+
+  const pageFiles = walkFiles(pagesDir)
+
+  for (const pageRel of pageFiles) {
+    const ext = testExt(pageRel)
+    const expectedE2E = pageRel.replace(/\.(ts|js)$/, ``) + ext
+    const e2ePath = join(e2eDir, expectedE2E)
+
+    if (existsSync(e2ePath) && !FORCE) {
+      result.skipped++
+      continue
+    }
+
+    if (CHECK_ONLY) {
+      console.log(`  ❌ ${label}: e2e/${expectedE2E} (for pages/${pageRel})`)
+      continue
+    }
+
+    const content = generateTestContent(pageRel)
+
+    if (DRY_RUN) {
+      console.log(`  📝 ${label}: would create e2e/${expectedE2E}`)
+      console.log(content.split(`\n`).map((l) => `     | ${l}`).join(`\n`))
+      console.log(``)
+      result.created++
+      continue
+    }
+
+    try {
+      mkdirSync(dirname(e2ePath), {recursive: true})
+      writeFileSync(e2ePath, content)
+      console.log(`  ✅ ${label}: created e2e/${expectedE2E}`)
+      result.created++
+    } catch (err) {
+      console.log(`  ❌ ${label}: failed to create e2e/${expectedE2E}: ${err}`)
+      result.errors++
+    }
+  }
+
+  if (result.created === 0 && result.errors === 0 && !CHECK_ONLY) {
+    console.log(`  ✅ ${label}: all ${pageFiles.length} pages already have matching e2e tests`)
+  }
+
+  return result
+}
+
+// ── Main ──────────────────────────────────────────────────────────────
+
+let totalCreated = 0
+let totalSkipped = 0
+let totalErrors = 0
+
+if (customPath) {
+  const label = customPath.replace(/\\/g, `/`).replace(/\/+$/, ``)
+  const pagesDir = join(customPath, `src`, `pages`)
+  const e2eDir = join(customPath, `e2e`)
+  const r = processProject(label, pagesDir, e2eDir)
+  totalCreated += r.created
+  totalSkipped += r.skipped
+  totalErrors += r.errors
+} else {
+  // Default: generate for this project's own pages → e2e
+  const pagesDir = join(import.meta.dir, `../src/pages`)
+  const e2eDir = join(import.meta.dir, `..`)
+  const r = processProject(`this project`, pagesDir, e2eDir)
+  totalCreated += r.created
+  totalSkipped += r.skipped
+  totalErrors += r.errors
+}
+
+// ── Summary ───────────────────────────────────────────────────────────
+
+console.log(``)
+console.log(`Summary:`)
+console.log(`  Created: ${totalCreated}`)
+console.log(`  Skipped (already exists): ${totalSkipped}`)
+console.log(`  Errors: ${totalErrors}`)
+
+if (totalErrors > 0) {
+  process.exit(1)
+}

package/dist/src/templates/src/core/bot.ts

@@ -1,6 +1,6 @@
 import {Gramstax} from "gramstax"
 import {UserGuard} from "~/guards/user"
-import {GeneralStatusPage} from "~/pages/general-status"
+import {StatusPage} from "~/pages/status"
 import type {CtxCore} from "./ctx"
 
 export class BotCore extends Gramstax {
@@ -13,10 +13,10 @@ export class BotCore extends Gramstax {
   }
 
   async hookErrorPage(ctx: CtxCore, data: NonNullable<Parameters<NonNullable<Gramstax[`hookErrorPage`]>>[1]>) {
-    await new GeneralStatusPage(ctx).berror.show(`${data.listenerName}:hookErrorPage`, data.error, data.isEdit)
+    await new StatusPage(ctx).berror.show(`${data.listenerName}:hookErrorPage`, data.error, data.isEdit)
   }
 
   async hookErrorInputNotFoundPage(ctx: CtxCore) {
-    await new GeneralStatusPage(ctx).berrorNotFound.show()
+    await new StatusPage(ctx).bnotFound.show()
   }
 }

package/dist/src/templates/src/guards/user.ts

@@ -1,10 +1,10 @@
 import {GuardBase} from "~/base/guard"
-import {GeneralStatusPage} from "~/pages/general-status"
+import {StatusPage} from "~/pages/status"
 import {UserNameNotFoundPage} from "~/pages/username-notfound"
 
 export class UserGuard extends GuardBase {
   async _catch(err: any, func: any, isEdit: boolean) {
-    await new GeneralStatusPage(this).berror.show(func, err, isEdit)
+    await new StatusPage(this).berror.show(func, err, isEdit)
     return null
   }
 

package/dist/src/templates/src/pages/{start.ts → start/index.ts}

@@ -1,7 +1,7 @@
-import {HelpPage} from "./help"
+import {HelpPage} from "../help"
 import {PageBase} from "~/base/page"
-import {RandomNumberPage} from "./random-number"
-import {SumNumberPage} from "./sum-number"
+import {SumNumberPage} from "../sum-number"
+import {StartRandomPage} from "./random"
 
 export class StartPage extends PageBase {
   async handleCallbackQueryData() {
@@ -15,7 +15,7 @@ export class StartPage extends PageBase {
   bdefault = {
     show: async (isEdit = true) => {
       await this.clearSession()
-      const kb = this.inlineKeyboardT([RandomNumberPage, SumNumberPage, HelpPage], `2`)
+      const kb = this.inlineKeyboardT([StartRandomPage, SumNumberPage, HelpPage], `2`)
       const da = {userName: this.from?.username}
       await this.renderAutoRich(kb, da, null, null, null, isEdit)
     }
@@ -23,14 +23,14 @@ export class StartPage extends PageBase {
 
   static template = `
     <g-base>
-      <g-keyboard type="inline">🎰 Random Number, ➕ Sum Number, 🆘 Help</g-keyboard>
-      <g-keyboard type="inline" lang="id">🎰 Angka Acak, ➕ Jumlah Angka, 🆘 Bantuan</g-keyboard>
+      <g-keyboard type="inline">🎲 Random, ➕ Sum Number, 🆘 Help</g-keyboard>
+      <g-keyboard type="inline" lang="id">🎲 Acak, ➕ Jumlah Angka, 🆘 Bantuan</g-keyboard>
       <g-message>
         <b>👋 Welcome to the bot {{userName}}</b>
 
         This bot was initially generated using Gramstax as the base setup and starting structure. It provides a clean foundation that can be extended with custom features, commands, and integrations as needed.
 
-        <b>🎰 Random Number</b> - Generate a random number
+        <b>🎲 Random</b> - Generate random numbers or text
         <b>➕ Sum Number</b> - Add two numbers together
         <b>❓ Help</b> - View help and available commands
 
@@ -43,7 +43,7 @@ export class StartPage extends PageBase {
 
         Bot ini dibuat menggunakan Gramstax sebagai generator awal dan struktur dasar. Dari sini, bot dapat dikembangkan lebih lanjut dengan fitur, perintah, dan integrasi sesuai kebutuhan.
 
-        <b>🎰 Angka Acak</b> - Menghasilkan angka secara acak
+        <b>🎲 Acak</b> - Hasilkan angka atau teks acak
         <b>➕ Jumlah Angka</b> - Menjumlahkan dua angka
         <b>❓ Bantuan</b> - Lihat bantuan dan daftar perintah
 

package/dist/src/templates/src/pages/start/random/index.ts

@@ -0,0 +1,38 @@
+import {PageBase} from "~/base/page"
+import {StartPage} from ".."
+import {StartRandomNumberPage} from "./number"
+import {StartRandomTextPage} from "./text"
+
+export class StartRandomPage extends PageBase {
+  async handleCallbackQueryData() {
+    await this.bdefault.show(true)
+  }
+
+  async handleCommandText() {
+    await this.bdefault.show(false)
+  }
+
+  bdefault = {
+    show: async (isEdit = true) => {
+      const kb = this.inlineKeyboardT([StartRandomNumberPage, StartRandomTextPage, StartPage], `2`)
+      await this.renderAutoRich(kb, null, null, null, null, isEdit)
+    }
+  }
+
+  static template = `
+    <g-base>
+      <g-keyboard type="inline">🎲 Random Number, 📝 Random Text, ${this.kbl.back.default}</g-keyboard>
+      <g-keyboard type="inline" lang="id">🎲 Angka Acak, 📝 Teks Acak, ${this.kbl.back.id}</g-keyboard>
+      <g-message>
+        <b>🎲 Random Generator</b>
+
+        Choose what kind of random you want to generate.
+      </g-message>
+      <g-message lang="id">
+        <b>🎲 Generator Acak</b>
+
+        Pilih jenis acak yang ingin dihasilkan.
+      </g-message>
+    </g-base>
+  `
+}

package/dist/src/templates/src/pages/{random-number.ts → start/random/number.ts}

@@ -1,18 +1,14 @@
 import {PageBase} from "~/base/page"
-import {StartPage} from "./start"
+import {StartRandomPage} from "."
 
-export class RandomNumberPage extends PageBase {
+export class StartRandomNumberPage extends PageBase {
   async handleCallbackQueryData() {
     await this.bdefault.show(true)
   }
 
-  async handleCommandText() {
-    await this.bdefault.show(false)
-  }
-
   bdefault = {
     show: async (isEdit = true) => {
-      const kb = this.inlineKeyboardT([this, StartPage])
+      const kb = this.inlineKeyboardT([this, StartRandomPage], `2`)
       const da = {result: Math.random() * 10 ** 18}
       await this.renderAuto(kb, da, null, null, isEdit)
     }

package/dist/src/templates/src/pages/start/random/text.ts

@@ -0,0 +1,98 @@
+import {PageBase} from "~/base/page"
+import {StartRandomPage} from "."
+
+const _WORDS = [
+  `innovation`,
+  `discovery`,
+  `adventure`,
+  `knowledge`,
+  `wisdom`,
+  `curiosity`,
+  `imagination`,
+  `creation`,
+  `exploration`,
+  `inspiration`,
+  `freedom`,
+  `harmony`,
+  `courage`,
+  `patience`,
+  `kindness`,
+  `brilliance`,
+  `serendipity`,
+  `resilience`,
+  `ambition`,
+  `compassion`,
+  `optimism`,
+  `integrity`,
+  `gratitude`,
+  `humility`,
+  `perseverance`
+]
+
+const _ID_WORDS = [
+  `inovasi`,
+  `penemuan`,
+  `petualangan`,
+  `pengetahuan`,
+  `kebijaksanaan`,
+  `rasa ingin tahu`,
+  `imajinasi`,
+  `kreasi`,
+  `eksplorasi`,
+  `inspirasi`,
+  `kemerdekaan`,
+  `keharmonisan`,
+  `keberanian`,
+  `kesabaran`,
+  `kebaikan`,
+  `kecerdasan`,
+  `keberuntungan`,
+  `ketahanan`,
+  `ambisi`,
+  `kasih sayang`,
+  `optimisme`,
+  `integritas`,
+  `rasa syukur`,
+  `kerendahan hati`,
+  `ketekunan`
+]
+
+class Helper {
+  static pickRandom<T>(arr: T[], count: number): T[] {
+    const shuffled = [...arr].sort(() => Math.random() - 0.5)
+    return shuffled.slice(0, count)
+  }
+}
+
+export class StartRandomTextPage extends PageBase {
+  async handleCallbackQueryData() {
+    await this.bdefault.show(true)
+  }
+
+  bdefault = {
+    show: async (isEdit = true) => {
+      const kb = this.inlineKeyboardT([this, StartRandomPage], `2`)
+      const count = Math.floor(Math.random() * 3) + 2 // 2–4 words
+      const lang = this.from.language_code
+      const da = {res: lang === `en` ? Helper.pickRandom(_WORDS, count).join(` `) : lang === `id` ? Helper.pickRandom(_ID_WORDS, count).join(` `) : Helper.pickRandom(_WORDS, count).join(` `)}
+      await this.renderAuto(kb, da, null, null, isEdit)
+    }
+  }
+
+  static template = `
+    <g-base>
+      <g-keyboard type="inline">🔁 Regenerate, ${this.kbl.back.default}</g-keyboard>
+      <g-keyboard type="inline" lang="id">🔁 Regenerasi, ${this.kbl.back.id}</g-keyboard>
+      <g-message>
+        <b>📝 Random Text</b>
+
+        {{res}}
+      </g-message>
+      <g-message lang="id">
+        <b>📝 Teks Acak</b>
+
+        {{res}}
+      </g-message>
+    </g-base>
+  `
+}

package/dist/src/templates/src/pages/{general-status.ts → status.ts}

@@ -2,7 +2,7 @@ import {LogHe} from "~/helpers/log"
 import {PageBase} from "~/base/page"
 import {StartPage} from "./start"
 
-export class GeneralStatusPage extends PageBase {
+export class StatusPage extends PageBase {
   constructorName?: string
 
   constructor(p: any) {
@@ -21,7 +21,7 @@ export class GeneralStatusPage extends PageBase {
     }
   }
 
-  berrorNotFound = {
+  bnotFound = {
     show: async () => {
       const kb = this.inlineKeyboardT([StartPage])
       const da = {isNotFound: true}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-gramstax",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "private": false,
   "publishConfig": {
     "access": "public",