mkui 0.1.0__tar.gz

mkui-0.1.0/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Mark Kim
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

mkui-0.1.0/PKG-INFO

@@ -0,0 +1,225 @@
+Metadata-Version: 2.4
+Name: mkui
+Version: 0.1.0
+Summary: Config-driven, zero-dependency web GUI framework with dockable panes
+Author: Mark Kim
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/markuskimius/mkui
+Project-URL: Repository, https://github.com/markuskimius/mkui
+Keywords: gui,web,framework,dockable,config-driven
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: JavaScript
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# mkui
+
+A config-driven, dependency-free web GUI framework with a floating-frame
+workspace and dockable panes inside each frame. Designed to pair with
+[mkio](../mkio) — the same project's TOML-driven microservice backend —
+but works against any backend (or none at all).
+
+## Model
+
+```
+mkui-app
+├── mkui-menubar
+├── mkui-workspace
+│   ├── mkui-frame  ← floating, movable, resizable. Clamped to workspace.
+│   │   └── layout tree
+│   │       └── TabGroup
+│   │           ├── tab bar
+│   │           └── mkui-pane  ← leaf content host
+│   ├── mkui-frame
+│   │   └── split (h | v)
+│   │       ├── TabGroup → panes
+│   │       └── TabGroup → panes
+│   └── ...
+└── mkui-statusbar
+```
+
+Top-level windows are **frames** — floating chrome with titlebar and 8-way
+resize. Frames don't dock into each other. Inside each frame lives an
+independent, normalized layout tree of **splits**, **tab groups**, and
+**panes**. Docking — splitting, tabbing, tearing out — happens entirely
+inside frames.
+
+**Design commitments** (things meant to hold up indefinitely):
+
+- **Structural invariant**: every pane leaf sits inside a tab group. A
+  single-pane frame is a single-tab group. This removes a whole class of
+  special cases from the renderer and the drop logic.
+- **Proportional resize by construction**: frame positions are fractions
+  of the workspace rect, and split ratios sum to 1. Resizing the browser
+  rescales every frame, every split, and every pane with no extra code.
+- **Viewport clamping invariant**: every frame move/resize passes through
+  a single `clampToDock` helper. Frames cannot escape the workspace —
+  shrinking the viewport drags stragglers back in.
+- **Stable pane identity**: pane elements live in a workspace-owned pool
+  and are re-parented via `appendChild` when re-docked. Content state,
+  subscriptions, scroll position, and DOM focus all survive.
+- **Zero runtime dependencies.** Web Components, so it drops into
+  React / Vue / Svelte / vanilla identically.
+
+## Interactions
+
+- **Frame titlebar** → drag to move (clamped). **Frame edges/corners** →
+  8-way resize (clamped, min 160×80).
+- **Frame close button** → closes the frame; panes inside are parked in
+  the pool (state preserved) and can be brought back by code.
+- **Tab click** → switch active pane in that tab group.
+- **Tab drag** → if the cursor leaves the tab bar by more than a few
+  pixels, the pane is **torn out** into a new frame at the cursor.
+- **Dragging a torn-out (or any single-pane) frame over another frame**
+  shows drop zones: edges split, center adds as a tab. Release to dock.
+- **Splitter drag** → resize the ratio between two children of a split.
+- **Any mousedown inside a frame** raises it to the top of the z-order.
+
+## Configs
+
+mkui's runtime input is JSON. When the backend is mkio, mkio's Python
+side parses `app.toml` with stdlib `tomllib` and serves the result as
+JSON — so the browser never needs a TOML parser. For other backends,
+author or generate `app.json` directly.
+
+Minimal config:
+
+```json
+{
+  "app":     { "title": "Trading desk", "theme": "dark" },
+  "menubar": [{ "label": "File", "items": [{ "label": "Quit", "action": "app.quit" }] }],
+  "statusbar": { "left": [{ "type": "text", "bind": "status.message" }] },
+
+  "panes": {
+    "orders":    { "title": "Orders", "type": "mkio-table", "service": "all_orders" },
+    "chart":     { "title": "Chart",  "widgets": [{ "type": "text", "text": "Chart goes here" }] },
+    "inspector": { "title": "Inspector", "widgets": [{ "type": "text", "text": "Properties" }] }
+  },
+
+  "frames": [
+    {
+      "id": "main",
+      "x": 0.05, "y": 0.05, "w": 0.65, "h": 0.9,
+      "layout": { "type": "tabs", "active": 0, "children": ["orders", "chart"] }
+    },
+    {
+      "id": "aux",
+      "x": 0.72, "y": 0.05, "w": 0.23, "h": 0.9,
+      "layout": { "type": "tabs", "children": ["inspector"] }
+    }
+  ],
+
+  "mkio": { "url": "ws://localhost:8080/ws" }
+}
+```
+
+Frame positions (`x`, `y`, `w`, `h`) are fractions of the workspace rect.
+
+## Standalone mode
+
+```html
+<!doctype html>
+<link rel="stylesheet" href="/mkui/styles/mkui.css">
+<script type="module" src="/mkui/src/index.js"></script>
+<mkui-app config="/mkui/config.json"></mkui-app>
+```
+
+## Library mode
+
+```js
+import { registerPaneType } from "mkui";
+import "mkui";   // side-effect: registers custom elements
+
+registerPaneType("clock", (spec, app, host) => {
+  const el = document.createElement("div");
+  host.appendChild(el);
+  setInterval(() => { el.textContent = new Date().toLocaleTimeString(); }, 1000);
+});
+
+const root = document.querySelector("mkui-app");
+await customElements.whenDefined("mkui-app");
+root.setConfig({
+  panes:  { clock: { title: "Clock", type: "clock" } },
+  frames: [{ id: "f1", x: 0.3, y: 0.3, w: 0.3, h: 0.3,
+             layout: { type: "tabs", children: ["clock"] } }],
+});
+
+// Add more frames at runtime:
+root.workspace.addFrame({ x: 0.5, y: 0.1, w: 0.4, h: 0.4,
+                          layout: { type: "tabs", children: ["other-pane"] } });
+```
+
+## Built-in widgets and pane types (v1)
+
+- Widgets (lightweight content inside a pane or statusbar slot):
+  - `text` — static or `bind`-ed to a state path
+  - `button` — fires an action by name
+- Pane types (whole-pane custom rendering):
+  - `mkio-table` — subscribes to an mkio subpub service and renders rows
+- Custom pane types are the primary extensibility surface. Register with
+  `registerPaneType(name, factory)`; reference from config as `type = "<name>"`.
+
+## Installation
+
+```
+pip install mkui
+```
+
+Then serve the static assets from your Python backend:
+
+```python
+import mkui
+
+# With mkio (toml config):
+#   [static]
+#   "/mkui" = "<result of mkui.static_dir>"
+
+# With FastAPI / Starlette:
+from starlette.staticfiles import StaticFiles
+app.mount("/mkui", StaticFiles(directory=mkui.static_dir))
+```
+
+## Running the examples
+
+```
+cd mkui/static
+python3 -m http.server 8000
+# http://localhost:8000/examples/standalone-json/
+# http://localhost:8000/examples/library-js/
+```
+
+## Project layout
+
+```
+mkui/                    Python package (pip install mkui)
+  __init__.py            Exposes static_dir path
+  static/
+    src/
+      core.js            State store, registries, App class
+      index.js           Side-effect entry point
+      layout/
+        tree.js          Normalized tree math
+        drag.js          clampToDock, snap, dropZoneFor, frac↔rect
+      components/
+        app.js           <mkui-app> — the shell
+        menubar.js       <mkui-menubar>
+        statusbar.js     <mkui-statusbar>
+        workspace.js     <mkui-workspace> — frame list, arrangement, snap
+        frame.js         <mkui-frame> + <mkui-pane>
+      widgets/
+        text.js  button.js  mkio-table.js
+      mkio-bridge.js     Lazy-loads mkio's /mkio.js client
+    styles/mkui.css      Default theme (CSS custom properties)
+    examples/
+      standalone-json/   Loaded from a static config
+      library-js/        Built imperatively from JS
+pyproject.toml           Python build config
+package.json             JS dev tooling
+tests/layout.test.js     33 unit tests
+```

