Project update. [p][robotic]

clevercanyon · Oct 19, 2023 · 891e332 · 891e332
1 parent 4a43c9a
commit 891e332
Show file tree

Hide file tree

Showing 22 changed files with 1,289 additions and 623 deletions.
diff --git a/.browserslistrc b/.browserslistrc
@@ -17,7 +17,7 @@
 # Generated data.
 # <generated:start>
 
-# Last generated Mon, Oct 9, 2023, 9:52:39 PM EDT.
+# Last generated Thu, Oct 19, 2023, 10:34:01 AM EDT.
 
 [production]
 last 1 chrome versions

diff --git a/.dockerignore b/.dockerignore
@@ -17,7 +17,7 @@
 # Generated data.
 # <generated:start>
 
-# Last generated Mon, Oct 9, 2023, 9:52:39 PM EDT.
+# Last generated Thu, Oct 19, 2023, 10:34:01 AM EDT.
 
 # Locals
 

diff --git a/.gitattributes b/.gitattributes
@@ -17,7 +17,7 @@
 # Generated data.
 # <generated:start>
 
-# Last generated Mon, Oct 9, 2023, 9:52:39 PM EDT.
+# Last generated Thu, Oct 19, 2023, 10:34:01 AM EDT.
 
 # Default
 

diff --git a/.gitignore b/.gitignore
@@ -17,7 +17,7 @@
 # Generated data.
 # <generated:start>
 
-# Last generated Mon, Oct 9, 2023, 9:52:39 PM EDT.
+# Last generated Thu, Oct 19, 2023, 10:34:01 AM EDT.
 
 # Locals
 

diff --git a/.npmignore b/.npmignore
@@ -25,7 +25,7 @@
 # Generated data.
 # <generated:start>
 
-# Last generated Mon, Oct 9, 2023, 9:52:39 PM EDT.
+# Last generated Thu, Oct 19, 2023, 10:34:01 AM EDT.
 
 # Locals
 

diff --git a/.prettierignore b/.prettierignore
@@ -17,7 +17,7 @@
 # Generated data.
 # <generated:start>
 
-# Last generated Mon, Oct 9, 2023, 9:52:39 PM EDT.
+# Last generated Thu, Oct 19, 2023, 10:34:01 AM EDT.
 
 # Packages
 

diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -7,7 +7,7 @@
  * @note This entire file will be updated automatically.
  * @note Instead of editing here, please review `./settings.mjs`.
  *
- * Last generated using `./settings.mjs` Mon, Oct 9, 2023, 9:52:38 PM EDT.
+ * Last generated using `./settings.mjs` Thu, Oct 19, 2023, 10:34:01 AM EDT.
  */
 {
     "editor.formatOnType": false,
@@ -170,18 +170,35 @@
             "scope": "workspace",
             "iconColor": "#fff0b5",
             "highlightColor": "#fff0b5",
+            "behavior": "anchor",
             "styleMode": "tag"
         },
         "@review": {
             "scope": "workspace",
             "iconColor": "#8a826d",
             "highlightColor": "#8a826d",
+            "behavior": "anchor",
             "styleMode": "tag"
         },
         "@someday": {
             "scope": "workspace",
             "iconColor": "#6d718a",
             "highlightColor": "#6d718a",
+            "behavior": "anchor",
+            "styleMode": "tag"
+        },
+        "@anchor": {
+            "scope": "hidden",
+            "iconColor": "#696969",
+            "highlightColor": "#696969",
+            "behavior": "anchor",
+            "styleMode": "tag"
+        },
+        "@see-anchor": {
+            "scope": "hidden",
+            "iconColor": "#696969",
+            "highlightColor": "#696969",
+            "behavior": "link",
             "styleMode": "tag"
         }
     },

diff --git a/.vscodeignore b/.vscodeignore
@@ -17,7 +17,7 @@
 # Generated data.
 # <generated:start>
 
-# Last generated Mon, Oct 9, 2023, 9:52:39 PM EDT.
+# Last generated Thu, Oct 19, 2023, 10:34:01 AM EDT.
 
 # Locals
 

diff --git a/dev-types.d.ts b/dev-types.d.ts
@@ -18,6 +18,11 @@ declare const $$__APP_PKG_HOMEPAGE__$$: string;
 declare const $$__APP_PKG_BUGS__$$: string;
 declare const $$__APP_BUILD_TIME_YMD__$$: string;
 
