@torpor/view 0.3.0 → 0.3.2

package/dist/compile.d.cts

@@ -0,0 +1,216 @@
+import { Component } from "./Component-C6Y3UwGs.cjs";
+
+//#region src/types/BuildOptions.d.ts
+interface BuildOptions {
+  /**
+  * Whether to create the component for server side rendering
+  */
+  server?: boolean;
+  /**
+  * Whether to create source maps.
+  */
+  mapped?: boolean;
+  /**
+  * If true, fragments will be built with calls to createElement etc. If
+  * false, fragments will be built with innerHTML. Using createElement is a
+  * bit slower, but may be useful in the future for rendering to different
+  * targets
+  */
+  useCreateElement?: boolean;
+  /**
+  * For internal testing and benchmarking
+  */
+  renderFolder?: string;
+}
+//#endregion
+//#region src/compile/types/Import.d.ts
+interface Import {
+  name: string;
+  alias?: string;
+  path: string;
+  nonDefault: boolean;
+  component: boolean;
+}
+//#endregion
+//#region src/compile/types/SourceRange.d.ts
+interface SourceRange {
+  start: number;
+  end: number;
+}
+//#endregion
+//#region src/compile/types/ScriptChunk.d.ts
+interface ScriptChunk {
+  script: string;
+  range: SourceRange;
+}
+//#endregion
+//#region src/compile/types/nodes/Fragment.d.ts
+interface Fragment {
+  number: number;
+  text: string;
+  ns: boolean;
+  effects: {
+    functionBody: string;
+    ranges: SourceRange[];
+    offsets: number[];
+    lengths: number[];
+  }[];
+  events: {
+    varName: string;
+    eventName: string;
+    handler: string;
+  }[];
+  animations: string[];
+  endVarName?: string;
+}
+//#endregion
+//#region src/compile/types/nodes/NodeType.d.ts
+type NodeType = "root" | "control" | "component" | "element" | "text" | "special";
+//#endregion
+//#region src/compile/types/nodes/TemplateNode.d.ts
+interface TemplateNode {
+  type: NodeType;
+  scopeStyles?: boolean;
+  varName?: string;
+  handled?: boolean;
+}
+//#endregion
+//#region src/compile/types/nodes/ParentNode.d.ts
+interface ParentNode extends TemplateNode {
+  type: NodeType;
+  children: TemplateNode[];
+}
+//#endregion
+//#region src/compile/types/nodes/RootNode.d.ts
+interface RootNode extends ParentNode {
+  type: "root";
+  children: TemplateNode[];
+  fragment?: Fragment;
+}
+//#endregion
+//#region src/compile/types/styles/Attribute.d.ts
+interface Attribute {
+  name: string;
+  value: string;
+}
+//#endregion
+//#region src/compile/types/styles/StyleBlock.d.ts
+interface StyleBlock {
+  selector: string;
+  attributes: Attribute[];
+  children: StyleBlock[];
+}
+//#endregion
+//#region src/compile/types/styles/Style.d.ts
+interface Style {
+  global: boolean;
+  blocks: StyleBlock[];
+  hash: string;
+}
+//#endregion
+//#region src/types/TemplateComponent.d.ts
+interface TemplateComponent {
+  start?: number;
+  /** The component's name */
+  name?: string;
+  /** Whether the component is exported from the file */
+  exported?: boolean;
+  /** Whether the component is defined with a default function */
+  default?: boolean;
+  /** The component's documentation comments */
+  documentation?: string;
+  /** Params declared by the user in the component's function */
+  params?: string;
+  markup?: RootNode;
+  head?: RootNode;
+  style?: Style;
+  /** The type or interface that is used for the $props param */
+  propsType?: string;
+  /** $props that are used in the component's function */
+  props?: string[];
+  /** $context props that are used in the component's function */
+  contextProps?: string[];
+  needsContext?: boolean;
+  /** $slot props that are used in the component's function */
+  slotProps?: string[];
+}
+//#endregion
+//#region src/types/Template.d.ts
+/**
+* The template for a component file, consisting of parts like script, markup and styles
+*/
+interface Template {
+  imports: Import[];
+  script: ScriptChunk[];
+  components: TemplateComponent[];
+}
+//#endregion
+//#region src/compile/types/SourceMapping.d.ts
+interface SourceMapping {
+  script: string;
+  source: SourceRange;
+  compiled: SourceRange;
+}
+//#endregion
+//#region src/compile/types/BuildResult.d.ts
+interface BuildResult {
+  code: string;
+  styles: {
+    style: string;
+    hash: string;
+  }[];
+  map: SourceMapping[];
+}
+//#endregion
+//#region src/compile/build.d.ts
+/**
+* Builds a component template into code and styles for rendering
+*
+* @param template The component template, possibly including script, markup and styles
+*
+* @returns The component's code and styles
+*/
+declare function build(template: Template, options?: BuildOptions): BuildResult;
+//#endregion
+//#region src/compile/buildType.d.ts
+/**
+* Builds a component template into a d.ts file
+*
+* @param name The name of the component
+* @param template The component template, possibly including script, markup and styles
+*
+* @returns The d.ts file content
+*/
+declare function buildType(template: Template, options?: BuildOptions): string;
+//#endregion
+//#region src/compile/types/CompileError.d.ts
+interface CompileError {
+  message: string;
+  startIndex: number;
+  startLine: number;
+  startChar: number;
+  endIndex: number;
+  endLine: number;
+  endChar: number;
+}
+//#endregion
+//#region src/compile/types/ParseResult.d.ts
+interface ParseResult {
+  ok: boolean;
+  errors: CompileError[];
+  template?: Template;
+}
+//#endregion
+//#region src/compile/parse.d.ts
+/**
+* Parses source code into a component template
+*
+* @param source The source code
+*
+* @returns A result indicating whether parsing was ok, and if so, containing
+* the component template's parts such as script, markup and styles
+*/
+declare function parse(source: string): ParseResult;
+//#endregion
+export { type Component, type Template, build, buildType, parse };
+//# sourceMappingURL=compile.d.cts.map

