kireji 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
  "name": "kireji",
- "version": "0.2.0",
+ "version": "0.3.0",
  "description": "A web framework for stateful, entropy-perfect, multi-origin web applications. Currently in alpha. Expect breaking changes for version 0. Use with caution!",
  "files": [
   "src/",

package/src/app/kireji/editor/tab-group/build.js

@@ -3,10 +3,7 @@ const tabBitDepths = [0n, 0n]
 const tabOffsets = [0n]
 const permutationSizes = [1n]
 const payloadSizes = [1n]
-const partOffsets = [0, allParts.length]
-const subjectCount = BigInt(allParts.reduce((subjectCount, part, i) =>
- partOffsets[i + 2] = subjectCount + part.filenames.length, allParts.length
-))
+const subjectCount = BigInt(allSubjects.length)
 const maxTabCount = subjectCount
 const LSB = []
 const powerFloor = 2n ** BigInt(subjectCount.toString(2).length - 1)
@@ -63,8 +60,6 @@ tabGroup.define({
  tabBitDepths: { value: tabBitDepths },
  permutationSizes: { value: permutationSizes },
  payloadSizes: { value: payloadSizes },
- partOffsets: { value: partOffsets },
- subjectCount: { value: subjectCount },
  maxTabCount: { value: maxTabCount },
  previousPart: { value: null, writable: true },
  tree: { value: null, writable: true },

package/src/app/kireji/editor/tab-group/factor-get-permutation.js

@@ -1,4 +1,4 @@
-const indexOfLastPossibleTabSubject = tabGroup.subjectCount - 1n
+const indexOfLastPossibleTabSubject = BigInt(allSubjects.length) - 1n
 const indexOfLastOpenTab = NUMBER_OF_TABS_OPEN - 1n
 
 let permutationFactorOfCurrentTabIndex = 1n

package/src/app/kireji/editor/tab-group/part.css

@@ -46,16 +46,7 @@
  display: none;
 }
 
-#kireji_app tab-[data-drag-preview] {
- position: fixed;
- pointer-events: none;
-}
-
-#kireji_app tab-[data-drag-preview] .close-tab {
- display: none;
-}
-
-#kireji_app tab- {
+tab- {
  height: fit-content;
  white-space: pre;
  text-overflow: ellipsis;
@@ -71,12 +62,12 @@
  line-height: var(--tab-line-height);
 }
 
-#kireji_app tab- img {
+tab- img {
  height: var(--tab-icon-size);
  margin: calc((var(--tab-group-height) - var(--tab-icon-size)) / 2) 0;
 }
 
-#kireji_app tab- .tab-button {
+tab- .tab-button {
  font-size: var(--default-font-size);
  font-weight: 400;
  height: unset;
@@ -105,6 +96,20 @@
  z-index: 999;
 }
 
+tab-[data-drag-preview] {
+ width: min-content;
+ pointer-events: none;
+ position: fixed;
+}
+
+tab-[data-drag-preview] .tab-button {
+ padding-right: calc(var(--spacing) / 1.5);
+}
+
+tab-[data-drag-preview] .close-tab {
+ display: none;
+}
+
 #kireji_app tab-[data-drop-target="after"]::before {
  right: -1px;
 }
@@ -156,7 +161,7 @@ body.modern.light #kireji_app tab-:is([data-active], :not([data-active]):hover)
  background-color: var(--bg-light-est);
 }
 
-body.modern #kireji_app tab- {
+body.modern tab- {
  box-shadow:
   inset 0 -2px 0 -1px var(--bg-un-mode),
   inset 0 2px 0 -1px var(--bg-un-mode),
@@ -169,7 +174,12 @@ body.modern #kireji_app tab-[data-active] {
   inset -2px 0 0 -1px var(--bg-un-mode);
 }
 
-body.modern #kireji_app tab- .tab-button {
+body.modern>tab-[data-drag-preview] {
+ box-shadow: inset 0 0 0 1px var(--bg-un-mode);
+ background-color: var(--bg-light-est);
+}
+
+body.modern tab- .tab-button {
  line-height: var(--tab-group-height);
 }
 
@@ -179,10 +189,6 @@ body.modern #kireji_app tab- .tab-path {
  display: inline-block;
 }
 
