create-caspian-app 0.0.1

package/dist/src/app/error.html

@@ -0,0 +1,130 @@
+<div class="container py-10">
+  <div class="max-w-2xl mx-auto bg-white shadow-sm rounded p-6">
+    <div class="flex items-start gap-4">
+      <svg
+        class="w-10 h-10 text-red-600"
+        viewBox="0 0 24 24"
+        fill="none"
+        xmlns="http://www.w3.org/2000/svg"
+        aria-hidden
+      >
+        <path
+          d="M11.001 2a1 1 0 0 1 .998 0L21 7v9a3 3 0 0 1-3 3H6a3 3 0 0 1-3-3V7l8.001-5z"
+          stroke="currentColor"
+          stroke-width="1.5"
+          stroke-linecap="round"
+          stroke-linejoin="round"
+        />
+        <path
+          d="M12 8v4"
+          stroke="currentColor"
+          stroke-width="1.5"
+          stroke-linecap="round"
+          stroke-linejoin="round"
+        />
+        <path
+          d="M12 16h.01"
+          stroke="currentColor"
+          stroke-width="1.5"
+          stroke-linecap="round"
+          stroke-linejoin="round"
+        />
+      </svg>
+
+      <div class="flex-1">
+        <h1 class="text-2xl font-semibold text-red-600">
+          Something went wrong
+        </h1>
+        <p class="mt-2 text-sm text-gray-600">
+          We're sorry — an unexpected error occurred. Try reloading or return to
+          the homepage.
+        </p>
+
+        <p class="mt-3 text-sm text-gray-700">[[error_message]]</p>
+
+        <div class="mt-4 flex flex-wrap gap-2">
+          <a
+            href="/"
+            class="inline-block px-3 py-1.5 bg-gray-100 border border-gray-200 rounded text-sm text-gray-800 hover:bg-gray-200"
+            >Home</a
+          >
+          <button
+            class="inline-block px-3 py-1.5 bg-blue-600 text-white rounded text-sm"
+            onclick="reloadPage()"
+          >
+            Reload
+          </button>
+          [% if error_trace %]
+          <button
+            id="toggleTraceBtn"
+            class="inline-block px-3 py-1.5 bg-transparent border border-gray-200 rounded text-sm text-black"
+            onclick="setShowTrace(showTrace => !showTrace)"
+          >
+            {showTrace ? "Hide details" : "Show details"}
+          </button>
+          [% endif %]
+        </div>
+      </div>
+    </div>
+
+    [% if error_trace %]
+    <div id="traceArea" class="mt-4" hidden="{!showTrace}">
+      <div class="flex items-center justify-between mb-2">
+        <div class="text-xs text-gray-500">Error details (soft copy)</div>
+        <div class="flex gap-2">
+          <button
+            class="px-2 py-1 text-xs bg-gray-100 border rounded text-black"
+            onclick="copyTrace()"
+          >
+            {showCopyTrace ? "Copied" : "Copy"}
+          </button>
+          <button
+            class="px-2 py-1 text-xs bg-gray-100 border rounded text-black"
+            onclick="downloadTrace()"
+          >
+            Download
+          </button>
+        </div>
+      </div>
+      <pre
+        id="tracePre"
+        class="p-4 bg-gray-100 rounded overflow-auto text-xs text-black"
+      >[[error_trace]]</pre>
+    </div>
+    [% endif %]
+  </div>
+</div>
+
+<script>
+  const [showTrace, setShowTrace] = pp.state(false);
+  const [showCopyTrace, setShowCopyTrace] = pp.state(false);
+
+  function reloadPage() {
+    window.location.reload();
+  }
+
+  function copyTrace() {
+    const tracePre = document.getElementById("tracePre");
+    navigator.clipboard.writeText(tracePre.innerText);
+
+    setShowCopyTrace(true);
+    setTimeout(() => {
+      setShowCopyTrace(false);
+    }, 2000);
+  }
+
+  function downloadTrace() {
+    const tracePre = document.getElementById("tracePre");
+    const blob = new Blob([tracePre.innerText], {
+      type: "text/plain",
+    });
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = "error_trace.txt";
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+    URL.revokeObjectURL(url);
+  }
+</script>

package/dist/src/app/globals.css

@@ -0,0 +1,24 @@
+@import "tailwindcss";
+
+:root {
+  --background: #ffffff;
+  --foreground: #171717;
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: #0a0a0a;
+    --foreground: #ededed;
+  }
+}
+
+body {
+  background: var(--background);
+  color: var(--foreground);
+  font-family: Arial, Helvetica, sans-serif;
+}

