@orieljs/framework 0.1.0-alpha.1 → 0.1.0-alpha.10

package/dist/{jsx-runtime-B8J6xq-7.d.ts → jsx-runtime-6um4Mwfb.d.ts}

@@ -1,148 +1,5 @@
-/** A typed, runtime-unique key for container bindings. */
-interface Token$1<T> {
-    readonly id: symbol;
-    readonly description: string;
-    /** Phantom field: only carries T at the type level. Never set at runtime. */
-    readonly __type?: T;
-}
-type Class<T> = abstract new (...args: any[]) => T;
-type Abstract<T> = Token$1<T> | Class<T>;
-type Factory$1<T> = (container: Container) => T;
-type Concrete<T> = Factory$1<T> | (new () => T);
-interface Container {
-    /** New instance on every make(). A class with no concrete binds to itself (constructed with no args). Root only; throws on a scope. */
-    bind<T>(abstract: Abstract<T>, concrete?: Concrete<T>): void;
-    /** One instance for the life of this container and its scopes. Root only; throws on a scope. */
-    singleton<T>(abstract: Abstract<T>, concrete?: Concrete<T>): void;
-    /** One instance per scope (e.g. per HTTP request or queue job). Root only; throws on a scope. */
-    scoped<T>(abstract: Abstract<T>, concrete?: Concrete<T>): void;
-    /** Register an existing object as a shared instance. Returns it. On a scope it stays local to that scope. */
-    instance<T>(abstract: Abstract<T>, instance: T): T;
-    /** Resolve. Unbound classes are constructed with `new Class()`. Unbound tokens throw BindingResolutionError. */
-    make<T>(abstract: Abstract<T>): T;
-    bound(abstract: Abstract<unknown>): boolean;
-    resolved(abstract: Abstract<unknown>): boolean;
-    /** Decorate or replace an instance each time it's resolved (applied before resolving callbacks). Root only; throws on a scope. */
-    extend<T>(abstract: Abstract<T>, extender: (instance: T, container: Container) => T): void;
-    /** Called after each resolution of the abstract. Root only; throws on a scope. */
-    resolving<T>(abstract: Abstract<T>, callback: (instance: T, container: Container) => void): void;
-    forgetInstance(abstract: Abstract<unknown>): void;
-    /** A child container: shares bindings and singletons with its parent, and has its own scoped instances. Bindings can't be registered on it. */
-    createScope(): Container;
-    /** Run fn with this container as the "current" one for inject(), helpers and facades (AsyncLocalStorage). */
-    run<R>(fn: () => R): R;
-}
-declare const Container: Token$1<Container>;
-
-interface ServiceProvider$1 {
-    /** Bind things into the container. Synchronous. Don't resolve other services here. */
-    register?(): void;
-    /** Runs after every provider is registered. May be async (e.g. importing route files). */
-    boot?(): void | Promise<void>;
-}
-type ServiceProviderClass = new (app: Application) => ServiceProvider$1;
-interface Application extends Container {
-    readonly version: string;
-    basePath(path?: string): string;
-    appPath(path?: string): string;
-    bootstrapPath(path?: string): string;
-    configPath(path?: string): string;
-    databasePath(path?: string): string;
-    publicPath(path?: string): string;
-    resourcePath(path?: string): string;
-    storagePath(path?: string): string;
-    /** With no args returns the environment name. With args returns whether it matches any of them. */
-    environment(): string;
-    environment(...environments: string[]): boolean;
-    isProduction(): boolean;
-    isLocal(): boolean;
-    runningInConsole(): boolean;
-    /** Mark the app as running in the console (the CLI entry point calls this). Defaults to true. */
-    setRunningInConsole(value?: boolean): void;
-    runningUnitTests(): boolean;
-    /** Registers the provider. If the app is already booted, the provider is booted immediately. */
-    register(provider: ServiceProvider$1 | ServiceProviderClass): Promise<ServiceProvider$1>;
-    getProviders(): ServiceProvider$1[];
-    boot(): Promise<void>;
-    isBooted(): boolean;
-    booting(callback: (app: Application) => void | Promise<void>): void;
-    booted(callback: (app: Application) => void | Promise<void>): void;
-    /** Handle one HTTP request in a fresh request scope via the bound HttpKernel. */
-    handle(request: Request): Promise<Response>;
-    /** Register a callback that terminate() runs, in registration order. */
-    terminating(callback: () => void | Promise<void>): void;
-    terminate(): Promise<void>;
-}
-declare const Application: Token$1<Application>;
-
-interface ConfigRepository {
-    has(key: string): boolean;
-    /** Dot notation: get('database.connections.sqlite.database'). */
-    get<T = unknown>(key: string, defaultValue?: T): T;
-    set(key: string, value: unknown): void;
-    set(values: Record<string, unknown>): void;
-    push(key: string, value: unknown): void;
-    all(): Record<string, unknown>;
-}
-declare const ConfigRepository: Token$1<ConfigRepository>;
-interface ClassRegistry {
-    /** Registers under `name` (default: cls.name). Throws if the name is already taken by a different class. */
-    register(cls: Class<unknown>, name?: string): string;
-    nameOf(cls: Class<unknown>): string | undefined;
-    resolve<T = unknown>(name: string): Class<T>;
-    has(name: string): boolean;
-}
-declare const ClassRegistry: Token$1<ClassRegistry>;
-
-/** A typed, runtime-unique key for container bindings. */
-interface Token<T> {
-    readonly id: symbol;
-    readonly description: string;
-    /** Phantom field: only carries T at the type level. Never set at runtime. */
-    readonly __type?: T;
-}
-interface Htmlable {
-    toHtml(): string;
-}
-
-interface View$1 extends Htmlable {
-    readonly name: string;
-    with(key: string | Record<string, unknown>, value?: unknown): this;
-    render(): Promise<string>;
-}
-/** Resolves 'posts.index' → resources/views/posts/index.tsx and renders it to HTML on the server. */
-interface ViewFactory {
-    make(name: string, data?: Record<string, unknown>): View$1;
-    exists(name: string): boolean;
-    share(key: string | Record<string, unknown>, value?: unknown): void;
-    composer(views: string | string[], composer: (view: View$1) => void | Promise<void>): void;
-}
-declare const ViewFactory: Token<ViewFactory>;
-
-type ErrorKind = 'Http' | 'Server' | 'ModelNotFound' | 'Validation' | 'Authentication' | 'Authorization' | 'TokenMismatch' | 'BindingResolution' | 'CircularDependency' | 'ContainerNotAvailable';
-/** Every error thrown by the framework implements this. The exception handler switches on `kind`. */
-interface OrielError extends Error {
-    readonly kind: ErrorKind;
-    /** HTTP status the error should render as, when relevant. */
-    readonly status?: number;
-    readonly headers?: Record<string, string>;
-}
-
-declare abstract class ServiceProvider implements ServiceProvider$1 {
-    protected readonly app: Application;
-    constructor(app: Application);
-    register(): void;
-    boot(): void | Promise<void>;
-    /** Package defaults under `key`; values the app already set win (shallow merge, like Laravel). */
-    protected mergeConfigFrom(defaults: Record<string, unknown>, key: string): void;
-}
-
-interface FacadeStatics<T> {
-    getFacadeRoot(): T;
-    /** Replace the instance in the current container (used by X.fake()). */
-    swap(instance: T): void;
-}
-type Facade<T, X = object> = T & X & FacadeStatics<T>;
+import { Htmlable, OrielError, ErrorKind, View as View$1, ViewFactory } from './contracts.js';
+import { F as Facade, S as ServiceProvider } from './index.d-WQpfdIbG.js';
 
 /** Marks the objects jsx() returns (Symbol.for, so two copies of the package agree). */
 declare const ELEMENT: unique symbol;
