kireji 0.7.3 → 0.8.2

package/README.md

@@ -1,7 +1,7 @@
 # Kireji - *Web Framework*
 > **<sub>Part of the Kireji Project</sub>**<br><sup><i>omnia ex una linea</i></sup>
 
-The **Kireji Web Framework** is a reactive full-stack web framework that uses the MPHF Coordinate System and the MVC paradigm to build multi-origin web app ecosystems. It offers a routing system that achieves the information-theoretic lower bound of data compression, enabling comprehensive deep linking, session bookmarking without user accounts or local storage, peer-to-peer data sharing without uploads or accounts, and cross-origin communication without cookies or CORS.
+The **Kireji Web Framework** is a reactive full-stack web framework that can build and serve web apps and multi-origin web app ecosystems. It stores its runtime state in its routing system, achieving the information-theoretic lower bound of data compression. This enables comprehensive deep linking, session bookmarking without user accounts or local storage, peer-to-peer data sharing without uploads or accounts, and cross-origin communication without cookies or CORS.
 ## The Kireji Project
 The Kireji Project poses a question: **What if we could treat every web page as a point in a unified, mathematically mapped space?**
 
@@ -13,7 +13,7 @@ The Kireji Project poses a question: **What if we could treat every web page as
 
 ## Usage
 