+/**
+ * Declares prefresh API in Vite plugin.
+ */
+declare var __PREFRESH__: object;
+
 /*
  * Customizations.
  *

diff --git a/dev/.files/postcss/config.mjs b/dev/.files/postcss/config.mjs
@@ -25,6 +25,12 @@ export default async () => {
      */
     return {
         plugins: {
+            // SCSS is not configured here, as it’s already backed into Vite; {@see https://o5p.me/CAJNAF}.
+            // To use `*.scss` files, just make sure the `sass` package is installed as a dev dependency.
+
+            // Note: Sass runs before postCSS, and therefore cannot interpolate Tailwind `theme()` function calls.
+            // i.e., Tailwind’s `theme()` function works, but don’t try to feed a response into an SCSS variable|fn.
+
             'tailwindcss': { config: path.resolve(projDir, './tailwind.config.mjs') },
             'postcss-preset-env': { stage: 3 }, // Includes autoprefixer.
         },

diff --git a/dev/.files/stylelint/config.mjs b/dev/.files/stylelint/config.mjs
@@ -39,14 +39,8 @@ export default async () => {
                 ...exclusions.exampleIgnores,
             ]),
         ],
-        plugins: [
-            'stylelint-scss', //
-            'stylelint-order',
-        ],
-        extends: [
-            'stylelint-config-standard-scss', //
-            'stylelint-config-recess-order',
-        ],
+        plugins: ['stylelint-order'],
+        extends: ['stylelint-config-recess-order'],
         rules: {
             'no-duplicate-selectors': null,
             'selector-type-no-unknown': null,
@@ -66,24 +60,16 @@ export default async () => {
         overrides: [
             {
                 files: ['**/*.' + extensions.asBracedGlob([...extensions.byVSCodeLang.css])],
-
-                plugins: [...baseConfig.plugins],
-                extends: [...baseConfig.extends],
-                ignoreFiles: [...baseConfig.ignoreFiles],
-
                 customSyntax: 'postcss-safe-parser',
-                rules: { ...baseConfig.rules },
             },
             {
                 files: ['**/*.' + extensions.asBracedGlob([...extensions.byVSCodeLang.scss])],
-
-                plugins: [...baseConfig.plugins],
-                extends: [...baseConfig.extends],
-                ignoreFiles: [...baseConfig.ignoreFiles],
-
                 customSyntax: 'postcss-scss',
+
+                plugins: ['stylelint-scss'],
+                extends: ['stylelint-config-standard-scss'],
                 rules: {
-                    ...baseConfig.rules,
+                    'at-rule-no-unknown': null,
                     'scss/at-rule-no-unknown': baseConfig.rules['at-rule-no-unknown'],
                 },
             },

diff --git a/dev/.files/tailwind/_layers.scss b/dev/.files/tailwind/_layers.scss
@@ -0,0 +1,86 @@
+/**
+ * Charset.
+ */
+@charset "UTF-8"; // Must use double quotes.
+
+/**
+ * Default settings.
+ */
+$google-fonts: (
+    'Georama': 'ital,wght@0,100..900;1,100..900',
+) !default;
+
+/**
+ * Google fonts.
+ */
+@each $family, $weights in $google-fonts {
+    // This import is ok. It must use `url()` for variable interpolation to work properly.
+    /* stylelint-disable-next-line no-invalid-position-at-import-rule, import-notation -- ok. */
+    @import url('https://fonts.googleapis.com/css2?family=#{$family}:#{$weights}&display=swap');
+}
+
+/**
+ * Tailwind layers.
+ */
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+@tailwind variants;
+
+/**
+ * Our base layer.
+ */
+@layer base {
+    html {
+        @apply text-base;
+        @apply bg-color text-color-fg;
+
+        :where(a, .link):not(:where(.prose, .not-basic, .prose *, .not-basic *)) {
+            @apply text-color-link/80 no-underline hover:text-color-link;
+
+            &:hover {
+                @apply underline;
+            }
+        }
+
+        :where(h1, h2, h3, h4, h5, h6):not(:where(.prose, .not-basic, .prose *, .not-basic *)) {
+            @apply text-color-heading;
+        }
+    }
+
+    #header {
+        @apply bg-color-header text-color-header-fg;
+
+        :where(a, .link):not(:where(.prose, .not-basic, .prose *, .not-basic *)) {
+            @apply text-color-header-link/80 hover:text-color-header-link;
+        }
+
+        :where(h1, h2, h3, h4, h5, h6):not(:where(.prose, .not-basic, .prose *, .not-basic *)) {
+            @apply text-color-header-heading;
+        }
+    }
+
+    #sidebar {
+        @apply bg-color-sidebar text-color-sidebar-fg;
+
+        :where(a, .link):not(:where(.prose, .not-basic, .prose *, .not-basic *)) {
+            @apply text-color-sidebar-link/80 hover:text-color-sidebar-link;
+        }
+
+        :where(h1, h2, h3, h4, h5, h6):not(:where(.prose, .not-basic, .prose *, .not-basic *)) {
+            @apply text-color-sidebar-heading;
+        }
+    }
+
+    #footer {
+        @apply bg-color-footer text-color-footer-fg;
+
+        :where(a, .link):not(:where(.prose, .not-basic, .prose *, .not-basic *)) {
+            @apply text-color-footer-link/80 hover:text-color-footer-link;
+        }
+
+        :where(h1, h2, h3, h4, h5, h6):not(:where(.prose, .not-basic, .prose *, .not-basic *)) {
+            @apply text-color-footer-heading;
+        }
+    }
+}