Change default license branch to main

Fixes #33.

package.json

@@ -1,6 +1,6 @@
 {
     "name": "@fwdekker/template",
-    "version": "3.3.6",
+    "version": "3.6.5",
     "description": "The base template for pages on fwdekker.com.",
     "author": "Florine W. Dekker",
     "license": "MIT",
@@ -24,20 +24,20 @@
         "deploy": "grunt deploy"
     },
     "dependencies": {
-        "@picocss/pico": "^1.5.6"
+        "@picocss/pico": "^1.5.10"
     },
     "devDependencies": {
-        "grunt": "^1.5.3",
+        "grunt": "^1.6.1",
         "grunt-cli": "^1.4.3",
         "grunt-contrib-clean": "^2.0.1",
-        "grunt-contrib-cssmin": "^4.0.0",
+        "grunt-contrib-cssmin": "^5.0.0",
         "grunt-contrib-watch": "^1.1.0",
         "grunt-focus": "^1.0.0",
-        "grunt-webpack": "^5.0.0",
-        "ts-loader": "^9.4.1",
+        "grunt-webpack": "^6.0.0",
+        "ts-loader": "^9.5.1",
         "ts-node": "^10.9.1",
-        "typescript": "^4.9.3",
-        "webpack": "^5.75.0",
-        "webpack-cli": "^5.0.0"
+        "typescript": "^5.3.2",
+        "webpack": "^5.89.0",
+        "webpack-cli": "^5.1.4"
     }
 }

src/main/css/main.css

@@ -4,5 +4,5 @@
 @import "snippets/colors.css";
 
 @import "snippets/common.css";
+@import "snippets/forms.css";
 @import "snippets/nav.css";
-@import "snippets/validation.css";

src/main/css/snippets/colors.css

@@ -1,12 +1,39 @@
 /* pico.css overrides, based on https://picocss.com/docs/customization.html */