mkui-0.1.0/README.md

@@ -0,0 +1,205 @@
+# mkui
+
+A config-driven, dependency-free web GUI framework with a floating-frame
+workspace and dockable panes inside each frame. Designed to pair with
+[mkio](../mkio) — the same project's TOML-driven microservice backend —
+but works against any backend (or none at all).
+
+## Model
+
+```
+mkui-app
+├── mkui-menubar
+├── mkui-workspace
+│   ├── mkui-frame  ← floating, movable, resizable. Clamped to workspace.
+│   │   └── layout tree
+│   │       └── TabGroup
+│   │           ├── tab bar
+│   │           └── mkui-pane  ← leaf content host
+│   ├── mkui-frame
+│   │   └── split (h | v)
+│   │       ├── TabGroup → panes
+│   │       └── TabGroup → panes
+│   └── ...
+└── mkui-statusbar
+```
+
+Top-level windows are **frames** — floating chrome with titlebar and 8-way
+resize. Frames don't dock into each other. Inside each frame lives an
+independent, normalized layout tree of **splits**, **tab groups**, and
+**panes**. Docking — splitting, tabbing, tearing out — happens entirely
+inside frames.
+
+**Design commitments** (things meant to hold up indefinitely):
+
+- **Structural invariant**: every pane leaf sits inside a tab group. A
+  single-pane frame is a single-tab group. This removes a whole class of
+  special cases from the renderer and the drop logic.
+- **Proportional resize by construction**: frame positions are fractions
+  of the workspace rect, and split ratios sum to 1. Resizing the browser
+  rescales every frame, every split, and every pane with no extra code.
+- **Viewport clamping invariant**: every frame move/resize passes through
+  a single `clampToDock` helper. Frames cannot escape the workspace —
+  shrinking the viewport drags stragglers back in.
+- **Stable pane identity**: pane elements live in a workspace-owned pool
+  and are re-parented via `appendChild` when re-docked. Content state,
+  subscriptions, scroll position, and DOM focus all survive.
+- **Zero runtime dependencies.** Web Components, so it drops into
+  React / Vue / Svelte / vanilla identically.
+
+## Interactions
+
+- **Frame titlebar** → drag to move (clamped). **Frame edges/corners** →
+  8-way resize (clamped, min 160×80).
+- **Frame close button** → closes the frame; panes inside are parked in
+  the pool (state preserved) and can be brought back by code.
+- **Tab click** → switch active pane in that tab group.
+- **Tab drag** → if the cursor leaves the tab bar by more than a few
+  pixels, the pane is **torn out** into a new frame at the cursor.
+- **Dragging a torn-out (or any single-pane) frame over another frame**
+  shows drop zones: edges split, center adds as a tab. Release to dock.
+- **Splitter drag** → resize the ratio between two children of a split.
+- **Any mousedown inside a frame** raises it to the top of the z-order.
+
+## Configs
+
+mkui's runtime input is JSON. When the backend is mkio, mkio's Python
+side parses `app.toml` with stdlib `tomllib` and serves the result as
+JSON — so the browser never needs a TOML parser. For other backends,
+author or generate `app.json` directly.
+
+Minimal config:
+
+```json
+{
+  "app":     { "title": "Trading desk", "theme": "dark" },
+  "menubar": [{ "label": "File", "items": [{ "label": "Quit", "action": "app.quit" }] }],
+  "statusbar": { "left": [{ "type": "text", "bind": "status.message" }] },
+
+  "panes": {
+    "orders":    { "title": "Orders", "type": "mkio-table", "service": "all_orders" },
+    "chart":     { "title": "Chart",  "widgets": [{ "type": "text", "text": "Chart goes here" }] },
+    "inspector": { "title": "Inspector", "widgets": [{ "type": "text", "text": "Properties" }] }
+  },
+
+  "frames": [
+    {
+      "id": "main",
+      "x": 0.05, "y": 0.05, "w": 0.65, "h": 0.9,
+      "layout": { "type": "tabs", "active": 0, "children": ["orders", "chart"] }
+    },
+    {
+      "id": "aux",
+      "x": 0.72, "y": 0.05, "w": 0.23, "h": 0.9,
+      "layout": { "type": "tabs", "children": ["inspector"] }
+    }
+  ],
+
+  "mkio": { "url": "ws://localhost:8080/ws" }
+}
+```
+
+Frame positions (`x`, `y`, `w`, `h`) are fractions of the workspace rect.
+
+## Standalone mode
+
+```html
+<!doctype html>
+<link rel="stylesheet" href="/mkui/styles/mkui.css">
+<script type="module" src="/mkui/src/index.js"></script>
+<mkui-app config="/mkui/config.json"></mkui-app>
+```
+
+## Library mode
+
+```js
+import { registerPaneType } from "mkui";
+import "mkui";   // side-effect: registers custom elements
+
+registerPaneType("clock", (spec, app, host) => {
+  const el = document.createElement("div");
+  host.appendChild(el);
+  setInterval(() => { el.textContent = new Date().toLocaleTimeString(); }, 1000);
+});
+
+const root = document.querySelector("mkui-app");
+await customElements.whenDefined("mkui-app");
+root.setConfig({
+  panes:  { clock: { title: "Clock", type: "clock" } },
+  frames: [{ id: "f1", x: 0.3, y: 0.3, w: 0.3, h: 0.3,
+             layout: { type: "tabs", children: ["clock"] } }],
+});
+
+// Add more frames at runtime:
+root.workspace.addFrame({ x: 0.5, y: 0.1, w: 0.4, h: 0.4,
+                          layout: { type: "tabs", children: ["other-pane"] } });
+```
+
+## Built-in widgets and pane types (v1)
+
+- Widgets (lightweight content inside a pane or statusbar slot):
+  - `text` — static or `bind`-ed to a state path
+  - `button` — fires an action by name
+- Pane types (whole-pane custom rendering):
+  - `mkio-table` — subscribes to an mkio subpub service and renders rows
+- Custom pane types are the primary extensibility surface. Register with
+  `registerPaneType(name, factory)`; reference from config as `type = "<name>"`.
+
+## Installation
+
+```
+pip install mkui
+```
+
+Then serve the static assets from your Python backend:
+
+```python
+import mkui
+
+# With mkio (toml config):
+#   [static]
+#   "/mkui" = "<result of mkui.static_dir>"
+
+# With FastAPI / Starlette:
+from starlette.staticfiles import StaticFiles
+app.mount("/mkui", StaticFiles(directory=mkui.static_dir))
+```
+
+## Running the examples
+
+```
+cd mkui/static
+python3 -m http.server 8000
+# http://localhost:8000/examples/standalone-json/
+# http://localhost:8000/examples/library-js/
+```
+
+## Project layout
+
+```
+mkui/                    Python package (pip install mkui)
+  __init__.py            Exposes static_dir path
+  static/
+    src/
+      core.js            State store, registries, App class
+      index.js           Side-effect entry point
+      layout/
+        tree.js          Normalized tree math
+        drag.js          clampToDock, snap, dropZoneFor, frac↔rect
+      components/
+        app.js           <mkui-app> — the shell
+        menubar.js       <mkui-menubar>
+        statusbar.js     <mkui-statusbar>
+        workspace.js     <mkui-workspace> — frame list, arrangement, snap
+        frame.js         <mkui-frame> + <mkui-pane>
+      widgets/
+        text.js  button.js  mkio-table.js
+      mkio-bridge.js     Lazy-loads mkio's /mkio.js client
+    styles/mkui.css      Default theme (CSS custom properties)
+    examples/
+      standalone-json/   Loaded from a static config
+      library-js/        Built imperatively from JS
+pyproject.toml           Python build config
+package.json             JS dev tooling
+tests/layout.test.js     33 unit tests
+```

mkui-0.1.0/mkui/__init__.py

@@ -0,0 +1,19 @@
+"""mkui — config-driven web GUI framework with dockable panes."""
+
+from pathlib import Path
+
+__version__ = "0.1.0"
+
+static_dir = Path(__file__).parent / "static"
+"""Path to the directory containing mkui's JS, CSS, and example files.
+
+Serve this directory from your web server to make mkui available to browsers::
+
+    # With mkio:
+    [static]
+    "/mkui" = "<mkui.static_dir>"
+
+    # With any ASGI/WSGI framework:
+    import mkui
+    app.mount("/mkui", StaticFiles(directory=mkui.static_dir))
+"""