package/dist/src/app/index.html

@@ -0,0 +1,159 @@
+<div
+  class="min-h-screen bg-background text-foreground selection:bg-primary/30 flex flex-col items-center justify-between py-8 md:py-12 px-6 md:px-24 overflow-x-hidden relative"
+>
+  <div class="fixed inset-0 bg-grid -z-20 opacity-[0.15]"></div>
+  <div class="fixed inset-0 glow-conic -z-10 translate-y-[-20%]"></div>
+
+  <div
+    class="z-10 w-full max-w-5xl items-center justify-between font-mono text-sm lg:flex"
+  >
+    <p
+      class="fixed left-0 top-0 flex w-full justify-center border-b border-border bg-background/80 pb-6 pt-8 backdrop-blur-2xl dark:border-neutral-800 dark:bg-zinc-800/30 dark:from-inherit lg:static lg:w-auto lg:rounded-xl lg:border lg:bg-muted/30 lg:p-4 lg:dark:bg-zinc-800/30"
+    >
+      Get started by editing&nbsp;
+      <code class="font-bold text-primary">src/app/index.html</code>
+    </p>
+
+    <div
+      class="fixed bottom-0 left-0 flex h-48 w-full items-end justify-center bg-linear-to-t from-background via-background lg:static lg:h-auto lg:w-auto lg:bg-none"
+    >
+      <a
+        href="https://github.com/TheSteelNinjaCode/create-caspian-app"
+        target="_blank"
+        rel="noreferrer"
+        class="pointer-events-auto flex place-items-center gap-2 p-8 lg:p-0 hover:text-primary transition-colors"
+      >
+        <span class="font-brand text-xs font-bold tracking-widest"
+          >BUILT WITH CASPIAN</span
+        >
+
+        <svg
+          xmlns="http://www.w3.org/2000/svg"
+          viewBox="0 0 24 24"
+          class="h-5 w-5"
+          fill="currentColor"
+          aria-hidden="true"
+        >
+          <path
+            d="M12 2C6.477 2 2 6.486 2 12.02c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.866-.013-1.7-2.782.605-3.369-1.343-3.369-1.343-.454-1.157-1.109-1.466-1.109-1.466-.907-.62.069-.608.069-.608 1.003.071 1.531 1.033 1.531 1.033.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.952 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.27.098-2.646 0 0 .84-.27 2.75 1.026A9.56 9.56 0 0 1 12 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.748-1.026 2.748-1.026.546 1.376.202 2.393.1 2.646.64.7 1.028 1.595 1.028 2.688 0 3.849-2.339 4.695-4.566 4.944.359.31.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.579.688.481A10.02 10.02 0 0 0 22 12.02C22 6.486 17.523 2 12 2z"
+          />
+        </svg>
+      </a>
+    </div>
+  </div>
+
+  <div
+    class="relative flex flex-col items-center justify-center gap-6 z-10 before:absolute before:h-75 before:w-120 before:-translate-x-1/2 before:rounded-full before:bg-linear-to-br before:from-transparent before:to-primary before:opacity-10 before:blur-2xl before:content-[''] before:max-w-full after:absolute after:-z-20 after:h-45 after:w-60 after:translate-x-1/3 after:bg-linear-to-t after:from-cyan-300 after:via-primary after:opacity-20 after:blur-2xl after:content-[''] after:max-w-full"
+  >
+    <div
+      class="relative flex flex-col items-center justify-center gap-6 z-10 pt-24 lg:pt-0 before:absolute before:h-75 before:w-120 before:-translate-x-1/2 before:rounded-full before:bg-linear-to-br before:from-transparent before:to-primary before:opacity-10 before:blur-2xl before:content-[''] before:max-w-full after:absolute after:-z-20 after:h-45 after:w-60 after:translate-x-1/3 after:bg-linear-to-t after:from-cyan-300 after:via-primary after:opacity-20 after:blur-2xl after:content-[''] after:max-w-full"
+    >
+      <div
+        class="relative w-24 h-24 md:w-32 md:h-32 flex items-center justify-center mb-4"
+      >
+        <img
+          src="/favicon.ico"
+          alt="caspian logo"
+          class="w-full h-full object-contain"
+        />
+      </div>
+
+      <h1
+        class="text-4xl md:text-6xl font-bold font-brand tracking-tight text-center"
+      >
+        CASPIAN
+      </h1>
+    </div>
+    <p
+      class="text-muted-foreground text-center max-w-[85vw] md:max-w-125 text-sm md:text-base"
+    >
+      The Native Python Framework with
+      <span class="text-[#053b69] font-medium whitespace-nowrap"
+        >PulsePoint</span
+      >
+      Reactivity.
+    </p>
+  </div>
+
+  <div
+    class="mb-32 grid text-center lg:max-w-5xl lg:w-full lg:mb-0 grid-cols-1 md:grid-cols-2 lg:grid-cols-4 lg:text-left gap-5 md:gap-6 mt-16"
+  >
+    <a
+      href="https://caspian.tsnc.tech/docs"
+      class="group rounded-lg border border-transparent px-5 py-4 transition-all hover:border-border hover:bg-muted/20 hover:backdrop-blur-sm"
+      target="_blank"
+    >
+      <h2
+        class="mb-3 text-xl md:text-2xl font-semibold font-brand group-hover:text-primary transition-colors"
+      >
+        Docs
+        <span
+          class="inline-block transition-transform group-hover:translate-x-1 motion-reduce:transform-none"
+          >-></span
+        >
+      </h2>
+      <p class="m-0 text-sm text-muted-foreground">
+        Find in-depth information about Caspian, Prisma, and PulsePoint
+        features.
+      </p>
+    </a>
+
+    <a
+      href="https://caspian.tsnc.tech/docs/rpc"
+      class="group rounded-lg border border-transparent px-5 py-4 transition-all hover:border-border hover:bg-muted/20 hover:backdrop-blur-sm"
+      target="_blank"
+    >
+      <h2
+        class="mb-3 text-xl md:text-2xl font-semibold font-brand group-hover:text-cyan-400 transition-colors"
+      >
+        RPC
+        <span
+          class="inline-block transition-transform group-hover:translate-x-1 motion-reduce:transform-none"
+          >-></span
+        >
+      </h2>
+      <p class="m-0 text-sm text-muted-foreground">
+        Learn how to call Python functions from HTML using Native RPC.
+      </p>
+    </a>
+
+    <a
+      href="https://caspian.tsnc.tech/docs/database"
+      class="group rounded-lg border border-transparent px-5 py-4 transition-all hover:border-border hover:bg-muted/20 hover:backdrop-blur-sm"
+      target="_blank"
+    >
+      <h2
+        class="mb-3 text-xl md:text-2xl font-semibold font-brand group-hover:text-purple-400 transition-colors"
+      >
+        Schema
+        <span
+          class="inline-block transition-transform group-hover:translate-x-1 motion-reduce:transform-none"
+          >-></span
+        >
+      </h2>
+      <p class="m-0 text-sm text-muted-foreground">
+        Edit <code>schema.prisma</code> to define your data models and generate
+        type-safe clients.
+      </p>
+    </a>
+
+    <a
+      href="https://caspian.tsnc.tech/docs/deploy"
+      class="group rounded-lg border border-transparent px-5 py-4 transition-all hover:border-border hover:bg-muted/20 hover:backdrop-blur-sm"
+      target="_blank"
+    >
+      <h2
+        class="mb-3 text-xl md:text-2xl font-semibold font-brand group-hover:text-green-400 transition-colors"
+      >
+        Deploy
+        <span
+          class="inline-block transition-transform group-hover:translate-x-1 motion-reduce:transform-none"
+          >-></span
+        >
+      </h2>
+      <p class="m-0 text-sm text-muted-foreground">
+        Instantly deploy your native Python app to Vercel, Railway, or Docker.
+      </p>
+    </a>
+  </div>
+</div>