-> <sub>Note: This framework is currently under heavy development in early alpha. Expect large, breaking changes with each version and some awkward features. Check out the [Demo App Ecosystem](https://github.com/kireji-app/demo#readme) to see the framework in action. Check back later to see if the package has been updated.</sub>
+> <sub>Note: This framework is currently in alpha. Expect breaking changes with each version. Check out the [Demo App Ecosystem](https://github.com/kireji-app/demo#readme) to see a live project that uses this framework. Check back later to see if the framework has advanced into beta.</sub>
 
 ```bash
 # In an empty git repo.
@@ -104,8 +104,8 @@ The Kireji Project is in **early research and development**.
 
 [![kireji on npm](https://img.shields.io/npm/v/kireji?style=for-the-badge&labelColor=CB3837&logo=npm&logoColor=white&label=NPM+package&color=212121)](https://www.npmjs.com/kireji)
 <br>[![Project Status: Alpha](https://img.shields.io/badge/status-alpha-212121?style=for-the-badge&labelColor=181717&logo=github&logoColor=white)](https://www.repostatus.org/#alpha)
-<br>[![Commits](https://img.shields.io/github/commit-activity/t/kireji-app/kireji?style=for-the-badge&labelColor=181717&color=212121&logo=github&logoColor=white)](https://github.com/kireji-app/demo/commits/)
-<br>[![Last Commit](https://img.shields.io/github/last-commit/kireji-app/kireji?style=for-the-badge&labelColor=181717&color=212121&logo=github&logoColor=white)](https://github.com/kireji-app/demo)
+<br>[![Commits](https://img.shields.io/github/commit-activity/t/kireji-app/kireji?style=for-the-badge&labelColor=181717&color=212121&logo=github&logoColor=white)](https://github.com/kireji-app/kireji/commits/)
+<br>[![Last Commit](https://img.shields.io/github/last-commit/kireji-app/kireji?style=for-the-badge&labelColor=181717&color=212121&logo=github&logoColor=white)](https://github.com/kireji-app/kireji)
 <br>[![Copyright © 2023-2025 <a href="https://www.ejaugust.com">Eric Augustinowicz</a>](https://img.shields.io/badge/2023%20--%202025-Eric_Augustinowicz-212121?labelColor=007ec6&style=for-the-badge&logoColor=white&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTk3cHgiIGhlaWdodD0iMTk3cHgiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgdmVyc2lvbj0iMS4xIj4KIDxkZWZzPgogIDxtYXNrIGlkPSJtYXNrIj4KICAgPGNpcmNsZSBjeD0iOTgiIGN5PSI5OCIgcj0iOTgiIGZpbGw9IndoaXRlIiAvPgogICA8Y2lyY2xlIGN4PSI5OCIgY3k9Ijk4IiByPSI3OCIgZmlsbD0iYmxhY2siIC8+CiAgIDxjaXJjbGUgY3g9Ijk4IiBjeT0iOTgiIHI9IjU1IiBmaWxsPSJ3aGl0ZSIgLz4KICAgPGNpcmNsZSBjeD0iOTgiIGN5PSI5OCIgcj0iMzAiIGZpbGw9ImJsYWNrIiAvPgogICA8cmVjdCB4PSIxMTUiIHk9Ijg1IiB3aWR0aD0iNDUiIGhlaWdodD0iMjUiIGZpbGw9ImJsYWNrIiAvPgogIDwvbWFzaz4KIDwvZGVmcz4KIDxwYXRoIGQ9Ik0gOTgsMCBBIDk4LDk4IDAgMSAxIDk4LDE5NiBBIDk4LDk4IDAgMSAxIDk4LDAgWiIgZmlsbD0id2hpdGUiIG1hc2s9InVybCgjbWFzaykiIC8+Cjwvc3ZnPg==)](http://www.ejaugust.com/)
 <br>[![Released under MIT License](https://img.shields.io/badge/License-MIT-212121?labelColor=007ec6&style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgdmlld0JveD0iMCAwIDEyIDEyIj48cGF0aCBzdHlsZT0iZmlsbDpub25lO3N0cm9rZTp3aGl0ZTtzdHJva2Utd2lkdGg6Ljk5OTc1MDAyO3N0cm9rZS1saW5lY2FwOmJ1dHQ7c3Ryb2tlLWxpbmVqb2luOm1pdGVyO3N0cm9rZS1taXRlcmxpbWl0OjYuNDAwMDAwMTtzdHJva2UtZGFzaGFycmF5Om5vbmU7c3Ryb2tlLW9wYWNpdHk6MSIgZD0iTTQuMjUgOS41SDZNNC4yNSA3Ljc1SDZtMi4wMjMtNS41YzAgLjY5LS45MDQgMS4yNS0yLjAyMyAxLjI1LTEuMTE5IDAtMi4wMjItLjU1OS0yLjAyMi0xLjI1QzMuOTc4IDEuNTU4IDQuODggMSA2IDFjMS4xMTkgMCAyLjAyMy41NTggMi4wMjMgMS4yNXpNNiAxMVYzLjUiLz48L3N2Zz4=&logoColor=white)](https://github.com/kireji-app/kireji/LICENSE.md)
 <br>[![Sponsor this Project](https://img.shields.io/badge/Sponsor-212121?labelColor=red&style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI0OTciIGhlaWdodD0iNDcwIj48cGF0aCBkPSJNMTQwIDIwQzczIDIwIDIwIDc0IDIwIDE0MGMwIDEzNSAxMzYgMTcwIDIyOCAzMDMgODgtMTMyIDIyOS0xNzMgMjI5LTMwMyAwLTY2LTU0LTEyMC0xMjAtMTIwLTQ4IDAtOTAgMjgtMTA5IDY5LTE5LTQxLTYwLTY5LTEwOC02OXoiIHN0cm9rZT0id2hpdGUiIHN0cm9rZS13aWR0aD0iNDAiIGZpbGw9Im5vbmUiLz48L3N2Zz4=&logoColor=white)](https://github.com/sponsors/EJAugust)

package/package.json

@@ -1,6 +1,6 @@
 {
  "name": "kireji",
- "version": "0.7.3",
+ "version": "0.8.2",
  "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/description

@@ -4,4 +4,4 @@ By clicking on a part in the sidebar, you can view the properties of that part a
 
 The properties also allow you to view the list of the files which are associated with each part and to see the current state of each part and its corresponding base 64 hash. These values update in real-time as you interact with any of the apps.
 
-You can travel away from this application, make changes in other applications, and then return here to see how those cross-origin interactions have impacted each part in the ecosystem.
+You can travel away from this application, make changes in other applications, and then return here to see how those cross-origin interactions have impacted each part of the ecosystem.

package/src/app/kireji/editor/sections/state-space/part.html_.js

@@ -3,14 +3,14 @@ const cardinalityAsString = instances.includes(activePart) ? activePartCardinali
 
 return (
  instances.includes(activePart) ? (
+  `<h3>Equation</h3>` +
+  activePart.mathML(1 + (activePart.length <= 4), "variable") +
+  `<hr>` +
   "<h3>Cardinality</h3>" +
-  `<p>${cardinalityAsString.length < 16 ? cardinalityAsString : scientific(activePartCardinality, true)}</p>` +
+  activePart.mathML(0, "value") +
   `<hr>` +
   "<h3>Hartley Entropy</h3>" +
-  `<p>${toCharms(activePartCardinality)} (${toBits(activePartCardinality)})</p>` +
-  `<hr>` +
-  `<h3>Equation</h3>` +
-  "<math>" + activePart["equation-variable.html"] + "<mo>=</mo>" + activePart["equation.html"] + "</math>"
+  `<math><mn>${toCharms(activePartCardinality, false)}</mn><mspace width=".5ch"/><mtext>charms</mtext><mspace width=".5ch"/><mo>(</mo><mn>${toBits(activePartCardinality, false)}</mn><mspace width=".5ch"/><mtext>bits</mtext><mo>)</mo></math>`
  ) : (
   "<p class=disabled-message>Abstract parts do not have a concrete state space.</p>"
  )

package/src/app/kireji/editor/static.css

@@ -354,6 +354,13 @@ body.vintage #kireji_app editor-::after {
  pointer-events: none;
 }
 
+body.vintage #kireji_app #info-state-space>section>math {
+ text-align: right;
+ margin: calc(.5 * var(--spacing));
+ width: min-content;
+ justify-self: end;
+}
+
 @container editor-view (width > 350px) {
  body.vintage #kireji_app #info-state-space>section {
   display: grid;

package/src/app/kireji/editor/tab-group/mathML-subpart.js

@@ -0,0 +1,8 @@
+const n_tabs = allSubjects.length
+
+return [
+ "<mn>1</mn>",
+ "<mo>+</mo>",
+ `<munderover><mo>∑</mo><mrow><msub><mi>𝑛</mi><mi>tabs</mi></msub><mo>=</mo><mn>1</mn></mrow><mi>${n_tabs}</mi></munderover><mrow><msub><mi>𝑛</mi><mi>tabs</mi></msub><mo>(</mo><msub><mi>𝑛</mi><mi>tabs</mi></msub><mo>+</mo><mn>1</mn><mo>)</mo></mrow>`,
+ `<munderover><mo>∏</mo><mrow><mi>i</mi><mo>=</mo><mn>1</mn></mrow><mrow><msub><mi>𝑛</mi><mi>tabs</mi></msub></mrow></munderover><mrow><mo>(</mo><mi>${n_tabs}</mi><mo>-</mo><mi>i</mi><mo>+</mo><mn>1</mn><mo>)</mo></mrow>`
+]

package/src/app/kireji/sidebar/static.css

@@ -1,4 +1,4 @@
-#kireji_app side-bar {
+#kireji_app>side-bar {
  position: absolute;
  top: 0;
  left: var(--tool-bar-width);
@@ -6,6 +6,29 @@
  bottom: 0;
 }
 
+@media (width > 424px) {
+
+ #kireji_app:has(side-bar) {
+  --sidebar-width: calc(var(--tool-bar-width) + var(--sidebar-view-width));
+ }
+}
+
+@media (width < 425px) {
+
+ #kireji_app:has(side-bar)>editor- {
+  pointer-events: none;
+ }
+
+ #kireji_app>width-handle {
+  display: none;
+ }
+
+ #kireji_app>side-bar {
+  z-index: 10000;
+  width: calc(var(--app-width) - var(--tool-bar-width));
+ }
+}
+
 #kireji_app #sidebar-view-header {
  position: absolute;
  z-index: 10;
@@ -92,26 +115,31 @@
  position: relative;
 }
 
-#kireji_app #sidebar-view summary>.explore-toggle,
-#kireji_app #sidebar-view summary>img,
-#kireji_app #sidebar-view svg {
- height: var(--tab-icon-size);
- width: var(--tab-icon-size);
- margin: calc((var(--tab-line-height) - var(--tab-icon-size)) / 2);
-}
-
 #kireji_app outliner-spacer {
- width: calc(var(--tab-line-height) / 2);
+ width: calc(var(--depth) * var(--tab-line-height) / 2);
  border-radius: 0;
- border-right: 1px solid var(--bg-un-mode);
+ background:
+  linear-gradient(to right, transparent 0%, transparent calc(100% - 1px), var(--bg-un-mode) calc(100% - 1px), var(--bg-un-mode) 100%) 0 0 / calc(var(--tab-line-height) / 2) var(--tab-line-height);
+ /* border-right: 1px solid var(--bg-un-mode); */
 }
 
 #kireji_app outliner-spacer:has(+ img) {
- margin-right: calc(var(--tab-line-height) / 2);
+ width: calc((var(--depth) - 1) * var(--tab-line-height) / 2);
+ margin-right: var(--tab-line-height);
 }
 
-#kireji_app details.empty>summary>outliner-spacer:last-of-type {
- border: none;
+/*
+ #kireji_app details.empty>summary>outliner-spacer:last-of-type {
+  border: none;
+ }
+*/
+
+#kireji_app #sidebar-view summary>.explore-toggle,
+#kireji_app #sidebar-view summary>img,
+#kireji_app #sidebar-view svg {
+ height: var(--tab-icon-size);
+ width: var(--tab-icon-size);
+ margin: calc((var(--tab-line-height) - var(--tab-icon-size)) / 2);
 }
 
 #kireji_app #sidebar-view summary .label {
@@ -152,13 +180,21 @@ body.modern #kireji_app #sidebar-view summary {
 
 /* Vintage */
 
-body.vintage #kireji_app side-bar {
+body.vintage #kireji_app>side-bar {
  top: 6px;
  width: calc(var(--sidebar-view-width) - (var(--handle-thickness) / 2) - 2px);
  left: calc(6px + var(--tool-bar-width));
  bottom: 6px;
 }
 
+
+@media (width < 425px) {
+
+ body.vintage #kireji_app>side-bar {
+  width: calc(var(--app-width) - var(--tool-bar-width) - 12px);
+ }
+}
+
 body.vintage #kireji_app side-bar::after {
  content: "";
  position: absolute;

package/src/app/kireji/static.css

@@ -5,10 +5,6 @@
  overscroll-behavior: none;
 }
 
-#kireji_app:has(side-bar) {
- --sidebar-width: calc(var(--tool-bar-width) + var(--sidebar-view-width));
-}
-
 body.modern {
  --tab-group-height: calc(var(--tab-line-height) + var(--spacing) / 1.5);
  --tab-line-height: 26px;

package/src/app/kireji/tool-bar/part.css

@@ -27,7 +27,7 @@ body.modern #kireji_app tool-bar {
 }
 
 body.modern #kireji_app:has(side-bar) tool-bar>button[data-active] {
- box-shadow: inset 3px 0 0 -1px var(--accent);
+ box-shadow: inset -5px 0 0 -1px var(--accent);
 }
 
 body.vintage #kireji_app tool-bar {

package/src/application-goto.js

@@ -1,11 +1,14 @@
 const targetLocation = (+_.local ? `http://${HOST}.localhost:${_.port}` : `https://${HOST}`) + encodePathname(_.routeID)
 document.body.classList.add("unhydrated")
 
-// Press the button before navigation starts.
-const instanceIndex = desktop.windows.instances.findIndex(window => window.application.host === HOST)
-if (instanceIndex !== -1) {
- const task = document.querySelectorAll(`task-bar>button.task`)[instanceIndex]
- task.classList.add("preview-pressed", "pressed")
+if (_.includeDesktop === "demo" || (!production && (_.includeDesktop === "full" || _.includeDesktop === 'local-only'))) {
+
+ // Press the task-bar button before navigation starts.
+ const instanceIndex = desktop.windows.instances.findIndex(window => window.application.host === HOST)
+ if (instanceIndex !== -1) {
+  const task = document.querySelectorAll(`task-bar>button.task`)[instanceIndex]
+  task.classList.add("preview-pressed", "pressed")
+ }
 }
 
 location = targetLocation

package/src/build.js

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+
+/** @type {(_: IEcosystem, compressedSubjectOrigins: string) => void} */
 function ƒ(_, compressedSubjectOrigins) {
 
  // Initialization
@@ -520,7 +522,7 @@ function ƒ(_, compressedSubjectOrigins) {
     packAndMap(url) {
      const sourceFile = this
      const script = sourceFile.lines.join("\n")
-     return +_.mapping
+     return _.mapping === "enabled"
       ? script +
       `
 //${"#"} sourceMappingURL=data:application/json;charset=utf-8;base64,${btoaUnicode(sourceFile.getMap())}${url
@@ -591,7 +593,6 @@ function ƒ(_, compressedSubjectOrigins) {
     imageSources = [],
     earlyImageSources = [],
     partsByHost = {},
-    preHydrationArchive = serialize(_),
     resolveRelativeHost = (relativeHost, base) => {
 
      if (typeof relativeHost !== "string")
@@ -891,8 +892,74 @@ function ƒ(_, compressedSubjectOrigins) {
       part.inheritors.sort((a, b) => (b.totalInheritors - a.totalInheritors) || (a.host > b.host ? 1 : -1))
 
      return totalInheritors
+    },
+    configureArchiveContent = () => {
+     // TODO: Consider merging user landing model with stock landing model instead of replacing it.
+     const landingModel = JSON.parse(_["landing-model.json"])
+
+     let desktopFeatures = 3
+
+     if (_.includeColor === "none") {
+      delete _.parts.desktop.color
+      delete landingModel.parts.desktop.color
+      desktopFeatures--
+     } else if (_.includeColor === "dark" || (_.includeColor === "debug-light" && production)) {
+      delete _.parts.desktop.color.light
+      landingModel.parts.desktop.color = "light"
+     } else if (_.includeColor === "light" || (_.includeColor === "debug-dark" && production)) {
+      delete _.parts.desktop.color.dark
+      landingModel.parts.desktop.color = "dark"
+     }
+
+     if (_.includeEra === "none") {
+      delete _.parts.desktop.era
+      delete landingModel.parts.desktop.era
+      desktopFeatures--
+     } else if (_.includeEra === "vintage" || (_.includeEra === "debug-modern" && production)) {
+      delete _.parts.desktop.era.modern
+      landingModel.parts.desktop.era = "vintage"
+     } else if (_.includeEra === "modern" || (_.includeEra === "debug-vintage" && production)) {
+      delete _.parts.desktop.era.vintage
+      landingModel.parts.desktop.era = "modern"
+     }
+
+     if (_.includeKirejiApp === "none" || (_.includeKirejiApp === "full" && production)) {
+      delete _.app
+      delete landingModel.app
+     }
+
+     const removeDesktopFeatures = () => {
+      delete _.parts.desktop.icons
+      delete landingModel.parts.desktop.icons
+      delete _.parts.desktop.windows
+      delete landingModel.parts.desktop.windows
+      delete _.parts.desktop["task-bar"].tray
+     }
+
+     if (_.includeDesktop === "none" || (production && _.includeDesktop === "local-only")) {
+      removeDesktopFeatures()
+      delete _.parts.desktop["task-bar"]
+      delete landingModel.parts.desktop.taskBar
+      desktopFeatures--
+     } else if (_.includeDesktop === "menu-only" || (production && _.includeDesktop === "full")) {
+      removeDesktopFeatures()
+      delete _.parts.desktop["task-bar"].tray
+     }
+
+     if (!desktopFeatures) {
+      delete _.parts.desktop
+      delete landingModel.parts.desktop
+     }
+
+     _["landing-model.json"] = JSON.stringify(landingModel)
+
+     Object.defineProperties(_, {
+      landingModel: { value: landingModel },
+      preHydrationArchive: { value: serialize(_) }
+     })
     }
 
+   configureArchiveContent()
    hydratePartsRecursive(_)
    hydrateSubjectOrigins()
    countAndSortInheritorsRecursive(_.parts.abstract.part)
@@ -954,14 +1021,15 @@ function ƒ(_, compressedSubjectOrigins) {
 
   logScope(1, "\nComputing Landing Hash & Route ID", hashLog => {
 
-   const landingModel = JSON.parse(_["landing-model.json"])
-   const landingRouteID = _.modelToRouteID(landingModel)
-   const landingHash = encodeSegment(landingRouteID)
-
    _.define({
-    landingHash: { value: landingHash },
-    landingModel: { value: landingModel },
-    landingRouteID: { value: landingRouteID },
+    landingRouteID: {
+     value: _.modelToRouteID(_.landingModel)
+    },
+    landingHash: {
+     resolve() {
+      return encodeSegment(this.landingRouteID)
+     }
+    }
    })
 
    hashLog("Landing hash: " + _.landingHash)
@@ -982,12 +1050,20 @@ function ƒ(_, compressedSubjectOrigins) {
 }
 
 ƒ({
+ // TODO: fix source mapping bugs.
  verbosity: "1",
- // TODO: Fix source mapping bugs.
- mapping: "0",
  change: "major",
  hangHydration: "0",
- haltHydration: "0",
  defaultApplicationHost: "kireji.app",
- port: "3000"
+ port: "3000",
+ mapping: "disabled",
+ resetLocalState: "enabled",
+ haltHydration: "disabled",
+ includeWarning: "enabled",
+ includeColor: "full",
+ includeEra: "full",
+ includeMenuApps: "full",
+ includeUpdates: "full",
+ includeKirejiApp: "full",
+ includeDesktop: "full"
 })

package/src/kireji.schema.json

@@ -0,0 +1,205 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "KirejiConfig",
+ "description": "Schema for the kireji.json configuration file.",
+ "type": "object",
+ "properties": {
+  "includeColor": {
+   "description": "Determines which color mode features will be included in the ecosystem.",
+   "oneOf": [
+    {
+     "const": "none",
+     "description": "The color component will never be included."
+    },
+    {
+     "const": "light",
+     "description": "Dark mode will never be included."
+    },
+    {
+     "const": "dark",
+     "description": "Light mode will never be included."
+    },
+    {
+     "const": "debug-dark",
+     "description": "Dark mode will only be included in local builds."
+    },
+    {
+     "const": "debug-light",
+     "description": "Light mode will only be included in local builds."
+    },
+    {
+     "const": "full",
+     "description": "The full color component will always be included."
+    }
+   ]
+  },
+  "includeEra": {
+   "description": "Determines which era mode features will be included in the ecosystem.",
+   "oneOf": [
+    {
+     "const": "none",
+     "description": "The era component will never be included."
+    },
+    {
+     "const": "vintage",
+     "description": "Modern mode will never be included."
+    },
+    {
+     "const": "modern",
+     "description": "Vintage mode will never be included."
+    },
+    {
+     "const": "debug-modern",
+     "description": "Modern mode will only be included in local builds."
+    },
+    {
+     "const": "debug-vintage",
+     "description": "Vintage mode will only be included in local builds."
+    },
+    {
+     "const": "full",
+     "description": "The full era component will always be included."
+    }
+   ]
+  },
+  "includeMenuApps": {
+   "description": "Determines whether a list of apps should be included in the menu.",
+   "oneOf": [
+    {
+     "const": "none",
+     "description": "Apps will never appear in the menu."
+    },
+    {
+     "const": "local-only",
+     "description": "Apps will only appear in the menu in local builds."
+    },
+    {
+     "const": "full",
+     "description": "Apps will always appear in the menu."
+    }
+   ]
+  },
+  "includeUpdates": {
+   "description": "Determines whether or not the version updating features should be included in the menu.",
+   "oneOf": [
+    {
+     "const": "none",
+     "description": "Update features will never appear in the menu."
+    },
+    {
+     "const": "local-only",
+     "description": "Update features will only appear in the menu in local builds."
+    },
+    {
+     "const": "full",
+     "description": "Update features will always appear in the menu."
+    }
+   ]
+  },
+  "includeKirejiApp": {
+   "description": "Determines whether or not the Kireji IDE should be included in the ecosystem.",
+   "oneOf": [
+    {
+     "const": "none",
+     "description": "kireji.app will never be included."
+    },
+    {
+     "const": "full",
+     "description": "kireji.app will only be included in local builds."
+    },
+    {
+     "const": "demo",
+     "description": "kireji.app will always be included (used only for Demo App Ecosystem)."
+    }
+   ]
+  },
+  "includeDesktop": {
+   "description": "Determines whether or not the ecosystem should include desktop-like features.",
+   "oneOf": [
+    {
+     "const": "none",
+     "description": "The desktop experience will never be included."
+    },
+    {
+     "const": "menu-only",
+     "description": "Only the menu will be included, and it will always be included."
+    },
+    {
+     "const": "local-only",
+     "description": "The full desktop experience will only be included in local builds."
+    },
+    {
+     "const": "full",
+     "description": "The menu will always be included. The desktop experience will only be included in local builds."
+    },
+    {
+     "const": "demo",
+     "description": "The full desktop experience will always be included (used only for Demo App Ecosystem)."
+    }
+   ]
+  },
+  "change": {
+   "description": "Represents the severity of the API change for semantic versioning.",
+   "oneOf": [
+    {
+     "const": "major",
+     "description": "A breaking change which breaks existing hash assignments."
+    },
+    {
+     "const": "minor",
+     "description": "A non-breaking change which adds new hash assignments."
+    },
+    {
+     "const": "patch",
+     "description": "A non-breaking change which does not impact hash assignments at all."
+    }
+   ]
+  },
+  "verbosity": {
+   "description": "A number used to control the detail in logs. Only messages with a priority <= this number will be logged.",
+   "type": "string"
+  },
+  "defaultApplicationHost": {
+   "description": "The host of the desired default app. The server will redirect to this when testing locally.",
+   "type": "string"
+  },
+  "port": {
+   "description": "The internal port (typically 3000-4000) where the server will be hosted.",
+   "type": "string"
+  },
+  "mapping": {
+   "description": "Determines whether or not the artifact should be output with embedded source map data.",
+   "enum": [
+    "disabled",
+    "enabled"
+   ]
+  },
+  "haltHydration": {
+   "description": "If enabled, halts the hydration of the application completely. Useful for debugging FOUC.",
+   "enum": [
+    "disabled",
+    "enabled"
+   ]
+  },
+  "includeWarning": {
+   "description": "If enabled, a warning line appears at the top of all applications regarding alpha status.",
+   "enum": [
+    "disabled",
+    "enabled"
+   ]
+  },
+  "resetLocalState": {
+   "description": "If enabled, applications running locally will reset to their landing hash when the service worker is replaced.",
+   "enum": [
+    "disabled",
+    "enabled"
+   ]
+  },
+  "hangHydration": {
+   "description": "A string representing how long the main thread should hang to simulate loading. Useful for debugging FOUC.",
+   "type": "string"
+  }
+ },
+ "required": [],
+ "additionalProperties": false
+}

package/src/part.css_.js

@@ -0,0 +1,20 @@
+const
+ includeWarning = _.includeWarning === "enabled",
+ includeDesktop = _.includeDesktop === "demo" || (!production && (_.includeDesktop === "full" || _.includeDesktop === "local-only"))
+
+return /* css */`
+
+html, body {
+ --warning-height: ${includeWarning ? "26px" : "0px"};
+ ${includeDesktop ? "" : `--title-bar-height: 0px !important;
+ --task-bar-height: 0px !important;`}
+}${includeWarning ? `
+
+@media (width < 390px) {
+
+ html,
+ body {
+  --warning-height: 49px;
+ }
+}` : ""}
+` + _["static.css"]

package/src/part.html_.js

@@ -1,6 +1,18 @@
 const
  title = sanitizeAttr(application.title ?? "Untitled App"),
- icon = application.placeholderImage("part.png")
+ icon = application.placeholderImage("part.png"),
+ classes = [...application.classes],
+ includeDesktop = _.includeDesktop === "demo" || (!production && (_.includeDesktop === "full" || _.includeDesktop === "local-only")),
+ includeMenu = includeDesktop || _.includeDesktop === "menu-only" || _.includeDesktop === "full"
+
+if (_.includeEra !== "none")
+ classes.push(era.arm.key)
+
+if (_.includeColor !== 'none')
+ classes.push(color.arm.key)
+
+if (includeMenu)
+ classes.push(taskBar.menu.classes)
 
 return _.injectImages(/* html */`<!DOCTYPE html>
 <html lang=en>
@@ -15,25 +27,25 @@ return _.injectImages(/* html */`<!DOCTYPE html>
   <link rel="canonical" href="https://${application.host}${application.canonicalPathname ?? "/"}" />
   <!-- <link rel="manifest"${worker.manifestLink}/> -->
   <style id="user-css">${_["part.css"]}</style>
-  <style id="era-css">${era["part.css"]}</style>
-  <style id="color-css">${color["part.css"]}</style>
+  ${_.includeEra === "none" ? "" : /*html*/`<style id="era-css">${era["part.css"]}</style>`}
+  ${_.includeColor === "none" ? "" : /*html*/`<style id="color-css">${color["part.css"]}</style>`}
   <style id="application-css">${application["part.css"]}</style>
  </head>
- <body class="unhydrated ${[era.arm.key, color.arm.key, ...taskBar.menu.classes, ...application.classes].join(" ")}">
-  <warning->🚧 App in Alpha. Features subject to change/break without notice.</warning->
-  <title-bar autofocus tabIndex=0>
+ <body class="unhydrated ${classes.join(" ")}">
+  ${_.includeWarning === "enabled" ? /*html*/`<warning->🚧 App in Alpha. Features subject to change/break without notice.</warning->` : ""}
+  ${includeDesktop ? `<title-bar autofocus tabIndex=0>
    <img class="part-icon" src="${icon}"/>
    <span id=application-title>${title}</span>
    <flex-spacer></flex-spacer>
    <button class=hide ${windows.pointAttr("hidePoint")}></button>
    <button class=restore ${windows.pointAttr("restorePoint")} disabled></button>
    <button class=close ${windows.pointAttr("closePoint")}></button>
-  </title-bar>
+  </title-bar>` : ""}
   <wallpaper- class=app-container id=${application.host.replaceAll(".", "_")} tabIndex=0 ${application.attributes.join(" ")}>
   ${application["part.html"]}
   </wallpaper->
   <!-- windows -->
-  ${taskBar["part.html"]}
+  ${includeMenu ? taskBar["part.html"] : ""}
   ${worker["part.html"]}
  </body>
 </html>`)