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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/NOTICE CHANGED
@@ -7,3 +7,10 @@ This product includes software developed by the Oriel project
7
7
  Oriel is licensed under the Apache License, Version 2.0 (see LICENSE).
8
8
  The Oriel name and logo are not covered by that license; see TRADEMARKS.md
9
9
  (https://github.com/orieljs/framework/blob/main/TRADEMARKS.md).
10
+
11
+ @orieljs/support (and @orieljs/framework, which bundles it) includes transliteration data from
12
+ voku/portable-ascii (https://github.com/voku/portable-ascii), Copyright (C) 2019 Lars Moelleken, MIT License.
13
+
14
+ @orieljs/notifications (and @orieljs/framework, which bundles it) includes the HTML and CSS of
15
+ Laravel's default notification mail (laravel/framework, https://github.com/laravel/framework),
16
+ Copyright (c) Taylor Otwell, MIT License.
package/README.md ADDED
@@ -0,0 +1,35 @@
1
+ # @orieljs/view
2
+
3
+ Server-rendered views for Oriel, written in TSX: a view is a function component that returns HTML, where Laravel uses Blade. It is part of `@orieljs/framework`, which every Oriel app already installs, and is re-exported from it. In an app, import it from `@orieljs/framework`; `@orieljs/view` is also published on its own.
4
+
5
+ ```bash
6
+ npm install @orieljs/framework
7
+ ```
8
+
9
+ ```tsx title="resources/views/posts/index.tsx"
10
+ import type { Post } from '../../../app/Models/Post'
11
+
12
+ export default function Index({ posts }: { posts: Post[] }) {
13
+ return (
14
+ <ul>
15
+ {posts.map((post) => (
16
+ <li>
17
+ <a href={`/posts/${post.slug}`}>{post.title}</a>
18
+ </li>
19
+ ))}
20
+ </ul>
21
+ )
22
+ }
23
+ ```
24
+
25
+ `view('posts.index', { posts })` renders `resources/views/posts/index.tsx` from a route or a controller. Text is escaped unless it is wrapped in `raw()`. `View.share()` and `View.composer()` add data to views, and `csrfField()` and `methodField()` write a form's hidden fields.
26
+
27
+ Documentation: https://orieljs.vercel.app/docs/views
28
+
29
+ Status: early alpha. APIs will change.
30
+
31
+ ## License
32
+
33
+ Oriel is open-source software licensed under the Apache License 2.0 (Apache-2.0; see `LICENSE` and `NOTICE`). The Oriel name and logo are trademarks; see `TRADEMARKS.md`.
34
+
35
+ Website: https://orieljs.vercel.app
package/TRADEMARKS.md ADDED
@@ -0,0 +1,33 @@
1
+ # Oriel trademark policy
2
+
3
+ The Oriel code is open source under the Apache License 2.0. The **Oriel name and logo** are not: the license covers
4
+ the code only (section 6 of the license says so), and the name and logo stay with the project. This page explains
5
+ what you can and can't do with them. The goal is simple: people should always be able to tell what is the real Oriel
6
+ and what isn't.
7
+
8
+ ## You can, without asking
9
+
10
+ - Use, change, ship and sell the code, as the license allows.
11
+ - Say that your app or package is "built with Oriel", "for Oriel" or "compatible with Oriel".
12
+ - Name a package `oriel-<something>` or `<something>-for-oriel` when it works with Oriel, as long as it is clear that
13
+ it is not official (for example, don't publish it under the `@orieljs` npm scope).
14
+ - Use the name and logo to write about Oriel, teach it, or link to it, in articles, talks, videos and courses.
15
+ - Use the unmodified logo to point to the project, as it is (no recolouring, cropping or
16
+ distortion).
17
+
18
+ ## You can't, without written permission
19
+
20
+ - Call a fork, a modified copy or a competing product "Oriel", or anything likely to be confused with it.
21
+ - Use the name or logo as the name, logo or domain of your own product, company or service.
22
+ - Suggest that the Oriel project made, endorses or supports your work when it doesn't.
23
+ - Sell merchandise with the name or logo.
24
+
25
+ ## Forks
26
+
27
+ Forks are welcome. Please give yours a different name and logo, keep the `LICENSE` and `NOTICE` files, and say that
28
+ it is based on Oriel.
29
+
30
+ ## Questions
31
+
32
+ Open an issue at https://github.com/orieljs/framework or email meeeet.dev@gmail.com. If you're unsure whether a use
33
+ is fine, ask; the answer is usually yes.
@@ -22,4 +22,4 @@ export {
22
22
  jsx,
23
23
  jsxs
24
24
  };
25
- //# sourceMappingURL=chunk-KIU7OKDI.js.map
25
+ //# sourceMappingURL=chunk-AXHMZAM6.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../Element.ts","../jsx-runtime.ts"],"sourcesContent":["import type { Htmlable } from '@orieljs/contracts'\n\n/** Marks the objects jsx() returns (Symbol.for, so two copies of the package agree). */\nexport const ELEMENT: unique symbol = Symbol.for('oriel:view.element')\n\nexport type Props = Record<string, unknown>\n\n/** Anything that can appear as a child: text is escaped, Htmlable is emitted as-is, promises are awaited. */\nexport type Renderable =\n | OrielElement\n | string\n | number\n | bigint\n | boolean\n | null\n | undefined\n | Htmlable\n | Promise<Renderable>\n | Iterable<Renderable>\n\n/** A function component. It may be async: the renderer awaits it. */\nexport type Component<P = Props> = (props: P) => Renderable | Promise<Renderable>\n\n/**\n * `<>…</>` and `<Fragment>`: renders its children only. A symbol at runtime; typed as a component so that\n * `<Fragment>` type-checks as a JSX tag.\n */\nexport const Fragment = Symbol.for('oriel:view.fragment') as unknown as (props: { children?: Renderable }) => Renderable\n\nexport type ElementType = string | Component<never>\n\n/** What `<div />` evaluates to: an inert description, rendered later by renderToString()/renderToStream(). */\nexport interface OrielElement {\n readonly [ELEMENT]: true\n readonly type: ElementType\n readonly props: Props\n readonly key: string | number | undefined\n}\n\nexport function createElement(type: ElementType, props: Props | null | undefined, key?: string | number): OrielElement {\n return { [ELEMENT]: true, type, props: props ?? {}, key }\n}\n\nexport function isElement(value: unknown): value is OrielElement {\n return typeof value === 'object' && value !== null && (value as Record<symbol, unknown>)[ELEMENT] === true\n}\n","/**\n * The automatic JSX runtime (`jsxImportSource: \"@orieljs/view\"`). jsx() only describes elements; rendering\n * (escaping, async components) happens in renderToString()/renderToStream().\n */\nimport type { ClassValue, StyleObject } from './attributes'\nimport { createElement, Fragment, type Component, type ElementType, type OrielElement, type Props, type Renderable } from './Element'\n\nexport { Fragment }\n\nexport function jsx(type: ElementType, props: Props | null, key?: string | number): OrielElement {\n return createElement(type, props, key)\n}\n\n/** Same as jsx(); the compiler uses it when there are several static children. */\nexport const jsxs = jsx\n\n/** Attributes every intrinsic element accepts. Unknown attributes (hx-*, x-*, o:click, …) are allowed. */\nexport interface HtmlAttributes {\n children?: Renderable\n class?: ClassValue\n className?: ClassValue\n style?: string | StyleObject\n dangerouslySetInnerHTML?: { __html: string }\n [attribute: string]: unknown\n}\n\nexport declare namespace JSX {\n type Element = OrielElement\n /** Lets components be async: `async function Posts() { … }` is a valid element type. */\n type ElementType = string | Component<never>\n interface ElementChildrenAttribute {\n children: unknown\n }\n interface IntrinsicAttributes {\n key?: string | number\n }\n interface IntrinsicElements {\n [element: string]: HtmlAttributes\n }\n}\n"],"mappings":";AAGO,IAAM,UAAyB,uBAAO,IAAI,oBAAoB;AAwB9D,IAAM,WAAW,uBAAO,IAAI,qBAAqB;AAYjD,SAAS,cAAc,MAAmB,OAAiC,KAAqC;AACrH,SAAO,EAAE,CAAC,OAAO,GAAG,MAAM,MAAM,OAAO,SAAS,CAAC,GAAG,IAAI;AAC1D;AAEO,SAAS,UAAU,OAAuC;AAC/D,SAAO,OAAO,UAAU,YAAY,UAAU,QAAS,MAAkC,OAAO,MAAM;AACxG;;;ACpCO,SAAS,IAAI,MAAmB,OAAqB,KAAqC;AAC/F,SAAO,cAAc,MAAM,OAAO,GAAG;AACvC;AAGO,IAAM,OAAO;","names":[]}
1
+ {"version":3,"sources":["../Element.ts","../jsx-runtime.ts"],"sourcesContent":["import type { Htmlable } from '@orieljs/contracts'\n\n/** Marks the objects jsx() returns (Symbol.for, so two copies of the package agree). */\nexport const ELEMENT: unique symbol = Symbol.for('oriel:view.element')\n\nexport type Props = Record<string, unknown>\n\n/** Anything that can appear as a child: text is escaped, Htmlable is emitted as-is, promises are awaited. */\nexport type Renderable =\n | OrielElement\n | string\n | number\n | bigint\n | boolean\n | null\n | undefined\n | Htmlable\n | Promise<Renderable>\n | Iterable<Renderable>\n\n/** A function component. It may be async: the renderer awaits it. */\nexport type Component<P = Props> = (props: P) => Renderable | Promise<Renderable>\n\n/**\n * `<>…</>` and `<Fragment>`: renders its children only. A symbol at runtime; typed as a component so that\n * `<Fragment>` type-checks as a JSX tag.\n */\nexport const Fragment = Symbol.for('oriel:view.fragment') as unknown as (props: { children?: Renderable }) => Renderable\n\nexport type ElementType = string | Component<never>\n\n/** What `<div />` evaluates to: an inert description, rendered later by renderToString()/renderToStream(). */\nexport interface OrielElement {\n readonly [ELEMENT]: true\n readonly type: ElementType\n readonly props: Props\n readonly key: string | number | undefined\n}\n\nexport function createElement(type: ElementType, props: Props | null | undefined, key?: string | number): OrielElement {\n return { [ELEMENT]: true, type, props: props ?? {}, key }\n}\n\nexport function isElement(value: unknown): value is OrielElement {\n return typeof value === 'object' && value !== null && (value as Record<symbol, unknown>)[ELEMENT] === true\n}\n","/**\n * The automatic JSX runtime (`jsxImportSource: \"@orieljs/view\"`). jsx() only describes elements; rendering\n * (escaping, async components) happens in renderToString()/renderToStream().\n */\nimport type { ClassValue, StyleObject } from './attributes'\nimport type { LiveDirectiveAttributes, LiveEventAttributes, OtherAttributes } from './directives'\nimport { createElement, Fragment, type Component, type ElementType, type OrielElement, type Props, type Renderable } from './Element'\n\nexport { Fragment }\n\nexport function jsx(type: ElementType, props: Props | null, key?: string | number): OrielElement {\n return createElement(type, props, key)\n}\n\n/** Same as jsx(); the compiler uses it when there are several static children. */\nexport const jsxs = jsx\n\n/**\n * Attributes every intrinsic element accepts. Any attribute is allowed (hx-*, x-*, data-*, …) except an `o:` name\n * that isn't a Live directive or `o:<event>` (directives.ts), so a typo such as `o:clik` doesn't compile. An `o:` form\n * with a `-` that the type doesn't list compiles unchecked (TypeScript doesn't check a hyphenated JSX name the type\n * leaves out), and a custom event name is spread: `<div {...{ 'o:saved': 'refresh' }} />`.\n */\nexport interface HtmlAttributes extends OtherAttributes, LiveDirectiveAttributes, LiveEventAttributes {\n children?: Renderable\n class?: ClassValue\n className?: ClassValue\n style?: string | StyleObject\n dangerouslySetInnerHTML?: { __html: string }\n}\n\nexport declare namespace JSX {\n type Element = OrielElement\n /** Lets components be async: `async function Posts() { … }` is a valid element type. */\n type ElementType = string | Component<never>\n interface ElementChildrenAttribute {\n children: unknown\n }\n interface IntrinsicAttributes {\n key?: string | number\n }\n interface IntrinsicElements {\n [element: string]: HtmlAttributes\n }\n}\n"],"mappings":";AAGO,IAAM,UAAyB,uBAAO,IAAI,oBAAoB;AAwB9D,IAAM,WAAW,uBAAO,IAAI,qBAAqB;AAYjD,SAAS,cAAc,MAAmB,OAAiC,KAAqC;AACrH,SAAO,EAAE,CAAC,OAAO,GAAG,MAAM,MAAM,OAAO,SAAS,CAAC,GAAG,IAAI;AAC1D;AAEO,SAAS,UAAU,OAAuC;AAC/D,SAAO,OAAO,UAAU,YAAY,UAAU,QAAS,MAAkC,OAAO,MAAM;AACxG;;;ACnCO,SAAS,IAAI,MAAmB,OAAqB,KAAqC;AAC/F,SAAO,cAAc,MAAM,OAAO,GAAG;AACvC;AAGO,IAAM,OAAO;","names":[]}
package/dist/index.d.ts CHANGED
@@ -53,6 +53,93 @@ declare function renderToString(node: Renderable): Promise<string>;
53
53
  /** Renders to a UTF-8 byte stream, sending everything rendered so far each time rendering waits on a promise. */
54
54
  declare function renderToStream(node: Renderable): ReadableStream<Uint8Array>;
55
55
 
56
+ /**
57
+ * The `o:` attributes of Live components, typed for TSX: a directive (`o:model`, `o:loading`, …) or an action on a DOM
58
+ * event (`o:click="save"`), with modifiers joined by `-` (`o:model-live`, `o:keydown-enter`). An `o:` name that is
59
+ * neither doesn't compile (`o:clik`, `o:modle`), and the forms listed here are completed by editors and have their
60
+ * values checked. TypeScript doesn't check JSX attribute names that contain a `-` unless the type lists them, so a
61
+ * form that isn't listed (a duration such as `o:model-live-debounce-500ms`, an event's modifiers) is accepted as
62
+ * written, and so is a misspelt one (`o:model-lvie`).
63
+ */
64
+ type ModelTrigger = 'live' | 'blur' | 'change' | 'lazy';
65
+ type ElementChange = 'remove' | 'class' | 'class-remove' | 'attr';
66
+ /**
67
+ * The directives that aren't DOM events, by name: the value each takes (`boolean` for one that can be written bare,
68
+ * `<a o:navigate>`, or from an expression, `o:navigate={external}`: `false` leaves it out) and its modifier forms, the
69
+ * `-`-joined text after the name (`never` for none). A new directive adds a member here, and its name to the Live
70
+ * client's reserved directives.
71
+ */
72
+ interface LiveDirectives {
73
+ /** o:model="title": binds an input to a public property, sent with the next request unless live, blur, change or lazy. */
74
+ model: {
75
+ value: string;
76
+ modifiers: ModelTrigger | 'number' | 'debounce' | 'live-debounce' | `${ModelTrigger}-number`;
77
+ };
78
+ /** o:loading: shown (or changed) while the component's request runs. */
79
+ loading: {
80
+ value: boolean | string;
81
+ modifiers: ElementChange | 'delay' | `delay-${ElementChange}`;
82
+ };
83
+ /** o:target="save,title": the actions or properties o:loading waits for. */
84
+ target: {
85
+ value: string;
86
+ modifiers: never;
87
+ };
88
+ /** o:poll="refresh": calls the method ($refresh without one) every 2.5 s, or every `o:poll-<n>s`. */
89
+ poll: {
90
+ value: boolean | string;
91
+ modifiers: 'keep-alive' | 'visible';
92
+ };
93
+ /** o:navigate on a link: fetches the page and swaps it in; `-hover` prefetches on hover. */
94
+ navigate: {
95
+ value: boolean;
96
+ modifiers: 'hover';
97
+ };
98
+ /** o:offline: shown (or changed) while the browser is offline. */
99
+ offline: {
100
+ value: boolean | string;
101
+ modifiers: ElementChange;
102
+ };
103
+ /** o:key: keeps an element's identity across re-renders. */
104
+ key: {
105
+ value: string | number;
106
+ modifiers: never;
107
+ };
108
+ /** o:confirm="Delete this tag?": asks before the element's action runs; `-prompt` asks for a typed answer. */
109
+ confirm: {
110
+ value: boolean | string;
111
+ modifiers: 'prompt';
112
+ };
113
+ /** o:announce on a status region: an action that leaves the same message announces it again. */
114
+ announce: {
115
+ value: boolean;
116
+ modifiers: never;
117
+ };
118
+ }
119
+ /**
120
+ * The DOM events `o:<event>` runs an action on. A name with a `-` can't be written in TSX (modifiers are `-`
121
+ * segments), and `offline` is the o:offline directive, not the event. An event this list doesn't have (a custom
122
+ * event a component dispatches) is spread: `<div {...{ 'o:saved': 'refresh' }} />`.
123
+ */
124
+ 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';
125
+ /** `o:model`, `o:model-live`, …: each directive and each of its modifier forms, with the directive's value. */
126
+ type LiveDirectiveAttributes = {
127
+ [N in keyof LiveDirectives as `o:${N}` | `o:${N}-${LiveDirectives[N]['modifiers']}`]?: LiveDirectives[N]['value'];
128
+ };
129
+ /** `o:click="save"`: an action (a method, `method(args)`, `$refresh`, `$set(…)`, `$dispatch(…)`) on a DOM event. */
130
+ type LiveEventAttributes = {
131
+ [E in LiveEvent as `o:${E}`]?: string;
132
+ };
133
+ 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';
134
+ type Digit = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
135
+ /**
136
+ * Every other attribute, with any value: each name that doesn't start with `o:` (`o`, `href`, `onclick`, `open`,
137
+ * `xlink:href`, `viewBox`; names with a `-`, such as `data-*`, `aria-*` and `hx-post`, are never checked).
138
+ */
139
+ type OtherAttributes = {
140
+ [K in 'o' | `${Exclude<Letter, 'o'> | Uppercase<Letter> | '_' | '$'}${string}` | `o${Letter | Uppercase<Letter> | Digit | '_' | '.' | '$'}${string}`]?: unknown;
141
+ };
142
+
56
143
  /**
57
144
  * The automatic JSX runtime (`jsxImportSource: "@orieljs/view"`). jsx() only describes elements; rendering
58
145
  * (escaping, async components) happens in renderToString()/renderToStream().
@@ -61,8 +148,13 @@ declare function renderToStream(node: Renderable): ReadableStream<Uint8Array>;
61
148
  declare function jsx(type: ElementType, props: Props | null, key?: string | number): OrielElement;
62
149
  /** Same as jsx(); the compiler uses it when there are several static children. */
63
150
  declare const jsxs: typeof jsx;
64
- /** Attributes every intrinsic element accepts. Unknown attributes (hx-*, x-*, o:click, …) are allowed. */
65
- interface HtmlAttributes {
151
+ /**
152
+ * Attributes every intrinsic element accepts. Any attribute is allowed (hx-*, x-*, data-*, …) except an `o:` name
153
+ * that isn't a Live directive or `o:<event>` (directives.ts), so a typo such as `o:clik` doesn't compile. An `o:` form
154
+ * with a `-` that the type doesn't list compiles unchecked (TypeScript doesn't check a hyphenated JSX name the type
155
+ * leaves out), and a custom event name is spread: `<div {...{ 'o:saved': 'refresh' }} />`.
156
+ */
157
+ interface HtmlAttributes extends OtherAttributes, LiveDirectiveAttributes, LiveEventAttributes {
66
158
  children?: Renderable;
67
159
  class?: ClassValue;
68
160
  className?: ClassValue;
@@ -70,7 +162,6 @@ interface HtmlAttributes {
70
162
  dangerouslySetInnerHTML?: {
71
163
  __html: string;
72
164
  };
73
- [attribute: string]: unknown;
74
165
  }
75
166
  declare namespace JSX {
76
167
  type Element = OrielElement;
@@ -182,6 +273,8 @@ declare class Factory implements ViewFactory, ViewEnvironment {
182
273
  /** Runs before matching views render. Patterns use `*` wildcards: 'posts.*', '*'. */
183
274
  composer(views: string | string[], composer: Composer): void;
184
275
  callComposer(view: View$1): Promise<void>;
276
+ /** Renders TSX, a string, an Htmlable or a View (or promises of them) to HTML, like Laravel's Blade::render(). */
277
+ renderToString(node: unknown): Promise<string>;
185
278
  /** Imports the view file (Node's module cache keeps it) and returns its default-export component. */
186
279
  load(path: string, name: string): Promise<Component>;
187
280
  addLocation(path: string): void;
@@ -205,4 +298,4 @@ declare class ViewServiceProvider extends ServiceProvider {
205
298
  register(): void;
206
299
  }
207
300
 
208
- export { type ClassValue, type Component, ELEMENT, Factory, FileViewFinder, Fragment, type HtmlAttributes, HtmlString, InvalidViewError, JSX, type OrielElement, type Props, type Renderable, type StyleObject, TsxView, View, type ViewEnvironment, ViewNotFoundError, ViewRenderError, ViewServiceProvider, classNames, createElement, csrfField, e, isElement, isHtmlable, jsx, jsxs, methodField, raw, renderToStream, renderToString, styleString, view };
301
+ export { type ClassValue, type Component, ELEMENT, Factory, FileViewFinder, Fragment, type HtmlAttributes, HtmlString, InvalidViewError, JSX, type LiveDirectiveAttributes, type LiveDirectives, type LiveEvent, type LiveEventAttributes, type OrielElement, type OtherAttributes, type Props, type Renderable, type StyleObject, TsxView, View, type ViewEnvironment, ViewNotFoundError, ViewRenderError, ViewServiceProvider, classNames, createElement, csrfField, e, isElement, isHtmlable, jsx, jsxs, methodField, raw, renderToStream, renderToString, styleString, view };
package/dist/index.js CHANGED
@@ -5,7 +5,7 @@ import {
5
5
  isElement,
6
6
  jsx,
7
7
  jsxs
8
- } from "./chunk-KIU7OKDI.js";
8
+ } from "./chunk-AXHMZAM6.js";
9
9
 
10
10
  // Html.ts
11
11
  var ESCAPES = { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#039;" };
@@ -400,6 +400,10 @@ var Factory = class {
400
400
  if (patterns.some((pattern) => Str.is(pattern, view2.name))) await composer(view2);
401
401
  }
402
402
  }
403
+ /** Renders TSX, a string, an Htmlable or a View (or promises of them) to HTML, like Laravel's Blade::render(). */
404
+ renderToString(node) {
405
+ return renderToString(node);
406
+ }
403
407
  /** Imports the view file (Node's module cache keeps it) and returns its default-export component. */
404
408
  async load(path, name) {
405
409
  const module = await import(pathToFileURL(path).href);
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../Html.ts","../errors.ts","../attributes.ts","../render.ts","../FileViewFinder.ts","../TsxView.ts","../Factory.ts","../helpers.ts","../facade.ts","../ViewServiceProvider.ts"],"sourcesContent":["import type { Htmlable } from '@orieljs/contracts'\n\nconst ESCAPES: Record<string, string> = { '&': '&amp;', '<': '&lt;', '>': '&gt;', '\"': '&quot;', \"'\": '&#039;' }\nconst UNSAFE = /[&<>\"']/g\n\n/** Markup that must not be escaped again (Laravel's Illuminate\\Support\\HtmlString). */\nexport class HtmlString implements Htmlable {\n constructor(private readonly html: string = '') {}\n\n toHtml(): string {\n return this.html\n }\n\n toString(): string {\n return this.html\n }\n\n isEmpty(): boolean {\n return this.html === ''\n }\n}\n\n/** Marks trusted markup so the renderer emits it unescaped: {raw(markdownHtml)}. Never pass user input. */\nexport function raw(html: string): HtmlString {\n return new HtmlString(html)\n}\n\nexport function isHtmlable(value: unknown): value is Htmlable {\n return typeof value === 'object' && value !== null && typeof (value as Htmlable).toHtml === 'function'\n}\n\n/** Laravel's e(): htmlspecialchars(ENT_QUOTES, double-encode). Htmlable values pass through; null is ''. */\nexport function e(value: unknown): string {\n if (value === null || value === undefined) return ''\n if (isHtmlable(value)) return value.toHtml()\n return String(value).replace(UNSAFE, (char) => ESCAPES[char]!)\n}\n","import type { ErrorKind, OrielError } from '@orieljs/contracts'\n\n/**\n * Programmer errors (Laravel throws InvalidArgumentException for these). Not an HTTP condition, so kind 'Server':\n * the exception handler reports them and renders a 500 whose message is hidden unless app.debug is on.\n */\nexport class ViewRenderError extends Error implements OrielError {\n override readonly name: string = 'ViewRenderError'\n readonly kind: ErrorKind = 'Server'\n readonly status = 500\n}\n\n/** Laravel's \"View [x] not found.\" (InvalidArgumentException). */\nexport class ViewNotFoundError extends Error implements OrielError {\n override readonly name: string = 'ViewNotFoundError'\n readonly kind: ErrorKind = 'Server'\n readonly status = 500\n constructor(readonly view: string, readonly searched: string[] = []) {\n super(`View [${view}] not found.`)\n }\n}\n\n/** A view file that doesn't default-export a component. */\nexport class InvalidViewError extends Error implements OrielError {\n override readonly name: string = 'InvalidViewError'\n readonly kind: ErrorKind = 'Server'\n readonly status = 500\n}\n","import { e, isHtmlable } from './Html'\nimport { ViewRenderError } from './errors'\n\n/** Props that are never attributes. */\nconst SKIPPED = new Set(['children', 'dangerouslySetInnerHTML', 'key', 'ref'])\n/** React-style prop names that map to a different HTML attribute. */\nconst RENAMED: Record<string, string> = { className: 'class', htmlFor: 'for' }\n/** HTML attribute names: no whitespace, quotes, `<`, `>`, `/`, `=` or control characters (WHATWG). */\nconst VALID_NAME = /^[^\\s\"'<>/=\\u0000-\\u001f\\u007f]+$/\n/** CSS properties whose numbers get no `px` (React's list, trimmed to what HTML pages use). */\nconst UNITLESS = new Set([\n 'animation-iteration-count', 'aspect-ratio', 'border-image-outset', 'border-image-slice', 'border-image-width',\n 'column-count', 'columns', 'fill-opacity', 'flex', 'flex-grow', 'flex-shrink', 'flex-order', 'font-weight',\n 'grid-area', 'grid-column', 'grid-column-end', 'grid-column-start', 'grid-row', 'grid-row-end', 'grid-row-start',\n 'line-clamp', 'line-height', 'opacity', 'order', 'orphans', 'scale', 'stop-opacity', 'stroke-dashoffset',\n 'stroke-opacity', 'stroke-width', 'tab-size', 'widows', 'z-index', 'zoom',\n])\n\nexport type ClassValue = string | number | null | undefined | false | ClassValue[] | Record<string, unknown>\nexport type StyleObject = Record<string, string | number | null | undefined | false>\n\n/** `class` accepts strings, arrays and `{ name: condition }` objects, like Blade's @class. */\nexport function classNames(value: ClassValue): string {\n if (value === null || value === undefined || value === false || value === '') return ''\n if (typeof value === 'string' || typeof value === 'number') return String(value).trim()\n if (Array.isArray(value)) return value.map(classNames).filter((name) => name !== '').join(' ')\n return Object.entries(value).filter(([, on]) => Boolean(on)).map(([name]) => name).join(' ')\n}\n\nconst kebab = (property: string) =>\n property.startsWith('--') ? property : property.replace(/^ms([A-Z])/, '-ms-$1').replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`)\n\n/** `{ marginTop: 4, '--gap': '1rem' }` → `margin-top:4px;--gap:1rem`. */\nexport function styleString(style: StyleObject): string {\n const parts: string[] = []\n for (const [property, value] of Object.entries(style)) {\n if (value === null || value === undefined || value === false || value === '') continue\n const name = kebab(property)\n const text = typeof value === 'number' && value !== 0 && !UNITLESS.has(name) && !name.startsWith('--') ? `${value}px` : String(value)\n parts.push(`${name}:${text}`)\n }\n return parts.join(';')\n}\n\nexport function assertValidName(name: string, what: 'attribute' | 'tag'): void {\n if (!VALID_NAME.test(name)) throw new ViewRenderError(`Invalid ${what} name [${name}].`)\n}\n\n/** Serializes props to ` name=\"value\"` pairs. Every value is escaped (HtmlString too); names are validated, never escaped. */\nexport function renderAttributes(props: Record<string, unknown>): string {\n let out = ''\n let classes = ''\n for (const [prop, value] of Object.entries(props)) {\n if (SKIPPED.has(prop)) continue\n if (value === undefined || value === null) continue\n if (typeof value === 'function' || typeof value === 'symbol') continue // event handlers do nothing on the server\n const name = RENAMED[prop] ?? prop\n assertValidName(name, 'attribute')\n // aria-*/data-* are string attributes: booleans are written out, like React.\n if (typeof value === 'boolean' && (name.startsWith('aria-') || name.startsWith('data-'))) {\n out += ` ${name}=\"${value}\"`\n continue\n }\n if (value === false) continue\n if (name === 'class') {\n const joined = classNames(value as ClassValue)\n classes = classes === '' ? joined : joined === '' ? classes : `${classes} ${joined}`\n continue\n }\n // Boolean attributes (disabled, checked, …) are present or absent.\n if (value === true) {\n out += ` ${name}`\n continue\n }\n const text = name === 'style' && typeof value === 'object' ? styleString(value as StyleObject) : attributeText(value)\n out += ` ${name}=\"${e(text)}\"`\n }\n return classes === '' ? out : ` class=\"${e(classes)}\"${out}`\n}\n\n/** Attribute values are text: objects become JSON (x-data, data-*), Htmlable its markup; the caller escapes all of it. */\nfunction attributeText(value: unknown): string {\n if (typeof value !== 'object' || value === null) return String(value)\n if (isHtmlable(value)) return value.toHtml()\n if (value instanceof Date) return value.toISOString()\n return JSON.stringify(value)\n}\n","import { Fragment, isElement, type OrielElement, type Renderable } from './Element'\nimport { e, isHtmlable } from './Html'\nimport { assertValidName, renderAttributes } from './attributes'\nimport { ViewRenderError } from './errors'\n\n/** Elements that never have children or a closing tag. */\nconst VOID = new Set(['area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input', 'link', 'meta', 'source', 'track', 'wbr'])\n\n/** Where rendered HTML goes. flush() is called before every await, so a stream sends what is ready. */\ninterface Sink {\n write(html: string): void\n flush(): void\n}\n\ninterface Renderer {\n render(): Promise<string>\n}\n\nconst isThenable = (value: unknown): value is PromiseLike<unknown> =>\n typeof value === 'object' && value !== null && typeof (value as PromiseLike<unknown>).then === 'function'\n\n/** A View (or anything with an async render() and toHtml()) used as a child, like Blade's @include. */\nconst isRenderer = (value: object): value is Renderer =>\n typeof (value as Partial<Renderer>).render === 'function' && isHtmlable(value)\n\nasync function write(node: Renderable, sink: Sink): Promise<void> {\n if (node === null || node === undefined || typeof node === 'boolean') return\n if (typeof node === 'string') return sink.write(e(node))\n if (typeof node === 'number' || typeof node === 'bigint') return sink.write(String(node))\n if (isElement(node)) return writeElement(node, sink)\n if (isThenable(node)) {\n sink.flush()\n const resolved: unknown = await (node as PromiseLike<unknown>)\n return write(resolved as Renderable, sink)\n }\n if (isRenderer(node)) {\n sink.flush()\n return sink.write(await node.render())\n }\n if (isHtmlable(node)) return sink.write(node.toHtml())\n if (typeof (node as Iterable<Renderable>)[Symbol.iterator] === 'function') {\n for (const child of node as Iterable<Renderable>) await write(child, sink)\n return\n }\n throw new ViewRenderError(`Objects are not valid as a child (found: object with keys {${Object.keys(node).join(', ')}}).`)\n}\n\nasync function writeElement(element: OrielElement, sink: Sink): Promise<void> {\n const { type, props } = element\n if (type === Fragment) return write(props.children as Renderable, sink)\n if (typeof type === 'function') {\n const result = (type as (props: unknown) => unknown)(props)\n if (isThenable(result)) sink.flush()\n const resolved: unknown = await result\n return write(resolved as Renderable, sink)\n }\n if (typeof type !== 'string') throw new ViewRenderError(`Invalid element type [${String(type)}].`)\n assertValidName(type, 'tag')\n\n const inner = props.dangerouslySetInnerHTML as { __html?: unknown } | undefined\n const hasChildren = props.children !== undefined && props.children !== null\n if (inner !== undefined && hasChildren) {\n throw new ViewRenderError(`<${type}> can't have both children and dangerouslySetInnerHTML.`)\n }\n // A document root gets its doctype: TSX has no syntax for <!DOCTYPE html>.\n if (type === 'html') sink.write('<!DOCTYPE html>')\n sink.write(`<${type}${renderAttributes(props)}>`)\n if (VOID.has(type.toLowerCase())) {\n if (hasChildren || inner !== undefined) throw new ViewRenderError(`<${type}> is a void element and can't have children.`)\n return\n }\n if (inner !== undefined) sink.write(String(inner.__html ?? ''))\n else await write(props.children as Renderable, sink)\n sink.write(`</${type}>`)\n}\n\n/** Renders JSX (or any Renderable) to an HTML string. Async components and promises are awaited in order. */\nexport async function renderToString(node: Renderable): Promise<string> {\n const parts: string[] = []\n await write(node, { write: (html) => void parts.push(html), flush: () => {} })\n return parts.join('')\n}\n\n/** Renders to a UTF-8 byte stream, sending everything rendered so far each time rendering waits on a promise. */\nexport function renderToStream(node: Renderable): ReadableStream<Uint8Array> {\n const encoder = new TextEncoder()\n return new ReadableStream<Uint8Array>({\n async start(controller) {\n let buffer = ''\n const sink: Sink = {\n write: (html) => void (buffer += html),\n flush: () => {\n if (buffer === '') return\n controller.enqueue(encoder.encode(buffer))\n buffer = ''\n },\n }\n try {\n await write(node, sink)\n sink.flush()\n controller.close()\n } catch (error) {\n controller.error(error)\n }\n },\n })\n}\n","import { existsSync } from 'node:fs'\nimport { isAbsolute, join, resolve } from 'node:path'\nimport { ViewNotFoundError } from './errors'\n\n/** `mail::message` → namespace `mail`, view `message` (Laravel's hint path delimiter). */\nconst HINT = '::'\n\n/**\n * Laravel's FileViewFinder: 'posts.index' → <location>/posts/index.<ext> for the first location and extension\n * that exist. Found paths are cached; misses are not, so a view created later is found.\n */\nexport class FileViewFinder {\n static readonly defaultExtensions = ['tsx', 'ts', 'jsx', 'js', 'mjs']\n\n private readonly locations: string[]\n private readonly hints = new Map<string, string[]>()\n private readonly views = new Map<string, string>()\n\n constructor(paths: string[], private readonly extensions: string[] = FileViewFinder.defaultExtensions) {\n this.locations = paths.map((path) => resolve(path))\n }\n\n /** The absolute path of the view file. Throws ViewNotFoundError. */\n find(name: string): string {\n const cached = this.views.get(name)\n if (cached !== undefined) return cached\n const [locations, view] = this.parse(name)\n const searched: string[] = []\n for (const location of locations) {\n for (const extension of this.extensions) {\n const file = join(location, `${view}.${extension}`)\n searched.push(file)\n if (existsSync(file)) {\n this.views.set(name, file)\n return file\n }\n }\n }\n throw new ViewNotFoundError(name, searched)\n }\n\n addLocation(path: string): void {\n this.locations.push(resolve(path))\n }\n\n prependLocation(path: string): void {\n this.locations.unshift(resolve(path))\n }\n\n /** Views under a namespace: addNamespace('mail', dir) makes 'mail::message' resolve to <dir>/message.tsx. */\n addNamespace(namespace: string, hints: string | string[]): void {\n const existing = this.hints.get(namespace) ?? []\n this.hints.set(namespace, [...existing, ...[hints].flat().map((path) => resolve(path))])\n }\n\n replaceNamespace(namespace: string, hints: string | string[]): void {\n this.hints.set(namespace, [hints].flat().map((path) => resolve(path)))\n this.flush()\n }\n\n getPaths(): string[] {\n return [...this.locations]\n }\n\n getHints(): Record<string, string[]> {\n return Object.fromEntries(this.hints)\n }\n\n /** Forget cached lookups. */\n flush(): void {\n this.views.clear()\n }\n\n /** [locations to search, relative file stem]. Dots become directories, so '..' can't climb out of a location. */\n private parse(name: string): [string[], string] {\n let locations = this.locations\n let view = name\n const at = name.indexOf(HINT)\n if (at !== -1) {\n const namespace = name.slice(0, at)\n view = name.slice(at + HINT.length)\n const hints = this.hints.get(namespace)\n if (hints === undefined) throw new ViewNotFoundError(name)\n locations = hints\n }\n const stem = view.replaceAll('.', '/')\n if (view === '' || stem.includes('\\0') || isAbsolute(stem) || stem.split(/[\\\\/]/).some((segment) => segment === '')) {\n throw new ViewNotFoundError(name)\n }\n return [locations, stem]\n }\n}\n","import type { View } from '@orieljs/contracts'\nimport { createElement, type Component } from './Element'\nimport { ViewRenderError } from './errors'\nimport { renderToString } from './render'\n\n/** What TsxView needs from its factory. */\nexport interface ViewEnvironment {\n getShared(): Record<string, unknown>\n callComposer(view: View): Promise<void>\n load(path: string, name: string): Promise<Component>\n}\n\n/**\n * One view: its name, file and data. render() runs the composers, imports the file and renders its default\n * export with { ...shared, ...data } as props. toHtml() returns the HTML of the last render().\n */\nexport class TsxView implements View {\n private data: Record<string, unknown>\n private html: string | undefined\n\n constructor(\n private readonly environment: ViewEnvironment,\n readonly name: string,\n readonly path: string,\n data: Record<string, unknown> = {},\n ) {\n this.data = { ...data }\n }\n\n with(key: string | Record<string, unknown>, value?: unknown): this {\n if (typeof key === 'string') this.data[key] = value\n else Object.assign(this.data, key)\n return this\n }\n\n /** The view's own data (Laravel's getData()). */\n getData(): Record<string, unknown> {\n return { ...this.data }\n }\n\n /** Shared data overlaid with the view's data: exactly the props the component receives. */\n gatherData(): Record<string, unknown> {\n return { ...this.environment.getShared(), ...this.data }\n }\n\n async render(): Promise<string> {\n await this.environment.callComposer(this)\n const component = await this.environment.load(this.path, this.name)\n this.html = await renderToString(createElement(component as Component<never>, this.gatherData()))\n return this.html\n }\n\n toHtml(): string {\n if (this.html === undefined) {\n throw new ViewRenderError(`View [${this.name}] has not been rendered: await view.render() before toHtml().`)\n }\n return this.html\n }\n}\n","import { pathToFileURL } from 'node:url'\nimport type { View, ViewFactory } from '@orieljs/contracts'\nimport { Str } from '@orieljs/support'\nimport type { Component } from './Element'\nimport { InvalidViewError, ViewNotFoundError } from './errors'\nimport type { FileViewFinder } from './FileViewFinder'\nimport { TsxView, type ViewEnvironment } from './TsxView'\n\ntype Composer = (view: View) => void | Promise<void>\n\n/** Laravel's view Factory: finds views by dotted name, shares data app-wide and runs view composers. */\nexport class Factory implements ViewFactory, ViewEnvironment {\n private readonly shared: Record<string, unknown> = {}\n private readonly composers: Array<{ patterns: string[]; composer: Composer }> = []\n\n constructor(private readonly finder: FileViewFinder) {}\n\n /** Throws ViewNotFoundError (\"View [x] not found.\") when no file matches. */\n make(name: string, data: Record<string, unknown> = {}): TsxView {\n return new TsxView(this, name, this.finder.find(name), data)\n }\n\n /** The first view that exists (Laravel's View::first()). */\n first(names: string[], data: Record<string, unknown> = {}): TsxView {\n const name = names.find((candidate) => this.exists(candidate))\n if (name === undefined) throw new ViewNotFoundError(names.join(', '))\n return this.make(name, data)\n }\n\n exists(name: string): boolean {\n try {\n this.finder.find(name)\n return true\n } catch (error) {\n if (error instanceof ViewNotFoundError) return false\n throw error\n }\n }\n\n /** App-wide data every view receives as props (view data wins on conflicts). */\n share(key: string | Record<string, unknown>, value?: unknown): void {\n if (typeof key === 'string') this.shared[key] = value\n else Object.assign(this.shared, key)\n }\n\n getShared(): Record<string, unknown> {\n return { ...this.shared }\n }\n\n /** Runs before matching views render. Patterns use `*` wildcards: 'posts.*', '*'. */\n composer(views: string | string[], composer: Composer): void {\n this.composers.push({ patterns: [views].flat(), composer })\n }\n\n async callComposer(view: View): Promise<void> {\n for (const { patterns, composer } of this.composers) {\n if (patterns.some((pattern) => Str.is(pattern, view.name))) await composer(view)\n }\n }\n\n /** Imports the view file (Node's module cache keeps it) and returns its default-export component. */\n async load(path: string, name: string): Promise<Component> {\n const module = (await import(pathToFileURL(path).href)) as { default?: unknown }\n if (typeof module.default !== 'function') {\n throw new InvalidViewError(`View [${name}] (${path}) must default-export a component function.`)\n }\n return module.default as Component\n }\n\n addLocation(path: string): void {\n this.finder.addLocation(path)\n }\n\n addNamespace(namespace: string, hints: string | string[]): this {\n this.finder.addNamespace(namespace, hints)\n return this\n }\n\n getFinder(): FileViewFinder {\n return this.finder\n }\n}\n","import { Session, ViewFactory, type View } from '@orieljs/contracts'\nimport { inject } from '@orieljs/container'\nimport { e, HtmlString } from './Html'\n\n/** view() → the ViewFactory; view('posts.index', data) → a View to return from a route or render. */\nexport function view(): ViewFactory\nexport function view(name: string, data?: Record<string, unknown>): View\nexport function view(name?: string, data: Record<string, unknown> = {}): ViewFactory | View {\n const factory = inject(ViewFactory)\n return name === undefined ? factory : factory.make(name, data)\n}\n\n/** Blade's @csrf / csrf_field(): the hidden _token input for the current request's session. */\nexport function csrfField(): HtmlString {\n return new HtmlString(`<input type=\"hidden\" name=\"_token\" value=\"${e(inject(Session).token())}\" autocomplete=\"off\">`)\n}\n\n/** Blade's @method('PUT') / method_field(): spoofs PUT/PATCH/DELETE from an HTML form. */\nexport function methodField(method: string): HtmlString {\n return new HtmlString(`<input type=\"hidden\" name=\"_method\" value=\"${e(method.toUpperCase())}\">`)\n}\n","import { ViewFactory, type Token } from '@orieljs/contracts'\nimport { facade } from '@orieljs/support'\nimport type { Factory } from './Factory'\n\n/** The View facade: View.make(), View.exists(), View.share(), View.composer(), View.first(), View.addNamespace(). */\nexport const View = facade(ViewFactory as unknown as Token<Factory>)\n","import { ConfigRepository, ViewFactory } from '@orieljs/contracts'\nimport { ServiceProvider } from '@orieljs/support'\nimport { Factory } from './Factory'\nimport { FileViewFinder } from './FileViewFinder'\n\n/** Binds the ViewFactory (resources/views by default) and merges the `view` config, like Laravel's config/view.php. */\nexport class ViewServiceProvider extends ServiceProvider {\n override register(): void {\n this.mergeConfigFrom({ paths: [this.app.resourcePath('views')] }, 'view')\n this.app.singleton(ViewFactory, () => {\n const paths = this.app.make(ConfigRepository).get<string[]>('view.paths', [this.app.resourcePath('views')])\n return new Factory(new FileViewFinder(paths))\n })\n }\n}\n"],"mappings":"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","names":["view","view","view","ViewFactory","ViewFactory","ViewFactory"]}
1
+ {"version":3,"sources":["../Html.ts","../errors.ts","../attributes.ts","../render.ts","../FileViewFinder.ts","../TsxView.ts","../Factory.ts","../helpers.ts","../facade.ts","../ViewServiceProvider.ts"],"sourcesContent":["import type { Htmlable } from '@orieljs/contracts'\n\nconst ESCAPES: Record<string, string> = { '&': '&amp;', '<': '&lt;', '>': '&gt;', '\"': '&quot;', \"'\": '&#039;' }\nconst UNSAFE = /[&<>\"']/g\n\n/** Markup that must not be escaped again (Laravel's Illuminate\\Support\\HtmlString). */\nexport class HtmlString implements Htmlable {\n constructor(private readonly html: string = '') {}\n\n toHtml(): string {\n return this.html\n }\n\n toString(): string {\n return this.html\n }\n\n isEmpty(): boolean {\n return this.html === ''\n }\n}\n\n/** Marks trusted markup so the renderer emits it unescaped: {raw(markdownHtml)}. Never pass user input. */\nexport function raw(html: string): HtmlString {\n return new HtmlString(html)\n}\n\nexport function isHtmlable(value: unknown): value is Htmlable {\n return typeof value === 'object' && value !== null && typeof (value as Htmlable).toHtml === 'function'\n}\n\n/** Laravel's e(): htmlspecialchars(ENT_QUOTES, double-encode). Htmlable values pass through; null is ''. */\nexport function e(value: unknown): string {\n if (value === null || value === undefined) return ''\n if (isHtmlable(value)) return value.toHtml()\n return String(value).replace(UNSAFE, (char) => ESCAPES[char]!)\n}\n","import type { ErrorKind, OrielError } from '@orieljs/contracts'\n\n/**\n * Programmer errors (Laravel throws InvalidArgumentException for these). Not an HTTP condition, so kind 'Server':\n * the exception handler reports them and renders a 500 whose message is hidden unless app.debug is on.\n */\nexport class ViewRenderError extends Error implements OrielError {\n override readonly name: string = 'ViewRenderError'\n readonly kind: ErrorKind = 'Server'\n readonly status = 500\n}\n\n/** Laravel's \"View [x] not found.\" (InvalidArgumentException). */\nexport class ViewNotFoundError extends Error implements OrielError {\n override readonly name: string = 'ViewNotFoundError'\n readonly kind: ErrorKind = 'Server'\n readonly status = 500\n constructor(readonly view: string, readonly searched: string[] = []) {\n super(`View [${view}] not found.`)\n }\n}\n\n/** A view file that doesn't default-export a component. */\nexport class InvalidViewError extends Error implements OrielError {\n override readonly name: string = 'InvalidViewError'\n readonly kind: ErrorKind = 'Server'\n readonly status = 500\n}\n","import { e, isHtmlable } from './Html'\nimport { ViewRenderError } from './errors'\n\n/** Props that are never attributes. */\nconst SKIPPED = new Set(['children', 'dangerouslySetInnerHTML', 'key', 'ref'])\n/** React-style prop names that map to a different HTML attribute. */\nconst RENAMED: Record<string, string> = { className: 'class', htmlFor: 'for' }\n/** HTML attribute names: no whitespace, quotes, `<`, `>`, `/`, `=` or control characters (WHATWG). */\nconst VALID_NAME = /^[^\\s\"'<>/=\\u0000-\\u001f\\u007f]+$/\n/** CSS properties whose numbers get no `px` (React's list, trimmed to what HTML pages use). */\nconst UNITLESS = new Set([\n 'animation-iteration-count', 'aspect-ratio', 'border-image-outset', 'border-image-slice', 'border-image-width',\n 'column-count', 'columns', 'fill-opacity', 'flex', 'flex-grow', 'flex-shrink', 'flex-order', 'font-weight',\n 'grid-area', 'grid-column', 'grid-column-end', 'grid-column-start', 'grid-row', 'grid-row-end', 'grid-row-start',\n 'line-clamp', 'line-height', 'opacity', 'order', 'orphans', 'scale', 'stop-opacity', 'stroke-dashoffset',\n 'stroke-opacity', 'stroke-width', 'tab-size', 'widows', 'z-index', 'zoom',\n])\n\nexport type ClassValue = string | number | null | undefined | false | ClassValue[] | Record<string, unknown>\nexport type StyleObject = Record<string, string | number | null | undefined | false>\n\n/** `class` accepts strings, arrays and `{ name: condition }` objects, like Blade's @class. */\nexport function classNames(value: ClassValue): string {\n if (value === null || value === undefined || value === false || value === '') return ''\n if (typeof value === 'string' || typeof value === 'number') return String(value).trim()\n if (Array.isArray(value)) return value.map(classNames).filter((name) => name !== '').join(' ')\n return Object.entries(value).filter(([, on]) => Boolean(on)).map(([name]) => name).join(' ')\n}\n\nconst kebab = (property: string) =>\n property.startsWith('--') ? property : property.replace(/^ms([A-Z])/, '-ms-$1').replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`)\n\n/** `{ marginTop: 4, '--gap': '1rem' }` → `margin-top:4px;--gap:1rem`. */\nexport function styleString(style: StyleObject): string {\n const parts: string[] = []\n for (const [property, value] of Object.entries(style)) {\n if (value === null || value === undefined || value === false || value === '') continue\n const name = kebab(property)\n const text = typeof value === 'number' && value !== 0 && !UNITLESS.has(name) && !name.startsWith('--') ? `${value}px` : String(value)\n parts.push(`${name}:${text}`)\n }\n return parts.join(';')\n}\n\nexport function assertValidName(name: string, what: 'attribute' | 'tag'): void {\n if (!VALID_NAME.test(name)) throw new ViewRenderError(`Invalid ${what} name [${name}].`)\n}\n\n/** Serializes props to ` name=\"value\"` pairs. Every value is escaped (HtmlString too); names are validated, never escaped. */\nexport function renderAttributes(props: Record<string, unknown>): string {\n let out = ''\n let classes = ''\n for (const [prop, value] of Object.entries(props)) {\n if (SKIPPED.has(prop)) continue\n if (value === undefined || value === null) continue\n if (typeof value === 'function' || typeof value === 'symbol') continue // event handlers do nothing on the server\n const name = RENAMED[prop] ?? prop\n assertValidName(name, 'attribute')\n // aria-*/data-* are string attributes: booleans are written out, like React.\n if (typeof value === 'boolean' && (name.startsWith('aria-') || name.startsWith('data-'))) {\n out += ` ${name}=\"${value}\"`\n continue\n }\n if (value === false) continue\n if (name === 'class') {\n const joined = classNames(value as ClassValue)\n classes = classes === '' ? joined : joined === '' ? classes : `${classes} ${joined}`\n continue\n }\n // Boolean attributes (disabled, checked, …) are present or absent.\n if (value === true) {\n out += ` ${name}`\n continue\n }\n const text = name === 'style' && typeof value === 'object' ? styleString(value as StyleObject) : attributeText(value)\n out += ` ${name}=\"${e(text)}\"`\n }\n return classes === '' ? out : ` class=\"${e(classes)}\"${out}`\n}\n\n/** Attribute values are text: objects become JSON (x-data, data-*), Htmlable its markup; the caller escapes all of it. */\nfunction attributeText(value: unknown): string {\n if (typeof value !== 'object' || value === null) return String(value)\n if (isHtmlable(value)) return value.toHtml()\n if (value instanceof Date) return value.toISOString()\n return JSON.stringify(value)\n}\n","import { Fragment, isElement, type OrielElement, type Renderable } from './Element'\nimport { e, isHtmlable } from './Html'\nimport { assertValidName, renderAttributes } from './attributes'\nimport { ViewRenderError } from './errors'\n\n/** Elements that never have children or a closing tag. */\nconst VOID = new Set(['area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input', 'link', 'meta', 'source', 'track', 'wbr'])\n\n/** Where rendered HTML goes. flush() is called before every await, so a stream sends what is ready. */\ninterface Sink {\n write(html: string): void\n flush(): void\n}\n\ninterface Renderer {\n render(): Promise<string>\n}\n\nconst isThenable = (value: unknown): value is PromiseLike<unknown> =>\n typeof value === 'object' && value !== null && typeof (value as PromiseLike<unknown>).then === 'function'\n\n/** A View (or anything with an async render() and toHtml()) used as a child, like Blade's @include. */\nconst isRenderer = (value: object): value is Renderer =>\n typeof (value as Partial<Renderer>).render === 'function' && isHtmlable(value)\n\nasync function write(node: Renderable, sink: Sink): Promise<void> {\n if (node === null || node === undefined || typeof node === 'boolean') return\n if (typeof node === 'string') return sink.write(e(node))\n if (typeof node === 'number' || typeof node === 'bigint') return sink.write(String(node))\n if (isElement(node)) return writeElement(node, sink)\n if (isThenable(node)) {\n sink.flush()\n const resolved: unknown = await (node as PromiseLike<unknown>)\n return write(resolved as Renderable, sink)\n }\n if (isRenderer(node)) {\n sink.flush()\n return sink.write(await node.render())\n }\n if (isHtmlable(node)) return sink.write(node.toHtml())\n if (typeof (node as Iterable<Renderable>)[Symbol.iterator] === 'function') {\n for (const child of node as Iterable<Renderable>) await write(child, sink)\n return\n }\n throw new ViewRenderError(`Objects are not valid as a child (found: object with keys {${Object.keys(node).join(', ')}}).`)\n}\n\nasync function writeElement(element: OrielElement, sink: Sink): Promise<void> {\n const { type, props } = element\n if (type === Fragment) return write(props.children as Renderable, sink)\n if (typeof type === 'function') {\n const result = (type as (props: unknown) => unknown)(props)\n if (isThenable(result)) sink.flush()\n const resolved: unknown = await result\n return write(resolved as Renderable, sink)\n }\n if (typeof type !== 'string') throw new ViewRenderError(`Invalid element type [${String(type)}].`)\n assertValidName(type, 'tag')\n\n const inner = props.dangerouslySetInnerHTML as { __html?: unknown } | undefined\n const hasChildren = props.children !== undefined && props.children !== null\n if (inner !== undefined && hasChildren) {\n throw new ViewRenderError(`<${type}> can't have both children and dangerouslySetInnerHTML.`)\n }\n // A document root gets its doctype: TSX has no syntax for <!DOCTYPE html>.\n if (type === 'html') sink.write('<!DOCTYPE html>')\n sink.write(`<${type}${renderAttributes(props)}>`)\n if (VOID.has(type.toLowerCase())) {\n if (hasChildren || inner !== undefined) throw new ViewRenderError(`<${type}> is a void element and can't have children.`)\n return\n }\n if (inner !== undefined) sink.write(String(inner.__html ?? ''))\n else await write(props.children as Renderable, sink)\n sink.write(`</${type}>`)\n}\n\n/** Renders JSX (or any Renderable) to an HTML string. Async components and promises are awaited in order. */\nexport async function renderToString(node: Renderable): Promise<string> {\n const parts: string[] = []\n await write(node, { write: (html) => void parts.push(html), flush: () => {} })\n return parts.join('')\n}\n\n/** Renders to a UTF-8 byte stream, sending everything rendered so far each time rendering waits on a promise. */\nexport function renderToStream(node: Renderable): ReadableStream<Uint8Array> {\n const encoder = new TextEncoder()\n return new ReadableStream<Uint8Array>({\n async start(controller) {\n let buffer = ''\n const sink: Sink = {\n write: (html) => void (buffer += html),\n flush: () => {\n if (buffer === '') return\n controller.enqueue(encoder.encode(buffer))\n buffer = ''\n },\n }\n try {\n await write(node, sink)\n sink.flush()\n controller.close()\n } catch (error) {\n controller.error(error)\n }\n },\n })\n}\n","import { existsSync } from 'node:fs'\nimport { isAbsolute, join, resolve } from 'node:path'\nimport { ViewNotFoundError } from './errors'\n\n/** `mail::message` → namespace `mail`, view `message` (Laravel's hint path delimiter). */\nconst HINT = '::'\n\n/**\n * Laravel's FileViewFinder: 'posts.index' → <location>/posts/index.<ext> for the first location and extension\n * that exist. Found paths are cached; misses are not, so a view created later is found.\n */\nexport class FileViewFinder {\n static readonly defaultExtensions = ['tsx', 'ts', 'jsx', 'js', 'mjs']\n\n private readonly locations: string[]\n private readonly hints = new Map<string, string[]>()\n private readonly views = new Map<string, string>()\n\n constructor(paths: string[], private readonly extensions: string[] = FileViewFinder.defaultExtensions) {\n this.locations = paths.map((path) => resolve(path))\n }\n\n /** The absolute path of the view file. Throws ViewNotFoundError. */\n find(name: string): string {\n const cached = this.views.get(name)\n if (cached !== undefined) return cached\n const [locations, view] = this.parse(name)\n const searched: string[] = []\n for (const location of locations) {\n for (const extension of this.extensions) {\n const file = join(location, `${view}.${extension}`)\n searched.push(file)\n if (existsSync(file)) {\n this.views.set(name, file)\n return file\n }\n }\n }\n throw new ViewNotFoundError(name, searched)\n }\n\n addLocation(path: string): void {\n this.locations.push(resolve(path))\n }\n\n prependLocation(path: string): void {\n this.locations.unshift(resolve(path))\n }\n\n /** Views under a namespace: addNamespace('mail', dir) makes 'mail::message' resolve to <dir>/message.tsx. */\n addNamespace(namespace: string, hints: string | string[]): void {\n const existing = this.hints.get(namespace) ?? []\n this.hints.set(namespace, [...existing, ...[hints].flat().map((path) => resolve(path))])\n }\n\n replaceNamespace(namespace: string, hints: string | string[]): void {\n this.hints.set(namespace, [hints].flat().map((path) => resolve(path)))\n this.flush()\n }\n\n getPaths(): string[] {\n return [...this.locations]\n }\n\n getHints(): Record<string, string[]> {\n return Object.fromEntries(this.hints)\n }\n\n /** Forget cached lookups. */\n flush(): void {\n this.views.clear()\n }\n\n /** [locations to search, relative file stem]. Dots become directories, so '..' can't climb out of a location. */\n private parse(name: string): [string[], string] {\n let locations = this.locations\n let view = name\n const at = name.indexOf(HINT)\n if (at !== -1) {\n const namespace = name.slice(0, at)\n view = name.slice(at + HINT.length)\n const hints = this.hints.get(namespace)\n if (hints === undefined) throw new ViewNotFoundError(name)\n locations = hints\n }\n const stem = view.replaceAll('.', '/')\n if (view === '' || stem.includes('\\0') || isAbsolute(stem) || stem.split(/[\\\\/]/).some((segment) => segment === '')) {\n throw new ViewNotFoundError(name)\n }\n return [locations, stem]\n }\n}\n","import type { View } from '@orieljs/contracts'\nimport { createElement, type Component } from './Element'\nimport { ViewRenderError } from './errors'\nimport { renderToString } from './render'\n\n/** What TsxView needs from its factory. */\nexport interface ViewEnvironment {\n getShared(): Record<string, unknown>\n callComposer(view: View): Promise<void>\n load(path: string, name: string): Promise<Component>\n}\n\n/**\n * One view: its name, file and data. render() runs the composers, imports the file and renders its default\n * export with { ...shared, ...data } as props. toHtml() returns the HTML of the last render().\n */\nexport class TsxView implements View {\n private data: Record<string, unknown>\n private html: string | undefined\n\n constructor(\n private readonly environment: ViewEnvironment,\n readonly name: string,\n readonly path: string,\n data: Record<string, unknown> = {},\n ) {\n this.data = { ...data }\n }\n\n with(key: string | Record<string, unknown>, value?: unknown): this {\n if (typeof key === 'string') this.data[key] = value\n else Object.assign(this.data, key)\n return this\n }\n\n /** The view's own data (Laravel's getData()). */\n getData(): Record<string, unknown> {\n return { ...this.data }\n }\n\n /** Shared data overlaid with the view's data: exactly the props the component receives. */\n gatherData(): Record<string, unknown> {\n return { ...this.environment.getShared(), ...this.data }\n }\n\n async render(): Promise<string> {\n await this.environment.callComposer(this)\n const component = await this.environment.load(this.path, this.name)\n this.html = await renderToString(createElement(component as Component<never>, this.gatherData()))\n return this.html\n }\n\n toHtml(): string {\n if (this.html === undefined) {\n throw new ViewRenderError(`View [${this.name}] has not been rendered: await view.render() before toHtml().`)\n }\n return this.html\n }\n}\n","import { pathToFileURL } from 'node:url'\nimport type { View, ViewFactory } from '@orieljs/contracts'\nimport { Str } from '@orieljs/support'\nimport type { Component, Renderable } from './Element'\nimport { InvalidViewError, ViewNotFoundError } from './errors'\nimport type { FileViewFinder } from './FileViewFinder'\nimport { renderToString } from './render'\nimport { TsxView, type ViewEnvironment } from './TsxView'\n\ntype Composer = (view: View) => void | Promise<void>\n\n/** Laravel's view Factory: finds views by dotted name, shares data app-wide and runs view composers. */\nexport class Factory implements ViewFactory, ViewEnvironment {\n private readonly shared: Record<string, unknown> = {}\n private readonly composers: Array<{ patterns: string[]; composer: Composer }> = []\n\n constructor(private readonly finder: FileViewFinder) {}\n\n /** Throws ViewNotFoundError (\"View [x] not found.\") when no file matches. */\n make(name: string, data: Record<string, unknown> = {}): TsxView {\n return new TsxView(this, name, this.finder.find(name), data)\n }\n\n /** The first view that exists (Laravel's View::first()). */\n first(names: string[], data: Record<string, unknown> = {}): TsxView {\n const name = names.find((candidate) => this.exists(candidate))\n if (name === undefined) throw new ViewNotFoundError(names.join(', '))\n return this.make(name, data)\n }\n\n exists(name: string): boolean {\n try {\n this.finder.find(name)\n return true\n } catch (error) {\n if (error instanceof ViewNotFoundError) return false\n throw error\n }\n }\n\n /** App-wide data every view receives as props (view data wins on conflicts). */\n share(key: string | Record<string, unknown>, value?: unknown): void {\n if (typeof key === 'string') this.shared[key] = value\n else Object.assign(this.shared, key)\n }\n\n getShared(): Record<string, unknown> {\n return { ...this.shared }\n }\n\n /** Runs before matching views render. Patterns use `*` wildcards: 'posts.*', '*'. */\n composer(views: string | string[], composer: Composer): void {\n this.composers.push({ patterns: [views].flat(), composer })\n }\n\n async callComposer(view: View): Promise<void> {\n for (const { patterns, composer } of this.composers) {\n if (patterns.some((pattern) => Str.is(pattern, view.name))) await composer(view)\n }\n }\n\n /** Renders TSX, a string, an Htmlable or a View (or promises of them) to HTML, like Laravel's Blade::render(). */\n renderToString(node: unknown): Promise<string> {\n return renderToString(node as Renderable)\n }\n\n /** Imports the view file (Node's module cache keeps it) and returns its default-export component. */\n async load(path: string, name: string): Promise<Component> {\n const module = (await import(pathToFileURL(path).href)) as { default?: unknown }\n if (typeof module.default !== 'function') {\n throw new InvalidViewError(`View [${name}] (${path}) must default-export a component function.`)\n }\n return module.default as Component\n }\n\n addLocation(path: string): void {\n this.finder.addLocation(path)\n }\n\n addNamespace(namespace: string, hints: string | string[]): this {\n this.finder.addNamespace(namespace, hints)\n return this\n }\n\n getFinder(): FileViewFinder {\n return this.finder\n }\n}\n","import { Session, ViewFactory, type View } from '@orieljs/contracts'\nimport { inject } from '@orieljs/container'\nimport { e, HtmlString } from './Html'\n\n/** view() → the ViewFactory; view('posts.index', data) → a View to return from a route or render. */\nexport function view(): ViewFactory\nexport function view(name: string, data?: Record<string, unknown>): View\nexport function view(name?: string, data: Record<string, unknown> = {}): ViewFactory | View {\n const factory = inject(ViewFactory)\n return name === undefined ? factory : factory.make(name, data)\n}\n\n/** Blade's @csrf / csrf_field(): the hidden _token input for the current request's session. */\nexport function csrfField(): HtmlString {\n return new HtmlString(`<input type=\"hidden\" name=\"_token\" value=\"${e(inject(Session).token())}\" autocomplete=\"off\">`)\n}\n\n/** Blade's @method('PUT') / method_field(): spoofs PUT/PATCH/DELETE from an HTML form. */\nexport function methodField(method: string): HtmlString {\n return new HtmlString(`<input type=\"hidden\" name=\"_method\" value=\"${e(method.toUpperCase())}\">`)\n}\n","import { ViewFactory, type Token } from '@orieljs/contracts'\nimport { facade } from '@orieljs/support'\nimport type { Factory } from './Factory'\n\n/** The View facade: View.make(), View.exists(), View.share(), View.composer(), View.first(), View.addNamespace(). */\nexport const View = facade(ViewFactory as unknown as Token<Factory>)\n","import { ConfigRepository, ViewFactory } from '@orieljs/contracts'\nimport { ServiceProvider } from '@orieljs/support'\nimport { Factory } from './Factory'\nimport { FileViewFinder } from './FileViewFinder'\n\n/** Binds the ViewFactory (resources/views by default) and merges the `view` config, like Laravel's config/view.php. */\nexport class ViewServiceProvider extends ServiceProvider {\n override register(): void {\n this.mergeConfigFrom({ paths: [this.app.resourcePath('views')] }, 'view')\n this.app.singleton(ViewFactory, () => {\n const paths = this.app.make(ConfigRepository).get<string[]>('view.paths', [this.app.resourcePath('views')])\n return new Factory(new FileViewFinder(paths))\n })\n }\n}\n"],"mappings":"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","names":["view","view","view","ViewFactory","ViewFactory","ViewFactory"]}
@@ -3,6 +3,93 @@ import { Htmlable } from '@orieljs/contracts';
3
3
  type ClassValue = string | number | null | undefined | false | ClassValue[] | Record<string, unknown>;
4
4
  type StyleObject = Record<string, string | number | null | undefined | false>;
5
5
 
6
+ /**
7
+ * The `o:` attributes of Live components, typed for TSX: a directive (`o:model`, `o:loading`, …) or an action on a DOM
8
+ * event (`o:click="save"`), with modifiers joined by `-` (`o:model-live`, `o:keydown-enter`). An `o:` name that is
9
+ * neither doesn't compile (`o:clik`, `o:modle`), and the forms listed here are completed by editors and have their
10
+ * values checked. TypeScript doesn't check JSX attribute names that contain a `-` unless the type lists them, so a
11
+ * form that isn't listed (a duration such as `o:model-live-debounce-500ms`, an event's modifiers) is accepted as
12
+ * written, and so is a misspelt one (`o:model-lvie`).
13
+ */
14
+ type ModelTrigger = 'live' | 'blur' | 'change' | 'lazy';
15
+ type ElementChange = 'remove' | 'class' | 'class-remove' | 'attr';
16
+ /**
17
+ * The directives that aren't DOM events, by name: the value each takes (`boolean` for one that can be written bare,
18
+ * `<a o:navigate>`, or from an expression, `o:navigate={external}`: `false` leaves it out) and its modifier forms, the
19
+ * `-`-joined text after the name (`never` for none). A new directive adds a member here, and its name to the Live
20
+ * client's reserved directives.
21
+ */
22
+ interface LiveDirectives {
23
+ /** o:model="title": binds an input to a public property, sent with the next request unless live, blur, change or lazy. */
24
+ model: {
25
+ value: string;
26
+ modifiers: ModelTrigger | 'number' | 'debounce' | 'live-debounce' | `${ModelTrigger}-number`;
27
+ };
28
+ /** o:loading: shown (or changed) while the component's request runs. */
29
+ loading: {
30
+ value: boolean | string;
31
+ modifiers: ElementChange | 'delay' | `delay-${ElementChange}`;
32
+ };
33
+ /** o:target="save,title": the actions or properties o:loading waits for. */
34
+ target: {
35
+ value: string;
36
+ modifiers: never;
37
+ };
38
+ /** o:poll="refresh": calls the method ($refresh without one) every 2.5 s, or every `o:poll-<n>s`. */
39
+ poll: {
40
+ value: boolean | string;
41
+ modifiers: 'keep-alive' | 'visible';
42
+ };
43
+ /** o:navigate on a link: fetches the page and swaps it in; `-hover` prefetches on hover. */
44
+ navigate: {
45
+ value: boolean;
46
+ modifiers: 'hover';
47
+ };
48
+ /** o:offline: shown (or changed) while the browser is offline. */
49
+ offline: {
50
+ value: boolean | string;
51
+ modifiers: ElementChange;
52
+ };
53
+ /** o:key: keeps an element's identity across re-renders. */
54
+ key: {
55
+ value: string | number;
56
+ modifiers: never;
57
+ };
58
+ /** o:confirm="Delete this tag?": asks before the element's action runs; `-prompt` asks for a typed answer. */
59
+ confirm: {
60
+ value: boolean | string;
61
+ modifiers: 'prompt';
62
+ };
63
+ /** o:announce on a status region: an action that leaves the same message announces it again. */
64
+ announce: {
65
+ value: boolean;
66
+ modifiers: never;
67
+ };
68
+ }
69
+ /**
70
+ * The DOM events `o:<event>` runs an action on. A name with a `-` can't be written in TSX (modifiers are `-`
71
+ * segments), and `offline` is the o:offline directive, not the event. An event this list doesn't have (a custom
72
+ * event a component dispatches) is spread: `<div {...{ 'o:saved': 'refresh' }} />`.
73
+ */
74
+ 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';
75
+ /** `o:model`, `o:model-live`, …: each directive and each of its modifier forms, with the directive's value. */
76
+ type LiveDirectiveAttributes = {
77
+ [N in keyof LiveDirectives as `o:${N}` | `o:${N}-${LiveDirectives[N]['modifiers']}`]?: LiveDirectives[N]['value'];
78
+ };
79
+ /** `o:click="save"`: an action (a method, `method(args)`, `$refresh`, `$set(…)`, `$dispatch(…)`) on a DOM event. */
80
+ type LiveEventAttributes = {
81
+ [E in LiveEvent as `o:${E}`]?: string;
82
+ };
83
+ 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';
84
+ type Digit = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
85
+ /**
86
+ * Every other attribute, with any value: each name that doesn't start with `o:` (`o`, `href`, `onclick`, `open`,
87
+ * `xlink:href`, `viewBox`; names with a `-`, such as `data-*`, `aria-*` and `hx-post`, are never checked).
88
+ */
89
+ type OtherAttributes = {
90
+ [K in 'o' | `${Exclude<Letter, 'o'> | Uppercase<Letter> | '_' | '$'}${string}` | `o${Letter | Uppercase<Letter> | Digit | '_' | '.' | '$'}${string}`]?: unknown;
91
+ };
92
+
6
93
  /** Marks the objects jsx() returns (Symbol.for, so two copies of the package agree). */
7
94
  declare const ELEMENT: unique symbol;
8
95
  type Props = Record<string, unknown>;
@@ -34,8 +121,13 @@ interface OrielElement {
34
121
  declare function jsx(type: ElementType, props: Props | null, key?: string | number): OrielElement;
35
122
  /** Same as jsx(); the compiler uses it when there are several static children. */
36
123
  declare const jsxs: typeof jsx;
37
- /** Attributes every intrinsic element accepts. Unknown attributes (hx-*, x-*, o:click, …) are allowed. */
38
- interface HtmlAttributes {
124
+ /**
125
+ * Attributes every intrinsic element accepts. Any attribute is allowed (hx-*, x-*, data-*, …) except an `o:` name
126
+ * that isn't a Live directive or `o:<event>` (directives.ts), so a typo such as `o:clik` doesn't compile. An `o:` form
127
+ * with a `-` that the type doesn't list compiles unchecked (TypeScript doesn't check a hyphenated JSX name the type
128
+ * leaves out), and a custom event name is spread: `<div {...{ 'o:saved': 'refresh' }} />`.
129
+ */
130
+ interface HtmlAttributes extends OtherAttributes, LiveDirectiveAttributes, LiveEventAttributes {
39
131
  children?: Renderable;
40
132
  class?: ClassValue;
41
133
  className?: ClassValue;
@@ -43,7 +135,6 @@ interface HtmlAttributes {
43
135
  dangerouslySetInnerHTML?: {
44
136
  __html: string;
45
137
  };
46
- [attribute: string]: unknown;
47
138
  }
48
139
  declare namespace JSX {
49
140
  type Element = OrielElement;
@@ -2,7 +2,7 @@ import {
2
2
  Fragment,
3
3
  jsx,
4
4
  jsxs
5
- } from "./chunk-KIU7OKDI.js";
5
+ } from "./chunk-AXHMZAM6.js";
6
6
  export {
7
7
  Fragment,
8
8
  jsx,
package/package.json CHANGED
@@ -1,9 +1,10 @@
1
1
  {
2
2
  "name": "@orieljs/view",
3
- "version": "0.1.0-alpha.1",
3
+ "version": "0.1.0-alpha.10",
4
4
  "description": "The Oriel View component.",
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",
7
+ "homepage": "https://orieljs.vercel.app",
7
8
  "sideEffects": false,
8
9
  "repository": {
9
10
  "type": "git",
@@ -30,12 +31,13 @@
30
31
  "files": [
31
32
  "dist",
32
33
  "LICENSE",
33
- "NOTICE"
34
+ "NOTICE",
35
+ "TRADEMARKS.md"
34
36
  ],
35
37
  "dependencies": {
36
- "@orieljs/container": "0.1.0-alpha.1",
37
- "@orieljs/contracts": "0.1.0-alpha.1",
38
- "@orieljs/support": "0.1.0-alpha.1"
38
+ "@orieljs/contracts": "0.1.0-alpha.10",
39
+ "@orieljs/container": "0.1.0-alpha.10",
40
+ "@orieljs/support": "0.1.0-alpha.10"
39
41
  },
40
42
  "scripts": {
41
43
  "build": "tsup && node ../../../scripts/copy-license.mjs"