@markless/core 0.3.3 → 0.4.0

package/dist/index.d.ts

@@ -4,8 +4,8 @@ import { ResumePayloadDocumentInput, ResumePayloadScriptsInput, ResumePayloadScr
 
 //#region src/framework-api.d.ts
 type AsyncComputedValue<T> = T extends Promise<infer Value> ? Awaited<Value> : T;
-type ElementHandle<T extends Element = Element> = T | undefined;
-type SharedScope = 'request' | 'container' | 'page';
+type ElementHandle<T extends Element | readonly Element[] = Element> = T extends readonly (infer E extends Element)[] ? E[] : T | undefined;
+type SharedScope = 'request' | 'container' | 'page' | 'widget';
 type SharedOptions = {
   readonly scope: SharedScope;
 };
@@ -38,10 +38,36 @@ declare class FrameworkApiRuntimeError extends Error implements FrameworkApiRunt
 }
 declare function state<T>(initial: T): T;
 declare function computed<T>(derive: () => T): AsyncComputedValue<T>;
-declare function element<T extends Element = Element>(): ElementHandle<T>;
+declare function element<T extends Element | Element[] = Element>(): ElementHandle<T>;
 type SharedDefinition<T> = () => T;
 declare function shared<T>(create: () => T, options?: SharedOptions): SharedDefinition<T>;
 declare function storage(fallback: string): string;
 declare function storage(key: string, fallback: string): string;
 //#endregion
-export { type AsyncComputedValue, type CsrRenderArtifact, type CsrRenderContainer, type CsrRenderOptions, type CsrRenderOutput, type CsrRenderable, type ElementHandle, type FrameworkApiName, type FrameworkApiRuntimeDiagnostic, FrameworkApiRuntimeError, type RenderTarget, type RenderToStringOptions, type ResumePayloadDocumentInput, type ResumePayloadScriptsInput, type ResumePayloadScriptsResult, type SharedDefinition, type SharedOptions, type SharedScope, type SsrRenderArtifact, type SsrRenderOutput, type SsrRenderable, computed, element, render, renderToString, resumeFromPayloadDocument, resumeFromPayloadScripts, shared, state, storage };
+//#region src/jsx-types.d.ts
+/** Anything that can sit in a component's `children` position. */
+type Children = __MarklessTypeService.Child;
+/** The HTML tags that cannot have children; every other tag's props include them. */
+type VoidTagName = 'area' | 'base' | 'br' | 'col' | 'embed' | 'hr' | 'img' | 'input' | 'link' | 'meta' | 'source' | 'track' | 'wbr';
+/**
+ * Every attribute, event handler, `attach`, and `el` the given intrinsic tag accepts.
+ * Tags that can hold content also accept `children`; void tags do not, so a part
+ * wrapping an `<input>` cannot be projected into by mistake.
+ */
+type PropsOf<Tag extends __MarklessTypeService.IntrinsicTagName> = __MarklessTypeService.IntrinsicElementFor<Tag> & (Tag extends VoidTagName ? unknown : {
+  readonly children?: Children;
+});
+/**
+ * The instance fields a widget root seeds from its props: the same fields the
+ * consumer knows, made required and mutable, because a prop is optional to the
+ * consumer while the root assigns every one of them on every render.
+ */
+type Seeded<Props, Keys extends keyof Props> = { -readonly [Field in Keys]-?: Props[Field] };
+/**
+ * A compiled TSRX component, as a value: what a `.tsrx` module's default export
+ * is, what test harnesses mount, and what composition renders. The runtime's
+ * internal contract stays internal; this is the name consumers see.
+ */
+type Component = CsrRenderable;
+//#endregion
+export { type AsyncComputedValue, type Children, type Component, type CsrRenderArtifact, type CsrRenderContainer, type CsrRenderOptions, type CsrRenderOutput, type CsrRenderable, type ElementHandle, type FrameworkApiName, type FrameworkApiRuntimeDiagnostic, FrameworkApiRuntimeError, type PropsOf, type RenderTarget, type RenderToStringOptions, type ResumePayloadDocumentInput, type ResumePayloadScriptsInput, type ResumePayloadScriptsResult, type Seeded, type SharedDefinition, type SharedOptions, type SharedScope, type SsrRenderArtifact, type SsrRenderOutput, type SsrRenderable, computed, element, render, renderToString, resumeFromPayloadDocument, resumeFromPayloadScripts, shared, state, storage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markless/core",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Markless core authoring APIs: resumable TSRX apps with no hydration and no VDOM.",
   "license": "MIT",
   "repository": {
@@ -113,9 +113,9 @@
     "provenance": true
   },
   "dependencies": {
-    "@markless/bundler": "0.3.3",
-    "@markless/router": "0.3.3",
-    "@markless/web": "0.3.3"
+    "@markless/router": "0.4.0",
+    "@markless/web": "0.4.0",
+    "@markless/bundler": "0.4.0"
   },
   "scripts": {}
 }