@ismaelsoilet/synapsejs 1.9.0 → 1.11.1

package/src/compiler/client-bundler.ts

@@ -17,6 +17,7 @@ import * as path from 'path';
 import { Err, Ok, type Result } from '../core/machine-types';
 import { clientEntrySource } from '../runtime/client-entry';
 import { isComponent } from '../runtime/discovery-rules';
+import { SYNAPSE_VERSION } from '../version';
 import { findSliceFiles, resolveSlicesDir, type SlicesDirError } from './slice-discovery';
 import { artifactDirectory, splitSlice, verifySplit, writeSplitArtifacts } from './slice-splitter';
 
@@ -61,6 +62,29 @@ export function clientManifestPath(baseDir: string): string {
   return path.join(baseDir, '.synapse', 'client', 'manifest.json');
 }
 
+export async function buildCssBundle(baseDir: string): Promise<Result<{ path: string; bytes: number }, BuildError>> {
+  const clientDir = path.join(baseDir, '.synapse/client');
+  fs.mkdirSync(clientDir, { recursive: true });
+  const outPath = path.join(clientDir, 'synapse.css');
+
+  const sourceCssCandidates = [
+    path.join(baseDir, 'public/synapse.css'),
+    path.join(baseDir, 'src/styles/synapse.css'),
+    path.join(baseDir, 'src/styles/main.css')
+  ];
+
+  for (const src of sourceCssCandidates) {
+    if (fs.existsSync(src)) {
+      const content = fs.readFileSync(src, 'utf-8');
+      fs.writeFileSync(outPath, content, 'utf-8');
+      return Ok({ path: outPath, bytes: Buffer.byteLength(content, 'utf-8') });
+    }
+  }
+
+  // No source means no stylesheet: the framework does not impose a theme.
+  return Ok({ path: outPath, bytes: 0 });
+}
+
 export async function buildVendorBundle(
   baseDir: string,
   vendorPackages: string[] = []
@@ -72,6 +96,7 @@ export async function buildVendorBundle(
   const extraExports = (vendorPackages || []).map((pkg) => `export * from '${pkg}';`).join('\n');
 
   const vendorEntryContent = [
+    `// SynapseJS Client Vendor Entry - Framework v${SYNAPSE_VERSION}`,
     `import React from 'react';`,
     `import * as ReactDOM from 'react-dom';`,
     `import * as ReactDOMClient from 'react-dom/client';`,
@@ -114,6 +139,30 @@ export async function buildVendorBundle(
     `  Children,`,
     `  startTransition`,
     `} = (React as unknown as Record<string, unknown>);`,
+    `const {`,
+    `  Badge,`,
+    `  Button,`,
+    `  Card,`,
+    `  DataForm,`,
+    `  DataTable,`,
+    `  Drawer,`,
+    `  DropdownItem,`,
+    `  DropdownMenu,`,
+    `  Modal,`,
+    `  Pagination,`,
+    `  Tab,`,
+    `  TabList,`,
+    `  TabPanel,`,
+    `  Tabs,`,
+    `  ToastProvider,`,
+    `  useToast,`,
+    `  SynapseProvider,`,
+    `  useAction,`,
+    `  useLoaderData,`,
+    `  useSubscription,`,
+    `  useWebSocket,`,
+    `  rpcCall`,
+    `} = (SynapseClient as unknown as Record<string, unknown>);`,
     `export {`,
     `  ReactDOM,`,
     `  ReactDOMClient,`,
@@ -146,7 +195,29 @@ export async function buildVendorBundle(
     `  memo,`,
     `  forwardRef,`,
     `  Children,`,
-    `  startTransition`,
+    `  startTransition,`,
+    `  Badge,`,
+    `  Button,`,
+    `  Card,`,
+    `  DataForm,`,
+    `  DataTable,`,
+    `  Drawer,`,
+    `  DropdownItem,`,
+    `  DropdownMenu,`,
+    `  Modal,`,
+    `  Pagination,`,
+    `  Tab,`,
+    `  TabList,`,
+    `  TabPanel,`,
+    `  Tabs,`,
+    `  ToastProvider,`,
+    `  useToast,`,
+    `  SynapseProvider,`,
+    `  useAction,`,
+    `  useLoaderData,`,
+    `  useSubscription,`,
+    `  useWebSocket,`,
+    `  rpcCall`,
     `};`,
     ``
   ].join('\n');
@@ -160,7 +231,28 @@ export async function buildVendorBundle(
   fs.mkdirSync(buildDir, { recursive: true });
   const vendorFile = path.join(buildDir, VENDOR_BUNDLE_NAME);
 
-  if (fs.existsSync(vendorFile) && existingEntry === vendorEntryContent) {
+  let isVendorStale = false;
+  if (fs.existsSync(vendorFile)) {
+    const vendorMtime = fs.statSync(vendorFile).mtimeMs;
+    try {
+      const localClientPath = path.resolve(__dirname, '../client.ts');
+      if (fs.existsSync(localClientPath) && fs.statSync(localClientPath).mtimeMs > vendorMtime) {
+        isVendorStale = true;
+      }
+      const localComponentsPath = path.resolve(__dirname, '../client/components.tsx');
+      if (fs.existsSync(localComponentsPath) && fs.statSync(localComponentsPath).mtimeMs > vendorMtime) {
+        isVendorStale = true;
+      }
+      const pkgJsonPath = path.join(baseDir, 'package.json');
+      if (fs.existsSync(pkgJsonPath) && fs.statSync(pkgJsonPath).mtimeMs > vendorMtime) {
+        isVendorStale = true;
+      }
+    } catch {
+      // ignore stat errors
+    }
+  }
+
+  if (fs.existsSync(vendorFile) && existingEntry === vendorEntryContent && !isVendorStale) {
     return Ok({
       sliceKey: '_vendor',
       url: VENDOR_BUNDLE_URL,

package/src/compiler/context-bench.ts

@@ -22,6 +22,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import * as ts from 'typescript';
+import { assertCompilerApi } from './typescript-api';
 
 export const TOKENS_PER_BYTE_ESTIMATE = 0.25;
 
@@ -149,6 +150,7 @@ interface BenchConfig {
 }
 
 export function measureAppSurface(appRoot: string): AppSurface {
+  assertCompilerApi();
   const configPath = path.join(appRoot, 'bench.config.json');
   if (!fs.existsSync(configPath)) {
     throw new Error(`bench.config.json ausente em ${appRoot}`);

package/src/compiler/contract.ts

@@ -242,7 +242,7 @@ export function machineContract(): MachineContract {
     },
     scaffolding: {
       command:
-        'synapse new-slice <domain> <name> [--template=<template>] [--fields=<grammar>] · synapse new-shared <name> · synapse new <project>',
+        'synapse new-slice <domain> <name> [--template=<template>] [--fields=<grammar>] · synapse new-shared <name> · synapse new-domain <domain> [--fields=<grammar>] · synapse new <project>',
       containment: `The domain, the slice name, the shared-module name and the new-project directory are each one safe path segment (pattern ${PATH_SEGMENT_PATTERN}), and before anything is written the resolved target is asserted to stay inside the directory the operation owns. A field name in --fields must be a plain identifier before it is interpolated into the generated DDL or TypeScript. Every containment failure is printed as JSON on standard output with a non-zero exit code.`,
       failureCodes: { ...SCAFFOLD_FAILURE_CODES }
     },

package/src/compiler/oracle-runner.ts

@@ -156,6 +156,8 @@ export function oracleWrapperSource(importPath: string, sliceName: string): stri
 export interface OracleRunOptions {
   /** Injected by tests: runs a command and returns its exit code and output. */
   spawn?: (args: string[], cwd: string) => Promise<{ exitCode: number; output: string }>;
+  /** Optional target slice name or pattern to run tests exclusively for */
+  targetSlice?: string;
   /** Enable Jev System One semantic test triage on failures. Default: true */
   /**
    * Opt-in (default: disabled). The triage consults an external model provider when
@@ -196,7 +198,14 @@ export async function runSliceOracles(
   }
 
   const slicesDir = resolution.value.slicesDir;
-  const sliceFiles = findSliceFiles(slicesDir);
+  const allSliceFiles = findSliceFiles(slicesDir);
+  const targetSlice = options.targetSlice;
+  const sliceFiles = targetSlice
+    ? allSliceFiles.filter((f) => {
+        const name = path.basename(f, '.slice.tsx');
+        return name === targetSlice || f.includes(targetSlice);
+      })
+    : allSliceFiles;
   const oraclesDir = path.join(root, '.synapse', ORACLE_DIR_NAME);
   const reportPath = path.join(oraclesDir, 'report.xml');
 

package/src/compiler/scaffolder.ts

@@ -58,10 +58,9 @@ import {
   Ok,
   Err,
   MockDatabaseClient,
-  type SessionContext,
-  DataForm,
-  Card
+  type SessionContext
 } from 'synapsejs';
+import { DataForm, type FormField, Card } from 'synapsejs/client';
 
 // ============================================================================
 // 1. CONTRATO DE ENTRADA JIT (TypeBox)
@@ -128,7 +127,7 @@ export interface ${pascal}TriggerProps {
   onSubmitAction?: (payload: unknown) => Promise<${outputTypeName}>;
 }
 
-const FORM_FIELDS = ${formFields};
+const FORM_FIELDS: FormField[] = ${formFields};
 
 export function ${triggerName}({ onSubmitAction }: ${pascal}TriggerProps) {
   const [feedback, setFeedback] = useState<string | null>(null);
@@ -426,6 +425,7 @@ export type ScaffoldErrorCode =
   | SlicesDirErrorCode
   | 'SLICE_EXISTS'
   | 'WRITE_FAILED'
+  | 'PARTIAL_WRITE'
   | 'INVALID_PATH_SEGMENT'
   | 'INVALID_FIELD_NAME';
 
@@ -440,6 +440,8 @@ export const SCAFFOLD_FAILURE_CODES: Record<ScaffoldErrorCode, string> = {
     'more than one application owns a slices directory; set SYNAPSE_ROOT or run inside the target application',
   SLICE_EXISTS: 'the target file already exists',
   WRITE_FAILED: 'the filesystem refused the write',
+  PARTIAL_WRITE:
+    'a domain scaffolding operation failed and one or more files could not be removed; candidates lists what remains',
   INVALID_PATH_SEGMENT:
     'a domain, slice name, shared-module name or project directory is not a single safe path segment',
   INVALID_FIELD_NAME: 'a field name or enum value in --fields is not a plain identifier'
@@ -684,6 +686,113 @@ export async function executeShared${pascalName}(
   }
 }
 
+/**
+ * Scaffolds an entire modular domain directory with domain layout (_layout.tsx),
+ * an initial listing slice (listar-<domain>.slice.tsx), and shared module (src/shared/<domain>.ts).
+ */
+export function scaffoldDomain(
+  domain: string,
+  baseDir: string = process.cwd(),
+  fieldsSpec?: string
+): Result<string[], ScaffoldError> {
+  const domainRejection = segmentRejection('domain', domain, 'o domínio');
+  if (domainRejection) return Err(domainRejection);
+
+  const target = resolveScaffoldTarget(baseDir);
+  if (!target.ok) return Err(target.error);
+
+  const domainDir = path.join(target.value, domain);
+  const layoutFile = path.join(domainDir, '_layout.tsx');
+  const domainDirExisted = fs.existsSync(domainDir);
+  const createdFiles: string[] = [];
+
+  const fail = (error: ScaffoldError): Result<string[], ScaffoldError> => {
+    const cleanupFailures: string[] = [];
+
+    for (const file of [...createdFiles].reverse()) {
+      try {
+        fs.rmSync(file, { force: true });
+      } catch {
+        cleanupFailures.push(file);
+      }
+    }
+
+    if (!domainDirExisted) {
+      try {
+        fs.rmdirSync(domainDir);
+      } catch {
+        if (fs.existsSync(domainDir)) {
+          cleanupFailures.push(domainDir);
+        }
+      }
+    }
+
+    if (cleanupFailures.length > 0) {
+      return Err({
+        code: 'PARTIAL_WRITE',
+        message: `${error.code}: ${error.message}; não foi possível remover: ${cleanupFailures.join(', ')}`,
+        candidates: cleanupFailures
+      });
+    }
+
+    return Err(error);
+  };
+
+  try {
+    fs.mkdirSync(domainDir, { recursive: true });
+
+    // 1. Domain layout if not exists
+    if (!fs.existsSync(layoutFile)) {
+      const pascalDomain = toPascalCase(domain);
+      const layoutContent = `import React, { type ReactNode } from 'react';
+
+export default function ${pascalDomain}DomainLayout({ children }: { children: ReactNode; url?: string; session?: any }) {
+  return (
+    <div className="flex flex-col flex-1 w-full min-h-full">
+      <header className="border-b border-slate-800 bg-slate-900/60 backdrop-blur px-6 py-4 flex items-center justify-between">
+        <div>
+          <div className="text-xs uppercase tracking-wider text-cyan-400 font-semibold">Domínio</div>
+          <h2 className="text-xl font-bold text-slate-100 capitalize">${domain}</h2>
+        </div>
+        <nav className="flex gap-4 text-sm font-medium">
+          <a href="/${domain}/listar-${domain}" className="text-slate-300 hover:text-cyan-400 transition-colors">Listagem</a>
+        </nav>
+      </header>
+      <main className="flex-1 p-6 max-w-7xl w-full mx-auto">
+        {children}
+      </main>
+    </div>
+  );
+}
+`;
+      fs.writeFileSync(layoutFile, layoutContent, 'utf-8');
+      createdFiles.push(layoutFile);
+    }
+
+    // 2. Initial List Slice
+    const listSliceRes = scaffoldSlice(domain, `listar-${domain}`, baseDir, 'list', fieldsSpec);
+    if (!listSliceRes.ok) {
+      return fail(listSliceRes.error);
+    }
+    createdFiles.push(listSliceRes.value);
+
+    // 3. Shared module
+    const sharedRes = scaffoldShared(domain, baseDir);
+    if (!sharedRes.ok) {
+      return fail(sharedRes.error);
+    }
+    createdFiles.push(sharedRes.value);
+  } catch (err) {
+    return fail({
+      code: 'WRITE_FAILED',
+      message: err instanceof Error ? err.message : String(err),
+      candidates: [domainDir]
+    });
+  }
+
+  return Ok(createdFiles);
+}
+
 if (import.meta.main) {
   const domain = process.argv[2] || 'core';
   const name = process.argv[3] || 'example-feature';

package/src/compiler/slice-splitter.ts

@@ -40,6 +40,7 @@ export interface SplitArtifact {
 export interface SplitResult {
   sliceName: string;
   artifacts: SplitArtifact[];
+  lineCount?: number;
 }
 
 export type SplitErrorCode =
@@ -86,7 +87,11 @@ export const SERVER_ONLY_PATTERNS: Array<{ label: string; pattern: RegExp }> = [
   { label: 'CREATE TABLE statement', pattern: /\bCREATE\s+TABLE\b/i },
   { label: 'ALTER TABLE statement', pattern: /\bALTER\s+TABLE\b/i },
   { label: 'DROP TABLE statement', pattern: /\bDROP\s+TABLE\b/i },
-  { label: 'database call', pattern: /\bdb\s*\.\s*(?:query|findMany|findOne|insert|update|delete|sql|sqlOne)\b/ },
+  {
+    label: 'database call',
+    pattern:
+      /\bdb\s*\.\s*(?:query|queryOne|findMany|findOne|insert|update|delete|sql|sqlOne|aggregate|count|exists|transaction)\b/
+  },
   { label: 'sliceSchema symbol', pattern: /\bsliceSchema\b/ },
   { label: 'test runner import', pattern: /from\s+['"]bun:test['"]/ },
   { label: 'process.env access', pattern: /\bprocess\s*(?:\.\s*env|\[\s*['"]env['"]\s*\])/ },
@@ -818,7 +823,8 @@ export function splitSlice(sliceFilePath: string, baseDir: string = process.cwd(
     )
   });
 
-  return Ok({ sliceName, artifacts });
+  const lineCount = sourceFile.text.split('\n').length;
+  return Ok({ sliceName, artifacts, lineCount });
 }
 
 export function writeSplitArtifacts(result: SplitResult, outDir: string): string[] {
@@ -899,8 +905,20 @@ export function verifySplit(result: SplitResult, outDir: string): SplitVerificat
     }
   }
 
+  if (result.lineCount && result.lineCount > 500) {
+    diagnostics.push({
+      file: `${result.sliceName}.slice.tsx`,
+      line: 1,
+      column: 1,
+      code: 'WARN_LARGE_SLICE',
+      message: `Fatia excede 500 linhas (${result.lineCount} linhas). Para manter alta densidade sem sobrecarregar agentes de IA e humanos, considere decompor este domínio em sub-fatias de intenção de negócio com <SubSlice> e src/shared/ (consulte docs/arquitetura-sistemas-grandes.pt-BR.md).`
+    });
+  }
+
+  const hasErrors = diagnostics.some((d) => !d.code.startsWith('WARN_'));
+
   return {
-    status: diagnostics.length === 0 && leaks.length === 0 ? 'PASS' : 'FAIL',
+    status: !hasErrors && leaks.length === 0 ? 'PASS' : 'FAIL',
     diagnostics,
     leaks
   };