@teispace/next-maker 3.0.2 → 3.0.4

package/dist/src/services/setup/validate-scripts/index.d.ts

@@ -1,3 +0,0 @@
-export { addValidationScripts, type PackageJsonShape, } from './package-modifier';
-export { CHECK_DEPRECATED_SCRIPT, SYNC_ENV_SCRIPT } from './scripts';
-export declare const setupValidationScripts: (projectPath: string) => Promise<void>;

package/dist/src/services/setup/validate-scripts/package-modifier.d.ts

@@ -1,18 +0,0 @@
-import type { PackageManager } from '../../../core/package-manager';
-/**
- * Pure modifiers for the package.json `scripts` block — separated from the
- * service so they can be unit-tested without touching the filesystem.
- */
-export interface PackageJsonShape {
-    scripts?: Record<string, string>;
-    devDependencies?: Record<string, string>;
-    [key: string]: unknown;
-}
-/**
- * Add the validation scripts (env:sync, check:deprecated, validate) and the
- * matching tsx/typescript dev-deps, never overwriting a user-defined entry.
- *
- * Returns a *new* package.json object — callers pass it through `updateJson`
- * which already understands "function returns the new value".
- */
-export declare const addValidationScripts: (pkg: PackageJsonShape, manager: PackageManager) => PackageJsonShape;

package/dist/src/services/setup/validate-scripts/scripts.d.ts

@@ -1,11 +0,0 @@
-/**
- * Source for the two validation scripts the starter ships under `scripts/`.
- *
- * Inlined here (not fetched from the starter via degit) because (a) these
- * scripts are stable and don't drift, (b) we get instant offline retrofits,
- * and (c) the diff between starter and next-maker is small enough to spot
- * during release reviews. If they ever start to differ, switch this module
- * to a degit fetch — the rest of the service won't need to change.
- */
-export declare const SYNC_ENV_SCRIPT = "import * as fs from 'node:fs';\nimport * as path from 'node:path';\n\nconst checkOnly = process.argv.includes('--check');\n\nconst envPath = path.join(process.cwd(), '.env');\nconst examplePath = path.join(process.cwd(), '.env.example');\n\nif (!fs.existsSync(envPath)) {\n  console.log('\u26A0\uFE0F  No .env file found. Skipping sync.');\n  process.exit(0);\n}\n\nconst envContent = fs.readFileSync(envPath, 'utf-8');\nconst lines = envContent.split('\\n');\n\nlet isPublicBlock = false;\n\nconst exampleLines = lines.map((line) => {\n  const trimmed = line.trim();\n\n  // Preserve empty lines and reset public block state\n  if (!trimmed) {\n    isPublicBlock = false;\n    return line;\n  }\n\n  // Preserve comments\n  if (trimmed.startsWith('#')) {\n    if (line.toLowerCase().includes('-public')) {\n      isPublicBlock = true;\n    }\n    return line;\n  }\n\n  // Parse KEY=VALUE\n  const match = line.match(/^([^=]+)=(.*)$/);\n\n  if (match) {\n    const key = match[1];\n\n    // Public marker: explicit \"# -public\" comment, or \"KEY=VAL # -public\"\n    if (isPublicBlock || line.toLowerCase().includes('-public')) {\n      isPublicBlock = false;\n      return line;\n    }\n\n    isPublicBlock = false;\n    return `${key}=`;\n  }\n\n  isPublicBlock = false;\n  return line;\n});\n\nconst newExampleContent = exampleLines.join('\\n');\n\nlet currentExampleContent = '';\nif (fs.existsSync(examplePath)) {\n  currentExampleContent = fs.readFileSync(examplePath, 'utf-8');\n}\n\nif (currentExampleContent === newExampleContent) {\n  console.log('\u2728 .env.example is already up to date');\n  process.exit(0);\n}\n\nif (checkOnly) {\n  console.error('\u274C .env.example is out of sync with .env. Run \"yarn env:sync\" to update.');\n  process.exit(1);\n}\n\nfs.writeFileSync(examplePath, newExampleContent);\nconsole.log('\u2705 Synchronized .env.example with .env');\n";
-export declare const CHECK_DEPRECATED_SCRIPT = "/**\n * Walks every identifier in the project and flags any whose resolved TypeScript\n * symbol carries a `@deprecated` JSDoc tag. Catches deprecated API usage that\n * `tsc --noEmit` does not surface (deprecations are \"suggestion\"-level, not\n * errors) and that Biome does not yet detect.\n *\n * Exits 1 if any deprecated usage is found (so it can gate CI).\n */\nimport path from 'node:path';\nimport ts from 'typescript';\n\nconst cwd = process.cwd();\nconst configPath = ts.findConfigFile(cwd, ts.sys.fileExists, 'tsconfig.json');\n\nif (!configPath) {\n  console.error('tsconfig.json not found');\n  process.exit(1);\n}\n\nconst raw = ts.readConfigFile(configPath, ts.sys.readFile).config;\nconst parsed = ts.parseJsonConfigFileContent(raw, ts.sys, path.dirname(configPath));\n\nconst program = ts.createProgram({\n  rootNames: parsed.fileNames,\n  options: parsed.options,\n});\n\nconst checker = program.getTypeChecker();\n\nfunction isDeprecated(sym: ts.Symbol | undefined): boolean {\n  if (!sym) return false;\n  return sym.getJsDocTags(checker).some((tag) => tag.name === 'deprecated');\n}\n\nlet hits = 0;\n\nfor (const sourceFile of program.getSourceFiles()) {\n  if (sourceFile.fileName.includes('node_modules')) continue;\n  if (!sourceFile.fileName.startsWith(cwd)) continue;\n\n  const visit = (node: ts.Node): void => {\n    if (ts.isIdentifier(node)) {\n      const sym = checker.getSymbolAtLocation(node);\n      if (isDeprecated(sym)) {\n        const { line, character } = sourceFile.getLineAndCharacterOfPosition(node.getStart());\n        console.log(\n          `${path.relative(cwd, sourceFile.fileName)}:${line + 1}:${character + 1}  ${node.text}  (@deprecated)`,\n        );\n        hits++;\n      }\n    }\n    ts.forEachChild(node, visit);\n  };\n\n  visit(sourceFile);\n}\n\nif (hits === 0) {\n  console.log('\u2713 No deprecated API usage found.');\n  process.exit(0);\n}\n\nconsole.log(`\\n${hits} deprecated symbol use(s) found.`);\nprocess.exit(1);\n";

