@kubuild/renderer 0.0.1 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kustora
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/animation.d.ts

@@ -0,0 +1,26 @@
+import { PageDocument, AnimationConfig } from '@kubuild/schema';
+/**
+ * Standard Keyframes for Entrance, Scroll, and Continuous Loop Animations (STORA-263, STORA-264)
+ */
+export declare const ANIMATION_KEYFRAMES_CSS: string;
+/**
+ * Generate CSS rules for Hover Micro-Interactions (STORA-264)
+ */
+export declare function getHoverEffectCss(nodeId: string, hoverEffect: string): string[];
+/**
+ * Generate CSS rules for Continuous Loop Effects (STORA-264)
+ */
+export declare function getLoopEffectCss(nodeId: string, loopEffect: string): string[];
+/**
+ * Generate CSS rules for Entrance / Scroll Animations (STORA-263)
+ */
+export declare function getEntranceAnimationCss(nodeId: string, anim: AnimationConfig): string[];
+/**
+ * Walk the document and collect all compiled CSS rules for animations, hover micro-interactions, and loop effects.
+ */
+export declare function collectAnimationStylesCss(document: PageDocument | undefined | null): string;
+/**
+ * Replay CSS animation on a specific DOM element by node ID (STORA-262)
+ */
+export declare function replayNodeAnimation(nodeId: string, rootElement?: HTMLElement | Document | null): boolean;
+//# sourceMappingURL=animation.d.ts.map

package/dist/animation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../src/animation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAQ,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,uBAAuB,QA4E5B,CAAC;AAST;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAkC/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAmC7E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE,CAUvF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CA6B3F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAgBxG"}

package/dist/code-generator.d.ts

@@ -0,0 +1,47 @@
+import { PageDocument, Node } from '@kubuild/schema';
+export interface GenerateHtmlOptions {
+    /**
+     * Whether to include internal node ID classes (`kb-node-{id}`).
+     * Defaults to true so generated CSS matches HTML elements.
+     */
+    includeNodeClasses?: boolean;
+    /**
+     * Indentation width in spaces. Defaults to 2.
+     */
+    indentSize?: number;
+    /**
+     * Root tag for the page container ('main' | 'div'). Defaults to 'main'.
+     */
+    rootTag?: 'main' | 'div';
+}
+export interface GenerateCssOptions {
+    /**
+     * Whether to include the baseline CSS reset. Defaults to true.
+     */
+    includeReset?: boolean;
+    /**
+     * Custom CSS class prefix for node selectors. Defaults to 'kb-node-'.
+     */
+    classPrefix?: string;
+}
+export interface StandaloneHtmlOptions {
+    htmlOptions?: GenerateHtmlOptions;
+    cssOptions?: GenerateCssOptions;
+    /** Custom language attribute for <html>. Defaults to 'en'. */
+    lang?: string;
+}
+/**
+ * Generates a clean, formatted semantic HTML string for a PageDocument or Node.
+ */
+export declare function generateSemanticHtml(docOrNode: PageDocument | Node, options?: GenerateHtmlOptions): string;
+/**
+ * Generates structured, readable CSS for the given document, compiling
+ * base styles, responsive breakpoints (tablet/mobile), and pseudo-classes.
+ */
+export declare function generateDocumentCss(docOrNode: PageDocument | Node, options?: GenerateCssOptions): string;
+/**
+ * Generates a complete, standalone, production-ready HTML document string
+ * with metadata, responsive viewport tags, embedded stylesheet, and semantic body markup.
+ */
+export declare function generateStandaloneHtml(doc: PageDocument, options?: StandaloneHtmlOptions): string;
+//# sourceMappingURL=code-generator.d.ts.map

package/dist/code-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-generator.d.ts","sourceRoot":"","sources":["../src/code-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAIrD,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA4ZD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,YAAY,GAAG,IAAI,EAC9B,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAIR;AAiBD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,YAAY,GAAG,IAAI,EAC9B,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAgGR;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE,qBAA0B,GAClC,MAAM,CA0BR"}

package/dist/error-boundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../src/error-boundary.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE/D,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CACnD;AAED,UAAU,2BAA2B;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,qBAAa,sBAAuB,SAAQ,SAAS,CACnD,2BAA2B,EAC3B,2BAA2B,CAC5B;gBACa,KAAK,EAAE,2BAA2B;IAK9C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,2BAA2B;IAI1E,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAM3D,MAAM,IAAI,SAAS;CA6CpB"}
+{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../src/error-boundary.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAG/D,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CACnD;AAED,UAAU,2BAA2B;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,qBAAa,sBAAuB,SAAQ,SAAS,CACnD,2BAA2B,EAC3B,2BAA2B,CAC5B;gBACa,KAAK,EAAE,2BAA2B;IAK9C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,2BAA2B;IAI1E,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAM3D,MAAM,IAAI,SAAS;CA8CpB"}