package/dist/src/app/layout.html

@@ -0,0 +1,22 @@
+<!DOCTYPE html>
+<html lang="en" class="dark">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>[[layout.title]]</title>
+    <meta name="description" content="[[layout.description]]" />
+    <link rel="icon" href="/favicon.ico" type="image/x-icon" sizes="16x16" />
+  </head>
+
+  <body
+    pp-spa="true"
+    style="
+      opacity: 0;
+      pointer-events: none;
+      user-select: none;
+      transition: opacity 0.18s ease-out;
+    "
+  >
+    [[children | safe]]
+  </body>
+</html>

package/dist/src/app/not-found.html

@@ -0,0 +1,18 @@
+<div class="bg-gray-50 flex h-screen items-center justify-center px-4">
+  <div class="text-center">
+    <h1 class="text-9xl font-black text-gray-200">404</h1>
+
+    <p class="text-2xl font-bold tracking-tight text-gray-900 sm:text-4xl">
+      Uh-oh!
+    </p>
+
+    <p class="mt-4 text-gray-500">We can't find that page.</p>
+
+    <a
+      href="/"
+      class="mt-6 inline-block rounded bg-indigo-600 px-5 py-3 text-sm font-medium text-white hover:bg-indigo-700 focus:outline-none focus:ring"
+    >
+      Go Back Home
+    </a>
+  </div>
+</div>