package/dist/src/services/setup/ws/assets.d.ts

@@ -1,20 +0,0 @@
-import type { Ora } from 'ora';
-export declare const fetchAssets: (tempDir: string, spinner: Ora) => Promise<void>;
-/**
- * Copy the entire WS subtree + the connection-state slice. The subtree is
- * package-managed code (not a user-edit surface) so it's always overwritten.
- *
- * `keepTests=false` strips `*.test.ts(x)` files and the `__test-utils__/`
- * helper directory so projects without vitest don't carry dead test files.
- * The strip is applied AFTER the recursive copy because cherry-picking files
- * with `fs.cp` filters is awkward and slow on this small a tree.
- */
-export declare const copyWsFiles: (projectPath: string, tempDir: string, options: {
-    keepTests: boolean;
-}) => Promise<void>;
-/**
- * Walk the copied ws/ tree and remove `*.test.ts`, `*.test.tsx`, and the
- * `__test-utils__/` directory. Used when the project doesn't have vitest —
- * orphan test files generate IDE noise and never run.
- */
-export declare const stripWsTestArtifacts: (wsRoot: string) => Promise<void>;

package/dist/src/services/setup/ws/checks.d.ts

@@ -1,17 +0,0 @@
-export type WsSetupStatus = {
-    isSetup: boolean;
-    reason?: string;
-};
-/**
- * Reports `isSetup: true` when the ws directory is already on disk —
- * matches the dual-signal check `detectProjectSetup` uses, but doesn't
- * require the dep to be resolved (the setup service installs the dep
- * itself, so we don't want to gate on it).
- */
-export declare const checkIsAlreadySetup: (projectPath: string) => Promise<WsSetupStatus>;
-/**
- * WS layer depends on Redux: the bridge dispatches into `wsReducer`, and
- * `src/store/rootReducer.ts` is the file we register the reducer in. Fail
- * loud before any files are copied so the user can run `setup --redux` first.
- */
-export declare const validateProjectStructure: (projectPath: string) => Promise<void>;