package/dist/compile.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.cts","names":[],"sources":["../src/types/BuildOptions.ts","../src/compile/types/Import.ts","../src/compile/types/SourceRange.ts","../src/compile/types/ScriptChunk.ts","../src/compile/types/nodes/Fragment.ts","../src/compile/types/nodes/NodeType.ts","../src/compile/types/nodes/TemplateNode.ts","../src/compile/types/nodes/ParentNode.ts","../src/compile/types/nodes/RootNode.ts","../src/compile/types/styles/Attribute.ts","../src/compile/types/styles/StyleBlock.ts","../src/compile/types/styles/Style.ts","../src/types/TemplateComponent.ts","../src/types/Template.ts","../src/compile/types/SourceMapping.ts","../src/compile/types/BuildResult.ts","../src/compile/build.ts","../src/compile/buildType.ts","../src/compile/types/CompileError.ts","../src/compile/types/ParseResult.ts","../src/compile/parse.ts"],"sourcesContent":[],"mappings":";;;UAAyB,YAAA;;;;;;;;;;;;;;;EGAI,gBAEJ,CAAA,EAAA,OAAA;;;;ECFI,YAEJ,CAAA,EAAA,MAAA;;;;UHFA,MAAA;;;MDAA,EAAA,MAAA;;;;;;UEAA,WAAA;;;;;;UCEA,WAAA;;OHFA,EGIjB,WHJiB;;;;UIEA,QAAA;;MJFA,EAAA,MAAA;;;;UCAA,EGQf,WHRe,EAAA;;;;QCAA,EAAA;;;;ECAI,CAAA,EAEJ;;;;;;KEFpB,QAAA;;;UCEoB,YAAA;QAClB;aNHkB,CAAA,EAAA,OAAA;;;;;;UOGA,UAAA,SAAmB;MPHnB,EOIlB,QPJkB;YOKd;;;;APLc,UQIA,QAAA,SAAiB,URJjB,CAAA;;YQMd;aAGC;;;;UCTa,SAAA;;;;;;UCEA,UAAA;;YVFA,EUIZ,SVJY,EAAA;YUKd;;;;UCHc,KAAA;;QXFA,EWIhB,UXJgB,EAAA;;;;;UYGA,iBAAA;OZHA,CAAA,EAAA,MAAA;;;;UCAA,CAAA,EAAA,OAAA;;;;eCAA,CAAA,EAAA,MAAA;;;WUef;ETfmB,IAEJ,CAAA,EScjB,QTdiB;USehB;;;ERjBoB;;;;cCAxB,CAAA,EAAA,OAAA;;;;;;;;;UQOoB,QAAA;SZPA,EYQf,MZRe,EAAA;UYShB;cACI;;;;UCRY,aAAA;;QdFA,EcIhB,WdJgB;YcKd;;;;UCHc,WAAA;;QfFA,EAAA;;;;KCAA,EcQnB,adRmB,EAAA;;;;;;;;;;;iBeeD,KAAA,WAAgB,oBAAoB,eAAe;;;;;;;;;;;iBCHnD,SAAA,WAAoB,oBAAoB;;;UCZvC,YAAA;;;WlBAA,EAAA,MAAA;;;;SCAA,EAAA,MAAA;;;;UkBGA,WAAA;MnBHA,OAAA;UmBKhB;aACG;;;;;;;;;;;;iBCKY,KAAA,kBAAuB"}

