@kuratchi/js 0.0.18 → 0.0.19

package/README.md

@@ -42,9 +42,9 @@ For the framework's internal compiler/runtime orchestration and tracked implemen
 Place `.html` files inside `src/routes/`. The file path becomes the URL pattern.
 
 ```
-src/routes/page.html          → /
-src/routes/items/page.html    → /items
-src/routes/blog/[slug]/page.html → /blog/:slug
+src/routes/index.html          → /
+src/routes/items/index.html    → /items
+src/routes/blog/[slug]/index.html → /blog/:slug
 src/routes/layout.html        → shared layout wrapping all routes
 ```
 
@@ -277,7 +277,7 @@ Throw `PageError` from a route's load scope to return the correct HTTP error pag
 ```ts
 import { PageError } from '@kuratchi/js';
 
-// In src/routes/posts/[id]/page.html <script> block:
+// In src/routes/posts/[id]/index.html <script> block:
 const post = await db.posts.findOne({ id: params.id });
 if (!post) throw new PageError(404);
 if (!post.isPublished && !currentUser?.isAdmin) throw new PageError(403);

package/dist/compiler/import-linking.js

@@ -120,7 +120,7 @@ export function linkRouteServerImports(opts) {
                 continue;
             }
             fnToModule[binding.local] = moduleId;
-            if (!routeImportDeclMap.has(binding.local) && !RESERVED_RENDER_VARS.has(binding.local)) {
+            if (!routeImportDeclMap.has(binding.local)) {
                 const accessExpr = binding.imported === 'default' ? `${moduleId}.default` : `${moduleId}.${binding.imported}`;
                 routeImportDeclMap.set(binding.local, `const ${binding.local} = ${accessExpr};`);
             }

package/dist/compiler/index.js

@@ -220,7 +220,7 @@ export async function compile(options) {
             }));
             continue;
         }
-        // -- Page route (page.html) --
+        // -- Page route (index.html) --
         const source = fileContents.get(fullPath) ?? fs.readFileSync(fullPath, 'utf-8');
         const parsed = parseFile(source, { kind: 'route', filePath: fullPath });
         const routeState = assembleRouteState({

package/dist/compiler/root-layout-pipeline.js

@@ -354,8 +354,18 @@ const BRIDGE_SOURCE = `(function(){
       (function tick(){
         setTimeout(function(){
           fetch(location.pathname + location.search, { headers: { 'x-kuratchi-fragment': pollId } })
-            .then(function(r){ return r.text(); })
+            .then(function(r){
+              if(r.status === 404){
+                // Fragment no longer exists (e.g., item completed and removed from list)
+                // Remove the element and stop polling
+                el.remove();
+                return null;
+              }
+              if(!r.ok) return null;
+              return r.text();
+            })
             .then(function(html){
+              if(html === null) return;
               if(prevHtml !== html){
                 el.innerHTML = html;
                 prevHtml = html;

package/dist/compiler/route-discovery.js

@@ -26,9 +26,9 @@ export function discoverRoutes(routesDir) {
         for (const entry of entries) {
             if (entry.isDirectory()) {
                 const childPrefix = prefix ? `${prefix}/${entry.name}` : entry.name;
-                const pageFile = path.join(dir, entry.name, 'page.html');
+                const pageFile = path.join(dir, entry.name, 'index.html');
                 if (fs.existsSync(pageFile)) {
-                    const routeFile = `${childPrefix}/page.html`;
+                    const routeFile = `${childPrefix}/index.html`;
                     if (!registered.has(routeFile)) {
                         registered.add(routeFile);
                         results.push({ file: routeFile, name: childPrefix, layouts: getLayoutsForPrefix(childPrefix), type: 'page' });
@@ -56,15 +56,15 @@ export function discoverRoutes(routesDir) {
                 }
                 continue;
             }
-            if (entry.name === 'page.html') {
-                const routeFile = prefix ? `${prefix}/page.html` : 'page.html';
+            if (entry.name === 'index.html') {
+                const routeFile = prefix ? `${prefix}/index.html` : 'index.html';
                 if (!registered.has(routeFile)) {
                     registered.add(routeFile);
                     results.push({ file: routeFile, name: prefix || 'index', layouts: getLayoutsForPrefix(prefix), type: 'page' });
                 }
                 continue;
             }
-            if (entry.name.endsWith('.html') && entry.name !== 'page.html') {
+            if (entry.name.endsWith('.html') && entry.name !== 'index.html') {
                 const name = prefix
                     ? `${prefix}/${entry.name.replace('.html', '')}`
                     : entry.name.replace('.html', '');

package/dist/compiler/route-pipeline.js

@@ -94,10 +94,18 @@ export function analyzeRouteBuild(opts) {
     const routeImportDecls = routeImportDeclLines.join('\n');
     const importedBindingNames = new Set(Object.keys(fnToModule));
     const renderScopeActionNames = new Set(parsed.actionFunctions);
+    // Filter out params/breadcrumbs from render prelude since they come from data destructuring
+    const reservedRenderVars = new Set(['params', 'breadcrumbs']);
     const renderImportPrelude = routeImportDeclLines
         .filter((statement) => {
         const declaredName = extractDeclaredConstName(statement);
-        return declaredName ? !renderScopeActionNames.has(declaredName) : true;
+        if (!declaredName)
+            return true;
+        if (renderScopeActionNames.has(declaredName))
+            return false;
+        if (reservedRenderVars.has(declaredName))
+            return false;
+        return true;
     })
         .join('\n');
     let scriptBody = '';

package/dist/compiler/routes-module-feature-blocks.js

@@ -311,10 +311,12 @@ function buildWorkflowStatusRpc(opts) {
     const rpcLines = [];
     rpcLines.push(`\n// Workflow Status RPCs (auto-generated)`);
     rpcLines.push(`const __workflowStatusRpc = {`);
+    const rpcNames = [];
     for (const workflow of opts.workflowConfig) {
         const baseName = workflow.file.split('/').pop()?.replace(/\.workflow\.ts$/, '') || '';
         const camelName = baseName.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
         const rpcName = `${camelName}WorkflowStatus`;
+        rpcNames.push(rpcName);
         rpcLines.push(`  '${rpcName}': async (instanceId) => {`);
         rpcLines.push(`    if (!instanceId) return { status: 'unknown', error: { name: 'Error', message: 'Missing instanceId' } };`);
         rpcLines.push(`    try {`);
@@ -326,5 +328,9 @@ function buildWorkflowStatusRpc(opts) {
         rpcLines.push(`  },`);
     }
     rpcLines.push(`};`);
+    // Export individual functions for use in route templates
+    for (const rpcName of rpcNames) {
+        rpcLines.push(`const ${rpcName} = __workflowStatusRpc['${rpcName}'];`);
+    }
     return rpcLines.join('\n');
 }

package/dist/create.js

@@ -211,25 +211,25 @@ function scaffold(dir, opts) {
     write(dir, 'tsconfig.json', genTsConfig());
     write(dir, '.gitignore', genGitIgnore());
     write(dir, 'src/routes/layout.html', genLayout(opts));
-    write(dir, 'src/routes/page.html', genLandingPage(opts));
+    write(dir, 'src/routes/index.html', genLandingPage(opts));
     if (orm) {
         write(dir, 'src/schemas/app.ts', genSchema(opts));
         write(dir, 'src/database/items.ts', genItemsCrud());
-        write(dir, 'src/routes/items/page.html', genItemsPage());
+        write(dir, 'src/routes/items/index.html', genItemsPage());
     }
     if (enableDO) {
         write(dir, 'src/schemas/notes.ts', genNotesSchema());
         write(dir, 'src/server/notes.do.ts', genNotesDoHandler());
         write(dir, 'src/database/notes.ts', genNotesDb());
-        write(dir, 'src/routes/notes/page.html', genNotesPage());
+        write(dir, 'src/routes/notes/index.html', genNotesPage());
     }
     if (auth) {
         write(dir, '.dev.vars', genDevVars());
         write(dir, 'src/database/auth.ts', genAuthFunctions());
         write(dir, 'src/database/admin.ts', genAdminLoader());
-        write(dir, 'src/routes/auth/login/page.html', genLoginPage());
-        write(dir, 'src/routes/auth/signup/page.html', genSignupPage());
-        write(dir, 'src/routes/admin/page.html', genAdminPage());
+        write(dir, 'src/routes/auth/login/index.html', genLoginPage());
+        write(dir, 'src/routes/auth/signup/index.html', genSignupPage());
+        write(dir, 'src/routes/admin/index.html', genAdminPage());
     }
 }
 function write(dir, filePath, content) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kuratchi/js",
-    "version": "0.0.18",
+    "version": "0.0.19",
     "description": "A thin, Cloudflare Workers-native web framework with Svelte-inspired syntax",
     "license": "MIT",
     "type": "module",