-:root {
+
+/* Light (default) */
+.fwd-nav,
+[data-theme="light"],
+:root:not([data-theme="dark"]) {
     --primary: rgb(0, 51, 204) !important;
     --primary-hover: rgb(0, 61, 245) !important;
     --primary-focus: rgba(0, 41, 163, 0.125) !important;
     --primary-focus-opaque: rgb(0, 41, 163) !important;
     --primary-focus-dark: rgb(0, 29, 114) !important;
     --primary-inverse: white !important;
+}
 
+/* Dark (auto) */
+@media only screen and (prefers-color-scheme: dark) {
+    :root:not([data-theme="light"]):not(.fwd-nav) {
+        --primary: #1e88e5 !important;
+        --primary-hover: #2196f3 !important;
+        --primary-focus: rgba(30, 136, 229, 0.25) !important;
+        --primary-focus-opaque: rgb(30, 136, 229) !important;
+        --primary-inverse: white !important;
+    }
+}
+
+/* Dark (forced) */
+:root[data-theme="dark"]:not(.fwd-nav) {
+    --primary: #1e88e5 !important;
+    --primary-hover: #2196f3 !important;
+    --primary-focus: rgba(30, 136, 229, 0.25) !important;
+    --primary-focus-opaque: rgb(30, 136, 229) !important;
+    --primary-inverse: white !important;
+}
+
+/* Common */
+:root {
     --form-element-active-border-color: var(--primary) !important;
     --form-element-focus-color: var(--primary-focus) !important;
     --switch-color: var(--primary-inverse) !important;

src/main/css/snippets/common.css

@@ -53,6 +53,11 @@ a[target="_blank"]::after {
     .grid-with-sidebar aside {
         max-width: var(--aside-width);
     }
+
+    .grid-with-sidebar aside .sticky {
+        position: sticky;
+        top: var(--block-spacing-vertical);
+    }
 }
 
 @media (max-width: 992px) {
@@ -75,7 +80,7 @@ noscript.fwd-js-notice p {
 
 /* Header */
 header.fwd-header a[href="."] {
-    color: black;
+    color: unset;
 }
 
 

src/main/css/snippets/forms.css

@@ -1,14 +1,21 @@
+/* Status card */
 .status-card {
     font-weight: bold;
+    position: relative;
+}
+
+.status-card output {
+    display: block;
+    margin-right: var(--block-spacing-horizontal);
 }
 
 .status-card .close {
-    float: right;
-    display: block;
+    position: absolute;
+    right: var(--block-spacing-horizontal);
+    top: calc(var(--block-spacing-vertical) / 2);
 
     width: 1rem;
     height: 1rem;
-    margin: 0 0 calc(var(--block-spacing-vertical) / 2) calc(var(--block-spacing-vertical) / 2);
 
     background-image: var(--icon-close);
     background-position: center;
@@ -46,6 +53,7 @@
 }
 
 
+/* Input validation */
 label.invalid,
 *[data-label-for].invalid,
 input.invalid,
@@ -59,3 +67,21 @@ input.valid,
 *[data-hint-for].valid {
     color: var(--form-element-valid-border-color) !important;
 }
+
+
+/* Enable hint-like styling on any element */
+.input-hint {
+    display: block;
+
+    /*noinspection CssUnresolvedCustomProperty*/
+    margin-top: calc(var(--spacing) * -.75);
+}
+
+
+/* Custom components */
+.inline-button {
+    display: inline-block;
+    width: unset;
+    margin: 0;
+    padding: 0.3em;
+}

src/main/css/snippets/overrides.css

@@ -1,14 +1,29 @@
 /* pico.css: Improved text contrast (see also picocss/pico#276) */
 :root {
     --code-color: var(--color) !important;
+}
+
+:root[data-theme="light"] {
     --muted-color: hsl(205deg, 15%, 41%) !important;
 }
 
-/* pico.css: Bold labels */
+:root[data-theme="dark"] {
+    --muted-color: hsl(205deg, 12%, 59%) !important;
+}
+
+/* pico.css: Bold <label> and <th>, except for checkbox/radio labels */
 :root {
     --form-label-font-weight: bold;
 }
 
+tr th {
+    font-weight: bold;
+}
+
+input:where([type="checkbox"], [type="radio"]) + label {
+    font-weight: normal;
+}
+
 /* pico.css: Halve header margins */
 h1 {
     --typography-spacing-vertical: 1.5rem;
@@ -54,8 +69,12 @@ article > header {
 }
 
 article > footer {
-    margin-bottom: calc(var(--block-spacing-vertical) / -2);
     margin-top: calc(var(--block-spacing-vertical) / 2);
+    margin-bottom: calc(var(--block-spacing-vertical) / -2);
+}
+
+article > footer > form > article {
+    margin-top: 0;
 }
 
 article > header > hgroup,

src/main/js/Storage.ts

@@ -20,7 +20,6 @@ export interface Storage {
      *
      * @param name the name of the array to store
      * @param value the array to store under the given name
-     * @protected
      */
     setArray(name: string, value: any[]): void;
 
@@ -29,7 +28,6 @@ export interface Storage {
      *
      * @param name the name of the boolean to retrieve
      * @param def the value to return if no boolean is stored with the given name
-     * @protected
      */
     getBoolean(name: string, def: boolean): boolean;
 
@@ -38,7 +36,6 @@ export interface Storage {
      *
      * @param name the name of the boolean to store
      * @param value the boolean to store under the given name
-     * @protected
      */
     setBoolean(name: string, value: boolean): void;
 
@@ -47,7 +44,6 @@ export interface Storage {
      *
      * @param name the name of the number to retrieve
      * @param def the value to return if no number is stored with the given name
-     * @protected
      */
     getNumber(name: string, def: number): number;
 
@@ -56,9 +52,24 @@ export interface Storage {
      *
      * @param name the name of the number to store
      * @param value the number to store under the given name
-     * @protected
      */
     setNumber(name: string, value: number): void;
+
+    /**
+     * Retrieves a string from storage.
+     *
+     * @param name the name of the string to retrieve
+     * @param def the value to return if no string is stored with the given name
+     */
+    getString(name: string, def: string): string;
+
+    /**
+     * Stores a string.
+     *
+     * @param name the name of the string to store
+     * @param value the number to store under the given name
+     */
+    setString(name: string, value: string): void;
 }
 
 /**
@@ -115,28 +126,32 @@ export class LocalStorage implements Storage {
     }
 
     setArray(name: string, value: any[]): void {
-        const item = this.read();
-        item[name] = JSON.stringify(value);
-        this.write(item);
+        this.setString(name, JSON.stringify(value));
     }
 
     getBoolean(name: string, def: boolean = false): boolean {
-        return (this.read()[name] ?? `${def}`) === "true";
+        return this.getString(name, def ? "true" : "false") === "true";
     }
 
     setBoolean(name: string, value: boolean): void {
-        const item = this.read();
-        item[name] = "" + value;
-        this.write(item);
+        this.setString(name, "" + value);
     }
 
     getNumber(name: string, def: number = 0): number {
-        return +(this.read()[name] ?? def);
+        return +this.getString(name, "" + def);
     }
 
     setNumber(name: string, value: number): void {
+        this.setString(name, "" + value);
+    }
+
+    getString(name: string, def: string = ""): string {
+        return this.read()[name] ?? def;
+    }
+
+    setString(name: string, value: string): void {
         const item = this.read();
-        item[name] = "" + value;
+        item[name] = value;
         this.write(item);
     }
 }
@@ -175,4 +190,12 @@ export class MemoryStorage implements Storage {
     getNumber(name: string, def: number): number {
         return this.storage[name] ?? def;
     }
+
+    setString(name: string, value: string): void {
+        this.storage[name] = value;
+    }
+
+    getString(name: string, def: string): string {
+        return this.storage[name] ?? def;
+    }
 }

src/main/js/Template.ts

@@ -86,7 +86,11 @@ function nav(highlightPath?: string, cb?: (json: any) => void): HTMLElement {
     const checkbox = stringToHtml(`<input id="fwd-nav-hamburger-checkbox" type="checkbox" hidden />`);
     nav.appendChild(checkbox);
 
-    const base = stringToHtml(`<ul><li><a id="logo" href="https://fwdekker.com/">FWDekker</a></span></li></ul>`);
+    const base = stringToHtml(
+        `<ul><li ${highlightPath === "/" ? `class="fwd-nav-highlighted" aria-current="page"` : ""}>` +
+        `<a id="logo" href="https://fwdekker.com/">FWDekker</a>` +
+        `</li></ul>`
+    );
     fetch("https://fwdekker.com/api/nav/")
         .then(it => it.json())
         .then(json => {
@@ -130,6 +134,7 @@ function unpackEntry(entry: any, parentPath: string = "/", highlightPath?: strin
 
     const a = document.createElement("a");
     a.innerText = entry.name;
+    a.tabIndex = 0;
     if (hasChildren) {
         const depth = parentPath.split("/").length - 2;  // -1 because count parts, then another -1 because of leading /
         a.innerText += ` ${depth === 0 ? "▾" : "▸"}`;
@@ -194,7 +199,7 @@ function footer(
     if (author === undefined) author = "Florine&nbsp;W.&nbsp;Dekker";
     if (authorURL === undefined) authorURL = "https://fwdekker.com/";
     if (license === undefined) license = "MIT";
-    if (licenseURL === undefined && vcsURL !== undefined) licenseURL = `${vcsURL}src/branch/master/LICENSE`;
+    if (licenseURL === undefined && vcsURL !== undefined) licenseURL = `${vcsURL}src/branch/main/LICENSE`;
     if (vcs === undefined && vcsURL !== undefined) vcs = "git";
     if (privacyPolicyURL === undefined) privacyPolicyURL = "https://fwdekker.com/privacy/";
 
@@ -238,8 +243,6 @@ function footerLink(prefix: string, text: string | null | undefined, url: string
  * not a valid value as a parameter for that function, its value is considered `undefined`.
  */
 doAfterLoad(() => {
-    $("html")!.dataset["theme"] = "light";
-
     const navTarget = $(getMetaProperty("fwd:nav:target"));
     if (navTarget != null) {
         navTarget.parentElement?.replaceChild(

src/main/js/Validation.ts

@@ -27,21 +27,23 @@ export function showMessageType(card: HTMLElement | HTMLFormElement,
                                 message?: string,
                                 type?: "busy" | "error" | "info" | "success" | "warning"): void {
     if (card instanceof HTMLFormElement) {
-        const formCard = $(`article[data-status-for="${card.id}"]`);
+        if (card.dataset.statusCard == null) return;
+
+        const formCard = $(`#${card.dataset.statusCard}`);
         if (formCard == null) return;
 
         card = formCard;
     }
     const output = $("output", card)!;
 
-    card.removeAttribute("aria-busy");
+    output.removeAttribute("aria-busy");
     card.classList.remove("hidden", "error", "info", "success", "warning");
 
     if (message == null || type == null) {
         card.classList.add("hidden");
         output.innerHTML = "";
     } else {
-        if (type === "busy") card.setAttribute("aria-busy", "true");
+        if (type === "busy") output.setAttribute("aria-busy", "true");
         else card.classList.add(type);
 
         output.innerHTML = message;
@@ -200,7 +202,7 @@ doAfterLoad(() => {
         });
     });
 
-    $a("input + small[data-hint]").forEach((hint: Element) => {
+    $a("small[data-hint]").forEach((hint: Element) => {
         if (!(hint instanceof HTMLElement)) return;
 
         hint.innerHTML = hint.dataset["hint"] ?? "";

src/test/index.html

@@ -11,7 +11,7 @@
     <meta name="fwd:nav:target" content="#nav" />
     <meta name="fwd:nav:highlight-path" content="/Tools/Dice/" />
     <meta name="fwd:footer:target" content="#footer" />
-    <meta name="fwd:footer:vcs-url" content="https://git.fwdekker.com/FWDekker/fwdekker-template/" />
+    <meta name="fwd:footer:vcs-url" content="https://git.fwdekker.com/fwdekker.com/template/" />
     <meta name="fwd:footer:version" content="vTEST" />
     <meta name="fwd:validation:load-forms" />
 
@@ -61,8 +61,8 @@
                         <h3>Already have an account? Welcome back!</h3>
                     </hgroup>
                 </header>
-                <form id="test-form" novalidate>
-                    <article class="status-card hidden" data-status-for="test-form">
+                <form id="test-form" data-status-card="test-status-card" novalidate>
+                    <article id="test-status-card" class="status-card hidden">
                         <output>Congrats!</output>
                         <a class="close" href="#" aria-label="Close"></a>
                     </article>