package/dist/ts/global-functions.ts

@@ -0,0 +1,35 @@
+export function createGlobalSingleton<T>(
+  name: string,
+  SingletonClass: { getInstance(): T } | T,
+  target: any = window,
+  immediateInit: boolean = true
+) {
+  Object.defineProperty(target, name, {
+    get() {
+      if (
+        SingletonClass &&
+        (typeof SingletonClass === "function" ||
+          typeof SingletonClass === "object") &&
+        "getInstance" in SingletonClass &&
+        typeof SingletonClass.getInstance === "function"
+      ) {
+        return (SingletonClass as { getInstance(): T }).getInstance();
+      } else {
+        return SingletonClass as T;
+      }
+    },
+    set(next) {
+      console.warn(`[${name}] Cannot override global ${name}; ignoring.`, next);
+    },
+    configurable: false,
+    enumerable: true,
+  });
+
+  if (immediateInit) {
+    try {
+      target[name];
+    } catch (error) {
+      console.error(`Failed to initialize ${name}:`, error);
+    }
+  }
+}

package/dist/ts/main.ts

@@ -0,0 +1,5 @@
+import "/js/pp-reactive-v1.js";
+
+// The following global names have already been declared elsewhere in the project:
+// - pp: Used for the Reactive Core functionality.
+// - searchParams: Manages URL manipulation and query parameters.

package/dist/tsconfig.json

