transpiler function

example/app.tsx

@@ -1,5 +1,3 @@
-import TWPreTail from "https://esm.sh/v115/@twind/preset-tailwind@1.1.4/es2022/preset-tailwind.mjs";
-import TWPreAuto from "https://esm.sh/v115/@twind/preset-autoprefix@1.0.7/es2022/preset-autoprefix.mjs";
 import React from "react";
 import * as Iso from "@eno/iso";
 
@@ -31,8 +29,3 @@ export default ()=>
         </Iso.Switch>
     </div>;
 };
-
-export const CSS = {
-    presets: [TWPreTail(), TWPreAuto()],
-    hash:false
-};

example/deno.jsonc

@@ -9,6 +9,6 @@
     },
     "tasks": {
         "host": "deno run -A --unstable https://deno.land/std@0.181.0/http/file_server.ts",
-        "dev": "deno run -A --unstable --reload=http://localhost:4507/ --no-lock --config=deno.json 'http://localhost:4507/server.tsx?reload=1'"
+        "dev": "deno run -A --unstable --reload=http://localhost:4507/ --no-lock --config=deno.jsonc 'http://localhost:4507/server.tsx'"
     }
 }

lib/iso.tsx

@@ -1,5 +1,13 @@
+import TWPreTail from "https://esm.sh/v115/@twind/preset-tailwind@1.1.4/es2022/preset-tailwind.mjs";
+import TWPreAuto from "https://esm.sh/v115/@twind/preset-autoprefix@1.0.7/es2022/preset-autoprefix.mjs";
 import React from "react";
 
