@vortexm/vjt 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,82 @@
+# vjt
+
+Declarative JSON-driven UI renderer for browser web apps.
+
+`vjt` turns JSON widget descriptions into interactive HTML, with built-in support for:
+
+- layout containers, adaptive layouts, tabs, spoilers, overlays
+- controls such as edit fields, buttons, links, lists, grids, checkboxes, radio groups, markdown text
+- actions, references, requests, SSE, cookies
+- i18n and light/dark theme styles
+
+## Install
+
+```bash
+npm install vjt showdown
+```
+
+`showdown` is a runtime dependency used by `md-text`.
+
+## Usage
+
+```ts
+import { renderApp, ResourceManager } from 'vjt';
+import 'vjt/styles.css';
+
+const resources = new ResourceManager({
+  ui: {
+    main: {
+      widget: 'container-layout',
+      type: 'vertical',
+      children: [
+        {
+          child: {
+            widget: 'static-text',
+            heading: 'h2',
+            text: 'Hello'
+          }
+        },
+        {
+          child: {
+            widget: 'button',
+            text: 'Click me'
+          }
+        }
+      ]
+    }
+  }
+});
+
+const root = document.querySelector('#app');
+if (!(root instanceof HTMLElement)) {
+  throw new Error('App requires #app root element');
+}
+
+renderApp(root, resources.getUi('main')!, {
+  resourceManager: resources,
+  language: 'en',
+  theme: 'dark'
+});
+```
+
+## API
+
+- `renderApp(root, description, options)` mounts an interactive app into a DOM element
+- `renderJson(description, options)` renders markup without mounting
+- `ResourceManager` stores UI resources, actions, requests, SSE configs, i18n, and custom styles
+- `DEFAULT_STYLE_MAP` contains the library predefined styles
+
+## CSS
+
+Include the bundled stylesheet:
+
+```ts
+import 'vjt/styles.css';
+```
+
+or load `vjt-styles.css` manually in the page.
+
+## Notes
+
+- This package is browser-oriented and expects DOM APIs.
+- Example apps and mock backend are part of the repository, but are not part of the published npm package surface.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { renderApp, renderJson } from './lib/render.js';
+export { ResourceManager } from './lib/resource-manager.js';
+export { DEFAULT_STYLE_MAP } from './lib/default-styles.js';
+export type { ActionDefinition, ActionMap, AdaptiveLayoutNode, BaseNode, ButtonNode, CheckboxNode, ComboboxNode, ConditionExpression, ConditionalContainerNode, ContextMenuNode, ContainerCell, ContainerLayoutNode, CellConstraints, DescriptionNode, GridViewNode, HeadingTag, I18nMap, ImageNode, LayoutType, LinkNode, ListElementContext, ListNode, ListboxNode, MdTextNode, ModalWindowNode, MountJsonOptions, OverlayContainerNode, OverlayLayer, PanelNode, PrimitiveRequestType, RadioGroupNode, RequestDefinition, RequestMap, RequestSchema, RenderJsonOptions, RuntimeSnapshot, SseConfig, SseConfigInput, SseEventDefinition, SpoilerNode, SplitterNode, StaticTextNode, StyleMap, TabsNode, TextAlign, TextareaNode, UiReferenceNode, Theme, VerticalAlign, WidgetEventName, WidgetState } from './lib/types.js';