@@ -0,0 +1,111 @@
+{
+  "compilerOptions": {
+    /* Visit https://aka.ms/tsconfig to read more about this file */
+
+    /* Projects */
+    // "incremental": true,                              /* Save .tsbuildinfo files to allow for incremental compilation of projects. */
+    // "composite": true,                                /* Enable constraints that allow a TypeScript project to be used with project references. */
+    // "tsBuildInfoFile": "./.tsbuildinfo",              /* Specify the path to .tsbuildinfo incremental compilation file. */
+    // "disableSourceOfProjectReferenceRedirect": true,  /* Disable preferring source files instead of declaration files when referencing composite projects. */
+    // "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
+    // "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
+
+    /* Language and Environment */
+    "target": "ESNext" /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */,
+    // "lib": [],                                        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
+    // "jsx": "preserve",                                /* Specify what JSX code is generated. */
+    // "experimentalDecorators": true,                   /* Enable experimental support for legacy experimental decorators. */
+    // "emitDecoratorMetadata": true,                    /* Emit design-type metadata for decorated declarations in source files. */
+    // "jsxFactory": "",                                 /* Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'. */
+    // "jsxFragmentFactory": "",                         /* Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'. */
+    // "jsxImportSource": "",                            /* Specify module specifier used to import the JSX factory functions when using 'jsx: react-jsx*'. */
+    // "reactNamespace": "",                             /* Specify the object invoked for 'createElement'. This only applies when targeting 'react' JSX emit. */
+    // "noLib": true,                                    /* Disable including any library files, including the default lib.d.ts. */
+    // "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
+    // "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
+
+    /* Modules */
+    "module": "ESNext" /* Specify what module code is generated. */,
+    // "rootDir": "./",                                  /* Specify the root folder within your source files. */
+    "moduleResolution": "Node",                     /* Specify how TypeScript looks up a file from a given module specifier. */
+    // "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
+    // "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */
+    // "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
+    // "typeRoots": [],                                  /* Specify multiple folders that act like './node_modules/@types'. */
+    // "types": [],                                      /* Specify type package names to be included without being referenced in a source file. */
+    // "allowUmdGlobalAccess": true,                     /* Allow accessing UMD globals from modules. */
+    // "moduleSuffixes": [],                             /* List of file name suffixes to search when resolving a module. */
+    // "allowImportingTsExtensions": true,               /* Allow imports to include TypeScript file extensions. Requires '--moduleResolution bundler' and either '--noEmit' or '--emitDeclarationOnly' to be set. */
+    // "resolvePackageJsonExports": true,                /* Use the package.json 'exports' field when resolving package imports. */
+    // "resolvePackageJsonImports": true,                /* Use the package.json 'imports' field when resolving imports. */
+    // "customConditions": [],                           /* Conditions to set in addition to the resolver-specific defaults when resolving imports. */
+    "resolveJsonModule": true /* Enable importing .json files. */,
+    // "allowArbitraryExtensions": true,                 /* Enable importing files with any extension, provided a declaration file is present. */
+    // "noResolve": true,                                /* Disallow 'import's, 'require's or '<reference>'s from expanding the number of files TypeScript should add to a project. */
+
+    /* JavaScript Support */
+    // "allowJs": true,                                  /* Allow JavaScript files to be a part of your program. Use the 'checkJS' option to get errors from these files. */
+    // "checkJs": true,                                  /* Enable error reporting in type-checked JavaScript files. */
+    // "maxNodeModuleJsDepth": 1,                        /* Specify the maximum folder depth used for checking JavaScript files from 'node_modules'. Only applicable with 'allowJs'. */
+
+    /* Emit */
+    // "declaration": true,                              /* Generate .d.ts files from TypeScript and JavaScript files in your project. */
+    // "declarationMap": true,                           /* Create sourcemaps for d.ts files. */
+    // "emitDeclarationOnly": true,                      /* Only output d.ts files and not JavaScript files. */
+    // "sourceMap": true,                                /* Create source map files for emitted JavaScript files. */
+    // "inlineSourceMap": true,                          /* Include sourcemap files inside the emitted JavaScript. */
+    // "outFile": "./",                                  /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
+    // "outDir": "./",                                   /* Specify an output folder for all emitted files. */
+    // "removeComments": true,                           /* Disable emitting comments. */
+    // "noEmit": true,                                   /* Disable emitting files from a compilation. */
+    // "importHelpers": true,                            /* Allow importing helper functions from tslib once per project, instead of including them per-file. */
+    // "importsNotUsedAsValues": "remove",               /* Specify emit/checking behavior for imports that are only used for types. */
+    // "downlevelIteration": true,                       /* Emit more compliant, but verbose and less performant JavaScript for iteration. */
+    // "sourceRoot": "",                                 /* Specify the root path for debuggers to find the reference source code. */
+    // "mapRoot": "",                                    /* Specify the location where debugger should locate map files instead of generated locations. */
+    // "inlineSources": true,                            /* Include source code in the sourcemaps inside the emitted JavaScript. */
+    // "emitBOM": true,                                  /* Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. */
+    // "newLine": "crlf",                                /* Set the newline character for emitting files. */
+    // "stripInternal": true,                            /* Disable emitting declarations that have '@internal' in their JSDoc comments. */
+    // "noEmitHelpers": true,                            /* Disable generating custom helper functions like '__extends' in compiled output. */
+    // "noEmitOnError": true,                            /* Disable emitting files if any type checking errors are reported. */
+    // "preserveConstEnums": true,                       /* Disable erasing 'const enum' declarations in generated code. */
+    // "declarationDir": "./",                           /* Specify the output directory for generated declaration files. */
+    // "preserveValueImports": true,                     /* Preserve unused imported values in the JavaScript output that would otherwise be removed. */
+
+    /* Interop Constraints */
+    "isolatedModules": true,                          /* Ensure that each file can be safely transpiled without relying on other imports. */
+    // "verbatimModuleSyntax": true,                     /* Do not transform or elide any imports or exports not marked as type-only, ensuring they are written in the output file's format based on the 'module' setting. */
+    // "allowSyntheticDefaultImports": true,             /* Allow 'import x from y' when a module doesn't have a default export. */
+    "esModuleInterop": true /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */,
+    // "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
+    "forceConsistentCasingInFileNames": true /* Ensure that casing is correct in imports. */,
+
+    /* Type Checking */
+    "strict": true /* Enable all strict type-checking options. */,
+    // "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied 'any' type. */
+    // "strictNullChecks": true,                         /* When type checking, take into account 'null' and 'undefined'. */
+    // "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */
+    // "strictBindCallApply": true,                      /* Check that the arguments for 'bind', 'call', and 'apply' methods match the original function. */
+    // "strictPropertyInitialization": true,             /* Check for class properties that are declared but not set in the constructor. */
+    // "noImplicitThis": true,                           /* Enable error reporting when 'this' is given the type 'any'. */
+    // "useUnknownInCatchVariables": true,               /* Default catch clause variables as 'unknown' instead of 'any'. */
+    // "alwaysStrict": true,                             /* Ensure 'use strict' is always emitted. */
+    "noUnusedLocals": true,                           /* Enable error reporting when local variables aren't read. */
+    "noUnusedParameters": true,                       /* Raise an error when a function parameter isn't read. */
+    // "exactOptionalPropertyTypes": true,               /* Interpret optional property types as written, rather than adding 'undefined'. */
+    // "noImplicitReturns": true,                        /* Enable error reporting for codepaths that do not explicitly return in a function. */
+    // "noFallthroughCasesInSwitch": true,               /* Enable error reporting for fallthrough cases in switch statements. */
+    // "noUncheckedIndexedAccess": true,                 /* Add 'undefined' to a type when accessed using an index. */
+    // "noImplicitOverride": true,                       /* Ensure overriding members in derived classes are marked with an override modifier. */
+    // "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type. */
+    // "allowUnusedLabels": true,                        /* Disable error reporting for unused labels. */
+    // "allowUnreachableCode": true,                     /* Disable error reporting for unreachable code. */
+
+    /* Completeness */
+    // "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
+    "skipLibCheck": true /* Skip type checking all .d.ts files. */
+  },
+    "include": ["**/*.ts", ".casp/**/*.d.ts"],
+  "exclude": ["node_modules", ".venv"]
+}

