url-spec, web-routes, content: static subdirectories

Author: towerofnix

src/content/dependencies/generatePageLayout.js

@@ -596,7 +596,7 @@ export default {
 
             html.tag('link', {
               rel: 'stylesheet',
-              href: to('static.path', 'site.css'),
+              href: to('staticCSS.path', 'site.css'),
             }),
 
             html.tag('style', [
@@ -606,7 +606,7 @@ export default {
             ]),
 
             html.tag('script', {
-              src: to('static.path', 'lazy-loading.js'),
+              src: to('staticJS.path', 'lazy-loading.js'),
             }),
           ]),
 
@@ -636,7 +636,7 @@ export default {
 
               html.tag('script', {
                 type: 'module',
-                src: to('static.path', 'client.js'),
+                src: to('staticJS.path', 'client.js'),
               }),
             ]),
         ])

src/content/dependencies/image.js

@@ -170,7 +170,7 @@ export default {
     if (willReveal) {
       reveal = [
         html.tag('img', {class: 'reveal-symbol'},
-          {src: to('static.path', 'warning.svg')}),
+          {src: to('staticMisc.icon', 'warning.svg')}),
 
         html.tag('br'),
 

src/content/dependencies/linkExternalAsIcon.js

@@ -37,7 +37,7 @@ export default {
             html.tag('title', platformText),
 
           html.tag('use', {
-            href: to('static.icon', iconId),
+            href: to('staticMisc.icon', iconId),
           }),
         ]),
 

src/static/site-basic.css src/static/css/site-basic.css

@@ -6,7 +6,7 @@
 // ephemeral nature.
 
 import {accumulateSum, empty, filterMultipleArrays, stitchArrays}
-  from '../util/sugar.js';
+  from '../shared-util/sugar.js';
 import {fetchWithProgress} from './xhr-util.js';
 
 const clientInfo = window.hsmusicClientInfo = Object.create(null);

src/static/site.css src/static/css/site.css

@@ -0,0 +1,11 @@
+# `src/static/shared-util`
+
+Module imports under `src/static/js` may appear to be pointing to files that aren't at quite the right place. For example, the import:
+
+    import {empty} from '../shared-util/sugar.js';
+
+...is reading a file that doesn't exist here, under `shared-util`. This isn't an error!
+
+This folder (`src/shared-util`) does not actually exist in a build of the website; instead, the folder `src/util` is symlinked in its place. So, all files under `src/util` are actually available at `/shared-util/` online.
+
+The above import would actually import from the bindings in `src/util/sugar.js`.

src/static/client.js src/static/js/client.js

@@ -66,6 +66,29 @@ const urlSpec = {
     paths: genericPaths,
   },
 
+  staticCSS: {
+    prefix: 'static/css/',
+    paths: genericPaths,
+  },
+
+  staticJS: {
+    prefix: 'static/js/',
+    paths: genericPaths,
+  },
+
+  staticMisc: {
+    prefix: 'static/misc/',
+    paths: {
+      ...genericPaths,
+      icon: 'icons.svg#icon-<>',
+    },
+  },
+
+  staticSharedUtil: {
+    prefix: 'static/shared-util/',
+    paths: genericPaths,
+  },
+
   media: {
     prefix: 'media/',
 
@@ -89,20 +112,6 @@ const urlSpec = {
     prefix: 'thumb/',
     paths: genericPaths,
   },
-
-  static: {
-    prefix: 'static/',
-    paths: {
-      ...genericPaths,
-
-      icon: 'icons.svg#icon-<>',
-    },
-  },
-
-  util: {
-    prefix: 'util/',
-    paths: genericPaths,
-  },
 };
 
 // This gets automatically switched in place when working from a baseDirectory,

src/static/lazy-loading.js src/static/js/lazy-loading.js

@@ -16,13 +16,23 @@ function getNodeDependencyRootPath(dependencyName) {
 
 export const stationaryCodeRoutes = [
   {
-    from: path.join(codeSrcPath, 'static'),
-    to: ['static.root'],
+    from: path.join(codeSrcPath, 'static', 'css'),
+    to: ['staticCSS.root'],
+  },
+
+  {
+    from: path.join(codeSrcPath, 'static', 'js'),
+    to: ['staticJS.root'],
+  },
+
+  {
+    from: path.join(codeSrcPath, 'static', 'misc'),
+    to: ['staticMisc.root'],
   },
 
   {
     from: path.join(codeSrcPath, 'util'),
-    to: ['util.root'],
+    to: ['staticSharedUtil.root'],
   },
 ];