-body.modern #kireji_app tab-[data-drag-preview] .tab-path {
- display: none;
-}
-
 body.vintage #kireji_app #tab-group {
  height: calc(4px + var(--tab-group-height));
  background: transparent;
@@ -222,11 +228,11 @@ body.vintage #kireji_app tab-[data-active] {
  z-index: 2;
 }
 
-body.vintage #kireji_app tab- .tab-path {
+/*body.vintage #kireji_app tab- .tab-path {
  display: none;
-}
+}*/
 
-body.vintage #kireji_app tab-:not([data-active]) {
+body.vintage tab-:not([data-active]) {
  height: var(--tab-group-height);
  position: relative;
  top: 2px;
@@ -239,7 +245,7 @@ body.vintage #kireji_app tab-[data-active] .tab-button {
  padding-left: calc(var(--spacing) / 1.5 + 2px);
 }
 
-body.vintage #kireji_app tab- .tab-button {
+body.vintage tab- .tab-button {
  padding-right: calc(var(--tab-group-height) + 8px);
  border-top-left-radius: 2px;
  border-top-right-radius: 2px;
@@ -251,7 +257,7 @@ body.vintage #kireji_app tab- .tab-button {
   inset -3px 0 0 -1px var(--bg-dark);
 }
 
-body.dark.vintage #kireji_app tab- .tab-button {
+body.dark.vintage tab- .tab-button {
  box-shadow:
   inset -2px 0 0 -1px black,
   inset 1px 1px 0 0 var(--bg-light-er),
@@ -279,7 +285,7 @@ body.vintage #kireji_app tab-[data-active] .tab-button:focus::after {
  --inset: 4px;
 }
 
-body.vintage #kireji_app tab-[data-drag-preview] .tab-button {
+body.vintage>tab-[data-drag-preview] .tab-button {
  box-shadow: inset 0 0 0 1px black;
 }
 

package/src/app/kireji/editor/tab-group/routeID-distribute.js