package/dist/compile.d.ts

@@ -113,13 +113,19 @@ interface TemplateComponent {
   start?: number;
   /** The component's name */
   name?: string;
+  /** Whether the component is exported from the file */
+  exported?: boolean;
   /** Whether the component is defined with a default function */
   default?: boolean;
+  /** The component's documentation comments */
+  documentation?: string;
   /** Params declared by the user in the component's function */
   params?: string;
   markup?: RootNode;
   head?: RootNode;
   style?: Style;
+  /** The type or interface that is used for the $props param */
+  propsType?: string;
   /** $props that are used in the component's function */
   props?: string[];
   /** $context props that are used in the component's function */

package/dist/compile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compile.d.ts","names":[],"sources":["../src/types/BuildOptions.ts","../src/compile/types/Import.ts","../src/compile/types/SourceRange.ts","../src/compile/types/ScriptChunk.ts","../src/compile/types/nodes/Fragment.ts","../src/compile/types/nodes/NodeType.ts","../src/compile/types/nodes/TemplateNode.ts","../src/compile/types/nodes/ParentNode.ts","../src/compile/types/nodes/RootNode.ts","../src/compile/types/styles/Attribute.ts","../src/compile/types/styles/StyleBlock.ts","../src/compile/types/styles/Style.ts","../src/types/TemplateComponent.ts","../src/types/Template.ts","../src/compile/types/SourceMapping.ts","../src/compile/types/BuildResult.ts","../src/compile/build.ts","../src/compile/buildType.ts","../src/compile/types/CompileError.ts","../src/compile/types/ParseResult.ts","../src/compile/parse.ts"],"sourcesContent":[],"mappings":";;;UAAyB,YAAA;;;;;;;;;;;;;;;EGAI,gBAEJ,CAAA,EAAA,OAAA;;;;ECFI,YAEJ,CAAA,EAAA,MAAA;;;;UHFA,MAAA;;;MDAA,EAAA,MAAA;;;;;;UEAA,WAAA;;;;;;UCEA,WAAA;;OHFA,EGIjB,WHJiB;;;;UIEA,QAAA;;MJFA,EAAA,MAAA;;;;UCAA,EGQf,WHRe,EAAA;;;;QCAA,EAAA;;;;ECAI,CAAA,EAEJ;;;;;;KEFpB,QAAA;;;UCEoB,YAAA;QAClB;aNHkB,CAAA,EAAA,OAAA;;;;;;UOGA,UAAA,SAAmB;MPHnB,EOIlB,QPJkB;YOKd;;;;APLc,UQIA,QAAA,SAAiB,URJjB,CAAA;;YQMd;aAGC;;;;UCTa,SAAA;;;;;;UCEA,UAAA;;YVFA,EUIZ,SVJY,EAAA;YUKd;;;;UCHc,KAAA;;QXFA,EWIhB,UXJgB,EAAA;;;;;UYGA,iBAAA;OZHA,CAAA,EAAA,MAAA;;;;SCAA,CAAA,EAAA,OAAA;;;WWWf;MVXe,CAAA,EUYjB,QVZiB;UUahB;;;ETboB;;;;ECAA,SAEJ,CAAA,EAAA,MAAA,EAAA;;;;;;;USKA,QAAA;SZPA,EYQf,MZRe,EAAA;UYShB;cACI;;;;UCRY,aAAA;;QdFA,EcIhB,WdJgB;YcKd;;;;UCHc,WAAA;;QfFA,EAAA;;;;KCAA,EcQnB,adRmB,EAAA;;;;;;;;;;;iBeeD,KAAA,WAAgB,oBAAoB,eAAe;;;;;;;;;;;iBCHnD,SAAA,WAAoB,oBAAoB;;;UCZvC,YAAA;;;WlBAA,EAAA,MAAA;;;;SCAA,EAAA,MAAA;;;;UkBGA,WAAA;MnBHA,OAAA;UmBKhB;aACG;;;;;;;;;;;;iBCKY,KAAA,kBAAuB"}
+{"version":3,"file":"compile.d.ts","names":[],"sources":["../src/types/BuildOptions.ts","../src/compile/types/Import.ts","../src/compile/types/SourceRange.ts","../src/compile/types/ScriptChunk.ts","../src/compile/types/nodes/Fragment.ts","../src/compile/types/nodes/NodeType.ts","../src/compile/types/nodes/TemplateNode.ts","../src/compile/types/nodes/ParentNode.ts","../src/compile/types/nodes/RootNode.ts","../src/compile/types/styles/Attribute.ts","../src/compile/types/styles/StyleBlock.ts","../src/compile/types/styles/Style.ts","../src/types/TemplateComponent.ts","../src/types/Template.ts","../src/compile/types/SourceMapping.ts","../src/compile/types/BuildResult.ts","../src/compile/build.ts","../src/compile/buildType.ts","../src/compile/types/CompileError.ts","../src/compile/types/ParseResult.ts","../src/compile/parse.ts"],"sourcesContent":[],"mappings":";;;UAAyB,YAAA;;;;;;;;;;;;;;;EGAI,gBAEJ,CAAA,EAAA,OAAA;;;;ECFI,YAEJ,CAAA,EAAA,MAAA;;;;UHFA,MAAA;;;MDAA,EAAA,MAAA;;;;;;UEAA,WAAA;;;;;;UCEA,WAAA;;OHFA,EGIjB,WHJiB;;;;UIEA,QAAA;;MJFA,EAAA,MAAA;;;;UCAA,EGQf,WHRe,EAAA;;;;QCAA,EAAA;;;;ECAI,CAAA,EAEJ;;;;;;KEFpB,QAAA;;;UCEoB,YAAA;QAClB;aNHkB,CAAA,EAAA,OAAA;;;;;;UOGA,UAAA,SAAmB;MPHnB,EOIlB,QPJkB;YOKd;;;;APLc,UQIA,QAAA,SAAiB,URJjB,CAAA;;YQMd;aAGC;;;;UCTa,SAAA;;;;;;UCEA,UAAA;;YVFA,EUIZ,SVJY,EAAA;YUKd;;;;UCHc,KAAA;;QXFA,EWIhB,UXJgB,EAAA;;;;;UYGA,iBAAA;OZHA,CAAA,EAAA,MAAA;;;;UCAA,CAAA,EAAA,OAAA;;;;eCAA,CAAA,EAAA,MAAA;;;WUef;ETfmB,IAEJ,CAAA,EScjB,QTdiB;USehB;;;ERjBoB;;;;cCAxB,CAAA,EAAA,OAAA;;;;;;;;;UQOoB,QAAA;SZPA,EYQf,MZRe,EAAA;UYShB;cACI;;;;UCRY,aAAA;;QdFA,EcIhB,WdJgB;YcKd;;;;UCHc,WAAA;;QfFA,EAAA;;;;KCAA,EcQnB,adRmB,EAAA;;;;;;;;;;;iBeeD,KAAA,WAAgB,oBAAoB,eAAe;;;;;;;;;;;iBCHnD,SAAA,WAAoB,oBAAoB;;;UCZvC,YAAA;;;WlBAA,EAAA,MAAA;;;;SCAA,EAAA,MAAA;;;;UkBGA,WAAA;MnBHA,OAAA;UmBKhB;aACG;;;;;;;;;;;;iBCKY,KAAA,kBAAuB"}

package/dist/compile.js

@@ -778,6 +778,7 @@ function buildAwaitNode(node, status, b) {
 	const parentName = node.parentName;
 	const rangeName = nextVarName("await_range", status);
 	const stateName = "$" + nextVarName("await_state", status);
+	const creatorsName = nextVarName("await_creators", status);
 	const awaitVarsName = nextVarName("await_vars", status);
 	const branches = node.children.filter((n) => isControlNode(n));
 	let awaitBranch = branches.find((n) => n.operation === "@await");
@@ -816,11 +817,13 @@ function buildAwaitNode(node, status, b) {
 	b.append(`
 		/* @await */
 		const ${rangeName} = t_range();
-		let ${stateName} = $watch({ creator: (_: Node | null) => {} });`);
+		let ${stateName} = $watch({ index: -1 });
+		let ${creatorsName}: ((t_before: Node | null) => void)[] = [];`);
 	b.append(`
 		let ${awaitVarsName} = { t_token: 0 };
 		$run(function runAwait() {`);
-	buildAwaitBranch(awaitBranch, status, b, parentName, stateName);
+	let index = 0;
+	buildAwaitBranch(awaitBranch, status, b, parentName, stateName, creatorsName, index++);
 	b.append(`${awaitVarsName}.t_token++;
 			((t_token) => {`);
 	awaitBranch.range.start += 7;
@@ -828,27 +831,27 @@ function buildAwaitNode(node, status, b) {
 	thenBranch.range.start -= 1;
 	addMappedText(".then((", replaceForVarNames(thenVar, status), ") => {", thenBranch.range, status, b);
 	b.append(`if (t_token === ${awaitVarsName}.t_token) {`);
-	buildAwaitBranch(thenBranch, status, b, parentName, stateName);
+	buildAwaitBranch(thenBranch, status, b, parentName, stateName, creatorsName, index++);
 	b.append(`}
 		})`);
 	catchBranch.range.start -= 1;
 	addMappedText(".catch((", replaceForVarNames(catchVar, status), ") => {", catchBranch.range, status, b);
 	b.append(`
 		if (t_token === ${awaitVarsName}.t_token) {`);
-	buildAwaitBranch(catchBranch, status, b, parentName, stateName);
+	buildAwaitBranch(catchBranch, status, b, parentName, stateName, creatorsName, index++);
 	b.append(`}
 				});
 			})(${awaitVarsName}.t_token);
 		});`);
 	b.append(`
 		t_run_control(${rangeName}, ${anchorName}, (t_before) => {
-			t_run_branch(${rangeName}, () => ${stateName}.creator(t_before));
+			t_run_branch(${rangeName}, () => ${creatorsName}[${stateName}.index](t_before));
 		});`);
 	b.append("");
 }
-function buildAwaitBranch(node, status, b, parentName, stateName) {
+function buildAwaitBranch(node, status, b, parentName, stateName, creatorsName, index) {
 	if (node.children.length > 0) {
-		b.append(`${stateName}.creator = (t_before) => {`);
+		b.append(`${creatorsName}[${index}] = (t_before) => {`);
 		buildFragment(node, status, b, parentName, "t_before");
 		status.fragmentStack.push({
 			fragment: node.fragment,
@@ -858,7 +861,8 @@ function buildAwaitBranch(node, status, b, parentName, stateName) {
 		status.fragmentStack.pop();
 		buildAddFragment(node, status, b, parentName, "t_before");
 		b.append("};");
-	} else b.append(`${stateName}.creator = (_) => {};`);
+	} else b.append(`${creatorsName}[${index}] = (_) => {};`);
+	b.append(`${stateName}.index = ${index};`);
 }
 
 //#endregion
@@ -998,6 +1002,7 @@ function buildIfNode(node, status, b) {
 	const parentName = node.parentName || anchorName + ".parentNode";
 	const rangeName = nextVarName("if_range", status);
 	const stateName = "$" + nextVarName("if_state", status);
+	const creatorsName = nextVarName("if_creators", status);
 	const branches = node.children.filter((n) => isControlNode(n));
 	if (branches.findIndex((n) => n.operation === "@else") === -1) branches.push({
 		type: "control",
@@ -1018,20 +1023,22 @@ function buildIfNode(node, status, b) {
 	b.append(`
 		/* @if */
 		const ${rangeName} = t_range();
-		let ${stateName} = $watch({ creator: (_: Node | null) => {} });`);
+		let ${stateName} = $watch({ index: -1 });
+		let ${creatorsName}: ((t_before: Node | null) => void)[] = [];`);
 	b.append(`$run(function runIf() {`);
-	for (let branch of branches) buildIfBranch(branch, status, b, parentName, stateName);
+	let index = 0;
+	for (let branch of branches) buildIfBranch(branch, status, b, parentName, stateName, creatorsName, index++);
 	b.append(`});`);
 	b.append(`
 		t_run_control(${rangeName}, ${anchorName}, (t_before) => {
-			t_run_branch(${rangeName}, () => ${stateName}.creator(t_before));
+			t_run_branch(${rangeName}, () => ${creatorsName}[${stateName}.index](t_before));
 		});`);
 	b.append("");
 }