@@ -195,6 +52,93 @@ declare function renderToString(node: Renderable): Promise<string>;
 /** Renders to a UTF-8 byte stream, sending everything rendered so far each time rendering waits on a promise. */
 declare function renderToStream(node: Renderable): ReadableStream<Uint8Array>;
 
+/**
+ * The `o:` attributes of Live components, typed for TSX: a directive (`o:model`, `o:loading`, …) or an action on a DOM
+ * event (`o:click="save"`), with modifiers joined by `-` (`o:model-live`, `o:keydown-enter`). An `o:` name that is
+ * neither doesn't compile (`o:clik`, `o:modle`), and the forms listed here are completed by editors and have their
+ * values checked. TypeScript doesn't check JSX attribute names that contain a `-` unless the type lists them, so a
+ * form that isn't listed (a duration such as `o:model-live-debounce-500ms`, an event's modifiers) is accepted as
+ * written, and so is a misspelt one (`o:model-lvie`).
+ */
+type ModelTrigger = 'live' | 'blur' | 'change' | 'lazy';
+type ElementChange = 'remove' | 'class' | 'class-remove' | 'attr';
+/**
+ * The directives that aren't DOM events, by name: the value each takes (`boolean` for one that can be written bare,
+ * `<a o:navigate>`, or from an expression, `o:navigate={external}`: `false` leaves it out) and its modifier forms, the
+ * `-`-joined text after the name (`never` for none). A new directive adds a member here, and its name to the Live
+ * client's reserved directives.
+ */
+interface LiveDirectives {
+    /** o:model="title": binds an input to a public property, sent with the next request unless live, blur, change or lazy. */
+    model: {
+        value: string;
+        modifiers: ModelTrigger | 'number' | 'debounce' | 'live-debounce' | `${ModelTrigger}-number`;
+    };
+    /** o:loading: shown (or changed) while the component's request runs. */
+    loading: {
+        value: boolean | string;
+        modifiers: ElementChange | 'delay' | `delay-${ElementChange}`;
+    };
+    /** o:target="save,title": the actions or properties o:loading waits for. */
+    target: {
+        value: string;
+        modifiers: never;
+    };
+    /** o:poll="refresh": calls the method ($refresh without one) every 2.5 s, or every `o:poll-<n>s`. */
+    poll: {
+        value: boolean | string;
+        modifiers: 'keep-alive' | 'visible';
+    };
+    /** o:navigate on a link: fetches the page and swaps it in; `-hover` prefetches on hover. */
+    navigate: {
+        value: boolean;
+        modifiers: 'hover';
+    };
+    /** o:offline: shown (or changed) while the browser is offline. */
+    offline: {
+        value: boolean | string;
+        modifiers: ElementChange;
+    };
+    /** o:key: keeps an element's identity across re-renders. */
+    key: {
+        value: string | number;
+        modifiers: never;
+    };
+    /** o:confirm="Delete this tag?": asks before the element's action runs; `-prompt` asks for a typed answer. */
+    confirm: {
+        value: boolean | string;
+        modifiers: 'prompt';
+    };
+    /** o:announce on a status region: an action that leaves the same message announces it again. */
+    announce: {
+        value: boolean;
+        modifiers: never;
+    };
+}
+/**
+ * The DOM events `o:<event>` runs an action on. A name with a `-` can't be written in TSX (modifiers are `-`
+ * segments), and `offline` is the o:offline directive, not the event. An event this list doesn't have (a custom
+ * event a component dispatches) is spread: `<div {...{ 'o:saved': 'refresh' }} />`.
+ */
+type LiveEvent = 'click' | 'dblclick' | 'auxclick' | 'contextmenu' | 'mousedown' | 'mouseup' | 'mousemove' | 'mouseover' | 'mouseout' | 'mouseenter' | 'mouseleave' | 'wheel' | 'pointerdown' | 'pointerup' | 'pointermove' | 'pointerover' | 'pointerout' | 'pointerenter' | 'pointerleave' | 'pointercancel' | 'gotpointercapture' | 'lostpointercapture' | 'keydown' | 'keyup' | 'keypress' | 'input' | 'beforeinput' | 'change' | 'submit' | 'reset' | 'invalid' | 'select' | 'formdata' | 'search' | 'focus' | 'blur' | 'focusin' | 'focusout' | 'copy' | 'cut' | 'paste' | 'drag' | 'dragstart' | 'dragend' | 'dragenter' | 'dragleave' | 'dragover' | 'drop' | 'touchstart' | 'touchend' | 'touchmove' | 'touchcancel' | 'compositionstart' | 'compositionupdate' | 'compositionend' | 'play' | 'pause' | 'playing' | 'ended' | 'timeupdate' | 'volumechange' | 'ratechange' | 'durationchange' | 'loadstart' | 'loadeddata' | 'loadedmetadata' | 'canplay' | 'canplaythrough' | 'seeking' | 'seeked' | 'waiting' | 'stalled' | 'suspend' | 'emptied' | 'progress' | 'abort' | 'error' | 'load' | 'animationstart' | 'animationend' | 'animationiteration' | 'animationcancel' | 'transitionstart' | 'transitionend' | 'transitionrun' | 'transitioncancel' | 'scroll' | 'scrollend' | 'resize' | 'toggle' | 'beforetoggle' | 'close' | 'cancel' | 'online' | 'popstate' | 'hashchange' | 'beforeunload' | 'pagehide' | 'pageshow' | 'storage' | 'message' | 'visibilitychange' | 'selectionchange' | 'fullscreenchange' | 'slotchange' | 'cuechange';
+/** `o:model`, `o:model-live`, …: each directive and each of its modifier forms, with the directive's value. */
+type LiveDirectiveAttributes = {
+    [N in keyof LiveDirectives as `o:${N}` | `o:${N}-${LiveDirectives[N]['modifiers']}`]?: LiveDirectives[N]['value'];
+};
+/** `o:click="save"`: an action (a method, `method(args)`, `$refresh`, `$set(…)`, `$dispatch(…)`) on a DOM event. */
+type LiveEventAttributes = {
+    [E in LiveEvent as `o:${E}`]?: string;
+};
+type Letter = 'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g' | 'h' | 'i' | 'j' | 'k' | 'l' | 'm' | 'n' | 'o' | 'p' | 'q' | 'r' | 's' | 't' | 'u' | 'v' | 'w' | 'x' | 'y' | 'z';
+type Digit = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
+/**
+ * Every other attribute, with any value: each name that doesn't start with `o:` (`o`, `href`, `onclick`, `open`,
+ * `xlink:href`, `viewBox`; names with a `-`, such as `data-*`, `aria-*` and `hx-post`, are never checked).
+ */
+type OtherAttributes = {
+    [K in 'o' | `${Exclude<Letter, 'o'> | Uppercase<Letter> | '_' | '$'}${string}` | `o${Letter | Uppercase<Letter> | Digit | '_' | '.' | '$'}${string}`]?: unknown;
+};
+
 /**
  * The automatic JSX runtime (`jsxImportSource: "@orieljs/view"`). jsx() only describes elements; rendering
  * (escaping, async components) happens in renderToString()/renderToStream().
@@ -203,8 +147,13 @@ declare function renderToStream(node: Renderable): ReadableStream<Uint8Array>;
 declare function jsx(type: ElementType, props: Props | null, key?: string | number): OrielElement;
 /** Same as jsx(); the compiler uses it when there are several static children. */
 declare const jsxs: typeof jsx;
