mono-jsx 0.1.3 → 0.3.0

package/types/index.d.ts

@@ -0,0 +1 @@
+export {};

package/types/jsx.d.ts

@@ -4,7 +4,6 @@ import type * as Mono from "./mono.d.ts";
 import type { HTML } from "./html.d.ts";
 
 export type ChildType = VNode | string | number | bigint | boolean | null;
-export type Children = ChildType | (ChildType | ChildType[])[];
 
 export type VNode = readonly [
   tag: string | symbol | FC<any>,

package/types/mono.d.ts

@@ -66,7 +66,10 @@ export interface CSSProperties extends BaseCSSProperties, AtRuleCSSProperties, P
   [key: `&${" " | "." | "["}${string}`]: CSSProperties;
 }
 
+export type ChildType = JSX.Element | string | number | bigint | boolean | null;
+
 export interface BaseAttributes {
+  children?: ChildType | (ChildType)[];
   key?: string | number;
   slot?: string;
 }
@@ -98,8 +101,10 @@ export interface Elements {
 }
 
 declare global {
-  type FC<T = Record<string, unknown>> = {
-    request: Request;
-    computed: <T = unknown>(fn: () => T) => T;
-  } & Omit<T, "request" | "computed">;
+  type FC<S = Record<string, unknown>, AppState = Record<string, unknown>, Context = Record<string, unknown>> = {
+    readonly app: AppState;
+    readonly context: Context;
+    readonly request: Request;
+    readonly computed: <V = unknown>(computeFn: () => V) => V;
+  } & Omit<S, "app" | "context" | "request" | "computed">;
 }

package/types/render.d.ts

@@ -1,6 +1,38 @@
-export interface RenderOptions {
+/**
+ * Htmx extensions.
+ * @see https://htmx.org/docs/#extensions
+ */
+type HtmxExts = {
+  [key in `html-ext-${JSX.HtmxExtensions[keyof JSX.HtmxExtensions]}`]:
+    | number
+    | string
+    | boolean;
+};
+
+/**
+ * Render options for the `render` function.
+ */
+export interface RenderOptions extends Partial<HtmxExts> {
+  /**
+   * Initial state of the application.
+   */
+  appState?: Record<string, unknown>;
+  /**
+   * The context object to be passed to components.
+   */
+  context?: Record<string, unknown>;
+  /**
+   * Current `Request` object to be passed to components.
+   */
   request?: Request;
+  /**
+   * The HTTP status code to be sent with the response.
+   * @defaultValue `200`
+   */
   status?: number;
+  /**
+   * The HTTP headers to be sent with the response.
+   */
   headers?: {
     [key: string]: string | undefined;
     contentSecurityPolicy?: string;
@@ -9,5 +41,15 @@ export interface RenderOptions {
     lastModified?: string;
     setCookie?: string;
   };
+  /**
+   * Rendering mode.
+   * - **eager**: Render the component immediately.
+   */
   rendering?: "eager";
+  /**
+   * Install htmx script with the given version.
+   * @see https://htmx.org/
+   * @defaultValue `false`
+   */
+  htmx?: number | string | boolean;
 }