-function buildIfBranch(node, status, b, parentName, stateName) {
+function buildIfBranch(node, status, b, parentName, stateName, creatorsName, index) {
 	addMappedText("", `${replaceForVarNames(node.statement, status)}`, " {", node.range, status, b);
 	if (node.children.length > 0) {
-		b.append(`${stateName}.creator = (t_before) => {`);
+		b.append(`${creatorsName}[${index}] = (t_before) => {`);
 		buildFragment(node, status, b, parentName, "t_before");
 		status.fragmentStack.push({
 			fragment: node.fragment,
@@ -1041,7 +1048,8 @@ function buildIfBranch(node, status, b, parentName, stateName) {
 		status.fragmentStack.pop();
 		buildAddFragment(node, status, b, parentName, "t_before");
 		b.append("};");
-	} else b.append(`${stateName}.creator = (_) => {};`);
+	} else b.append(`${creatorsName}[${index}] = (_) => {};`);
+	b.append(`${stateName}.index = ${index};`);
 	b.append("}");
 }
 
@@ -1096,6 +1104,7 @@ function buildSwitchNode(node, status, b) {
 	const parentName = node.parentName;
 	const rangeName = nextVarName("switch_range", status);
 	const stateName = "$" + nextVarName("switch_state", status);
+	const creatorsName = nextVarName("switch_creators", status);
 	const branches = node.children.filter((n) => isControlNode(n));
 	if (branches.findIndex((n) => n.operation === "@default") === -1) branches.push({
 		type: "control",
@@ -1116,24 +1125,26 @@ function buildSwitchNode(node, status, b) {
 	b.append(`
 		/* @switch */
 		const ${rangeName} = t_range();
-		let ${stateName} = $watch({ creator: (_: Node | null) => {} });`);
+		let ${stateName} = $watch({ index: -1 });
+		let ${creatorsName}: ((t_before: Node | null) => void)[] = [];`);
 	b.append(`
 		$run(function runSwitch() {`);
+	let index = 0;
 	addMappedText("", `${replaceForVarNames(node.statement, status)}`, " {", node.range, status, b);
-	for (let branch of branches) buildSwitchBranch(branch, status, b, parentName, stateName);
+	for (let branch of branches) buildSwitchBranch(branch, status, b, parentName, stateName, creatorsName, index++);
 	b.append(`
 		}
 	});`);
 	b.append(`
 		t_run_control(${rangeName}, ${anchorName}, (t_before) => {
-			t_run_branch(${rangeName}, () => ${stateName}.creator(t_before));
+			t_run_branch(${rangeName}, () => ${creatorsName}[${stateName}.index](t_before));
 		});`);
 	b.append("");
 }
-function buildSwitchBranch(node, status, b, parentName, stateName) {
+function buildSwitchBranch(node, status, b, parentName, stateName, creatorsName, index) {
 	addMappedText("", `${replaceForVarNames(node.statement, status)}`, " {", node.range, status, b);
 	if (node.children.length > 0) {
-		b.append(`${stateName}.creator = (t_before) => {`);
+		b.append(`${creatorsName}[${index}] = (t_before) => {`);
 		buildFragment(node, status, b, parentName, "t_before");
 		status.fragmentStack.push({
 			fragment: node.fragment,
@@ -1143,7 +1154,8 @@ function buildSwitchBranch(node, status, b, parentName, stateName) {
 		status.fragmentStack.pop();
 		buildAddFragment(node, status, b, parentName, "t_before");
 		b.append("};");
-	} else b.append(`${stateName}.creator = (_) => {};`);
+	} else b.append(`${creatorsName}[${index}] = (_) => {};`);
+	b.append(`${stateName}.index = ${index};`);
 	b.append(`
 			break;
 		}`);
@@ -1712,7 +1724,7 @@ function buildTemplate(template, map, imports, b, options) {
 	if (/\$run\b/.test(script)) imports.add("$run");
 	if (/\$mount\b/.test(script)) imports.add("$mount");
 	if (/\$unwrap\b/.test(script)) imports.add("$unwrap");
-	if (/\$peek\b/.test(script)) imports.add("$peek");
+	imports.add("$peek");
 	if (/\$batch\b/.test(script)) imports.add("$batch");
 	let currentIndex = 0;
 	let current = template.components[0];
@@ -1728,6 +1740,7 @@ function buildTemplate(template, map, imports, b, options) {
 	} else if (chunk.script === ") /* @return_type */ {") b.append("): void {");
 	else if (chunk.script === "/* @start */") {
 		if (current.contextProps?.length) b.append(`$context = Object.assign({}, $context);`);
+		b.append("$peek(() => { /**/");
 		b.append("");
 	} else if (chunk.script === "/* @render */") {
 		if (current.markup) {
@@ -1748,6 +1761,7 @@ function buildTemplate(template, map, imports, b, options) {
 			status.inHead = false;
 		}
 	} else if (chunk.script === "/* @style */") {} else if (chunk.script === "/* @end */") {
+		b.append("/**/ });");
 		currentIndex += 1;
 		current = template.components[currentIndex];
 	} else {
@@ -2425,17 +2439,14 @@ function build(template, options) {
 function buildType(template, options) {
 	let b = new Builder();
 	b.append(`import { type SlotRender } from "${options?.renderFolder || "@torpor/view"}";`);
-	for (let component of template.components) {
+	for (let component of template.components) if (component.exported) {
 		b.append("");
+		if (component.propsType) {
+			b.append(component.propsType);
+			b.append("");
+		}
 		b.append(`
-			/**
-			 * Mounts or hydrates the component into the supplied parent node.
-			 * @param $parent -- The parent node.
-			 * @param $anchor -- The node to mount the component before.
-			 * @param $props -- The values that have been passed into the component as properties.
-			 * @param $context -- Values that have been passed into the component from its ancestors.
-			 * @param $slots -- Functions for rendering children into slot nodes within the component.
-			 */
+			${component.documentation ?? ""}
 			${component.default ? "declare" : "export declare"} function ${component.name}(
 				$parent: ParentNode,
 				$anchor: Node | null,
@@ -2455,6 +2466,45 @@ function isSpaceNode(node) {
 	return isTextNode(node) && isSpace(node.content);
 }
 
+//#endregion
+//#region src/compile/parse/utils/accept.ts
+/**
+* Checks whether the source at the current parse position matches the supplied
+* string
+*
+* @param value The string to check
+* @param status The parse status
+* @param advance (Optional) If true, advances the parse position past the
+* checked string (defaults to true)
+*
+* @returns True if the supplied string was found at the current parse position
+*/
+function accept(value, status, advance = true) {
+	if (status.source.substring(status.i, status.i + value.length) == value) {
+		status.i += advance ? value.length : 0;
+		return true;
+	}
+	return false;
+}
+
+//#endregion
+//#region src/compile/parse/parseInlineScript.ts
+function parseInlineScript(status) {
+	const start = status.i;
+	let braceCount = 0;
+	while (status.i < status.source.length) if (accept("{", status)) braceCount += 1;
+	else if (accept("}", status)) if (braceCount > 0) braceCount -= 1;
+	else return status.source.substring(start, status.i - 1);
+	else if (accept("//", status)) status.i = status.source.indexOf("\n", status.i) + 1;
+	else if (accept("/*", status)) status.i = status.source.indexOf("*/", status.i) + 2;
+	else if (accept("\"", status) || accept("'", status)) {
+		const char = status.source[status.i - 1];
+		status.i = endOfString(char, status.source, status.i - 1) + 1;
+	} else if (accept("`", status)) status.i = endOfTemplateString(status.source, status.i - 1) + 1;
+	else status.i += 1;
+	return "";
+}
+
 //#endregion
 //#region src/compile/utils/trimStart.ts
 /**
@@ -2519,45 +2569,6 @@ function isFullyReactive(text) {
 	return text.trim().startsWith("{") && text.trim().endsWith("}");
 }
 
-//#endregion
-//#region src/compile/parse/utils/accept.ts
-/**
-* Checks whether the source at the current parse position matches the supplied
-* string
-*
-* @param value The string to check
-* @param status The parse status
-* @param advance (Optional) If true, advances the parse position past the
-* checked string (defaults to true)
-*
-* @returns True if the supplied string was found at the current parse position
-*/
-function accept(value, status, advance = true) {
-	if (status.source.substring(status.i, status.i + value.length) == value) {
-		status.i += advance ? value.length : 0;
-		return true;
-	}
-	return false;
-}
-
-//#endregion
-//#region src/compile/parse/parseInlineScript.ts
-function parseInlineScript(status) {
-	const start = status.i;
-	let braceCount = 0;
-	while (status.i < status.source.length) if (accept("{", status)) braceCount += 1;
-	else if (accept("}", status)) if (braceCount > 0) braceCount -= 1;
-	else return status.source.substring(start, status.i - 1);
-	else if (accept("//", status)) status.i = status.source.indexOf("\n", status.i) + 1;
-	else if (accept("/*", status)) status.i = status.source.indexOf("*/", status.i) + 2;
-	else if (accept("\"", status) || accept("'", status)) {
-		const char = status.source[status.i - 1];
-		status.i = endOfString(char, status.source, status.i - 1) + 1;
-	} else if (accept("`", status)) status.i = endOfTemplateString(status.source, status.i - 1) + 1;
-	else status.i += 1;
-	return "";
-}
-
 //#endregion
 //#region src/compile/parse/utils/isAlphaNumericChar.ts
 /**
@@ -2651,6 +2662,7 @@ function parseTagAttributes(status) {
 		if (accept("@//", status)) status.i = status.source.indexOf("\n", status.i) + 1;
 		else if (accept("@/*", status)) status.i = status.source.indexOf("*/", status.i) + 2;
 		else if (accept("/>", status, false) || accept(">", status, false)) break;
+		else if (accept("<", status, false) || accept("@", status, false) || accept("}", status, false)) break;
 		else {
 			const attribute = parseAttribute(status);
 			attributes.push(attribute);
@@ -3400,11 +3412,14 @@ function parseCode(source) {
 				return {
 					start: c.start,
 					name: c.name,
+					exported: c.exported,
 					default: c.default,
+					documentation: c.documentation,
 					params: c.params,
 					markup: c.markup,
 					head: c.head,
 					style: c.style,
+					propsType: c.propsType,
 					props: c.props,
 					contextProps: c.contextProps,
 					slotProps: c.slotProps,
@@ -3415,17 +3430,31 @@ function parseCode(source) {
 	};
 }
 function parseComponentStart(status) {
-	let source = status.source.substring(0, status.i);
+	let source = status.source.substring(status.marker, status.i);
+	let exported = /export\s+(default\s+)*(function\s+|const\s+)*$/.test(source);
 	let def = /export\s+default\s+(function\s+|const\s+)*$/.test(source);
 	let isConst = /const\s+$/.test(source);
 	let isAnon = /export default\s+$/.test(source);
-	status.components.push({
-		start: status.i,
-		name: consumeAlphaNumeric(status),
+	let componentStart = status.i;
+	let name = consumeAlphaNumeric(status);
+	const current = {
+		start: componentStart,
+		name,
+		exported,
 		default: def
-	});
-	const current = status.components.at(-1);
-	if (!current) return;
+	};
+	status.components.push(current);
+	let presource = source.substring(0, status.i).trimEnd();
+	let lastNewline = presource.lastIndexOf("\n");
+	if (lastNewline !== -1) {
+		presource = presource.substring(0, lastNewline).trimEnd();
+		if (presource.endsWith("*/")) {
+			for (let i = presource.length; i >= 0; i--) if (presource.substring(i, i + 3) === "/**") {
+				current.documentation = presource.substring(i);
+				break;
+			}
+		}
+	}
 	let start = -1;
 	let end = -1;
 	let level = 0;
@@ -3457,6 +3486,29 @@ function parseComponentStart(status) {
 		}
 	});
 	current.params = status.source.substring(start, end).trim() || void 0;
+	const paramsMatch = current.params?.match(/\$props:\s*([$A-Za-z0-9]+)/);
+	if (paramsMatch) {
+		let propsTypeName = paramsMatch[1];
+		let propsTypeStart = status.source.search(/* @__PURE__ */ new RegExp(`interface\\s+${propsTypeName}`));
+		if (propsTypeStart === -1) propsTypeStart = status.source.search(/* @__PURE__ */ new RegExp(`type\\s+${propsTypeName}`));
+		if (propsTypeStart !== -1) {
+			let bracesStart = status.source.indexOf("{", propsTypeStart);
+			if (bracesStart !== -1) {
+				const status2 = {
+					source: status.source,
+					i: bracesStart + 1,
+					marker: 0,
+					level: 0,
+					imports: [],
+					script: [],
+					components: [],
+					errors: []
+				};
+				const propsType = parseInlineScript(status2);
+				if (propsType) current.propsType = `${status.source.substring(propsTypeStart, bracesStart)}{${propsType}}`;
+			}
+		}
+	}
 	status.marker = end;
 	status.i = status.marker;
 	accept(")", status);