Clean up repo

Author: CodapopKSP

.cursor/rules/library-of-time-core.mdc

@@ -8,7 +8,7 @@ alwaysApply: true
 - **Tech constraints**
   - Use only vanilla HTML, JavaScript, and CSS.
   - Do not introduce build tools, frameworks, or dependencies.
-  - Do not add new external scripts, CDNs, or APIs beyond the existing `masonry.pkgd.min.js` file.
+  - Do not add new external scripts, CDNs, or APIs beyond the existing `UserInterface/masonry.pkgd.min.js` file.
   - The site must continue to work when `index.html` is opened directly from disk.
 
 - **Deployment model**

.cursor/skills/add-calendar-system/SKILL.md

@@ -46,13 +46,13 @@ Each step below is required unless explicitly skipped by the user.
    - **Accuracy** (stub section).
    - **Source** (stub section).
    - Keep all sections present even if their bodies are just short placeholder sentences, and add **no detailed content** unless the user explicitly requested text (respect the project’s `Docs/` rule).
-3. Ensure the new file is referenced in `Docs/src/SUMMARY.md` under the right section, so `buildNodeData.js` will include it.
+3. Ensure the new file is referenced in `Docs/src/SUMMARY.md` under the right section, so `actions/buildNodeData.js` will include it.
 
 ### Reference tables in `#### Info` (months, weekdays, alignment)
 
 When adding **month names**, **weekday names**, or similar reference material:
 
-- Use **markdown tables** with a **header row** (required for mdBook and `buildNodeData.js` table conversion).
+- Use **markdown tables** with a **header row** (required for mdBook and `actions/buildNodeData.js` table conversion).
 - **Months:** Include month order/number, **days per month** (or an explicit rule when lengths vary), and **names**. If names are given in a **non-Latin script**, include a **Latin transliteration** column (or Latin-letter names) beside the native script so readers can parse the table without the script.
 - **Weekdays:** Include order (e.g. Sunday first) and names; state in the header if the week **starts on a different day** than Sunday.
 - **Approximate Gregorian alignment:** Add a column, footnote row, or small separate table **only when** the calendar maps in a stable, documentable way to Gregorian months or seasons. When there is **no** meaningful fixed mapping (e.g. a **drifting** 365-day solar year, or a lunar/lunisolar calendar unrelated to Gregorian months), use a one-row table or single cell with **Not applicable** (or an em dash)—**do not** invent long explanatory prose unless the user explicitly asks for body copy.
@@ -64,7 +64,7 @@ When adding **month names**, **weekday names**, or similar reference material:
 
 1. Run the build pipeline to regenerate `Content/nodeData.js` and the mdBook output, typically via:
    - `bash build.sh`
-   - or directly `node buildNodeData.js` if only `Content/nodeData.js` is needed.
+   - or directly `node actions/buildNodeData.js` if only `Content/nodeData.js` is needed.
 2. **Do not edit** `Content/nodeData.js` by hand; it is generated.
 3. After the build, locate the new node entry in `Content/nodeData.js`:
    - Search by the doc filename or title.
@@ -154,7 +154,7 @@ The main grid and `nodeUpdate.js` are not enough for the **Calendar View** side
 Before considering a new calendar/time system “hooked up”, confirm:
 
 - [ ] A Docs stub exists in `Docs/src/...` with title/outline and is referenced from `Docs/src/SUMMARY.md`.
-- [ ] `Content/nodeData.js` has been regenerated (via `build.sh` or `buildNodeData.js`), and the node id is known.
+- [ ] `Content/nodeData.js` has been regenerated (via `build.sh` or `actions/buildNodeData.js`), and the node id is known.
 - [ ] A main implementation function exists in the correct `CalendarAPI/...` file, following existing patterns and conventions.
 - [ ] `nodeUpdate.js` calls `setTimeValue` for this node id using the main function.
 - [ ] **`calendarView.js`:** `buildNodeValueGetters` includes an entry for the node’s short `id` (so Calendar View cells and month shading work when that system is selected).

README.md

@@ -1,12 +1,11 @@
 # The Library of Time
 
-![Library Animated SVG](The%20Library.svg)
+![Library Animated SVG](actions/The%20Library.svg)
 
 The mission of this website is to create a collection of every calendar with a verifiable date at a specific point in time, as well as other methods of timekeeping. It is to be a celebration of time as counted by humans from all walks of life, displaying all of the unique ways different people chose to satisfy one of humanity's earliest and most universal curiosities.
 
 https://libraryoftime.xyz
 