package/dist/vite.config.ts

@@ -0,0 +1,61 @@
+import { defineConfig, Plugin } from "vite";
+import path from "path";
+import fg from "fast-glob";
+import { writeFileSync } from "fs";
+import { generateGlobalTypes } from "./settings/vite-plugins/generate-global-types.js";
+
+const entries = Object.fromEntries(
+  fg.sync("ts/**/*.ts", { ignore: ["**/*.test.ts"] }).map((f) => {
+    const rel = f.replace(/^ts\//, "").replace(/\.ts$/, "");
+    return [rel, path.resolve(__dirname, f)];
+  })
+);
+
+const VITE_WATCH_EXCLUDE = [
+  "public/js/**",
+  "node_modules/**",
+  ".venv/**",
+  ".casp/**",
+];
+
+function browserSyncNotify(): Plugin {
+  const flagFile = path.resolve(__dirname, ".casp", ".vite-build-complete");
+
+  return {
+    name: "browsersync-notify",
+    writeBundle() {
+      writeFileSync(flagFile, Date.now().toString());
+    },
+  };
+}
+
+export default defineConfig(({ command, mode }) => ({
+  publicDir: false,
+  build: {
+    outDir: "public/js",
+    emptyOutDir: false,
+    minify: "esbuild",
+    sourcemap: false,
+    watch:
+      command === "build" && mode === "development"
+        ? { exclude: VITE_WATCH_EXCLUDE }
+        : undefined,
+    rollupOptions: {
+      input: entries,
+      external: [/^\/js\/.*/],
+      output: {
+        entryFileNames: "[name].js",
+        chunkFileNames: "chunks/[name]-[hash].js",
+        assetFileNames: "assets/[name]-[hash][extname]",
+      },
+    },
+  },
+  plugins: [
+    generateGlobalTypes(),
+    ...(command === "build" && mode === "development"
+      ? [browserSyncNotify()]
+      : []),
+  ],
+  esbuild: { legalComments: "none" },
+  define: { "process.env.NODE_ENV": '"production"' },
+}));

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "create-caspian-app",
+  "version": "0.0.1",
+  "description": "Scaffold a new Caspian project (FastAPI-powered reactive Python framework).",
+  "main": "dist/index.js",
+  "type": "module",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "prepublish": "npm run tsc"
+  },
+  "bin": {
+    "create-caspian-app": "dist/index.js",
+    "casp": "dist/caspian.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TheSteelNinjaCode/create-caspian-app.git"
+  },
+  "homepage": "https://caspian.tsnc.tech/",
+  "keywords": [
+    "caspian",
+    "caspian orm",
+    "prisma",
+    "python",
+    "nodejs",
+    "venv",
+    "orm",
+    "database",
+    "boilerplate"
+  ],
+  "author": "Jefferson Abraham Omier <thesteelninjacode@gmail.com>",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "eslint": "^9.39.2",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "prompts": "^2.4.2"
+  }
+}