-/** Attributes every intrinsic element accepts. Unknown attributes (hx-*, x-*, o:click, …) are allowed. */
-interface HtmlAttributes {
+/**
+ * Attributes every intrinsic element accepts. Any attribute is allowed (hx-*, x-*, data-*, …) except an `o:` name
+ * that isn't a Live directive or `o:<event>` (directives.ts), so a typo such as `o:clik` doesn't compile. An `o:` form
+ * with a `-` that the type doesn't list compiles unchecked (TypeScript doesn't check a hyphenated JSX name the type
+ * leaves out), and a custom event name is spread: `<div {...{ 'o:saved': 'refresh' }} />`.
+ */
+interface HtmlAttributes extends OtherAttributes, LiveDirectiveAttributes, LiveEventAttributes {
     children?: Renderable;
     class?: ClassValue;
     className?: ClassValue;
@@ -212,7 +161,6 @@ interface HtmlAttributes {
     dangerouslySetInnerHTML?: {
         __html: string;
     };
-    [attribute: string]: unknown;
 }
 declare namespace JSX {
     type Element = OrielElement;
@@ -324,6 +272,8 @@ declare class Factory implements ViewFactory, ViewEnvironment {
     /** Runs before matching views render. Patterns use `*` wildcards: 'posts.*', '*'. */
     composer(views: string | string[], composer: Composer): void;
     callComposer(view: View$1): Promise<void>;
+    /** Renders TSX, a string, an Htmlable or a View (or promises of them) to HTML, like Laravel's Blade::render(). */
+    renderToString(node: unknown): Promise<string>;
     /** Imports the view file (Node's module cache keeps it) and returns its default-export component. */
     load(path: string, name: string): Promise<Component>;
     addLocation(path: string): void;
@@ -347,4 +297,4 @@ declare class ViewServiceProvider extends ServiceProvider {
     register(): void;
 }
 
-export { Application as A, jsxs as B, ClassRegistry as C, ELEMENT as E, FileViewFinder as F, type HtmlAttributes as H, InvalidViewError as I, JSX as J, type OrielElement as O, type Props as P, type Renderable as R, type ServiceProvider$1 as S, TsxView as T, View as V, type Class as a, type Abstract as b, ConfigRepository as c, type ClassValue as d, type Component as e, Fragment as f, HtmlString as g, type StyleObject as h, type ViewEnvironment as i, Factory as j, ViewNotFoundError as k, ViewRenderError as l, ViewServiceProvider as m, classNames as n, createElement as o, csrfField as p, e as q, isElement as r, isHtmlable as s, methodField as t, raw as u, renderToStream as v, renderToString as w, styleString as x, view as y, jsx as z };
+export { type ClassValue as C, ELEMENT as E, FileViewFinder as F, type HtmlAttributes as H, InvalidViewError as I, JSX as J, type LiveDirectives as L, type OrielElement as O, type Props as P, type Renderable as R, type StyleObject as S, TsxView as T, View as V, Fragment as a, HtmlString as b, type LiveEvent as c, type Component as d, type ViewEnvironment as e, Factory as f, ViewNotFoundError as g, ViewRenderError as h, ViewServiceProvider as i, classNames as j, createElement as k, csrfField as l, e as m, isElement as n, isHtmlable as o, methodField as p, renderToStream as q, raw as r, renderToString as s, styleString as t, jsx as u, view as v, jsxs as w };

package/dist/jsx-runtime.d.ts

@@ -1 +1,3 @@
-export { f as Fragment, H as HtmlAttributes, J as JSX, z as jsx, B as jsxs } from './jsx-runtime-B8J6xq-7.js';
+export { a as Fragment, H as HtmlAttributes, J as JSX, u as jsx, w as jsxs } from './jsx-runtime-6um4Mwfb.js';
+import './contracts.js';
+import './index.d-WQpfdIbG.js';

package/dist/jsx-runtime.js

@@ -2,9 +2,9 @@ import {
   Fragment,
   jsx,
   jsxs
-} from "./chunk-WI7E7Q46.js";
-import "./chunk-AI2RFMBT.js";
-import "./chunk-K6MAA3RM.js";
+} from "./chunk-VOYW3R5J.js";
+import "./chunk-7ZQZYDOC.js";
+import "./chunk-GVNLZZTN.js";
 export {
   Fragment,
   jsx,