@@ -37,7 +37,7 @@ if (numberOfTabsOpen !== tabGroup.openTabs.length || tabGroup.permutationRouteID
  tabGroup.tree = new tabGroup.FenwickTree()
 
  const indexOfLastOpenTab = numberOfTabsOpen - 1n
- const indexOfLastPossibleTabSubject = tabGroup.subjectCount - 1n
+ const indexOfLastPossibleTabSubject = BigInt(allSubjects.length) - 1n
 
  for (let currentTabIndex = 0n; currentTabIndex < numberOfTabsOpen; currentTabIndex++) {
 
@@ -56,29 +56,12 @@ if (numberOfTabsOpen !== tabGroup.openTabs.length || tabGroup.permutationRouteID
   const payload = payloadRouteID % tabGroup.payloadCardinality
   payloadRouteID /= tabGroup.payloadCardinality
 
-  // Using embedded match logic, split apart the true index into usable file data.
-  if (trueIndexOfActiveTabSubject < allParts.length) {
-
-   // The index is in the first plane; it maps to the set of parts themselves.
-   tabGroup.openTabs[currentTabIndex] = {
-    part: allParts[trueIndexOfActiveTabSubject],
-    payload
-   }
-  } else {
-
-   // The index is among the later planes, indicating a specific file defined on a specific part.
-   for (let indexOfPlane = 1; indexOfPlane <= allParts.length; indexOfPlane++) {
-    const nextPlaneIndex = indexOfPlane + 1
-    if (nextPlaneIndex > allParts.length || trueIndexOfActiveTabSubject < tabGroup.partOffsets[nextPlaneIndex]) {
-     const indexOfOwningPart = indexOfPlane - 1
-     const part = allParts[indexOfOwningPart]
-     const firstIndexOfCurrentPlane = tabGroup.partOffsets[indexOfPlane]
-     const indexOfSubjectWithinCurrentPlane = Number(trueIndexOfActiveTabSubject) - firstIndexOfCurrentPlane
-     const filename = part.filenames[indexOfSubjectWithinCurrentPlane]
-     tabGroup.openTabs[currentTabIndex] = { part, filename, payload }
-     break
-    }
-   }
+  // Match the subject index with the actual subject.
+  const [host, filename] = allSubjects[Number(trueIndexOfActiveTabSubject)]
+  tabGroup.openTabs[currentTabIndex] = {
+   part: partsByHost[host],
+   filename,
+   payload
   }
  }
 

package/src/app/kireji/editor/tab-group/routeID-get-permutation.js

@@ -7,10 +7,9 @@ tabGroup.tree = new tabGroup.FenwickTree()
 let permutationRouteID = 0n
 for (let currentTabIndex = 0n; currentTabIndex < numberOfTabsOpen; currentTabIndex++) {
 
- // Use an embedded match to combine the current tab's file data into an absolute tab subject index.
+ // Get the absolute tab subject index.
  const { part, filename } = TABS[Number(currentTabIndex)]
- const index = allParts.indexOf(part)
- const trueIndexOfActiveTabSubject = BigInt(filename ? tabGroup.partOffsets[index + 1] + part.filenames.indexOf(filename) : index)
+ const trueIndexOfActiveTabSubject = BigInt(subjectIndices.get(part.host + (filename ? "/" + filename : "")))
 
  // Use the Fenwick tree to obtain the availability-based index of the tab subject in the list of remaining subjects.
  const availabilityIndexOfActiveTabSubject = tabGroup.tree.query(trueIndexOfActiveTabSubject - 1n)

package/src/app/kireji/editor/tab-group/type.d.ts

@@ -57,10 +57,6 @@ declare interface IKirejiAppTabGroup
  readonly activeTabIndex: number
  /** The index of the preview tab, if one exists. The preview tab is the tab which can be replaced when opening a new tab. */
  readonly previewTabIndex?: number
- /** The array of memoized offset route IDs corresponding to the start of each part's filename plane. */
- readonly partOffsets: number[]
- /** The total number of tab subjects available - the number of _different_ filenames and part summaries that can be the focus of their own tab (regardless of the maximum number of tabs which can be open at once). */
- readonly subjectCount: bigint
  /** A data type which can be used to performantly rank and unrank permutation indices. */
  readonly FenwickTree: typeof FenwickTree
 }

package/src/app/kireji/static.css

@@ -9,14 +9,14 @@
  --sidebar-width: calc(var(--tool-bar-width) + var(--sidebar-view-width));
 }
 
-body.modern #kireji_app {
+body.modern {
  --tab-group-height: calc(var(--tab-line-height) + var(--spacing) / 1.5);
  --tab-line-height: 26px;
  --crumbs-height: 26px;
  --tab-icon-size: 20px;
 }
 
-body.vintage #kireji_app {
+body.vintage {
  --tab-group-height: calc(var(--tab-line-height) + 2px);
  --tab-line-height: 20px;
  --crumbs-height: 20px;

package/src/build.js

@@ -1,23 +1,23 @@
 #!/usr/bin/env node
-function ƒ(_) {
+function ƒ(_, compressedSubjectOrigins) {
 
  // Initialization
  const
   environment = globalThis.constructor === globalThis.Window ? "client" : globalThis.constructor === globalThis.ServiceWorkerGlobalScope ? "worker" : (
    Object.defineProperty(_, "$", { value: (f => x => f(x).toString().trim())(require("child_process").execSync) }),
    _.command = process.argv[2] || "help",
-   _.local = _.command === "dev",
+   _.local = _.command === "dev" ? "1" : "0",
    require.main === module && (
     _.branch = _.$("git rev-parse --abbrev-ref HEAD").toString().trim(),
     _.gitSHA = _.$("git rev-parse HEAD").toString().trim(),
-    _.version = (([M, m, p], c) => _.local ? +M && c === "major" ? `${++M}.0.0` : c === "minor" || (!+M && c === "major") ? `${M}.${++m}.0` : `${M}.${m}.${++p}` : `${M}.${m}.${p}`)(_.$("git log -1 --pretty=%s").toString().match(/^\s*(\d+\.\d+\.\d+)/)[1].split("."), _.change),
+    _.version = (([M, m, p], c) => +_.local ? +M && c === "major" ? `${++M}.0.0` : c === "minor" || (!+M && c === "major") ? `${M}.${++m}.0` : `${M}.${m}.${++p}` : `${M}.${m}.${p}`)(_.$("git log -1 --pretty=%s").toString().match(/^\s*(\d+\.\d+\.\d+)/)[1].split("."), _.change),
     _.modified = _.$('git show -s --format=%ci HEAD').toString().trim(),
-    _.ETag = `"${_.version}.${_.gitSHA.slice(0, 7)}${_.local ? ("." + Math.random()).slice(2, 10) : ""}"`,
+    _.ETag = `"${_.version}.${_.gitSHA.slice(0, 7)}${+_.local ? ("." + Math.random()).slice(2, 10) : ""}"`,
     _.name = __dirname.split(/[\\/]/).filter(Boolean).at(-4)
    ),
    "node"
   ),
-  production = _.branch === "main" && environment !== "node" && !_.local,
+  production = _.branch === "main" && environment !== "node" && !(+_.local),
   welcomeMessage = `
      ▌ ▘     ▘▘ ${_.name}
  k = ▙▘▌▛▘█▌ ▌▌ ${_.branch}
@@ -132,6 +132,9 @@ function ƒ(_) {
   pathRadix = "123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ-_0",
   encodeSegment = routeID => {
 
+   if (typeof routeID !== "bigint")
+    throw new RangeError(`Segment encoder can only encode a bigint type (got ${typeof routeID})`)
+
    if (routeID < 0n)
     throw new RangeError("Segment encoder cannot encode a negative route ID.")
 
@@ -230,16 +233,41 @@ function ƒ(_) {
  ┊ Now booting the Kireji Web Framework ┊
  ╰┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈╯
 `)
-  const buildStartTime = Date.now()
+
+  const
+   bootStartTime = Date.now(),
+   allSubjects = [],
+   subjectIndices = new Map(),
+   subjectOrigins = new Map()
+
   if (environment === "node" && require.main === module) {
+   subjectOrigins.set("", true)
+
    const
-    stats = { fileCount: 0, domainCount: 0 },
+    stats = { fileCount: 0, partCount: 0, ignoreCount: 0 },
     { readdirSync: readFolder, readFileSync: readFile, existsSync: exists } = require("fs"),
-    { resolve } = require("path"),
-    configPath = resolve(__dirname, "../../../src/kireji.json")
-
-   if (exists(configPath))
-    Object.assign(_, require(configPath))
+    { resolve } = require("path")
+
+   logScope(1, "Merging Configurations", configLog => {
+    for (const key in _) {
+     const value = _[key]
+     if (typeof value !== "string")
+      throw new TypeError(`Internal Error: found framework default config parameter that was not a string (typeof "${key}" === ${typeof value}).`)
+     subjectOrigins.set("/" + key, false)
+    }
+    const projectConfigPath = resolve(__dirname, "../../../src/kireji.json")
+    if (exists(projectConfigPath)) {
+     const projectConfig = require(projectConfigPath)
+     for (const key in projectConfig) {
+      const value = projectConfig[key]
+      if (typeof value !== "string")
+       throw new TypeError(`All config values in kireji.json must be strings (found typeof "${key}" === ${typeof value}).`)
+      _[key] = value
+      subjectOrigins.set("/" + key, true)
+     }
+    }
+    configLog("Done.")
+   })
 
    logScope(1, "Archiving Repository", archiveLog => {
     let lastLogFlush = Date.now()
@@ -256,88 +284,69 @@ function ƒ(_) {
        lastLogFlush = now
       }
      },
-     readRecursive = (host, baseDir, overlayDir, part, depth) => {
-      if (host && host.length > 253)
-       throw SyntaxError(`requested host is ${host.length} characters long, exceeding the maximum domain name length of 253. \n${host}`)
+     frameworkRoot = __dirname,
+     projectRoot = resolve(__dirname, "../../../src"),
+     readRecursive = domains => {
 
-      // 1. Get entries from BOTH directories if they exist
-      const baseEntries = exists(baseDir) ? readFolder(baseDir, { withFileTypes: true }) : []
-      const overlayEntries = exists(overlayDir) ? readFolder(overlayDir, { withFileTypes: true }) : []
+      const host = [...domains].reverse().join(".")
 
-      // 2. Create a unified map of names to entry types (Overlay wins)
-      const unifiedEntries = new Map()
+      if (host.length > 253)
+       throw SyntaxError(`Part host would be ${host.length} characters long, exceeding the maximum host name length of 253 (${host}).`)
 
-      // Base entries first
-      for (const entry of baseEntries)
-       unifiedEntries.set(entry.name, { entry, source: 'base' })
+      const mergedSubjects = new Map()
 
-      // Overlays overwrite base definitions
-      for (const entry of overlayEntries)
-       unifiedEntries.set(entry.name, { entry, source: 'overlay' })
+      const frameworkPath = resolve(frameworkRoot, ...domains)
+      if (exists(frameworkPath))
+       for (const subject of readFolder(frameworkPath, { withFileTypes: true }))
+        mergedSubjects.set(subject.name, { subject, path: frameworkPath })
 
-      const filenames = []
+      const projectPath = resolve(projectRoot, ...domains)
+      if (exists(projectPath))
+       for (const subject of readFolder(projectPath, { withFileTypes: true }))
+        mergedSubjects.set(subject.name, { subject, path: projectPath })
 
-      for (const [itemName, { entry, source }] of unifiedEntries) {
-       // Ignore logic (TS files, hidden files, etc)
-       if (itemName.startsWith(".") || itemName === "Icon" || (!host && itemName === "build.js") || itemName.endsWith(".ts")) {
-        bufferLog(4, "".padEnd(depth, " ") + `⬚ ${itemName.padEnd(20, " ")} - ignored`)
-        continue
-       }
+      const part = domains.length ? {} : _
 
-       // Determine paths for the next step
-       const nextBase = `${baseDir}/${itemName}`
-       const nextOverlay = `${overlayDir}/${itemName}`
-
-       // Logic for host string construction remains...
-       const filePath = (host ? host.split(".").reverse().join("/") + "/" : "") + itemName
-
-       if (entry.isDirectory()) {
-        bufferLog(2, "".padEnd(depth, "  ") + `▼ ${itemName}/`)
-
-        // RECURSION: Pass both potential paths down
-        readRecursive(
-         host ? (itemName ? itemName + "." + host : host) : itemName ?? "",
-         nextBase,
-         nextOverlay,
-         (part[itemName] = part[itemName] || {}), // Ensure we merge into existing object if base/overlay share folder
-         depth + 1
-        )
-
-       } else if (entry.isFile()) {
-        // Prioritize overlay file path, fallback to base
-        const actualPath = (source === 'overlay') ? nextOverlay : nextBase
-        filenames.push([itemName, actualPath])
+      for (const [itemName, { subject, path }] of mergedSubjects)
+       if (itemName.startsWith(".") || itemName === "Icon" || (!host && itemName === "build.js") || itemName.endsWith(".ts")) {
+        stats.ignoreCount++
+        bufferLog(4, "".padEnd(domains.length, " ") + `⬚ ${itemName.padEnd(20, " ")} - ignored`)
+       } else if (subject.isDirectory()) {
+        stats.partCount++
+        bufferLog(2, "".padEnd(domains.length, "  ") + `▼ ${itemName}/`)
+        subjectOrigins.set(itemName + (host ? "." + host : ""), path === projectPath)
+        part[itemName] = readRecursive([...domains, itemName])
+       } else if (subject.isFile()) {
+        stats.fileCount++
+        const isBinary = itemName.endsWith(".png") || itemName.endsWith(".gif")
+        bufferLog(3, "".padEnd(domains.length, " ") + `${isBinary ? "▣" : "≡"} ${itemName}`)
+        subjectOrigins.set(host + "/" + itemName, path === projectPath)
+        part[itemName] = readFile(resolve(path, itemName), isBinary ? "base64" : "utf-8")
+       } else {
+        stats.ignoreCount++
+        bufferLog(4, "".padEnd(domains.length, " ") + `⬚ ${itemName.padEnd(20, " ")} - ignored (exotic type)`)
        }
-      }
-
-      // File processing (remains largely the same, but uses the prioritized path)
-      for (const [filename, filePath] of filenames) {
-       const isBinary = filename.endsWith("png") || filename.endsWith("gif")
-       const content = readFile(filePath, isBinary ? "base64" : "utf-8")
-
-       part[filename] = content
-       stats.fileCount++
-       bufferLog(3, "".padEnd(depth, " ") + `${isBinary ? "▣" : "≡"} ${filename}`)
-      }
 
-      stats.domainCount++
+      return part
      }
 
-    readRecursive("", __dirname, resolve(__dirname, "../../../src"), _, 0)
+    readRecursive([])
 
     if (batchedLogs.length)
      archiveLog(batchedLogs.join("\n") + "\n")
 
-    archiveLog(`Archived in ${Date.now() - buildStartTime}ms`)
+    archiveLog(`Archived in ${Date.now() - bootStartTime}ms`)
    })
 
-   logScope(2, "\nLogging Domain Stats", () => {
+   logScope(2, "\nDomain Stats", () => {
     logAny(2, [{
-     Parts: { Amount: stats.domainCount },
+     Parts: { Amount: stats.partCount },
      Files: { Amount: stats.fileCount },
+     Ignored: { Amount: stats.ignoreCount }
     }], "table")
    })
   }
+
   logScope(1, "\nRecursively Hydrating Parts", hydrateLog => {
 
    class SourceMappedFile {
@@ -404,7 +413,7 @@ function ƒ(_) {
     packAndMap(url) {
      const sourceFile = this
      const script = sourceFile.lines.join("\n")
-     return _.mapping
+     return +_.mapping
       ? script +
       `
 //${"#"} sourceMappingURL=data:application/json;charset=utf-8;base64,${btoaUnicode(sourceFile.getMap())}${url
@@ -474,7 +483,7 @@ function ƒ(_) {
     earlyImageSources = [],
     partsByHost = {},
     preHydrationArchive = serialize(_),
-    hydrateRecursive = (part, domains = []) => {
+    hydratePartsRecursive = (part, domains = []) => {
 
      let host
 
@@ -516,7 +525,9 @@ function ƒ(_) {
        const extendsString = part.manifest.extends ?? "part"
        const relativeStepsBack = extendsString.match(/\.*$/)[0].length
        const typename = relativeStepsBack ? `${extendsString.slice(0, -relativeStepsBack)}.${domains.slice(relativeStepsBack - 1).join(".")}` : extendsString.includes(".") ? extendsString : `${extendsString}.abstract.parts`
-       prototype = hydrateRecursive(typename)
+       prototype = hydratePartsRecursive(typename)
+       if (!prototype.isAbstract)
+        throw new Error(`Hydration Error: parts can only extend abstract parts (${host} tried to extend ${prototype.host}).`)
        Object.setPrototypeOf(part, prototype)
        part.define({
         isAbstract: { value: part.manifest.abstract }
@@ -662,6 +673,8 @@ function ƒ(_) {
          earlyImageSources.push([part, fn.slice(6)])
         imageSources.push([part, fn])
        }
+       subjectIndices.set(`${host}/${fn}`, allSubjects.length)
+       allSubjects.push([host, fn])
       }
       for (const methodID in part.manifest)
        if (!["extends", "abstract"].includes(methodID))
@@ -690,7 +703,7 @@ function ƒ(_) {
         part.define({ [identifier]: { value: childPart } })
        }
 
-       hydrateRecursive(childPart, [subdomain, ...domains])
+       hydratePartsRecursive(childPart, [subdomain, ...domains])
 
        childPart.define({ "..": { value: part } })
 
@@ -699,10 +712,23 @@ function ƒ(_) {
       }
       if (!part.isAbstract) instances.push(part)
       allParts.push(part)
+      subjectIndices.set(host, allSubjects.length)
+      allSubjects.push([host])
      })
 
      return part
     },
+    hydrateSubjectOrigins = () => {
+     if (environment === "node") {
+      const bits = allSubjects.map(([host, fn]) => +subjectOrigins.get(host + (fn ? "/" + fn : "")))
+      const bitString = bits.join("")
+      compressedSubjectOrigins = encodeSegment(BigInt("0b" + bitString))
+     } else {
+      const bitString = decodeSegment(compressedSubjectOrigins).toString(2).padStart(allSubjects.length, "0")
+      const bits = [...bitString]
+      allSubjects.forEach(([host, fn], index) => subjectOrigins.set(host + (fn ? "/" + fn : ""), bits[index] === "1"))
+     }
+    },
     countAndSortInheritorsRecursive = part => {
      if (part.totalInheritors !== undefined)
       return part.totalInheritors
@@ -717,7 +743,8 @@ function ƒ(_) {
      return totalInheritors
     }
 
-   hydrateRecursive(_)
+   hydratePartsRecursive(_)
+   hydrateSubjectOrigins()
    countAndSortInheritorsRecursive(_.parts.abstract.part)
    hydrateLog(`\nParts hydrated in ${Date.now() - hydrationStartTime}ms.`)
 
@@ -752,10 +779,10 @@ function ƒ(_) {
    })
 
    logScope(1, "\nBuilding Part Instances", buildLog => {
-    const buildStartTime = Date.now()
+    const bootStartTime = Date.now()
     for (const part of instances)
      part.startBuild()
-    buildLog(`Parts built in ${Date.now() - buildStartTime}ms.`)
+    buildLog(`Parts built in ${Date.now() - bootStartTime}ms.`)
    })
 
    logScope(2, "\nLogging Part Entropy", () => {
@@ -795,7 +822,7 @@ function ƒ(_) {
 
   bootLog(`
  ╭┈┈┈┈┈┈┈┈┈┈┈ BOOT SUCCEEDED ┈┈┈┈┈┈┈┈┈┈┈╮
- ┊ Booted in ${(Date.now() - buildStartTime + "ms.").padEnd(27, " ")}┊
+ ┊ Booted in ${(Date.now() - bootStartTime + "ms.").padEnd(27, " ")}┊
  ┊                                      ┊
  ┊ End of synchronous script execution. ┊
  ╰┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈╯
@@ -804,12 +831,12 @@ function ƒ(_) {
 }
 
 ƒ({
- verbosity: 1,
+ verbosity: "1",
  // TODO: Fix source mapping bugs.
- mapping: false,
+ mapping: "0",
  change: "major",
- hangHydration: 0,
- haltHydration: false,
+ hangHydration: "0",
+ haltHydration: "0",
  defaultApplicationHost: "kireji.app",
- port: 3000
+ port: "3000"
 })

package/src/build.js_.js

@@ -1,13 +1,6 @@
 const boilerplate = ƒ.toString()
-
 const sourceFile = new SourceMappedFile("../", undefined, "build.js")
 sourceFile.addSection(boilerplate, sourceFile.addSource("build.js", boilerplate))
-sourceFile.addSection(`\nƒ(${JSON.stringify(_, (k, v) => {
- if (typeof v === "bigint")
-  return v.toString() + "n"
-
- return v
-
-}, 1)})`, sourceFile.addSource(property.filename, property.content))
+sourceFile.addSection(`\nƒ(${serialize(_)}, ${serialize(compressedSubjectOrigins)})`, sourceFile.addSource(property.filename, property.content))
 const script = sourceFile.packAndMap()
 return script

package/src/parts/abstract/scroller/view-add.js

@@ -1,5 +1,16 @@
+if (!scroller.query)
+ throw new ReferenceError(`Scrollers must define a css-style "query" property which can select the parent element of the scroller (from ${scroller.host}).`)
+
 scroller.container = Q(scroller.query + ">scroller-")
+
+if (!scroller.container)
+ throw new ReferenceError(`Could not find scroller parent element via query "${scroller.query}" (from ${scroller.host}).`)
+
 scroller.scrollBar = Q(scroller.query + ">scroll-bar")
+
+if (!scroller.scrollBar)
+ throw new ReferenceError(`Could not find scroller components in the element "${scroller.query}" (from ${scroller.host}). Use scroller.wrap to wrap the HTML contents of the element with the scroller's container and include the custom scroll bar HTML (from ${scroller.host}).`)
+
 scroller.thumb = scroller.scrollBar.querySelector("thumb-")
 scroller.content = Q(scroller.query + ">scroller->scroll-content")
 scroller.container.scrollTop = scroller.fraction * scroller.container.scrollHeight

package/src/parts/core/client/async-install.js

@@ -4,7 +4,7 @@ await Promise.all([
 ])
 
 logScope(0, "Finalizing Hydration", log => {
- if (_.haltHydration && !production)
+ if (+_.haltHydration && !production)
   warn('Intentionally blocked hydration.')
  else {
 

package/src/parts/core/hot-keys/combo_.js

@@ -15,6 +15,8 @@ for (const code of hotKeys.pressed)
   terminalKeys.add(code.slice(5).toLowerCase())
  else if (/^(Minus|Equal|Semicolon|Quote|Comma|Period|Slash|Backquote|Backslash|Bracket(Right|Left)|Arrow(Up|Down|Left|Right)|Escape|Tab|Enter|Backspace)$/.test(code))
   terminalKeys.add(code.toLowerCase())
+ else if (!production && code === "F8")
+  debugger
  else debug("Unhandled Key Code: " + code)
 
 const combo = [...terminalKeys].sort()

package/src/parts/core/server/sync-install.js

@@ -199,7 +199,7 @@ const httpServer = require('http').createServer((request, response) => logServer
     /** @type {IVersionedExports} */
     let destinationExports
     try {
-     destinationExports = destinationVersion === _.version ? currentExports : require(`../.versions/${destinationVersion}.js`)
+     destinationExports = destinationVersion === _.version ? currentExports : require(`../../../.versions/${destinationVersion}.js`)
     } catch {
      throw `Bad Version: ${destinationVersion}`
     }
@@ -211,7 +211,7 @@ const httpServer = require('http').createServer((request, response) => logServer
      /** @type {IVersionedExports} */
      let sourceExports
      try {
-      sourceExports = require(`../.versions/${sourceVersion}.js`)
+      sourceExports = require(`../../../.versions/${sourceVersion}.js`)
      } catch {
       throw `Bad Version: ${sourceVersion}`
      }
@@ -260,4 +260,4 @@ const httpServer = require('http').createServer((request, response) => logServer
  }
 ))
 
-httpServer.listen(_.port, () => logScope(0, `Server Ready - http://localhost:${_.port}`))
+httpServer.listen(+_.port, () => logScope(0, `Server Ready - http://localhost:${_.port}`))

package/src/parts/desktop/era/modern/part.css

@@ -57,13 +57,13 @@ task-bar button,
 task-bar menu-button {
  height: var(--icon-size);
  line-height: var(--icon-size);
- cursor: pointer;
  font-size: calc(var(--icon-size) * 1.2);
 }
 
 button:hover,
 menu-button:hover {
  color: var(--accent);
+ cursor: pointer;
 }
 
 menu-button>img {

package/src/parts/desktop/icons/point.js

@@ -70,7 +70,7 @@ pointer.handle({
   desktopIcons.setRouteID(0n)
 
   const application = desktopIcons.superset[Number(TARGET_ELEMENT.getAttribute("data-index"))]
-  const targetLocation = (_.local ? `http://${application.host}.localhost:${_.port}` : `https://${application.host}`) + encodePathname(_.routeID)
+  const targetLocation = (+_.local ? `http://${application.host}.localhost:${_.port}` : `https://${application.host}`) + encodePathname(_.routeID)
   location = targetLocation
  },
  getIntersectionMask() {

package/src/point.js

@@ -10,7 +10,7 @@ pointer.handle({
   if (host !== _.application.host) {
    if (host in _.applications) {
     if (pathname === "/" && !hash) {
-     const targetLocation = (_.local ? `http://${host}.localhost:${_.port}` : `https://${host}`) + encodePathname(_.routeID)
+     const targetLocation = (+_.local ? `http://${host}.localhost:${_.port}` : `https://${host}`) + encodePathname(_.routeID)
      location = targetLocation
     } else warn(`Cross-host navigation and canonical pathname are not yet handled because of ambiguity between simply changing applications and linking to a canonical home page (while attempting to navigate to "${TARGET_ELEMENT.href}").`)
    } else window.open(TARGET_ELEMENT.href, '_blank')

package/src/type.d.ts

@@ -289,7 +289,17 @@ declare function randomBits(bigCount: number): bigint
 declare function randomRouteID(cardinality: bigint): bigint
 /** Returns a random boolean value. */
 declare function flipCoin(): boolean
-/** The immutable list of runtime instances for the root space, in order of when they were fully hydrated. */
+/** The immutable list of runtime instances for the root space, in order of when the were reached during recursive part hydration. */
 declare const instances: IPartAny[]
-/** The immutable list of every part in the root space, in order of when they were fully hydrated. */
-declare const allParts: IPartAny[]
+/** The immutable list of every part in the root space, in order of when the were reached during recursive part hydration. */
+declare const allParts: IPartAny[]
+/** The immutable list of every part host and filename combination, in order of when the were reached during recursive part hydration. */
+declare const allSubjects: [host: string, filename?: string]
+/** The Unix timestamp (in ms) when the current instance of the framework started booting. */
+declare const bootStartTime: number
+/** A map that provides information about whether a subject was defined in the project repository (maps to true) or only in the kireji framework package (maps to false). */
+declare const subjectOrigins: Map<string, boolean>
+/** A map that provides the index (in the `allSubjects` array) for the given subject. */
+declare const subjectIndices: Map<string, boolean>
+/** A base64-encoded string which represents a portable bitmask that compresses `subjectOrigins` in hydration order (because that order is identical between environments). */
+declare const compressedSubjectOrigins: string