package/dist/src/services/setup/ws/index.d.ts

@@ -1,20 +0,0 @@
-/**
- * Set up the WebSocket transport layer in an existing project.
- *
- * Pre-requisites validated up front: Redux must be installed (the bridge
- * dispatches into a Redux slice). On a fresh install the orchestrator
- * fails fast with guidance to run `setup --redux` first rather than
- * leaving a half-applied state.
- *
- * Steps:
- *   1. pre-check (skip if ws/ already exists)
- *   2. validate Redux is present
- *   3. degit the starter into a tempdir
- *   4. copy ws/ subtree + wsReducer slice (strip *.test.ts when no vitest)
- *   5. wire wsReducer into rootReducer (no persist — connection state is ephemeral)
- *   6. mount attachWsBridge inside StoreProvider's useEffect
- *   7. ensure test/setup.ts has the react-secure-storage + server-only mocks
- *   8. install socket.io-client (pinned to ^4.8.3 — backend protocol match)
- *   9. format via `lint:fix`
- */
-export declare const setupWs: (projectPath: string) => Promise<void>;

package/dist/src/services/setup/ws/injectors.d.ts

@@ -1,56 +0,0 @@
-/**
- * Register `wsReducer` in `src/store/rootReducer.ts` WITHOUT wrapping it in
- * `persistReducer` — connection state is ephemeral and rehydrating it would
- * lie about the actual transport. Delegates to the existing root-reducer
- * modifier; passing `persist: false` produces the same shape the template ships.
- */
-export declare const registerWsReducer: (projectPath: string) => Promise<void>;
-/**
- * Pure helper: insert the `attachWsBridge` import + useEffect block into a
- * StoreProvider.tsx source string. Idempotent — bails when the import is
- * already present.
- *
- * The bridge effect mounts immediately after the `if (!storeRef.current) {...}`
- * initialiser, matching the template. We anchor on the closing brace of that
- * block to preserve any pre-existing effects further down (a user may have
- * added unrelated mount logic).
- */
-export declare const injectBridgeMount: (content: string) => string;
-/**
- * Reverse of `injectBridgeMount`. Drops the import + effect block, and also
- * prunes `useEffect` from the React import when no other `useEffect(` call
- * survives (so we don't leave an unused-import lint error).
- *
- * Anchored on **stable code tokens** — the import path `@/lib/utils/ws` and
- * the function name `attachWsBridge` — not the comment wording. Upstream
- * comment drift won't silently break strip.
- */
-export declare const stripBridgeMount: (content: string) => string;
-/**
- * Filesystem-bound install/strip pair.
- */
-export declare const installBridgeMount: (projectPath: string) => Promise<void>;
-export declare const removeBridgeMount: (projectPath: string) => Promise<void>;
-/**
- * Append `react-secure-storage` and `server-only` mocks to `test/setup.ts`
- * if either is missing. The template ships them by default; this helper
- * covers the case where the user has customised setup.ts after init.
- *
- * No-op when `test/setup.ts` doesn't exist (vitest isn't installed).
- */
-export declare const ensureTestSetupMocks: (projectPath: string) => Promise<void>;
-/**
- * Pure helper: strip the `wsReducer` import + `ws: wsReducer,` entry from a
- * rootReducer.ts source string. Also removes the JSDoc block above
- * `combineReducers` that explains why `ws` is unwrapped (misleading once the
- * entry is gone). Idempotent — re-applying is a no-op on clean input.
- *
- * Used by both `cleanupWs` (init-time opt-out) and the WS manifest's
- * `removePattern` (so `remove ws` auto-strips instead of surfacing as
- * manual cleanup).
- *
- * Anchored on stable code tokens (`wsReducer`, the import path, and the
- * `ws` + `persistReducer` keywords inside the JSDoc) rather than literal
- * comment text — upstream comment rewording doesn't break it.
- */
-export declare const stripWsReducerRegistration: (content: string) => string;