+export const CSS = {
+    presets: [TWPreTail(), TWPreAuto()],
+    hash:false
+};
+
+
 type Meta = {title:string, description:string, keywords:string, image:string, canonical:string }
 type MetaKeys = keyof Meta;
 export const Meta:Meta = {

server.tsx

@@ -1,330 +1,407 @@
 import * as ESBuild from 'https://deno.land/x/esbuild@v0.14.45/mod.js';
 import * as MIME from "https://deno.land/std@0.180.0/media_types/mod.ts";
 import { debounce } from "https://deno.land/std@0.151.0/async/debounce.ts";
+import { parse as JSONC} from "https://deno.land/std@0.185.0/jsonc/mod.ts";
 import SSR from "https://esm.sh/v113/preact-render-to-string@6.0.2";
 import Prepass from "https://esm.sh/preact-ssr-prepass@1.2.0";
 import * as Twind from "https://esm.sh/@twind/core@1.1.3";
 import React from "react";
 import * as Iso from "@eno/iso";
 
-let hosted = import.meta.resolve("./");
+/**
-const Path = {
+ * Setup a transpiler.
-    Hosted:hosted.substring(0, hosted.length-1),
+ * @param inDevMode When true, starts a file-watcher
-    Active:`file://${Deno.cwd().replaceAll("\\", "/")}`
+ * @returns 
-};
+ */
-console.log(Path);
+function Transpiler(inDevMode:boolean)
-
-const Transpiled = new Map();
-const Transpileable =(inFilePath:string):boolean=>
 {
-    let dotIndex = inFilePath.length-4;
+    const Transpiled = new Map();
-    if(inFilePath[dotIndex] !== ".")
+    const Transpileable =(inFilePath:string):boolean=>
     {
-        if(inFilePath[++dotIndex] !== ".")
+        let dotIndex = inFilePath.length-4;
+        if(inFilePath[dotIndex] !== ".")
         {
-            return false;
+            if(inFilePath[++dotIndex] !== ".")
+            {
+                return false;
+            }
         }
-    }
     
-    if(inFilePath[dotIndex+2] == "s")
+        if(inFilePath[dotIndex+2] == "s")
-    {
-        const first = inFilePath[dotIndex+1];
-        return (first == "t" || first == "j");
-    }
-
-    return false;
-};
-const Transpile =async(inCode:string, inKey:string):Promise<string>=>
-{
-    const transpile = await ESBuild.transform(inCode, { loader: "tsx", sourcemap:"inline", minify:true, sourcefile:inKey});
-
-    Transpiled.set(inKey, transpile.code);
-    return transpile.code;
-};
-type Transpiler = (inPath:string, inKey:string, inCheck?:boolean)=>Promise<string>;
-const TranspileURL:Transpiler =async(inPath, inKey, inCheck)=>
-{
-    if(inCheck)
-    {
-        const cached = Transpiled.get(inKey);
-        if(cached)
         {
-            return cached;
+            const first = inFilePath[dotIndex+1];
+            return (first == "t" || first == "j");
         }
-    }
-    let body = await fetch(inPath);
-    let text = await body.text();
-    return Transpile(text, inKey);
-};
     
-
+        return false;
-const LibPath = "lib";
+    };
-type ImportMap = {imports?:Record<string, string>, importMap?:string};
+    const Transpile =async(inCode:string, inKey:string):Promise<string>=>
-let ImportObject:ImportMap = {};
-try
-{
-    const confDeno = await fetch(`${Path.Active}/deno.json`);
-    const confDenoParsed:ImportMap = await confDeno.json();
-    if(confDenoParsed.importMap)
     {
-        try
+        const transpile = await ESBuild.transform(inCode, inDevMode ? { loader: "tsx", sourcemap:"inline", minify: false, sourcefile:inKey} : {loader:"tsx", minify: true});
+    
+        Transpiled.set(inKey, transpile.code);
+        return transpile.code;
+    };
+    type Transpiler = (inPath:string, inKey:string, inCheck?:boolean)=>Promise<string>;
+    const TranspileURL:Transpiler =async(inPath, inKey, inCheck)=>
+    {
+        if(inCheck)
+        {
+            const cached = Transpiled.get(inKey);
+            if(cached)
+            {
+                return cached;
+            }
+        }
+        let body = await fetch(inPath);
+        let text = await body.text();
+        return Transpile(text, inKey);
+    };
+    
+    const Sockets:Set<WebSocket> = new Set();
+    const SocketsBroadcast =(inData:string)=>{ for (const socket of Sockets){ socket.send(inData); } }
+    const SocketsHandler = inDevMode ? (_req:Request)=>
+    {
+        if(_req.headers.get("upgrade") == "websocket")
         {
-            const confImports = await Deno.readTextFile(confDenoParsed.importMap);
             try
             {
-                ImportObject = JSON.parse(confImports);
+              const { response, socket } = Deno.upgradeWebSocket(_req);
+              socket.onopen = () => Sockets.add(socket);
+              socket.onclose = () => Sockets.delete(socket);
+              socket.onmessage = (e) => {};
+              socket.onerror = (e) => console.log("Socket errored:", e);
+              return response;
             }
             catch(e)
             {
-                console.log(`"importMap" "${confDenoParsed.importMap}" contains invalid JSON`);
+                //
             }
         }
-        catch(e)
+        return false;
-        {
-            console.log(`"importMap" "${confDenoParsed.importMap}" cannot be found`);
-        }
     }
-    else if(confDenoParsed.imports)
+    :
+    ()=>false;
+
+    const watcher =async()=>
     {
-        ImportObject = {imports:confDenoParsed.imports};
+        const FilesChanged:Map<string, string> = new Map();
-    }
+        const ProcessFiles =debounce(async()=>
-
-    if(ImportObject.imports)
-    {
-        const importReact = ImportObject.imports["react"];
-        if(importReact)
         {
-            ImportObject.imports["react-original"] = importReact;
+            for await (const [path, action] of FilesChanged)
-            ImportObject.imports["react"] = `/${LibPath}/react.tsx`;
-        }
-        else
-        {
-            console.log(`"imports" configuration does not alias "react"`);
-        }
-
-        const importApp = ImportObject.imports["@eno/app"];
-        if(importApp)
-        {
-            
-        }
-        else
-        {
-            console.log(`"imports" configuration does not alias an entry-point component with "@eno/app"`);
-        }
-        
-        const importIso = ImportObject.imports["@eno/iso"];
-        if(importIso)
-        {
-            ImportObject.imports["@eno/iso"] = `/${LibPath}/iso.tsx`;
-        }
-        else
-        {
-
-        }
-        Object.entries(ImportObject.imports).forEach(([key, value])=>{
-            if(value.startsWith("./") && ImportObject.imports)
             {
-                ImportObject.imports[key] = value.substring(1);
+                const key = path.substring(Deno.cwd().length).replaceAll("\\", "/");
+                if(action != "remove")
+                {
+                    await TranspileURL(Path.Active+key, key, false);
+                    SocketsBroadcast(key);
+                }
+                else
+                {
+                    Transpiled.delete(key);
+                }
             }
-        })
+            FilesChanged.clear();
-    }
+        }, 1000);
-    else
+        for await (const event of Deno.watchFs(Deno.cwd()))
-    {
-        console.log(`No "imports" found in configuration`);
-    }
-}
-catch(e)
-{
-    console.log(`deno.json not found`);
-}
-
-
-Deno.serve({ port: Deno.args[0]||3000 }, async(_req:Request) =>
-{
-    const url:URL = new URL(_req.url);
-    const pathParts = url.pathname.substring(1, url.pathname.endsWith("/") ? url.pathname.length-1 : url.pathname.length).split("/");
-    const pathLast = pathParts.at(-1);
-    const pathExt:string|undefined = pathLast?.split(".")[1];
-
-    console.log(pathParts, pathLast, pathExt);
-
-    console.log(`Request for "${url.pathname}"...`);    
-
-    if(_req.headers.get("upgrade") == "websocket")
-    {
-        try
         {
-          const { response, socket } = Deno.upgradeWebSocket(_req);
+            event.paths.forEach( path =>
-          socket.onopen = () =>
+            {
-          {
+                if(Transpileable(path))
-              Sockets.add(socket);
+                {
-              console.log("Overwatch: Socket created");
+                    FilesChanged.set(path, event.kind);
-          };
+                }
-          socket.onclose = () =>
+            });
-          {
+            if(FilesChanged.size)
-              Sockets.delete(socket);
+            {
-              console.log("Overwatch: Socket deleted");
+                ProcessFiles();
-          };
+            }
-          socket.onmessage = (e) => {};
-          socket.onerror = (e) => console.log("Overwatch: Socket errored:", e);
-          return response;
-        }
-        catch(e)
-        {
-            //
         }
     }
 
+    if(inDevMode)
+    {
+        watcher().then(()=>{console.log("done watching");});
+    }
+
+    return {TranspileURL, Transpileable, SocketsHandler};
+
+}
+
+/**
+ * Extract all configuration info form a project's deno.jsonc file
+ * @param inDevMode When true, proxies react to an HMR-enabled version
+ * @param inLibPath 
+ * @returns 
+ */
+async function Configure(inDevMode:boolean, inLibPath:string)
+{
+    type ImportMap = {imports?:Record<string, string>, importMap?:string};
+    const output:{Imports?:ImportMap, App?:React.FunctionComponent, TwindInst?:Twind.Twind, Error?:string} = {};
+    let ImportObject:ImportMap = {};
     try
     {
-        // serve index by default
+        const confDeno = await fetch(`${Path.Active}/deno.jsonc`);
-        let type = `text/html`;
+        const confText = await confDeno.text();
-        let body:BodyInit = ``;
+        const confDenoParsed = JSONC(confText) as ImportMap;
-
+        if(confDenoParsed.importMap)
-        const isLib = url.pathname.startsWith(`/${LibPath}/`);
-
-        if(Transpileable(url.pathname))
         {
-            type = `application/javascript`;
+            try
-            if(isLib)
             {
-                body = await TranspileURL(Path.Hosted+url.pathname, url.pathname, true);
+                const confImports = await Deno.readTextFile(confDenoParsed.importMap);
+                try
+                {
+                    output.Imports = JSON.parse(confImports);
+                }
+                catch(e)
+                {
+                    output.Error = `"importMap" "${confDenoParsed.importMap}" contains invalid JSON`;
+                    return output;
+                }
             }
-            else if(!url.searchParams.get("reload"))
+            catch(e)
             {
-                const imp = await import(Path.Active+url.pathname);
+                output.Error = `"importMap" "${confDenoParsed.importMap}" cannot be found`;
-                const members = [];
+                return output;
-                for( const key in imp ) { members.push(key); }
+            }
-                body =
+        }
-`
+        else if(confDenoParsed.imports)
-import {FileListen} from "/${LibPath}/hmr.tsx";
+        {
-import * as Import from "${url.pathname}?reload=0";
+            output.Imports  = {imports:confDenoParsed.imports};
-${ members.map(m=>`let proxy_${m} = Import.${m};
+        }
-export { proxy_${m} as ${m} };
-`).join(" ") }
-const reloadHandler = (updatedModule)=>
-{
-    ${ members.map(m=>`proxy_${m} = updatedModule.${m};`).join("\n") }
-};
-FileListen("${url.pathname}", reloadHandler);`;
     
+        if(output.Imports?.imports)
+        {
+            if(inDevMode)
+            {
+                const importReact = output.Imports.imports["react"];
+                if(importReact)
+                {
+                    output.Imports.imports["react-original"] = importReact;
+                    output.Imports.imports["react"] = `/${inLibPath}/react.tsx`;
+                }
+                else
+                {
+                    output.Error = `"imports" configuration does not alias "react"`;
+                    return output;
+                }
+            }
+    
+            const importIso = output.Imports.imports["@eno/iso"];
+            if(importIso)
+            {
+                output.Imports.imports["@eno/iso"] = `/${inLibPath}/iso.tsx`;
             }
             else
             {
-                body = await TranspileURL(Path.Active+url.pathname, url.pathname, true);
+                output.Error = `"imports" configuration does not alias "@eno/iso"`;
+                return output;
             }
-        }
+    
-        // serve static media
+            const importApp = output.Imports.imports["@eno/app"];
-        else if( pathExt )
+            if(importApp)
-        {
-            type = MIME.typeByExtension(pathExt) || "text/html";
-            const _fetch = await fetch((isLib ? Path.Hosted : Path.Active)+url.pathname);
-            body = await _fetch.text();
-        }
-        else
-        {
-            Iso.Fetch.ServerBlocking = [];
-            Iso.Fetch.ServerTouched = new Set();
-            Iso.Fetch.ServerRemove = new Set();
-            let app = <Iso.Router.Provider url={url}><App/></Iso.Router.Provider>;
-            await Prepass(app)
-            let bake = SSR(app);
-            while(Iso.Fetch.ServerBlocking.length)
             {
-                await Promise.all(Iso.Fetch.ServerBlocking);
+                let appImport 
-                Iso.Fetch.ServerBlocking = [];
+                try
-                // at this point, anything that was requested that was not cached, has now been loaded and cached
+                {
-                // this next render will use cached resources. using a cached resource (if its "Seed" is true) adds it to the "touched" set.
+                    appImport = await import(Path.Active+importApp);
-                app = <Iso.Router.Provider url={url}><App/></Iso.Router.Provider>;
+                }
-                await Prepass(app)
+                catch(e)
-                bake = SSR(app);
+                {
+                    output.Error = `"@eno/app" entry-point (${importApp}) file not found`;
+                    return output;
+                }
+                
+                if(typeof appImport.default == "function" )
+                {
+                    output.App = appImport.default;
+                }
+                else
+                {
+                    output.Error = `"@eno/app" entry-point (${importApp}) needs to export a default function to use as the app root.`;
+                    return output;
+                }
+    
+                let twindConfig = Iso.CSS;
+                if(typeof appImport.CSS == "object")
+                {
+                    twindConfig = {...twindConfig, ...appImport.CSS};
+                }
+                try
+                {
+                    // @ts-ignore
+                    output.TwindInst = Twind.install(twindConfig);
+                }
+                catch(e)
+                {
+                    output.Error = `CSS configuration is malformed`;
+                    return output;
+                }
+            }
+            else
+            {
+                output.Error = `"imports" configuration does not alias an entry-point file as "@eno/app"`;
+                return output;
             }
             
-            const seed:Iso.FetchRecord[] = [];
-            Iso.Fetch.ServerTouched.forEach((record)=>{
-                const r:Iso.FetchRecord = {...record};
-                delete r.Promise;
-                seed.push(r);
-            });
-            Iso.Fetch.ServerTouched = false;
     
-            const results = Twind.extract(bake, TwindInst);
+            Object.entries(output.Imports.imports).forEach(([key, value])=>{
-
+                if(value.startsWith("./") && output.Imports?.imports)
-            type = `text/html`;
+                {
-            body =
+                    output.Imports.imports[key] = value.substring(1);
-`<!doctype html>
+                }
-<html lang="en">
+            })
-    <head>
-        <title>${Iso.Meta.title}</title>
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        <meta charset="utf-8"/>
-        <style data-twind>${results.css}</style>
-        <script type="importmap">${JSON.stringify(ImportObject)}</script>
-    </head>
-    <body>
-        <div id="app">${results.html}</div>
-        <script type="module">
-            import {hydrate, createElement as H} from "react";
-            import * as Twind from "https://esm.sh/v115/@twind/core@1.1.3/es2022/core.mjs";
-            import {default as App, CSS} from "@eno/app";
-            import {Router, Fetch} from "@eno/iso";
-            Twind.install(CSS);
-            Fetch.Seed(${JSON.stringify(seed)});
-            const hmrWrap = H( ()=>H(App) );
-            hydrate( H(Router.Provider, null, hmrWrap), document.querySelector("#app"));
-        </script>
-    </body>
-</html>`;
-        }
-
-        return new Response(body, {headers:{"content-type":type as string, "Access-Control-Allow-Origin":"*", charset:"utf-8"}});
-    }
-    catch(error)
-    {
-        console.log(error);
-        return new Response(error, {status:404});
-    }
-});
-
-import App, {CSS} from "@eno/app";
-const TwindInst = Twind.install(CSS);
-
-const Sockets:Set<WebSocket> = new Set();
-const SocketsBroadcast =(inData:string)=>{ for (const socket of Sockets){ socket.send(inData); } }
-
-const FilesChanged:Map<string, string> = new Map();
-const ProcessFiles =debounce(async()=>
-{
-    console.log("Processing Files...", FilesChanged);
-    for await (const [path, action] of FilesChanged)
-    {
-        const key = path.substring(Deno.cwd().length).replaceAll("\\", "/");
-        console.log(key, action);
-
-        if(action != "remove")
-        {
-            await TranspileURL(Path.Active+key, key, false);
-            console.log(`  ...cached "${key}"`);
-            SocketsBroadcast(key);
         }
         else
         {
-            Transpiled.delete(key);
+            output.Error = `No "imports" found in configuration`;
+            return output;
         }
     }
-    FilesChanged.clear();
+    catch(e)
-}, 1000);
-for await (const event of Deno.watchFs(Deno.cwd()))
-{
-    event.paths.forEach( path =>
     {
-        if(Transpileable(path))
+        output.Error = `error during configuration: ${e}`;
+        return output;
+    }
+    return output;
+}
+
+let DevMode = true;
+let hosted = import.meta.resolve("./");
+const Path = {
+    Hosted: hosted.substring(0, hosted.length-1),
+    Active: `file://${Deno.cwd().replaceAll("\\", "/")}`,
+    LibDir: "lib"
+};
+console.log(Path);
+console.log(`Dev Mode: ${DevMode}`);
+
+const {Transpileable, TranspileURL, SocketsHandler} = Transpiler(DevMode);
+const {Imports, App, TwindInst, Error} = await Configure(DevMode, Path.LibDir);
+if(Error)
+{
+    console.log(Error);
+}
+else if(App && TwindInst)
+{
+    Deno.serve({ port: Deno.args[0]||3000 }, async(_req:Request) =>
+    {
+        const url:URL = new URL(_req.url);
+        const pathParts = url.pathname.substring(1, url.pathname.endsWith("/") ? url.pathname.length-1 : url.pathname.length).split("/");
+        const pathLast = pathParts.at(-1);
+        const pathExt:string|undefined = pathLast?.split(".")[1];
+        
+        const resp = SocketsHandler(_req);
+        if(resp){ return resp; }
+    
+        try
         {
-            FilesChanged.set(path, event.kind);
+            // serve index by default
+            let type = `text/html`;
+            let body:BodyInit = ``;
+    
+            const isLib = url.pathname.startsWith(`/${Path.LibDir}/`);
+    
+            if(Transpileable(url.pathname))
+            {
+                type = `application/javascript`;
+                if(isLib)
+                {
+                    body = await TranspileURL(Path.Hosted+url.pathname, url.pathname, true);
+                }
+                else if(!url.searchParams.get("reload"))
+                {
+                    const imp = await import(Path.Active+url.pathname);
+                    const members = [];
+                    for( const key in imp ) { members.push(key); }
+                    body =
+    `
+    import {FileListen} from "/${Path.LibDir}/hmr.tsx";
+    import * as Import from "${url.pathname}?reload=0";
+    ${ members.map(m=>`let proxy_${m} = Import.${m};
+    export { proxy_${m} as ${m} };
+    `).join(" ") }
+    const reloadHandler = (updatedModule)=>
+    {
+        ${ members.map(m=>`proxy_${m} = updatedModule.${m};`).join("\n") }
+    };
+    FileListen("${url.pathname}", reloadHandler);`;
+    
+                }
+                else
+                {
+                    body = await TranspileURL(Path.Active+url.pathname, url.pathname, true);
+                }
+            }
+            // serve static media
+            else if( pathExt )
+            {
+                type = MIME.typeByExtension(pathExt) || "text/html";
+                const _fetch = await fetch((Path.Active)+url.pathname);
+                body = await _fetch.text();
+            }
+            else
+            {
+                Iso.Fetch.ServerBlocking = [];
+                Iso.Fetch.ServerTouched = new Set();
+                Iso.Fetch.ServerRemove = new Set();
+                let app = <Iso.Router.Provider url={url}><App/></Iso.Router.Provider>;
+                await Prepass(app)
+                let bake = SSR(app);
+                while(Iso.Fetch.ServerBlocking.length)
+                {
+                    await Promise.all(Iso.Fetch.ServerBlocking);
+                    Iso.Fetch.ServerBlocking = [];
+                    // at this point, anything that was requested that was not cached, has now been loaded and cached
+                    // this next render will use cached resources. using a cached resource (if its "Seed" is true) adds it to the "touched" set.
+                    app = <Iso.Router.Provider url={url}><App/></Iso.Router.Provider>;
+                    await Prepass(app)
+                    bake = SSR(app);
+                }
+    
+                const seed:Iso.FetchRecord[] = [];
+                Iso.Fetch.ServerTouched.forEach((record)=>{
+                    const r:Iso.FetchRecord = {...record};
+                    delete r.Promise;
+                    seed.push(r);
+                });
+                Iso.Fetch.ServerTouched = false;
+    
+                const results = Twind.extract(bake, TwindInst);
+    
+                type = `text/html`;
+                body =
+    `<!doctype html>
+    <html lang="en">
+        <head>
+            <title>${Iso.Meta.title}</title>
+            <meta name="viewport" content="width=device-width, initial-scale=1.0">
+            <meta charset="utf-8"/>
+            <style data-twind>${results.css}</style>
+            <script type="importmap">${JSON.stringify(Imports)}</script>
+        </head>
+        <body>
+            <div id="app">${results.html}</div>
+            <script type="module">
+                import {hydrate, createElement as H} from "react";
+                import * as Twind from "https://esm.sh/v115/@twind/core@1.1.3/es2022/core.mjs";
+                import * as App from "@eno/app";
+                import {Router, Fetch, CSS} from "@eno/iso";
+                Twind.install(App.CSS ? {...CSS, ...App.CSS} : CSS);
+                Fetch.Seed(${JSON.stringify(seed)});
+                const hmrWrap = H( ()=>H(App.default) );
+                hydrate( H(Router.Provider, null, hmrWrap), document.querySelector("#app"));
+            </script>
+        </body>
+    </html>`;
+            }
+    
+            return new Response(body, {headers:{"content-type":type as string, "Access-Control-Allow-Origin":"*", charset:"utf-8"}});
+        }
+        catch(error)
+        {
+            console.log(error);
+            return new Response(error, {status:404});
         }
     });
-    if(FilesChanged.size)
-    {
-        ProcessFiles();
-    }
 }