olova 2.0.67 → 2.0.70

package/CHANGELOG.md

@@ -1,5 +1,5 @@
-# Changelog
-
-## 0.1.0
-
-- Initial standalone package setup for publishing the Olova plugin, compiler, runtime, and Vite integration.
+# Changelog
+
+## 0.1.0
+
+- Initial standalone package setup for publishing the Olova plugin, compiler, runtime, and Vite integration.

package/README.md

@@ -1,42 +1,42 @@
-# olova
-
-Standalone npm package for the Olova compiler, runtime, and Vite plugin.
-
-## Install
-
-```bash
-npm install olova
-```
-
-Install Vite separately if you plan to use `olova/vite`.
-
-```bash
-npm install -D vite
-```
-
-## Exports
-
-- `olova`
-- `olova/runtime`
-- `olova/core`
-- `olova/state`
-- `olova/global`
-- `olova/compiler`
-- `olova/vite`
-
-## Local package workflow
-
-```bash
-npm install
-npm run build
-npm run pack:check
-```
-
-## Publish later
-
-```bash
-npm login
-npm publish
-```
-
-If the `olova` package name is already taken on npm, change the `name` field in `package.json` before publishing.
+# olova
+
+Standalone npm package for the Olova compiler, runtime, and Vite plugin.
+
+## Install
+
+```bash
+npm install olova
+```
+
+Install Vite separately if you plan to use `olova/vite`.
+
+```bash
+npm install -D vite
+```
+
+## Exports
+
+- `olova`
+- `olova/core`
+- `olova/state`
+- `olova/vite`
+
+For app code, prefer importing from `olova/core`.
+Use `olova/vite` only for the Vite plugin.
+
+## Local package workflow
+
+```bash
+npm install
+npm run build
+npm run pack:check
+```
+
+## Publish later
+
+```bash
+npm login
+npm publish
+```
+
+If the `olova` package name is already taken on npm, change the `name` field in `package.json` before publishing.

package/dist/compiler.d.ts

@@ -1,13 +1,88 @@
+type StyleBlock = {
+    content: string;
+    attrs: Record<string, string | true>;
+};
+type ParsedOlovaFile = {
+    script: string;
+    template: string;
+    styles: StyleBlock[];
+};
+
 type CompileResult = {
     code: string;
     css?: string;
     map?: unknown;
 };
+type TextBinding = {
+    id: string;
+    expr: string;
+};
+type HtmlBinding = {
+    id: string;
+    expr: string;
+};
+type AttrBinding = {
+    id: string;
+    attr: string;
+    expr: string;
+};
+type EventBinding = {
+    id: string;
+    event: string;
+    expr: string;
+};
+type SlotBinding = {
+    id: string;
+    name: string;
+};
+type SlotFactoryDef = {
+    varName: string;
+    name: string;
+    descriptor: TemplateTransformResult;
+};
+type ComponentBinding = {
+    id: string;
+    component: string;
+    propsExpr: string;
+    slotFactories: SlotFactoryDef[];
+};
+type IfBinding = {
+    id: string;
+    expr: string;
+    trueBranch: TemplateTransformResult;
+    falseBranch?: TemplateTransformResult;
+};
+type TemplateTransformResult = {
+    html: string;
+    textBindings: TextBinding[];
+    htmlBindings: HtmlBinding[];
+    attrBindings: AttrBinding[];
+    eventBindings: EventBinding[];
+    slotBindings: SlotBinding[];
+    componentBindings: ComponentBinding[];
+    ifBindings: IfBinding[];
+    buildFnStr?: string;
+};
+declare function collectScriptInfo(script: string): {
+    importsCode: string;
+    scriptBodyCode: string;
+    stateNames: Set<string>;
+    allSignalNames: Set<string>;
+    componentNames: Set<string>;
+    jsxFunctionNames: Set<string>;
+};
 interface CompileOptions {
     filename?: string;
     dev?: boolean;
     exportName?: string;
 }
+type CompilePhasesResult = {
+    parsed: ParsedOlovaFile;
+    script: ReturnType<typeof collectScriptInfo>;
+    template: TemplateTransformResult;
+    scopeId?: string;
+};
+declare function analyzeOlovaPhases(source: string, options?: CompileOptions): CompilePhasesResult;
 declare function compileOlovaScriptModule(source: string, options?: CompileOptions): CompileResult;
 declare function compileOlova(source: string, options?: CompileOptions): CompileResult;
 
@@ -41,4 +116,4 @@ declare function generateBuildFunction(html: string, stateNames: Set<string>, tr
     containsJsx: boolean;
 }, counters: TransformContext, componentNames: Set<string>): string;
 
-export { compileOlova, compileOlovaScriptModule, generateBuildFunction, parseHTML };
+export { analyzeOlovaPhases, compileOlova, compileOlovaScriptModule, generateBuildFunction, parseHTML };