-<!-- Badges: colors in readmeBadges.json; entries & test coverage from buildNodeData.js; size from release.py -->
 ![Library Entries](https://img.shields.io/badge/Library%20Entries-148-blue)
 ![Library Size](https://img.shields.io/badge/Library%20Size-1.6%20MB-orange)
 ![Test Coverage](https://img.shields.io/badge/Test%20Coverage-72%25-brightgreen)
@@ -27,7 +26,7 @@ This command should be run from the Docs directory. It will generate the HTML fi
 
 The Library of Time is written entirely in vanilla HTML/JS/CSS. There must not be any imported packages nor external API.
 
-*Currently there is one exception (masonry.pkgd.min.js) purely to make the calendar groups more pleasing to look at. The website does not need it to function and should eventually be phased out.*
+*Currently there is one exception (`UserInterface/masonry.pkgd.min.js`) purely to make the calendar groups more pleasing to look at. The website does not need it to function and should eventually be phased out.*
 
 Calendars should be rigorously tested to ensure accuracy. These tests can be found in /Tests, and they can be run by uncommenting the following line located in runTests.js
 

masonry.pkgd.min.js UserInterface/masonry.pkgd.min.jsmasonry.pkgd.min.js renamed to UserInterface/masonry.pkgd.min.js

@@ -1,5 +1,18 @@
-# Bundler
-The `release.py` compresses the Library of Time project into a single .html file. The file can then be ran on client side without the need for a web server or even an internet connection. Specifically:
+# Build scripts
+
+## `buildNodeData.js`
+
+Generates `Content/nodeData.js` from markdown in `Docs/src`, and updates the Library Entries and Test Coverage badges in the root `README.md`. Run from the repo root via `bash build.sh` (Step 1) or:
+
+```bash
+node actions/buildNodeData.js
+```
+
+Badge colors are set by environment variables exported from `build.sh`.
+
+## `release.py`
+
+The bundler compresses the Library of Time project into a single .html file. The file can then be ran on client side without the need for a web server or even an internet connection. Specifically:
 
 - JS files are compressed into a single string and embeded in a `<script>` tag at the bottom of the page
 - CSS files are copied into a single `<style>` tag in the page he ader

actions/README.md

@@ -9,6 +9,8 @@
 const fs = require('fs');
 const path = require('path');
 
+const REPO_ROOT = path.join(__dirname, '..');
+
 // Map directory names to node types
 const directoryToType = {
     'StandardTime': 'Standard Time',
@@ -554,7 +556,7 @@ const typeToVariableName = {
 
 // Parse SUMMARY.md to get the ordered list of files
 function parseSummaryForFileOrder() {
-    const summaryPath = path.join(__dirname, 'Docs/src/SUMMARY.md');
+    const summaryPath = path.join(REPO_ROOT, 'Docs/src/SUMMARY.md');
     const summaryContent = fs.readFileSync(summaryPath, 'utf8');
     const lines = summaryContent.split('\n');
 
@@ -619,8 +621,20 @@ function formatNodeDataArray(nodeDataArray, variableName) {
 }
 
 function loadReadmeBadgeConfig() {
-    const configPath = path.join(__dirname, 'readmeBadges.json');
-    return JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    return {
+        libraryEntries: {
+            altText: 'Library Entries',
+            shieldsColor: process.env.LOT_README_BADGE_LIBRARY_ENTRIES_COLOR || 'blue',
+        },
+        librarySize: {
+            altText: 'Library Size',
+            shieldsColor: process.env.LOT_README_BADGE_LIBRARY_SIZE_COLOR || 'orange',
+        },
+        testCoverage: {
+            altText: 'Test Coverage',
+            shieldsColor: process.env.LOT_README_BADGE_TEST_COVERAGE_COLOR || 'brightgreen',
+        },
+    };
 }
 
 function readmeBadgeRegex(altText) {
@@ -630,7 +644,7 @@ function readmeBadgeRegex(altText) {
 
 function updateReadmeEntriesBadge(nodeCount) {
     const { altText, shieldsColor } = loadReadmeBadgeConfig().libraryEntries;
-    const readmePath = path.join(__dirname, 'README.md');
+    const readmePath = path.join(REPO_ROOT, 'README.md');
     const badgeUrl = `https://img.shields.io/badge/${encodeURIComponent(altText)}-${nodeCount}-${shieldsColor}`;
     const newLine = `![${altText}](${badgeUrl})`;
     const badgeRe = readmeBadgeRegex(altText);
@@ -646,7 +660,7 @@ function updateReadmeEntriesBadge(nodeCount) {
 }
 
 function countTestSuiteFunctions() {
-    const testsDir = path.join(__dirname, 'Tests');
+    const testsDir = path.join(REPO_ROOT, 'Tests');
     const skipFiles = new Set(['runTests.js', 'runCalendarDevTests.js']);
     let total = 0;
 
@@ -670,7 +684,7 @@ function updateReadmeTestCoverageBadge(testCount, entryCount) {
     const { altText, shieldsColor } = loadReadmeBadgeConfig().testCoverage;
     const percent = entryCount > 0 ? Math.round((testCount / entryCount) * 100) : 0;
     const badgeValue = `${percent}%`;
-    const readmePath = path.join(__dirname, 'README.md');
+    const readmePath = path.join(REPO_ROOT, 'README.md');
     const badgeUrl = `https://img.shields.io/badge/${encodeURIComponent(altText)}-${encodeURIComponent(badgeValue)}-${shieldsColor}`;
     const newLine = `![${altText}](${badgeUrl})`;
     const badgeRe = readmeBadgeRegex(altText);
@@ -687,8 +701,8 @@ function updateReadmeTestCoverageBadge(testCount, entryCount) {
 
 // Main build function
 function build() {
-    const docsSrcPath = path.join(__dirname, 'Docs/src');
-    const outputPath = path.join(__dirname, 'Content', 'nodeData.js');
+    const docsSrcPath = path.join(REPO_ROOT, 'Docs/src');
+    const outputPath = path.join(REPO_ROOT, 'Content', 'nodeData.js');
 
     console.log('Parsing SUMMARY.md for file order...');
     const fileOrder = parseSummaryForFileOrder();

The Library.svg actions/The Library.svgThe Library.svg renamed to actions/The Library.svg

@@ -5,16 +5,18 @@
 import io
 import re
 import os
-import json
 from urllib.parse import quote
 
 OUTPUT_DIR = 'dist'
 
 
 def load_readme_badge_config():
-    config_path = os.path.normpath(os.path.join(os.path.dirname(__file__), '..', 'readmeBadges.json'))
-    with open(config_path, 'r', encoding='utf-8') as config_file:
-        return json.load(config_file)
+    return {
+        'librarySize': {
+            'altText': 'Library Size',
+            'shieldsColor': os.environ.get('LOT_README_BADGE_LIBRARY_SIZE_COLOR', 'orange'),
+        },
+    }
 
 
 def readme_badge_regex(alt_text):

buildNodeData.js actions/buildNodeData.jsbuildNodeData.js renamed to actions/buildNodeData.js

@@ -1,11 +1,16 @@
 #!/bin/bash
 # Unified build script
-# Runs buildNodeData.js, mdbook build, and (optionally) the single-file HTML bundler
+# Runs actions/buildNodeData.js, mdbook build, and (optionally) the single-file HTML bundler
 
 set -e  # Exit on error
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 
+# README shields.io badge colors (names or hex without #)
+export LOT_README_BADGE_LIBRARY_ENTRIES_COLOR=blue
+export LOT_README_BADGE_LIBRARY_SIZE_COLOR=orange
+export LOT_README_BADGE_TEST_COVERAGE_COLOR=brightgreen
+
 echo "=========================================="
 echo "  Library of Time - Build Script"
 echo "=========================================="
@@ -14,10 +19,10 @@ echo ""
 # Step 1: Build nodeData.js from markdown files
 echo "Step 1: Building nodeData.js from markdown files..."
 echo "---------------------------------------------------"
-node "$SCRIPT_DIR/buildNodeData.js"
+node "$SCRIPT_DIR/actions/buildNodeData.js"
 
 if [ $? -ne 0 ]; then
-    echo "Error: buildNodeData.js failed!"
+    echo "Error: actions/buildNodeData.js failed!"
     exit 1
 fi
 

actions/release.py

@@ -442,6 +442,6 @@ <h2 class="modal-panel-title">Glossary of Terms</h2>
     <script src="Content/nodeData.js"></script>
     <script src="nodeUpdate.js"></script>
     <script src="script.js"></script>
-    <script src="masonry.pkgd.min.js"></script>
+    <script src="UserInterface/masonry.pkgd.min.js"></script>
 </body>
 </html>