From 08ac315f91bc83bcf24e53fa1d58058faab7428a Mon Sep 17 00:00:00 2001
From: "andrei.kislitsyn" <kisandy@yandex.ru>
Date: Wed, 14 May 2025 15:49:18 +0400
Subject: [PATCH 1/8] utilities generation topic

---
 docs/StardustDocs/d.tree                      |   1 +
 .../topics/Utilities-Generation.md            | 223 ++++++++
 .../notebook_test_generate_docs_1.html        | 520 ++++++++++++++++++
 tests/build.gradle.kts                        |   1 +
 .../kotlinx/dataframe/samples/api/Generate.kt | 166 ++++++
 5 files changed, 911 insertions(+)
 create mode 100644 docs/StardustDocs/topics/Utilities-Generation.md
 create mode 100644 docs/resources/api/generate_docs/notebook_test_generate_docs_1.html
 create mode 100644 tests/src/test/kotlin/org/jetbrains/kotlinx/dataframe/samples/api/Generate.kt

diff --git a/docs/StardustDocs/d.tree b/docs/StardustDocs/d.tree
index 6cd7f92400..3db96f109d 100644
--- a/docs/StardustDocs/d.tree
+++ b/docs/StardustDocs/d.tree
@@ -191,6 +191,7 @@
             <toc-element topic="format.md"/>
             <toc-element topic="jupyterRendering.md"/>
         </toc-element>
+        <toc-element topic="Utilities-Generation.md"/>
     </toc-element>
     <toc-element topic="gradleReference.md"/>
     <toc-element topic="Usage-with-Kotlin-Notebook-Plugin.md">
diff --git a/docs/StardustDocs/topics/Utilities-Generation.md b/docs/StardustDocs/topics/Utilities-Generation.md
new file mode 100644
index 0000000000..5b44d16172
--- /dev/null
+++ b/docs/StardustDocs/topics/Utilities-Generation.md
@@ -0,0 +1,223 @@
+# Utilities Generation
+
+<web-summary>
+Generate useful Kotlin definitions based on your DataFrame structure.
+</web-summary>
+
+<card-summary>
+Generate useful Kotlin definitions based on your DataFrame structure.
+</card-summary>
+
+<link-summary>
+Generate useful Kotlin definitions based on your DataFrame structure.
+</link-summary>
+
+<!---IMPORT org.jetbrains.kotlinx.dataframe.samples.api.Generate-->
+
+Special utility functions that generate code of useful Kotlin definitions (returned as a `String`) 
+based on the current `DataFrame` schema.
+
+
+## generateInterfaces
+
+Generates [`@DataSchema`](schemas.md) interfaces for this `DataFrame` 
+(including all nested `DataFrame` columns and column groups) as Kotlin interfaces.
+
+This is useful when working with the [compiler plugin](Compiler-Plugin.md) 
+in cases where the schema cannot be inferred automatically from the source.
+
+### Arguments {id="generateInterfaces-arguments"}
+* `markerName`: `String` – The base name to use for generated interfaces.  
+  If not specified, uses the `T` type argument of `DataFrame` simple name.
+
+### Returns {id="generateInterfaces-returns"}
+* `CodeString` – A value class wrapper for `String`, containing  
+  the generated Kotlin code of `@DataSchema` interfaces without extension properties.
+
+### Examples {id="generateInterfaces-examples"}}
+
+
+<!---FUN notebook_test_generate_docs_1-->
+
+```kotlin
+df
+```
+
+<!---END-->
+
+<inline-frame src="./resources/notebook_test_generate_docs_1.html" width="100%" height="500px"></inline-frame>
+
+<!---FUN notebook_test_generate_docs_2-->
+
+```kotlin
+df.generateInterfaces()
+```
+
+<!---END-->
+
+Output:
+```kotlin
+@DataSchema(isOpen = false)
+interface _DataFrameType11 {
+    val amount: kotlin.Double
+    val orderId: kotlin.Int
+}
+
+@DataSchema
+interface _DataFrameType1 {
+    val orders: List<_DataFrameType11>
+    val user: kotlin.String
+}
+```
+
+By adding these interfaces to your project with the [compiler plugin](Compiler-Plugin.md) enabled,  
+you'll gain full support for the [extension properties API](extensionPropertiesApi.md) and type-safe operations.
+
+Use [`cast`](cast.md) to apply the generated schema to a `DataFrame`:
+
+<!---FUN notebook_test_generate_docs_3-->
+
+```kotlin
+df.cast<_DataFrameType1>().filter { orders.all { orderId >= 102 } }
+```
+
+<!---END-->
+
+<!--inline-frame src="./resources/notebook_test_generate_docs_3.html" width="100%" height="500px"></inline-frame>-->
+
+## generateDataClasses
+
+Generates Kotlin data classes corresponding to the `DataFrame` schema 
+(including all nested `DataFrame` columns and column groups).
+
+Useful when you want to:
+
+- Work with the data as regular Kotlin data classes.
+- Work with data classes serialization.
+- Extract structured types for further use in your application.
+- 
+### Arguments {id="generateDataClasses-arguments"}
+* `markerName`: `String?` — The base name to use for generated data classes.  
+  If `null`, uses the `T` type argument of `DataFrame` simple name.  
+  Default: `null`.
+* `extensionProperties`: `Boolean` – Whether to generate extension properties in addition to `data class` declarations.  
+  Default: `false`.
+* `visibility`: `MarkerVisibility` – Visibility modifier for the generated declarations.  
+  Default: `MarkerVisibility.IMPLICIT_PUBLIC`.
+* `useFqNames`: `Boolean` – If `true`, fully qualified type names will be used in generated code.  
+  Default: `false`.
+* `nameNormalizer`: `NameNormalizer` – Strategy for converting column names (with spaces, underscores, etc.) to valid Kotlin identifiers.  
+  Default: `NameNormalizer.default`.
+
+### Returns {id="generateDataClasses-returns"}
+* `CodeString` – A value class wrapper for `String`, containing  
+  the generated Kotlin code of `data class` declarations and optionally extension properties.
+
+### Examples {id="generateDataClasses-examples"}
+
+<!---FUN notebook_test_generate_docs_4-->
+
+```kotlin
+df.generateDataClasses("Customer")
+```
+
+<!---END-->
+
+Output:
+```kotlin
+@DataSchema
+data class Customer1(
+    val amount: Double,
+    val orderId: Int
+)
+
+@DataSchema
+data class Customer(
+    val orders: List<Customer1>,
+    val user: String
+)
+```
+
+AAdd these classes to your project and convert the DataFrame to a list of typed objects:
+
+<!---FUN notebook_test_generate_docs_5-->
+
+```kotlin
+val customers: List<Customer> = df.cast<Customer>().toList()
+```
+
+<!---END-->
+
+<!---FUN notebook_test_generate_docs_6-->
+
+## generateCode
+
+Generates a data schema interface as [`generateInterfaces()`](#generateinterfaces),  
+along with explicit [extension properties](extensionPropertiesApi.md). 
+Useful if you don't use the [compiler plugin](Compiler-Plugin.md).
+
+### Arguments {id="generateCode-arguments"}
+* `markerName`: `String` – The base name to use for generated interfaces. 
+If not specified, uses the `T` type argument of `DataFrame` simple name.
+* `fields`: `Boolean` – Whether to generate fields (`val ...`) inside interfaces. 
+Default: `true`.
+* `extensionProperties`: `Boolean` – Whether to generate extension properties for the schema.
+Default: `true`.
+* `visibility`: `MarkerVisibility` – Visibility modifier for the generated declarations.
+Default: `MarkerVisibility.IMPLICIT_PUBLIC`.
+
+### Returns {id="generateCode-returns"}
+* `CodeString` – A value class wrapper for `String`, containing
+the generated Kotlin code of `@DataSchema` interfaces and/or extension properties.
+
+### Examples {id="generateCode-examples"}
+
+```kotlin
+df.generateCode("Customer")
+```
+
+<!---END-->
+
+Output:
+```kotlin
+@DataSchema(isOpen = false)
+interface Customer1 {
+    val amount: kotlin.Double
+    val orderId: kotlin.Int
+}
+
+val org.jetbrains.kotlinx.dataframe.ColumnsContainer<Customer1>.amount: org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Double> @JvmName("Customer1_amount") get() = this["amount"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Double>
+val org.jetbrains.kotlinx.dataframe.DataRow<Customer1>.amount: kotlin.Double @JvmName("Customer1_amount") get() = this["amount"] as kotlin.Double
+val org.jetbrains.kotlinx.dataframe.ColumnsContainer<Customer1>.orderId: org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Int> @JvmName("Customer1_orderId") get() = this["orderId"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Int>
+val org.jetbrains.kotlinx.dataframe.DataRow<Customer1>.orderId: kotlin.Int @JvmName("Customer1_orderId") get() = this["orderId"] as kotlin.Int
+
+@DataSchema
+interface Customer {
+    val orders: List<Customer1>
+    val user: kotlin.String
+}
+
+val org.jetbrains.kotlinx.dataframe.ColumnsContainer<Customer>.orders: org.jetbrains.kotlinx.dataframe.DataColumn<org.jetbrains.kotlinx.dataframe.DataFrame<Customer1>> @JvmName("Customer_orders") get() = this["orders"] as org.jetbrains.kotlinx.dataframe.DataColumn<org.jetbrains.kotlinx.dataframe.DataFrame<Customer1>>
+val org.jetbrains.kotlinx.dataframe.DataRow<Customer>.orders: org.jetbrains.kotlinx.dataframe.DataFrame<Customer1> @JvmName("Customer_orders") get() = this["orders"] as org.jetbrains.kotlinx.dataframe.DataFrame<Customer1>
+val org.jetbrains.kotlinx.dataframe.ColumnsContainer<Customer>.user: org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.String> @JvmName("Customer_user") get() = this["user"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.String>
+val org.jetbrains.kotlinx.dataframe.DataRow<Customer>.user: kotlin.String @JvmName("Customer_user") get() = this["user"] as kotlin.String
+```
+
+By adding this generated code to your project, you can use the [extension properties API](extensionPropertiesApi.md)
+for fully type-safe column access and transformations.
+
+Use [`cast`](cast.md) to apply the generated schema to a `DataFrame`:
+
+<!---FUN notebook_test_generate_docs_7-->
+
+```kotlin
+df.cast<Customer>()
+    .add("ordersTotal") { orders.sumOf { it.amount } }
+    .filter { user.startsWith("A") }
+    .rename { user }.into("customer")
+```
+
+<!---END-->
+
+<!--inline-frame src="./resources/notebook_test_generate_docs_7.html" width="100%" height="500px"></inline-frame>-->
+
diff --git a/docs/resources/api/generate_docs/notebook_test_generate_docs_1.html b/docs/resources/api/generate_docs/notebook_test_generate_docs_1.html
new file mode 100644
index 0000000000..3fd35bf310
--- /dev/null
+++ b/docs/resources/api/generate_docs/notebook_test_generate_docs_1.html
@@ -0,0 +1,520 @@
+<html>
+<head>
+<style type="text/css">
+:root {
+    --background: #fff;
+    --background-odd: #f5f5f5;
+    --background-hover: #d9edfd;
+    --header-text-color: #474747;
+    --text-color: #848484;
+    --text-color-dark: #000;
+    --text-color-medium: #737373;
+    --text-color-pale: #b3b3b3;
+    --inner-border-color: #aaa;
+    --bold-border-color: #000;
+    --link-color: #296eaa;
+    --link-color-pale: #296eaa;
+    --link-hover: #1a466c;
+}
+
+:root[theme="dark"], :root [data-jp-theme-light="false"], .dataframe_dark{
+    --background: #303030;
+    --background-odd: #3c3c3c;
+    --background-hover: #464646;
+    --header-text-color: #dddddd;
+    --text-color: #b3b3b3;
+    --text-color-dark: #dddddd;
+    --text-color-medium: #b2b2b2;
+    --text-color-pale: #737373;
+    --inner-border-color: #707070;
+    --bold-border-color: #777777;
+    --link-color: #008dc0;
+    --link-color-pale: #97e1fb;
+    --link-hover: #00688e;
+}
+
+p.dataframe_description {
+    color: var(--text-color-dark);
+}
+
+table.dataframe {
+    font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
+    font-size: 12px;
+    background-color: var(--background);
+    color: var(--text-color-dark);
+    border: none;
+    border-collapse: collapse;
+}
+
+table.dataframe th, td {
+    padding: 6px;
+    border: 1px solid transparent;
+    text-align: left;
+}
+
+table.dataframe th {
+    background-color: var(--background);
+    color: var(--header-text-color);
+}
+
+table.dataframe td {
+    vertical-align: top;
+    white-space: nowrap;
+}
+
+table.dataframe th.bottomBorder {
+    border-bottom-color: var(--bold-border-color);
+}
+
+table.dataframe tbody > tr:nth-child(odd) {
+    background: var(--background-odd);
+}
+
+table.dataframe tbody > tr:nth-child(even) {
+    background: var(--background);
+}
+
+table.dataframe tbody > tr:hover {
+    background: var(--background-hover);
+}
+
+table.dataframe a {
+    cursor: pointer;
+    color: var(--link-color);
+    text-decoration: none;
+}
+
+table.dataframe tr:hover > td a {
+    color: var(--link-color-pale);
+}
+
+table.dataframe a:hover {
+    color: var(--link-hover);
+    text-decoration: underline;
+}
+
+table.dataframe img {
+    max-width: fit-content;
+}
+
+table.dataframe th.complex {
+    background-color: var(--background);
+    border: 1px solid var(--background);
+}
+
+table.dataframe .leftBorder {
+    border-left-color: var(--inner-border-color);
+}
+
+table.dataframe .rightBorder {
+    border-right-color: var(--inner-border-color);
+}
+
+table.dataframe .rightAlign {
+    text-align: right;
+}
+
+table.dataframe .expanderSvg {
+    width: 8px;
+    height: 8px;
+    margin-right: 3px;
+}
+
+table.dataframe .expander {
+    display: flex;
+    align-items: center;
+}
+
+/* formatting */
+
+table.dataframe .null {
+    color: var(--text-color-pale);
+}
+
+table.dataframe .structural {
+    color: var(--text-color-medium);
+    font-weight: bold;
+}
+
+table.dataframe .dataFrameCaption {
+    font-weight: bold;
+}
+
+table.dataframe .numbers {
+    color: var(--text-color-dark);
+}
+
+table.dataframe td:hover .formatted .structural, .null {
+    color: var(--text-color-dark);
+}
+
+table.dataframe tr:hover .formatted .structural, .null {
+    color: var(--text-color-dark);
+}
+
+
+body {
+    font-family: "JetBrains Mono",SFMono-Regular,Consolas,"Liberation Mono",Menlo,Courier,monospace;
+}       
+
+:root {
+    color: #19191C;
+    background-color: #fff;
+}
+
+:root[theme="dark"] {
+    background-color: #19191C;
+    color: #FFFFFFCC
+}
+
+details details {
+    margin-left: 20px; 
+}
+
+summary {
+    padding: 6px;
+}
+</style>
+</head>
+<body>
+<table class="dataframe" id="df_-1140850688"></table>
+
+<p class="dataframe_description"></p>
+</body>
+<script>
+(function () {
+    window.DataFrame = window.DataFrame || new (function () {
+        this.addTable = function (df) {
+            let cols = df.cols;
+            for (let i = 0; i < cols.length; i++) {
+                for (let c of cols[i].children) {
+                    cols[c].parent = i;
+                }
+            }
+            df.nrow = 0
+            for (let i = 0; i < df.cols.length; i++) {
+                if (df.cols[i].values.length > df.nrow) df.nrow = df.cols[i].values.length
+            }
+            if (df.id === df.rootId) {
+                df.expandedFrames = new Set()
+                df.childFrames = {}
+                const table = this.getTableElement(df.id)
+                table.df = df
+                for (let i = 0; i < df.cols.length; i++) {
+                    let col = df.cols[i]
+                    if (col.parent === undefined && col.children.length > 0) col.expanded = true
+                }
+            } else {
+                const rootDf = this.getTableData(df.rootId)
+                rootDf.childFrames[df.id] = df
+            }
+        }
+
+        this.computeRenderData = function (df) {
+            let result = []
+            let pos = 0
+            for (let col = 0; col < df.cols.length; col++) {
+                if (df.cols[col].parent === undefined)
+                    pos += this.computeRenderDataRec(df.cols, col, pos, 0, result, false, false)
+            }
+            for (let i = 0; i < result.length; i++) {
+                let row = result[i]
+                for (let j = 0; j < row.length; j++) {
+                    let cell = row[j]
+                    if (j === 0)
+                        cell.leftBd = false
+                    if (j < row.length - 1) {
+                        let nextData = row[j + 1]
+                        if (nextData.leftBd) cell.rightBd = true
+                        else if (cell.rightBd) nextData.leftBd = true
+                    } else cell.rightBd = false
+                }
+            }
+            return result
+        }
+
+        this.computeRenderDataRec = function (cols, colId, pos, depth, result, leftBorder, rightBorder) {
+            if (result.length === depth) {
+                const array = [];
+                if (pos > 0) {
+                    let j = 0
+                    for (let i = 0; j < pos; i++) {
+                        let c = result[depth - 1][i]
+                        j += c.span
+                        let copy = Object.assign({empty: true}, c)
+                        array.push(copy)
+                    }
+                }
+                result.push(array)
+            }
+            const col = cols[colId];
+            let size = 0;
+            if (col.expanded) {
+                let childPos = pos
+                for (let i = 0; i < col.children.length; i++) {
+                    let child = col.children[i]
+                    let childLeft = i === 0 && (col.children.length > 1 || leftBorder)
+                    let childRight = i === col.children.length - 1 && (col.children.length > 1 || rightBorder)
+                    let childSize = this.computeRenderDataRec(cols, child, childPos, depth + 1, result, childLeft, childRight)
+                    childPos += childSize
+                    size += childSize
+                }
+            } else {
+                for (let i = depth + 1; i < result.length; i++)
+                    result[i].push({id: colId, span: 1, leftBd: leftBorder, rightBd: rightBorder, empty: true})
+                size = 1
+            }
+            let left = leftBorder
+            let right = rightBorder
+            if (size > 1) {
+                left = true
+                right = true
+            }
+            result[depth].push({id: colId, span: size, leftBd: left, rightBd: right})
+            return size
+        }
+
+        this.getTableElement = function (id) {
+            return document.getElementById("df_" + id)
+        }
+
+        this.getTableData = function (id) {
+            return this.getTableElement(id).df
+        }
+
+        this.createExpander = function (isExpanded) {
+            const svgNs = "http://www.w3.org/2000/svg"
+            let svg = document.createElementNS(svgNs, "svg")
+            svg.classList.add("expanderSvg")
+            let path = document.createElementNS(svgNs, "path")
+            if (isExpanded) {
+                svg.setAttribute("viewBox", "0 -2 8 8")
+                path.setAttribute("d", "M1 0 l-1 1 4 4 4 -4 -1 -1 -3 3Z")
+            } else {
+                svg.setAttribute("viewBox", "-2 0 8 8")
+                path.setAttribute("d", "M1 0 l-1 1 3 3 -3 3 1 1 4 -4Z")
+            }
+            path.setAttribute("fill", "currentColor")
+            svg.appendChild(path)
+            return svg
+        }
+
+        this.renderTable = function (id) {
+
+            let table = this.getTableElement(id)
+
+            if (table === null) return
+
+            table.innerHTML = ""
+
+            let df = table.df
+            let rootDf = df.rootId === df.id ? df : this.getTableData(df.rootId)
+
+            // header
+            let header = document.createElement("thead")
+            table.appendChild(header)
+
+            let renderData = this.computeRenderData(df)
+            for (let j = 0; j < renderData.length; j++) {
+                let rowData = renderData[j]
+                let tr = document.createElement("tr");
+                let isLastRow = j === renderData.length - 1
+                header.appendChild(tr);
+                for (let i = 0; i < rowData.length; i++) {
+                    let cell = rowData[i]
+                    let th = document.createElement("th");
+                    th.setAttribute("colspan", cell.span)
+                    let colId = cell.id
+                    let col = df.cols[colId];
+                    if (!cell.empty) {
+                        if (col.children.length === 0) {
+                            th.innerHTML = col.name
+                        } else {
+                            let link = document.createElement("a")
+                            link.className = "expander"
+                            let that = this
+                            link.onclick = function () {
+                                col.expanded = !col.expanded
+                                that.renderTable(id)
+                            }
+                            link.appendChild(this.createExpander(col.expanded))
+                            link.innerHTML += col.name
+                            th.appendChild(link)
+                        }
+                    }
+                    let classes = (cell.leftBd ? " leftBorder" : "") + (cell.rightBd ? " rightBorder" : "")
+                    if (col.rightAlign)
+                        classes += " rightAlign"
+                    if (isLastRow)
+                        classes += " bottomBorder"
+                    if (classes.length > 0)
+                        th.setAttribute("class", classes)
+                    tr.appendChild(th)
+                }
+            }
+
+            // body
+            let body = document.createElement("tbody")
+            table.appendChild(body)
+
+            let columns = renderData.pop()
+            for (let row = 0; row < df.nrow; row++) {
+                let tr = document.createElement("tr");
+                body.appendChild(tr)
+                for (let i = 0; i < columns.length; i++) {
+                    let cell = columns[i]
+                    let td = document.createElement("td");
+                    let colId = cell.id
+                    let col = df.cols[colId]
+                    let classes = (cell.leftBd ? " leftBorder" : "") + (cell.rightBd ? " rightBorder" : "")
+                    if (col.rightAlign)
+                        classes += " rightAlign"
+                    if (classes.length > 0)
+                        td.setAttribute("class", classes)
+                    tr.appendChild(td)
+                    let value = col.values[row]
+                    if (value.frameId !== undefined) {
+                        let frameId = value.frameId
+                        let expanded = rootDf.expandedFrames.has(frameId)
+                        let link = document.createElement("a")
+                        link.className = "expander"
+                        let that = this
+                        link.onclick = function () {
+                            if (rootDf.expandedFrames.has(frameId))
+                                rootDf.expandedFrames.delete(frameId)
+                            else rootDf.expandedFrames.add(frameId)
+                            that.renderTable(id)
+                        }
+                        link.appendChild(this.createExpander(expanded))
+                        link.innerHTML += value.value
+                        if (expanded) {
+                            td.appendChild(link)
+                            td.appendChild(document.createElement("p"))
+                            const childTable = document.createElement("table")
+                            childTable.className = "dataframe"
+                            childTable.id = "df_" + frameId
+                            let childDf = rootDf.childFrames[frameId]
+                            childTable.df = childDf
+                            td.appendChild(childTable)
+                            this.renderTable(frameId)
+                            if (childDf.nrow !== childDf.totalRows) {
+                                const footer = document.createElement("p")
+                                footer.innerText = `... showing only top ${childDf.nrow} of ${childDf.totalRows} rows`
+                                td.appendChild(footer)
+                            }
+                        } else {
+                            td.appendChild(link)
+                        }
+                    } else if (value.style !== undefined) {
+                        td.innerHTML = value.value
+                        td.setAttribute("style", value.style)
+                    } else td.innerHTML = value
+                    this.nodeScriptReplace(td)
+                }
+            }
+        }
+
+        this.nodeScriptReplace = function (node) {
+            if (this.nodeScriptIs(node) === true) {
+                node.parentNode.replaceChild(this.nodeScriptClone(node), node);
+            } else {
+                let i = -1, children = node.childNodes;
+                while (++i < children.length) {
+                    this.nodeScriptReplace(children[i]);
+                }
+            }
+
+            return node;
+        }
+
+        this.nodeScriptClone = function (node) {
+            let script = document.createElement("script");
+            script.text = node.innerHTML;
+
+            let i = -1, attrs = node.attributes, attr;
+            while (++i < attrs.length) {
+                script.setAttribute((attr = attrs[i]).name, attr.value);
+            }
+            return script;
+        }
+
+        this.nodeScriptIs = function (node) {
+            return node.tagName === 'SCRIPT';
+        }
+    })()
+
+    window.call_DataFrame = function (f) {
+        return f();
+    };
+
+    let funQueue = window["kotlinQueues"] && window["kotlinQueues"]["DataFrame"];
+    if (funQueue) {
+        funQueue.forEach(function (f) {
+            f();
+        });
+        funQueue = [];
+    }
+})()
+
+/*<!--*/
+call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"user: String\">user</span>", children: [], rightAlign: false, values: ["Alice","Bob"] }, 
+{ name: "<span title=\"orders: DataFrame<*>\">orders</span>", children: [], rightAlign: false, values: [{ frameId: -1140850687, value: "<b>DataFrame 2 x 2</b>" },{ frameId: -1140850686, value: "<b>DataFrame 3 x 2</b>" }] }, 
+], id: -1140850688, rootId: -1140850688, totalRows: 2 } ) });
+/*-->*/
+
+/*<!--*/
+call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"orderId: Int\">orderId</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">101</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">102</span></span>"] }, 
+{ name: "<span title=\"amount: Double\">amount</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">50.0</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">75.5</span></span>"] }, 
+], id: -1140850687, rootId: -1140850688, totalRows: 2 } ) });
+/*-->*/
+
+/*<!--*/
+call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"orderId: Int\">orderId</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">103</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">104</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">105</span></span>"] }, 
+{ name: "<span title=\"amount: Double\">amount</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">20.0</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">30.0</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">25.0</span></span>"] }, 
+], id: -1140850686, rootId: -1140850688, totalRows: 3 } ) });
+/*-->*/
+
+call_DataFrame(function() { DataFrame.renderTable(-1140850688) });
+
+        function sendHeight() {
+    const table = document.querySelector('table.dataframe');
+    if (!table) return;
+
+    const thead = table.querySelector('thead');
+    const tbody = table.querySelector('tbody');
+    if (!thead || !tbody || tbody.children.length === 0) return;
+
+    let height = thead.offsetHeight;
+    const rows = tbody.querySelectorAll('tr');
+    for (let i = 0; i < Math.min(rows.length, 5); i++) {
+        height += rows[i].offsetHeight;
+    }
+
+    const margin = parseFloat(getComputedStyle(table).marginTop) +
+                   parseFloat(getComputedStyle(table).marginBottom);
+
+    const totalHeight = Math.ceil(height + margin + 10);
+
+    window.parent.postMessage({ type: 'iframeHeight', height: totalHeight }, '*');
+}
+
+function repeatHeightCalculation(maxRetries = 10, interval = 100) {
+    let retries = 0;
+    const intervalId = setInterval(() => {
+        sendHeight();
+        retries++;
+        if (retries >= maxRetries) clearInterval(intervalId);
+    }, interval);
+}
+
+window.addEventListener('load', repeatHeightCalculation);
+
+const observer = new MutationObserver(sendHeight);
+observer.observe(document.querySelector('.dataframe'), {
+    childList: true,
+    subtree: true,
+    characterData: true
+});
+
+</script>
+</html>
diff --git a/tests/build.gradle.kts b/tests/build.gradle.kts
index 99957219f3..b6e0a3adbf 100644
--- a/tests/build.gradle.kts
+++ b/tests/build.gradle.kts
@@ -60,6 +60,7 @@ kotlin.sourceSets {
 
 korro {
     docs = fileTree(rootProject.rootDir) {
+        include("docs/StardustDocs/topics/Utilities-Generation.md")
         include("docs/StardustDocs/topics/read.md")
         include("docs/StardustDocs/topics/write.md")
         include("docs/StardustDocs/topics/guides/*.md")
diff --git a/tests/src/test/kotlin/org/jetbrains/kotlinx/dataframe/samples/api/Generate.kt b/tests/src/test/kotlin/org/jetbrains/kotlinx/dataframe/samples/api/Generate.kt
new file mode 100644
index 0000000000..d02d2fa355
--- /dev/null
+++ b/tests/src/test/kotlin/org/jetbrains/kotlinx/dataframe/samples/api/Generate.kt
@@ -0,0 +1,166 @@
+@file:Suppress("UNUSED_VARIABLE", "unused", "UNCHECKED_CAST")
+package org.jetbrains.kotlinx.dataframe.samples.api
+
+import org.jetbrains.kotlinx.dataframe.annotations.DataSchema
+import org.jetbrains.kotlinx.dataframe.api.add
+import org.jetbrains.kotlinx.dataframe.api.all
+import org.jetbrains.kotlinx.dataframe.api.cast
+import org.jetbrains.kotlinx.dataframe.api.dataFrameOf
+import org.jetbrains.kotlinx.dataframe.api.filter
+import org.jetbrains.kotlinx.dataframe.api.generateCode
+import org.jetbrains.kotlinx.dataframe.api.generateDataClasses
+import org.jetbrains.kotlinx.dataframe.api.generateInterfaces
+import org.jetbrains.kotlinx.dataframe.api.into
+import org.jetbrains.kotlinx.dataframe.api.rename
+import org.jetbrains.kotlinx.dataframe.api.sumOf
+import org.jetbrains.kotlinx.dataframe.api.toList
+import org.jetbrains.kotlinx.kandy.letsplot.samples.SampleHelper
+import org.junit.Test
+
+class Generate : SampleHelper("generate_docs", "api") {
+    val ordersAlice = dataFrameOf(
+        "orderId" to listOf(101, 102),
+        "amount" to listOf(50.0, 75.5)
+    )
+
+    val ordersBob = dataFrameOf(
+        "orderId" to listOf(103, 104, 105),
+        "amount" to listOf(20.0, 30.0, 25.0)
+    )
+
+    val df = dataFrameOf(
+        "user" to listOf("Alice", "Bob"),
+        "orders" to listOf(ordersAlice, ordersBob)
+    )
+
+    @DataSchema(isOpen = false)
+    interface _DataFrameType11 {
+        val amount: kotlin.Double
+        val orderId: kotlin.Int
+    }
+
+    val org.jetbrains.kotlinx.dataframe.ColumnsContainer<_DataFrameType11>.amount: org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Double>
+        @JvmName(
+            "_DataFrameType11_amount"
+        ) get() = this["amount"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Double>
+    val org.jetbrains.kotlinx.dataframe.DataRow<_DataFrameType11>.amount: kotlin.Double @JvmName("_DataFrameType11_amount") get() = this["amount"] as kotlin.Double
+    val org.jetbrains.kotlinx.dataframe.ColumnsContainer<_DataFrameType11>.orderId: org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Int>
+        @JvmName(
+            "_DataFrameType11_orderId"
+        ) get() = this["orderId"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Int>
+    val org.jetbrains.kotlinx.dataframe.DataRow<_DataFrameType11>.orderId: kotlin.Int @JvmName("_DataFrameType11_orderId") get() = this["orderId"] as kotlin.Int
+
+    @DataSchema
+    interface _DataFrameType1 {
+        val orders: List<_DataFrameType11>
+        val user: kotlin.String
+    }
+
+    val org.jetbrains.kotlinx.dataframe.ColumnsContainer<_DataFrameType1>.orders: org.jetbrains.kotlinx.dataframe.DataColumn<org.jetbrains.kotlinx.dataframe.DataFrame<_DataFrameType11>>
+        @JvmName(
+            "_DataFrameType1_orders"
+        ) get() = this["orders"] as org.jetbrains.kotlinx.dataframe.DataColumn<org.jetbrains.kotlinx.dataframe.DataFrame<_DataFrameType11>>
+    val org.jetbrains.kotlinx.dataframe.DataRow<_DataFrameType1>.orders: org.jetbrains.kotlinx.dataframe.DataFrame<_DataFrameType11>
+        @JvmName(
+            "_DataFrameType1_orders"
+        ) get() = this["orders"] as org.jetbrains.kotlinx.dataframe.DataFrame<_DataFrameType11>
+    val org.jetbrains.kotlinx.dataframe.ColumnsContainer<_DataFrameType1>.user: org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.String>
+        @JvmName(
+            "_DataFrameType1_user"
+        ) get() = this["user"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.String>
+    val org.jetbrains.kotlinx.dataframe.DataRow<_DataFrameType1>.user: kotlin.String @JvmName("_DataFrameType1_user") get() = this["user"] as kotlin.String
+
+    @DataSchema
+    data class Customer1(
+        val amount: Double,
+        val orderId: Int
+    )
+
+    @DataSchema
+    data class Customer(
+        val orders: List<Customer1>,
+        val user: String
+    )
+
+    val org.jetbrains.kotlinx.dataframe.ColumnsContainer<Customer1>.amount: org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Double>
+        @JvmName(
+            "Customer1_amount"
+        ) get() = this["amount"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Double>
+    val org.jetbrains.kotlinx.dataframe.DataRow<Customer1>.amount: kotlin.Double @JvmName("Customer1_amount") get() = this["amount"] as kotlin.Double
+    val org.jetbrains.kotlinx.dataframe.ColumnsContainer<Customer1>.orderId: org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Int>
+        @JvmName(
+            "Customer1_orderId"
+        ) get() = this["orderId"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Int>
+    val org.jetbrains.kotlinx.dataframe.DataRow<Customer1>.orderId: kotlin.Int @JvmName("Customer1_orderId") get() = this["orderId"] as kotlin.Int
+
+    val org.jetbrains.kotlinx.dataframe.ColumnsContainer<Customer>.orders: org.jetbrains.kotlinx.dataframe.DataColumn<org.jetbrains.kotlinx.dataframe.DataFrame<Customer1>>
+        @JvmName(
+            "Customer_orders"
+        ) get() = this["orders"] as org.jetbrains.kotlinx.dataframe.DataColumn<org.jetbrains.kotlinx.dataframe.DataFrame<Customer1>>
+    val org.jetbrains.kotlinx.dataframe.DataRow<Customer>.orders: org.jetbrains.kotlinx.dataframe.DataFrame<Customer1>
+        @JvmName(
+            "Customer_orders"
+        ) get() = this["orders"] as org.jetbrains.kotlinx.dataframe.DataFrame<Customer1>
+    val org.jetbrains.kotlinx.dataframe.ColumnsContainer<Customer>.user: org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.String>
+        @JvmName(
+            "Customer_user"
+        ) get() = this["user"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.String>
+    val org.jetbrains.kotlinx.dataframe.DataRow<Customer>.user: kotlin.String @JvmName("Customer_user") get() = this["user"] as kotlin.String
+
+    private val customers: List<Customer> = df.cast<Customer>().toList()
+
+    @Test
+    fun notebook_test_generate_docs_1() {
+        // SampleStart
+        df
+            // SampleEnd
+            .saveDfHtmlSample()
+    }
+
+    @Test
+    fun notebook_test_generate_docs_2() {
+        // SampleStart
+        df.generateInterfaces()
+        // SampleEnd
+    }
+
+    @Test
+    fun notebook_test_generate_docs_3() {
+        // SampleStart
+        df.cast<_DataFrameType1>().filter { orders.all { orderId >= 102 } }
+        // SampleEnd
+        //.saveDfHtmlSample()
+    }
+
+    @Test
+    fun notebook_test_generate_docs_4() {
+        // SampleStart
+        df.generateDataClasses("Customer")
+        // SampleEnd
+    }
+
+    @Test
+    fun notebook_test_generate_docs_5() {
+        // SampleStart
+        val customers: List<Customer> = df.cast<Customer>().toList()
+        // SampleEnd
+    }
+
+    @Test
+    fun notebook_test_generate_docs_6() {
+        // SampleStart
+        df.generateCode("Customer")
+        // SampleEnd
+    }
+
+    @Test
+    fun notebook_test_generate_docs_7() {
+        // SampleStart
+        df.cast<Customer>()
+            .add("ordersTotal") { orders.sumOf { it.amount } }
+            .filter { user.startsWith("A") }
+            .rename { user }.into("customer")
+        // SampleEnd
+        //   .saveDfHtmlSample()
+    }
+}

From 290c419c2eb468e09b186d874d48064cbe3fc23d Mon Sep 17 00:00:00 2001
From: "andrei.kislitsyn" <kisandy@yandex.ru>
Date: Wed, 14 May 2025 15:52:08 +0400
Subject: [PATCH 2/8] fix sample helper

---
 .../notebook_test_generate_docs_1.html        | 520 ------------------
 .../kotlinx/dataframe/samples/api/Generate.kt |   4 +-
 2 files changed, 2 insertions(+), 522 deletions(-)
 delete mode 100644 docs/resources/api/generate_docs/notebook_test_generate_docs_1.html

diff --git a/docs/resources/api/generate_docs/notebook_test_generate_docs_1.html b/docs/resources/api/generate_docs/notebook_test_generate_docs_1.html
deleted file mode 100644
index 3fd35bf310..0000000000
--- a/docs/resources/api/generate_docs/notebook_test_generate_docs_1.html
+++ /dev/null
@@ -1,520 +0,0 @@
-<html>
-<head>
-<style type="text/css">
-:root {
-    --background: #fff;
-    --background-odd: #f5f5f5;
-    --background-hover: #d9edfd;
-    --header-text-color: #474747;
-    --text-color: #848484;
-    --text-color-dark: #000;
-    --text-color-medium: #737373;
-    --text-color-pale: #b3b3b3;
-    --inner-border-color: #aaa;
-    --bold-border-color: #000;
-    --link-color: #296eaa;
-    --link-color-pale: #296eaa;
-    --link-hover: #1a466c;
-}
-
-:root[theme="dark"], :root [data-jp-theme-light="false"], .dataframe_dark{
-    --background: #303030;
-    --background-odd: #3c3c3c;
-    --background-hover: #464646;
-    --header-text-color: #dddddd;
-    --text-color: #b3b3b3;
-    --text-color-dark: #dddddd;
-    --text-color-medium: #b2b2b2;
-    --text-color-pale: #737373;
-    --inner-border-color: #707070;
-    --bold-border-color: #777777;
-    --link-color: #008dc0;
-    --link-color-pale: #97e1fb;
-    --link-hover: #00688e;
-}
-
-p.dataframe_description {
-    color: var(--text-color-dark);
-}
-
-table.dataframe {
-    font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
-    font-size: 12px;
-    background-color: var(--background);
-    color: var(--text-color-dark);
-    border: none;
-    border-collapse: collapse;
-}
-
-table.dataframe th, td {
-    padding: 6px;
-    border: 1px solid transparent;
-    text-align: left;
-}
-
-table.dataframe th {
-    background-color: var(--background);
-    color: var(--header-text-color);
-}
-
-table.dataframe td {
-    vertical-align: top;
-    white-space: nowrap;
-}
-
-table.dataframe th.bottomBorder {
-    border-bottom-color: var(--bold-border-color);
-}
-
-table.dataframe tbody > tr:nth-child(odd) {
-    background: var(--background-odd);
-}
-
-table.dataframe tbody > tr:nth-child(even) {
-    background: var(--background);
-}
-
-table.dataframe tbody > tr:hover {
-    background: var(--background-hover);
-}
-
-table.dataframe a {
-    cursor: pointer;
-    color: var(--link-color);
-    text-decoration: none;
-}
-
-table.dataframe tr:hover > td a {
-    color: var(--link-color-pale);
-}
-
-table.dataframe a:hover {
-    color: var(--link-hover);
-    text-decoration: underline;
-}
-
-table.dataframe img {
-    max-width: fit-content;
-}
-
-table.dataframe th.complex {
-    background-color: var(--background);
-    border: 1px solid var(--background);
-}
-
-table.dataframe .leftBorder {
-    border-left-color: var(--inner-border-color);
-}
-
-table.dataframe .rightBorder {
-    border-right-color: var(--inner-border-color);
-}
-
-table.dataframe .rightAlign {
-    text-align: right;
-}
-
-table.dataframe .expanderSvg {
-    width: 8px;
-    height: 8px;
-    margin-right: 3px;
-}
-
-table.dataframe .expander {
-    display: flex;
-    align-items: center;
-}
-
-/* formatting */
-
-table.dataframe .null {
-    color: var(--text-color-pale);
-}
-
-table.dataframe .structural {
-    color: var(--text-color-medium);
-    font-weight: bold;
-}
-
-table.dataframe .dataFrameCaption {
-    font-weight: bold;
-}
-
-table.dataframe .numbers {
-    color: var(--text-color-dark);
-}
-
-table.dataframe td:hover .formatted .structural, .null {
-    color: var(--text-color-dark);
-}
-
-table.dataframe tr:hover .formatted .structural, .null {
-    color: var(--text-color-dark);
-}
-
-
-body {
-    font-family: "JetBrains Mono",SFMono-Regular,Consolas,"Liberation Mono",Menlo,Courier,monospace;
-}       
-
-:root {
-    color: #19191C;
-    background-color: #fff;
-}
-
-:root[theme="dark"] {
-    background-color: #19191C;
-    color: #FFFFFFCC
-}
-
-details details {
-    margin-left: 20px; 
-}
-
-summary {
-    padding: 6px;
-}
-</style>
-</head>
-<body>
-<table class="dataframe" id="df_-1140850688"></table>
-
-<p class="dataframe_description"></p>
-</body>
-<script>
-(function () {
-    window.DataFrame = window.DataFrame || new (function () {
-        this.addTable = function (df) {
-            let cols = df.cols;
-            for (let i = 0; i < cols.length; i++) {
-                for (let c of cols[i].children) {
-                    cols[c].parent = i;
-                }
-            }
-            df.nrow = 0
-            for (let i = 0; i < df.cols.length; i++) {
-                if (df.cols[i].values.length > df.nrow) df.nrow = df.cols[i].values.length
-            }
-            if (df.id === df.rootId) {
-                df.expandedFrames = new Set()
-                df.childFrames = {}
-                const table = this.getTableElement(df.id)
-                table.df = df
-                for (let i = 0; i < df.cols.length; i++) {
-                    let col = df.cols[i]
-                    if (col.parent === undefined && col.children.length > 0) col.expanded = true
-                }
-            } else {
-                const rootDf = this.getTableData(df.rootId)
-                rootDf.childFrames[df.id] = df
-            }
-        }
-
-        this.computeRenderData = function (df) {
-            let result = []
-            let pos = 0
-            for (let col = 0; col < df.cols.length; col++) {
-                if (df.cols[col].parent === undefined)
-                    pos += this.computeRenderDataRec(df.cols, col, pos, 0, result, false, false)
-            }
-            for (let i = 0; i < result.length; i++) {
-                let row = result[i]
-                for (let j = 0; j < row.length; j++) {
-                    let cell = row[j]
-                    if (j === 0)
-                        cell.leftBd = false
-                    if (j < row.length - 1) {
-                        let nextData = row[j + 1]
-                        if (nextData.leftBd) cell.rightBd = true
-                        else if (cell.rightBd) nextData.leftBd = true
-                    } else cell.rightBd = false
-                }
-            }
-            return result
-        }
-
-        this.computeRenderDataRec = function (cols, colId, pos, depth, result, leftBorder, rightBorder) {
-            if (result.length === depth) {
-                const array = [];
-                if (pos > 0) {
-                    let j = 0
-                    for (let i = 0; j < pos; i++) {
-                        let c = result[depth - 1][i]
-                        j += c.span
-                        let copy = Object.assign({empty: true}, c)
-                        array.push(copy)
-                    }
-                }
-                result.push(array)
-            }
-            const col = cols[colId];
-            let size = 0;
-            if (col.expanded) {
-                let childPos = pos
-                for (let i = 0; i < col.children.length; i++) {
-                    let child = col.children[i]
-                    let childLeft = i === 0 && (col.children.length > 1 || leftBorder)
-                    let childRight = i === col.children.length - 1 && (col.children.length > 1 || rightBorder)
-                    let childSize = this.computeRenderDataRec(cols, child, childPos, depth + 1, result, childLeft, childRight)
-                    childPos += childSize
-                    size += childSize
-                }
-            } else {
-                for (let i = depth + 1; i < result.length; i++)
-                    result[i].push({id: colId, span: 1, leftBd: leftBorder, rightBd: rightBorder, empty: true})
-                size = 1
-            }
-            let left = leftBorder
-            let right = rightBorder
-            if (size > 1) {
-                left = true
-                right = true
-            }
-            result[depth].push({id: colId, span: size, leftBd: left, rightBd: right})
-            return size
-        }
-
-        this.getTableElement = function (id) {
-            return document.getElementById("df_" + id)
-        }
-
-        this.getTableData = function (id) {
-            return this.getTableElement(id).df
-        }
-
-        this.createExpander = function (isExpanded) {
-            const svgNs = "http://www.w3.org/2000/svg"
-            let svg = document.createElementNS(svgNs, "svg")
-            svg.classList.add("expanderSvg")
-            let path = document.createElementNS(svgNs, "path")
-            if (isExpanded) {
-                svg.setAttribute("viewBox", "0 -2 8 8")
-                path.setAttribute("d", "M1 0 l-1 1 4 4 4 -4 -1 -1 -3 3Z")
-            } else {
-                svg.setAttribute("viewBox", "-2 0 8 8")
-                path.setAttribute("d", "M1 0 l-1 1 3 3 -3 3 1 1 4 -4Z")
-            }
-            path.setAttribute("fill", "currentColor")
-            svg.appendChild(path)
-            return svg
-        }
-
-        this.renderTable = function (id) {
-
-            let table = this.getTableElement(id)
-
-            if (table === null) return
-
-            table.innerHTML = ""
-
-            let df = table.df
-            let rootDf = df.rootId === df.id ? df : this.getTableData(df.rootId)
-
-            // header
-            let header = document.createElement("thead")
-            table.appendChild(header)
-
-            let renderData = this.computeRenderData(df)
-            for (let j = 0; j < renderData.length; j++) {
-                let rowData = renderData[j]
-                let tr = document.createElement("tr");
-                let isLastRow = j === renderData.length - 1
-                header.appendChild(tr);
-                for (let i = 0; i < rowData.length; i++) {
-                    let cell = rowData[i]
-                    let th = document.createElement("th");
-                    th.setAttribute("colspan", cell.span)
-                    let colId = cell.id
-                    let col = df.cols[colId];
-                    if (!cell.empty) {
-                        if (col.children.length === 0) {
-                            th.innerHTML = col.name
-                        } else {
-                            let link = document.createElement("a")
-                            link.className = "expander"
-                            let that = this
-                            link.onclick = function () {
-                                col.expanded = !col.expanded
-                                that.renderTable(id)
-                            }
-                            link.appendChild(this.createExpander(col.expanded))
-                            link.innerHTML += col.name
-                            th.appendChild(link)
-                        }
-                    }
-                    let classes = (cell.leftBd ? " leftBorder" : "") + (cell.rightBd ? " rightBorder" : "")
-                    if (col.rightAlign)
-                        classes += " rightAlign"
-                    if (isLastRow)
-                        classes += " bottomBorder"
-                    if (classes.length > 0)
-                        th.setAttribute("class", classes)
-                    tr.appendChild(th)
-                }
-            }
-
-            // body
-            let body = document.createElement("tbody")
-            table.appendChild(body)
-
-            let columns = renderData.pop()
-            for (let row = 0; row < df.nrow; row++) {
-                let tr = document.createElement("tr");
-                body.appendChild(tr)
-                for (let i = 0; i < columns.length; i++) {
-                    let cell = columns[i]
-                    let td = document.createElement("td");
-                    let colId = cell.id
-                    let col = df.cols[colId]
-                    let classes = (cell.leftBd ? " leftBorder" : "") + (cell.rightBd ? " rightBorder" : "")
-                    if (col.rightAlign)
-                        classes += " rightAlign"
-                    if (classes.length > 0)
-                        td.setAttribute("class", classes)
-                    tr.appendChild(td)
-                    let value = col.values[row]
-                    if (value.frameId !== undefined) {
-                        let frameId = value.frameId
-                        let expanded = rootDf.expandedFrames.has(frameId)
-                        let link = document.createElement("a")
-                        link.className = "expander"
-                        let that = this
-                        link.onclick = function () {
-                            if (rootDf.expandedFrames.has(frameId))
-                                rootDf.expandedFrames.delete(frameId)
-                            else rootDf.expandedFrames.add(frameId)
-                            that.renderTable(id)
-                        }
-                        link.appendChild(this.createExpander(expanded))
-                        link.innerHTML += value.value
-                        if (expanded) {
-                            td.appendChild(link)
-                            td.appendChild(document.createElement("p"))
-                            const childTable = document.createElement("table")
-                            childTable.className = "dataframe"
-                            childTable.id = "df_" + frameId
-                            let childDf = rootDf.childFrames[frameId]
-                            childTable.df = childDf
-                            td.appendChild(childTable)
-                            this.renderTable(frameId)
-                            if (childDf.nrow !== childDf.totalRows) {
-                                const footer = document.createElement("p")
-                                footer.innerText = `... showing only top ${childDf.nrow} of ${childDf.totalRows} rows`
-                                td.appendChild(footer)
-                            }
-                        } else {
-                            td.appendChild(link)
-                        }
-                    } else if (value.style !== undefined) {
-                        td.innerHTML = value.value
-                        td.setAttribute("style", value.style)
-                    } else td.innerHTML = value
-                    this.nodeScriptReplace(td)
-                }
-            }
-        }
-
-        this.nodeScriptReplace = function (node) {
-            if (this.nodeScriptIs(node) === true) {
-                node.parentNode.replaceChild(this.nodeScriptClone(node), node);
-            } else {
-                let i = -1, children = node.childNodes;
-                while (++i < children.length) {
-                    this.nodeScriptReplace(children[i]);
-                }
-            }
-
-            return node;
-        }
-
-        this.nodeScriptClone = function (node) {
-            let script = document.createElement("script");
-            script.text = node.innerHTML;
-
-            let i = -1, attrs = node.attributes, attr;
-            while (++i < attrs.length) {
-                script.setAttribute((attr = attrs[i]).name, attr.value);
-            }
-            return script;
-        }
-
-        this.nodeScriptIs = function (node) {
-            return node.tagName === 'SCRIPT';
-        }
-    })()
-
-    window.call_DataFrame = function (f) {
-        return f();
-    };
-
-    let funQueue = window["kotlinQueues"] && window["kotlinQueues"]["DataFrame"];
-    if (funQueue) {
-        funQueue.forEach(function (f) {
-            f();
-        });
-        funQueue = [];
-    }
-})()
-
-/*<!--*/
-call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"user: String\">user</span>", children: [], rightAlign: false, values: ["Alice","Bob"] }, 
-{ name: "<span title=\"orders: DataFrame<*>\">orders</span>", children: [], rightAlign: false, values: [{ frameId: -1140850687, value: "<b>DataFrame 2 x 2</b>" },{ frameId: -1140850686, value: "<b>DataFrame 3 x 2</b>" }] }, 
-], id: -1140850688, rootId: -1140850688, totalRows: 2 } ) });
-/*-->*/
-
-/*<!--*/
-call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"orderId: Int\">orderId</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">101</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">102</span></span>"] }, 
-{ name: "<span title=\"amount: Double\">amount</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">50.0</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">75.5</span></span>"] }, 
-], id: -1140850687, rootId: -1140850688, totalRows: 2 } ) });
-/*-->*/
-
-/*<!--*/
-call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"orderId: Int\">orderId</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">103</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">104</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">105</span></span>"] }, 
-{ name: "<span title=\"amount: Double\">amount</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">20.0</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">30.0</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">25.0</span></span>"] }, 
-], id: -1140850686, rootId: -1140850688, totalRows: 3 } ) });
-/*-->*/
-
-call_DataFrame(function() { DataFrame.renderTable(-1140850688) });
-
-        function sendHeight() {
-    const table = document.querySelector('table.dataframe');
-    if (!table) return;
-
-    const thead = table.querySelector('thead');
-    const tbody = table.querySelector('tbody');
-    if (!thead || !tbody || tbody.children.length === 0) return;
-
-    let height = thead.offsetHeight;
-    const rows = tbody.querySelectorAll('tr');
-    for (let i = 0; i < Math.min(rows.length, 5); i++) {
-        height += rows[i].offsetHeight;
-    }
-
-    const margin = parseFloat(getComputedStyle(table).marginTop) +
-                   parseFloat(getComputedStyle(table).marginBottom);
-
-    const totalHeight = Math.ceil(height + margin + 10);
-
-    window.parent.postMessage({ type: 'iframeHeight', height: totalHeight }, '*');
-}
-
-function repeatHeightCalculation(maxRetries = 10, interval = 100) {
-    let retries = 0;
-    const intervalId = setInterval(() => {
-        sendHeight();
-        retries++;
-        if (retries >= maxRetries) clearInterval(intervalId);
-    }, interval);
-}
-
-window.addEventListener('load', repeatHeightCalculation);
-
-const observer = new MutationObserver(sendHeight);
-observer.observe(document.querySelector('.dataframe'), {
-    childList: true,
-    subtree: true,
-    characterData: true
-});
-
-</script>
-</html>
diff --git a/tests/src/test/kotlin/org/jetbrains/kotlinx/dataframe/samples/api/Generate.kt b/tests/src/test/kotlin/org/jetbrains/kotlinx/dataframe/samples/api/Generate.kt
index d02d2fa355..fcf1be9419 100644
--- a/tests/src/test/kotlin/org/jetbrains/kotlinx/dataframe/samples/api/Generate.kt
+++ b/tests/src/test/kotlin/org/jetbrains/kotlinx/dataframe/samples/api/Generate.kt
@@ -14,10 +14,10 @@ import org.jetbrains.kotlinx.dataframe.api.into
 import org.jetbrains.kotlinx.dataframe.api.rename
 import org.jetbrains.kotlinx.dataframe.api.sumOf
 import org.jetbrains.kotlinx.dataframe.api.toList
-import org.jetbrains.kotlinx.kandy.letsplot.samples.SampleHelper
+import org.jetbrains.kotlinx.dataframe.samples.DataFrameSampleHelper
 import org.junit.Test
 
-class Generate : SampleHelper("generate_docs", "api") {
+class Generate : DataFrameSampleHelper("generate_docs", "api") {
     val ordersAlice = dataFrameOf(
         "orderId" to listOf(101, 102),
         "amount" to listOf(50.0, 75.5)

From 5eeca4a792dc94b34f2756c168c11fd2cf70163b Mon Sep 17 00:00:00 2001
From: "andrei.kislitsyn" <kisandy@yandex.ru>
Date: Wed, 14 May 2025 15:52:21 +0400
Subject: [PATCH 3/8] add df iframe for generate utilities

---
 .../notebook_test_generate_docs_1.html        | 520 ++++++++++++++++++
 1 file changed, 520 insertions(+)
 create mode 100644 docs/StardustDocs/resources/api/generate_docs/notebook_test_generate_docs_1.html

diff --git a/docs/StardustDocs/resources/api/generate_docs/notebook_test_generate_docs_1.html b/docs/StardustDocs/resources/api/generate_docs/notebook_test_generate_docs_1.html
new file mode 100644
index 0000000000..af5795ad21
--- /dev/null
+++ b/docs/StardustDocs/resources/api/generate_docs/notebook_test_generate_docs_1.html
@@ -0,0 +1,520 @@
+<html>
+<head>
+<style type="text/css">
+:root {
+    --background: #fff;
+    --background-odd: #f5f5f5;
+    --background-hover: #d9edfd;
+    --header-text-color: #474747;
+    --text-color: #848484;
+    --text-color-dark: #000;
+    --text-color-medium: #737373;
+    --text-color-pale: #b3b3b3;
+    --inner-border-color: #aaa;
+    --bold-border-color: #000;
+    --link-color: #296eaa;
+    --link-color-pale: #296eaa;
+    --link-hover: #1a466c;
+}
+
+:root[theme="dark"], :root [data-jp-theme-light="false"], .dataframe_dark{
+    --background: #303030;
+    --background-odd: #3c3c3c;
+    --background-hover: #464646;
+    --header-text-color: #dddddd;
+    --text-color: #b3b3b3;
+    --text-color-dark: #dddddd;
+    --text-color-medium: #b2b2b2;
+    --text-color-pale: #737373;
+    --inner-border-color: #707070;
+    --bold-border-color: #777777;
+    --link-color: #008dc0;
+    --link-color-pale: #97e1fb;
+    --link-hover: #00688e;
+}
+
+p.dataframe_description {
+    color: var(--text-color-dark);
+}
+
+table.dataframe {
+    font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
+    font-size: 12px;
+    background-color: var(--background);
+    color: var(--text-color-dark);
+    border: none;
+    border-collapse: collapse;
+}
+
+table.dataframe th, td {
+    padding: 6px;
+    border: 1px solid transparent;
+    text-align: left;
+}
+
+table.dataframe th {
+    background-color: var(--background);
+    color: var(--header-text-color);
+}
+
+table.dataframe td {
+    vertical-align: top;
+    white-space: nowrap;
+}
+
+table.dataframe th.bottomBorder {
+    border-bottom-color: var(--bold-border-color);
+}
+
+table.dataframe tbody > tr:nth-child(odd) {
+    background: var(--background-odd);
+}
+
+table.dataframe tbody > tr:nth-child(even) {
+    background: var(--background);
+}
+
+table.dataframe tbody > tr:hover {
+    background: var(--background-hover);
+}
+
+table.dataframe a {
+    cursor: pointer;
+    color: var(--link-color);
+    text-decoration: none;
+}
+
+table.dataframe tr:hover > td a {
+    color: var(--link-color-pale);
+}
+
+table.dataframe a:hover {
+    color: var(--link-hover);
+    text-decoration: underline;
+}
+
+table.dataframe img {
+    max-width: fit-content;
+}
+
+table.dataframe th.complex {
+    background-color: var(--background);
+    border: 1px solid var(--background);
+}
+
+table.dataframe .leftBorder {
+    border-left-color: var(--inner-border-color);
+}
+
+table.dataframe .rightBorder {
+    border-right-color: var(--inner-border-color);
+}
+
+table.dataframe .rightAlign {
+    text-align: right;
+}
+
+table.dataframe .expanderSvg {
+    width: 8px;
+    height: 8px;
+    margin-right: 3px;
+}
+
+table.dataframe .expander {
+    display: flex;
+    align-items: center;
+}
+
+/* formatting */
+
+table.dataframe .null {
+    color: var(--text-color-pale);
+}
+
+table.dataframe .structural {
+    color: var(--text-color-medium);
+    font-weight: bold;
+}
+
+table.dataframe .dataFrameCaption {
+    font-weight: bold;
+}
+
+table.dataframe .numbers {
+    color: var(--text-color-dark);
+}
+
+table.dataframe td:hover .formatted .structural, .null {
+    color: var(--text-color-dark);
+}
+
+table.dataframe tr:hover .formatted .structural, .null {
+    color: var(--text-color-dark);
+}
+
+
+body {
+    font-family: "JetBrains Mono",SFMono-Regular,Consolas,"Liberation Mono",Menlo,Courier,monospace;
+}       
+
+:root {
+    color: #19191C;
+    background-color: #fff;
+}
+
+:root[theme="dark"] {
+    background-color: #19191C;
+    color: #FFFFFFCC
+}
+
+details details {
+    margin-left: 20px; 
+}
+
+summary {
+    padding: 6px;
+}
+</style>
+</head>
+<body>
+<table class="dataframe" id="df_117440512"></table>
+
+<p class="dataframe_description"></p>
+</body>
+<script>
+(function () {
+    window.DataFrame = window.DataFrame || new (function () {
+        this.addTable = function (df) {
+            let cols = df.cols;
+            for (let i = 0; i < cols.length; i++) {
+                for (let c of cols[i].children) {
+                    cols[c].parent = i;
+                }
+            }
+            df.nrow = 0
+            for (let i = 0; i < df.cols.length; i++) {
+                if (df.cols[i].values.length > df.nrow) df.nrow = df.cols[i].values.length
+            }
+            if (df.id === df.rootId) {
+                df.expandedFrames = new Set()
+                df.childFrames = {}
+                const table = this.getTableElement(df.id)
+                table.df = df
+                for (let i = 0; i < df.cols.length; i++) {
+                    let col = df.cols[i]
+                    if (col.parent === undefined && col.children.length > 0) col.expanded = true
+                }
+            } else {
+                const rootDf = this.getTableData(df.rootId)
+                rootDf.childFrames[df.id] = df
+            }
+        }
+
+        this.computeRenderData = function (df) {
+            let result = []
+            let pos = 0
+            for (let col = 0; col < df.cols.length; col++) {
+                if (df.cols[col].parent === undefined)
+                    pos += this.computeRenderDataRec(df.cols, col, pos, 0, result, false, false)
+            }
+            for (let i = 0; i < result.length; i++) {
+                let row = result[i]
+                for (let j = 0; j < row.length; j++) {
+                    let cell = row[j]
+                    if (j === 0)
+                        cell.leftBd = false
+                    if (j < row.length - 1) {
+                        let nextData = row[j + 1]
+                        if (nextData.leftBd) cell.rightBd = true
+                        else if (cell.rightBd) nextData.leftBd = true
+                    } else cell.rightBd = false
+                }
+            }
+            return result
+        }
+
+        this.computeRenderDataRec = function (cols, colId, pos, depth, result, leftBorder, rightBorder) {
+            if (result.length === depth) {
+                const array = [];
+                if (pos > 0) {
+                    let j = 0
+                    for (let i = 0; j < pos; i++) {
+                        let c = result[depth - 1][i]
+                        j += c.span
+                        let copy = Object.assign({empty: true}, c)
+                        array.push(copy)
+                    }
+                }
+                result.push(array)
+            }
+            const col = cols[colId];
+            let size = 0;
+            if (col.expanded) {
+                let childPos = pos
+                for (let i = 0; i < col.children.length; i++) {
+                    let child = col.children[i]
+                    let childLeft = i === 0 && (col.children.length > 1 || leftBorder)
+                    let childRight = i === col.children.length - 1 && (col.children.length > 1 || rightBorder)
+                    let childSize = this.computeRenderDataRec(cols, child, childPos, depth + 1, result, childLeft, childRight)
+                    childPos += childSize
+                    size += childSize
+                }
+            } else {
+                for (let i = depth + 1; i < result.length; i++)
+                    result[i].push({id: colId, span: 1, leftBd: leftBorder, rightBd: rightBorder, empty: true})
+                size = 1
+            }
+            let left = leftBorder
+            let right = rightBorder
+            if (size > 1) {
+                left = true
+                right = true
+            }
+            result[depth].push({id: colId, span: size, leftBd: left, rightBd: right})
+            return size
+        }
+
+        this.getTableElement = function (id) {
+            return document.getElementById("df_" + id)
+        }
+
+        this.getTableData = function (id) {
+            return this.getTableElement(id).df
+        }
+
+        this.createExpander = function (isExpanded) {
+            const svgNs = "http://www.w3.org/2000/svg"
+            let svg = document.createElementNS(svgNs, "svg")
+            svg.classList.add("expanderSvg")
+            let path = document.createElementNS(svgNs, "path")
+            if (isExpanded) {
+                svg.setAttribute("viewBox", "0 -2 8 8")
+                path.setAttribute("d", "M1 0 l-1 1 4 4 4 -4 -1 -1 -3 3Z")
+            } else {
+                svg.setAttribute("viewBox", "-2 0 8 8")
+                path.setAttribute("d", "M1 0 l-1 1 3 3 -3 3 1 1 4 -4Z")
+            }
+            path.setAttribute("fill", "currentColor")
+            svg.appendChild(path)
+            return svg
+        }
+
+        this.renderTable = function (id) {
+
+            let table = this.getTableElement(id)
+
+            if (table === null) return
+
+            table.innerHTML = ""
+
+            let df = table.df
+            let rootDf = df.rootId === df.id ? df : this.getTableData(df.rootId)
+
+            // header
+            let header = document.createElement("thead")
+            table.appendChild(header)
+
+            let renderData = this.computeRenderData(df)
+            for (let j = 0; j < renderData.length; j++) {
+                let rowData = renderData[j]
+                let tr = document.createElement("tr");
+                let isLastRow = j === renderData.length - 1
+                header.appendChild(tr);
+                for (let i = 0; i < rowData.length; i++) {
+                    let cell = rowData[i]
+                    let th = document.createElement("th");
+                    th.setAttribute("colspan", cell.span)
+                    let colId = cell.id
+                    let col = df.cols[colId];
+                    if (!cell.empty) {
+                        if (col.children.length === 0) {
+                            th.innerHTML = col.name
+                        } else {
+                            let link = document.createElement("a")
+                            link.className = "expander"
+                            let that = this
+                            link.onclick = function () {
+                                col.expanded = !col.expanded
+                                that.renderTable(id)
+                            }
+                            link.appendChild(this.createExpander(col.expanded))
+                            link.innerHTML += col.name
+                            th.appendChild(link)
+                        }
+                    }
+                    let classes = (cell.leftBd ? " leftBorder" : "") + (cell.rightBd ? " rightBorder" : "")
+                    if (col.rightAlign)
+                        classes += " rightAlign"
+                    if (isLastRow)
+                        classes += " bottomBorder"
+                    if (classes.length > 0)
+                        th.setAttribute("class", classes)
+                    tr.appendChild(th)
+                }
+            }
+
+            // body
+            let body = document.createElement("tbody")
+            table.appendChild(body)
+
+            let columns = renderData.pop()
+            for (let row = 0; row < df.nrow; row++) {
+                let tr = document.createElement("tr");
+                body.appendChild(tr)
+                for (let i = 0; i < columns.length; i++) {
+                    let cell = columns[i]
+                    let td = document.createElement("td");
+                    let colId = cell.id
+                    let col = df.cols[colId]
+                    let classes = (cell.leftBd ? " leftBorder" : "") + (cell.rightBd ? " rightBorder" : "")
+                    if (col.rightAlign)
+                        classes += " rightAlign"
+                    if (classes.length > 0)
+                        td.setAttribute("class", classes)
+                    tr.appendChild(td)
+                    let value = col.values[row]
+                    if (value.frameId !== undefined) {
+                        let frameId = value.frameId
+                        let expanded = rootDf.expandedFrames.has(frameId)
+                        let link = document.createElement("a")
+                        link.className = "expander"
+                        let that = this
+                        link.onclick = function () {
+                            if (rootDf.expandedFrames.has(frameId))
+                                rootDf.expandedFrames.delete(frameId)
+                            else rootDf.expandedFrames.add(frameId)
+                            that.renderTable(id)
+                        }
+                        link.appendChild(this.createExpander(expanded))
+                        link.innerHTML += value.value
+                        if (expanded) {
+                            td.appendChild(link)
+                            td.appendChild(document.createElement("p"))
+                            const childTable = document.createElement("table")
+                            childTable.className = "dataframe"
+                            childTable.id = "df_" + frameId
+                            let childDf = rootDf.childFrames[frameId]
+                            childTable.df = childDf
+                            td.appendChild(childTable)
+                            this.renderTable(frameId)
+                            if (childDf.nrow !== childDf.totalRows) {
+                                const footer = document.createElement("p")
+                                footer.innerText = `... showing only top ${childDf.nrow} of ${childDf.totalRows} rows`
+                                td.appendChild(footer)
+                            }
+                        } else {
+                            td.appendChild(link)
+                        }
+                    } else if (value.style !== undefined) {
+                        td.innerHTML = value.value
+                        td.setAttribute("style", value.style)
+                    } else td.innerHTML = value
+                    this.nodeScriptReplace(td)
+                }
+            }
+        }
+
+        this.nodeScriptReplace = function (node) {
+            if (this.nodeScriptIs(node) === true) {
+                node.parentNode.replaceChild(this.nodeScriptClone(node), node);
+            } else {
+                let i = -1, children = node.childNodes;
+                while (++i < children.length) {
+                    this.nodeScriptReplace(children[i]);
+                }
+            }
+
+            return node;
+        }
+
+        this.nodeScriptClone = function (node) {
+            let script = document.createElement("script");
+            script.text = node.innerHTML;
+
+            let i = -1, attrs = node.attributes, attr;
+            while (++i < attrs.length) {
+                script.setAttribute((attr = attrs[i]).name, attr.value);
+            }
+            return script;
+        }
+
+        this.nodeScriptIs = function (node) {
+            return node.tagName === 'SCRIPT';
+        }
+    })()
+
+    window.call_DataFrame = function (f) {
+        return f();
+    };
+
+    let funQueue = window["kotlinQueues"] && window["kotlinQueues"]["DataFrame"];
+    if (funQueue) {
+        funQueue.forEach(function (f) {
+            f();
+        });
+        funQueue = [];
+    }
+})()
+
+/*<!--*/
+call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"user: String\">user</span>", children: [], rightAlign: false, values: ["Alice","Bob"] }, 
+{ name: "<span title=\"orders: DataFrame<*>\">orders</span>", children: [], rightAlign: false, values: [{ frameId: 117440513, value: "<b>DataFrame 2 x 2</b>" },{ frameId: 117440514, value: "<b>DataFrame 3 x 2</b>" }] }, 
+], id: 117440512, rootId: 117440512, totalRows: 2 } ) });
+/*-->*/
+
+/*<!--*/
+call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"orderId: Int\">orderId</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">101</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">102</span></span>"] }, 
+{ name: "<span title=\"amount: Double\">amount</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">50.0</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">75.5</span></span>"] }, 
+], id: 117440513, rootId: 117440512, totalRows: 2 } ) });
+/*-->*/
+
+/*<!--*/
+call_DataFrame(function() { DataFrame.addTable({ cols: [{ name: "<span title=\"orderId: Int\">orderId</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">103</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">104</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">105</span></span>"] }, 
+{ name: "<span title=\"amount: Double\">amount</span>", children: [], rightAlign: true, values: ["<span class=\"formatted\" title=\"\"><span class=\"numbers\">20.0</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">30.0</span></span>","<span class=\"formatted\" title=\"\"><span class=\"numbers\">25.0</span></span>"] }, 
+], id: 117440514, rootId: 117440512, totalRows: 3 } ) });
+/*-->*/
+
+call_DataFrame(function() { DataFrame.renderTable(117440512) });
+
+        function sendHeight() {
+    const table = document.querySelector('table.dataframe');
+    if (!table) return;
+
+    const thead = table.querySelector('thead');
+    const tbody = table.querySelector('tbody');
+    if (!thead || !tbody || tbody.children.length === 0) return;
+
+    let height = thead.offsetHeight;
+    const rows = tbody.querySelectorAll('tr');
+    for (let i = 0; i < Math.min(rows.length, 5); i++) {
+        height += rows[i].offsetHeight;
+    }
+
+    const margin = parseFloat(getComputedStyle(table).marginTop) +
+                   parseFloat(getComputedStyle(table).marginBottom);
+
+    const totalHeight = Math.ceil(height + margin + 10);
+
+    window.parent.postMessage({ type: 'iframeHeight', height: totalHeight }, '*');
+}
+
+function repeatHeightCalculation(maxRetries = 10, interval = 100) {
+    let retries = 0;
+    const intervalId = setInterval(() => {
+        sendHeight();
+        retries++;
+        if (retries >= maxRetries) clearInterval(intervalId);
+    }, interval);
+}
+
+window.addEventListener('load', repeatHeightCalculation);
+
+const observer = new MutationObserver(sendHeight);
+observer.observe(document.querySelector('.dataframe'), {
+    childList: true,
+    subtree: true,
+    characterData: true
+});
+
+</script>
+</html>

From bf07e43072d062cbd99ff3ff1f5bd2eb4c59cfad Mon Sep 17 00:00:00 2001
From: "andrei.kislitsyn" <kisandy@yandex.ru>
Date: Wed, 14 May 2025 15:54:25 +0400
Subject: [PATCH 4/8] fix shadow resources

---
 docs/StardustDocs/topics/_shadow_resources.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/StardustDocs/topics/_shadow_resources.md b/docs/StardustDocs/topics/_shadow_resources.md
index 7b6832503b..5bb11025ad 100644
--- a/docs/StardustDocs/topics/_shadow_resources.md
+++ b/docs/StardustDocs/topics/_shadow_resources.md
@@ -159,3 +159,4 @@
 <resource src="notebook_test_quickstart_12.html"></resource>
 <resource src="notebook_test_quickstart_3.html"></resource>
 <resource src="notebook_test_quickstart_14.html"></resource>
+<resource src="notebook_test_generate_docs_1.html"></resource>

From 1c8064ae74d15d7877a0fa5050efd3fa68cf7ee1 Mon Sep 17 00:00:00 2001
From: "andrei.kislitsyn" <kisandy@yandex.ru>
Date: Wed, 14 May 2025 15:57:38 +0400
Subject: [PATCH 5/8] fix Utilities-Generation topic

---
 docs/StardustDocs/topics/Utilities-Generation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/StardustDocs/topics/Utilities-Generation.md b/docs/StardustDocs/topics/Utilities-Generation.md
index 5b44d16172..a7fc297084 100644
--- a/docs/StardustDocs/topics/Utilities-Generation.md
+++ b/docs/StardustDocs/topics/Utilities-Generation.md
@@ -34,7 +34,7 @@ in cases where the schema cannot be inferred automatically from the source.
 * `CodeString` – A value class wrapper for `String`, containing  
   the generated Kotlin code of `@DataSchema` interfaces without extension properties.
 
-### Examples {id="generateInterfaces-examples"}}
+### Examples {id="generateInterfaces-examples"}
 
 
 <!---FUN notebook_test_generate_docs_1-->

From 5aecd8896cc0b213fb2f9e50d48f548c9c19a007 Mon Sep 17 00:00:00 2001
From: "andrei.kislitsyn" <kisandy@yandex.ru>
Date: Wed, 14 May 2025 16:34:09 +0400
Subject: [PATCH 6/8] added function signatures

---
 .../topics/Utilities-Generation.md            | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/docs/StardustDocs/topics/Utilities-Generation.md b/docs/StardustDocs/topics/Utilities-Generation.md
index a7fc297084..d762ae06e2 100644
--- a/docs/StardustDocs/topics/Utilities-Generation.md
+++ b/docs/StardustDocs/topics/Utilities-Generation.md
@@ -20,6 +20,12 @@ based on the current `DataFrame` schema.
 
 ## generateInterfaces
 
+```kotlin
+inline fun <reified T> DataFrame<T>.generateInterfaces(): CodeString
+
+fun <T> DataFrame<T>.generateInterfaces(markerName: String): CodeString
+```
+
 Generates [`@DataSchema`](schemas.md) interfaces for this `DataFrame` 
 (including all nested `DataFrame` columns and column groups) as Kotlin interfaces.
 
@@ -87,6 +93,16 @@ df.cast<_DataFrameType1>().filter { orders.all { orderId >= 102 } }
 
 ## generateDataClasses
 
+```kotlin
+inline fun <reified T> DataFrame<T>.generateDataClasses(
+    markerName: String? = null,
+    extensionProperties: Boolean = false,
+    visibility: MarkerVisibility = MarkerVisibility.IMPLICIT_PUBLIC,
+    useFqNames: Boolean = false,
+    nameNormalizer: NameNormalizer = NameNormalizer.default,
+): CodeString
+```
+
 Generates Kotlin data classes corresponding to the `DataFrame` schema 
 (including all nested `DataFrame` columns and column groups).
 
@@ -152,6 +168,20 @@ val customers: List<Customer> = df.cast<Customer>().toList()
 
 ## generateCode
 
+```kotlin
+inline fun <reified T> DataFrame<T>.generateCode(
+    fields: Boolean = true,
+    extensionProperties: Boolean = true,
+): CodeString
+
+fun <T> DataFrame<T>.generateCode(
+    markerName: String,
+    fields: Boolean = true,
+    extensionProperties: Boolean = true,
+    visibility: MarkerVisibility = MarkerVisibility.IMPLICIT_PUBLIC,
+): CodeString
+```
+
 Generates a data schema interface as [`generateInterfaces()`](#generateinterfaces),  
 along with explicit [extension properties](extensionPropertiesApi.md). 
 Useful if you don't use the [compiler plugin](Compiler-Plugin.md).

From 76c6d7ed94391787c21fbb66b65ae63c8a2040c5 Mon Sep 17 00:00:00 2001
From: "andrei.kislitsyn" <kisandy@yandex.ru>
Date: Wed, 14 May 2025 16:43:39 +0400
Subject: [PATCH 7/8] small md list fix

---
 docs/StardustDocs/topics/Utilities-Generation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/StardustDocs/topics/Utilities-Generation.md b/docs/StardustDocs/topics/Utilities-Generation.md
index d762ae06e2..7bfc1867ab 100644
--- a/docs/StardustDocs/topics/Utilities-Generation.md
+++ b/docs/StardustDocs/topics/Utilities-Generation.md
@@ -111,7 +111,7 @@ Useful when you want to:
 - Work with the data as regular Kotlin data classes.
 - Work with data classes serialization.
 - Extract structured types for further use in your application.
-- 
+
 ### Arguments {id="generateDataClasses-arguments"}
 * `markerName`: `String?` — The base name to use for generated data classes.  
   If `null`, uses the `T` type argument of `DataFrame` simple name.  

From 5578c5b38a0740521fbefc970ab6b0d59fa1c432 Mon Sep 17 00:00:00 2001
From: "andrei.kislitsyn" <kisandy@yandex.ru>
Date: Wed, 14 May 2025 17:03:13 +0400
Subject: [PATCH 8/8] rename and move generation topic

---
 .../explainer/SamplesRenderingUtils.kt        |  2 +-
 docs/StardustDocs/d.tree                      |  2 +-
 ... => DataSchema-Data-Classes-Generation.md} |  2 +-
 .../kotlinx/dataframe/samples/api/Generate.kt | 95 +++++++++++--------
 4 files changed, 59 insertions(+), 42 deletions(-)
 rename docs/StardustDocs/topics/{Utilities-Generation.md => DataSchema-Data-Classes-Generation.md} (99%)

diff --git a/core/src/test/kotlin/org/jetbrains/kotlinx/dataframe/explainer/SamplesRenderingUtils.kt b/core/src/test/kotlin/org/jetbrains/kotlinx/dataframe/explainer/SamplesRenderingUtils.kt
index 28e7205354..0ec2122ed0 100644
--- a/core/src/test/kotlin/org/jetbrains/kotlinx/dataframe/explainer/SamplesRenderingUtils.kt
+++ b/core/src/test/kotlin/org/jetbrains/kotlinx/dataframe/explainer/SamplesRenderingUtils.kt
@@ -96,7 +96,7 @@ allObservedTables.forEach((table) => {
         characterData: true,
     });
 });
-        """.trimIndent()
+        """.trimIndent(),
 )
 
 val WritersideFooter: (DataFrame<*>) -> String = { "" }
diff --git a/docs/StardustDocs/d.tree b/docs/StardustDocs/d.tree
index 3db96f109d..467e28eeb8 100644
--- a/docs/StardustDocs/d.tree
+++ b/docs/StardustDocs/d.tree
@@ -191,12 +191,12 @@
             <toc-element topic="format.md"/>
             <toc-element topic="jupyterRendering.md"/>
         </toc-element>
-        <toc-element topic="Utilities-Generation.md"/>
     </toc-element>
     <toc-element topic="gradleReference.md"/>
     <toc-element topic="Usage-with-Kotlin-Notebook-Plugin.md">
         <toc-element topic="Trobleshooting.md"/>
     </toc-element>
     <toc-element topic="Compiler-Plugin.md"/>
+    <toc-element topic="DataSchema-Data-Classes-Generation.md"/>
     <toc-element topic="_shadow_resources.md" hidden="true"/>
 </instance-profile>
diff --git a/docs/StardustDocs/topics/Utilities-Generation.md b/docs/StardustDocs/topics/DataSchema-Data-Classes-Generation.md
similarity index 99%
rename from docs/StardustDocs/topics/Utilities-Generation.md
rename to docs/StardustDocs/topics/DataSchema-Data-Classes-Generation.md
index 7bfc1867ab..33972aa1b3 100644
--- a/docs/StardustDocs/topics/Utilities-Generation.md
+++ b/docs/StardustDocs/topics/DataSchema-Data-Classes-Generation.md
@@ -1,4 +1,4 @@
-# Utilities Generation
+# Data Schemas/Data Classes Generation
 
 <web-summary>
 Generate useful Kotlin definitions based on your DataFrame structure.
diff --git a/tests/src/test/kotlin/org/jetbrains/kotlinx/dataframe/samples/api/Generate.kt b/tests/src/test/kotlin/org/jetbrains/kotlinx/dataframe/samples/api/Generate.kt
index fcf1be9419..cde85c0a70 100644
--- a/tests/src/test/kotlin/org/jetbrains/kotlinx/dataframe/samples/api/Generate.kt
+++ b/tests/src/test/kotlin/org/jetbrains/kotlinx/dataframe/samples/api/Generate.kt
@@ -1,4 +1,5 @@
-@file:Suppress("UNUSED_VARIABLE", "unused", "UNCHECKED_CAST")
+@file:Suppress("UNUSED_VARIABLE", "unused", "UNCHECKED_CAST", "ktlint", "ClassName")
+
 package org.jetbrains.kotlinx.dataframe.samples.api
 
 import org.jetbrains.kotlinx.dataframe.annotations.DataSchema
@@ -20,17 +21,17 @@ import org.junit.Test
 class Generate : DataFrameSampleHelper("generate_docs", "api") {
     val ordersAlice = dataFrameOf(
         "orderId" to listOf(101, 102),
-        "amount" to listOf(50.0, 75.5)
+        "amount" to listOf(50.0, 75.5),
     )
 
     val ordersBob = dataFrameOf(
         "orderId" to listOf(103, 104, 105),
-        "amount" to listOf(20.0, 30.0, 25.0)
+        "amount" to listOf(20.0, 30.0, 25.0),
     )
 
     val df = dataFrameOf(
         "user" to listOf("Alice", "Bob"),
-        "orders" to listOf(ordersAlice, ordersBob)
+        "orders" to listOf(ordersAlice, ordersBob),
     )
 
     @DataSchema(isOpen = false)
@@ -41,14 +42,20 @@ class Generate : DataFrameSampleHelper("generate_docs", "api") {
 
     val org.jetbrains.kotlinx.dataframe.ColumnsContainer<_DataFrameType11>.amount: org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Double>
         @JvmName(
-            "_DataFrameType11_amount"
-        ) get() = this["amount"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Double>
-    val org.jetbrains.kotlinx.dataframe.DataRow<_DataFrameType11>.amount: kotlin.Double @JvmName("_DataFrameType11_amount") get() = this["amount"] as kotlin.Double
+            "_DataFrameType11_amount",
+        )
+        get() = this["amount"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Double>
+    val org.jetbrains.kotlinx.dataframe.DataRow<_DataFrameType11>.amount: kotlin.Double
+        @JvmName("_DataFrameType11_amount")
+        get() = this["amount"] as kotlin.Double
     val org.jetbrains.kotlinx.dataframe.ColumnsContainer<_DataFrameType11>.orderId: org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Int>
         @JvmName(
-            "_DataFrameType11_orderId"
-        ) get() = this["orderId"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Int>
-    val org.jetbrains.kotlinx.dataframe.DataRow<_DataFrameType11>.orderId: kotlin.Int @JvmName("_DataFrameType11_orderId") get() = this["orderId"] as kotlin.Int
+            "_DataFrameType11_orderId",
+        )
+        get() = this["orderId"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Int>
+    val org.jetbrains.kotlinx.dataframe.DataRow<_DataFrameType11>.orderId: kotlin.Int
+        @JvmName("_DataFrameType11_orderId")
+        get() = this["orderId"] as kotlin.Int
 
     @DataSchema
     interface _DataFrameType1 {
@@ -58,54 +65,64 @@ class Generate : DataFrameSampleHelper("generate_docs", "api") {
 
     val org.jetbrains.kotlinx.dataframe.ColumnsContainer<_DataFrameType1>.orders: org.jetbrains.kotlinx.dataframe.DataColumn<org.jetbrains.kotlinx.dataframe.DataFrame<_DataFrameType11>>
         @JvmName(
-            "_DataFrameType1_orders"
-        ) get() = this["orders"] as org.jetbrains.kotlinx.dataframe.DataColumn<org.jetbrains.kotlinx.dataframe.DataFrame<_DataFrameType11>>
+            "_DataFrameType1_orders",
+        )
+        get() = this["orders"] as org.jetbrains.kotlinx.dataframe.DataColumn<org.jetbrains.kotlinx.dataframe.DataFrame<_DataFrameType11>>
     val org.jetbrains.kotlinx.dataframe.DataRow<_DataFrameType1>.orders: org.jetbrains.kotlinx.dataframe.DataFrame<_DataFrameType11>
         @JvmName(
-            "_DataFrameType1_orders"
-        ) get() = this["orders"] as org.jetbrains.kotlinx.dataframe.DataFrame<_DataFrameType11>
+            "_DataFrameType1_orders",
+        )
+        get() = this["orders"] as org.jetbrains.kotlinx.dataframe.DataFrame<_DataFrameType11>
     val org.jetbrains.kotlinx.dataframe.ColumnsContainer<_DataFrameType1>.user: org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.String>
         @JvmName(
-            "_DataFrameType1_user"
-        ) get() = this["user"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.String>
-    val org.jetbrains.kotlinx.dataframe.DataRow<_DataFrameType1>.user: kotlin.String @JvmName("_DataFrameType1_user") get() = this["user"] as kotlin.String
+            "_DataFrameType1_user",
+        )
+        get() = this["user"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.String>
+    val org.jetbrains.kotlinx.dataframe.DataRow<_DataFrameType1>.user: kotlin.String
+        @JvmName("_DataFrameType1_user")
+        get() = this["user"] as kotlin.String
 
     @DataSchema
-    data class Customer1(
-        val amount: Double,
-        val orderId: Int
-    )
+    data class Customer1(val amount: Double, val orderId: Int)
 
     @DataSchema
-    data class Customer(
-        val orders: List<Customer1>,
-        val user: String
-    )
+    data class Customer(val orders: List<Customer1>, val user: String)
 
     val org.jetbrains.kotlinx.dataframe.ColumnsContainer<Customer1>.amount: org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Double>
         @JvmName(
-            "Customer1_amount"
-        ) get() = this["amount"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Double>
-    val org.jetbrains.kotlinx.dataframe.DataRow<Customer1>.amount: kotlin.Double @JvmName("Customer1_amount") get() = this["amount"] as kotlin.Double
+            "Customer1_amount",
+        )
+        get() = this["amount"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Double>
+    val org.jetbrains.kotlinx.dataframe.DataRow<Customer1>.amount: kotlin.Double
+        @JvmName("Customer1_amount")
+        get() = this["amount"] as kotlin.Double
     val org.jetbrains.kotlinx.dataframe.ColumnsContainer<Customer1>.orderId: org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Int>
         @JvmName(
-            "Customer1_orderId"
-        ) get() = this["orderId"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Int>
-    val org.jetbrains.kotlinx.dataframe.DataRow<Customer1>.orderId: kotlin.Int @JvmName("Customer1_orderId") get() = this["orderId"] as kotlin.Int
+            "Customer1_orderId",
+        )
+        get() = this["orderId"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.Int>
+    val org.jetbrains.kotlinx.dataframe.DataRow<Customer1>.orderId: kotlin.Int
+        @JvmName("Customer1_orderId")
+        get() = this["orderId"] as kotlin.Int
 
     val org.jetbrains.kotlinx.dataframe.ColumnsContainer<Customer>.orders: org.jetbrains.kotlinx.dataframe.DataColumn<org.jetbrains.kotlinx.dataframe.DataFrame<Customer1>>
         @JvmName(
-            "Customer_orders"
-        ) get() = this["orders"] as org.jetbrains.kotlinx.dataframe.DataColumn<org.jetbrains.kotlinx.dataframe.DataFrame<Customer1>>
+            "Customer_orders",
+        )
+        get() = this["orders"] as org.jetbrains.kotlinx.dataframe.DataColumn<org.jetbrains.kotlinx.dataframe.DataFrame<Customer1>>
     val org.jetbrains.kotlinx.dataframe.DataRow<Customer>.orders: org.jetbrains.kotlinx.dataframe.DataFrame<Customer1>
         @JvmName(
-            "Customer_orders"
-        ) get() = this["orders"] as org.jetbrains.kotlinx.dataframe.DataFrame<Customer1>
+            "Customer_orders",
+        )
+        get() = this["orders"] as org.jetbrains.kotlinx.dataframe.DataFrame<Customer1>
     val org.jetbrains.kotlinx.dataframe.ColumnsContainer<Customer>.user: org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.String>
         @JvmName(
-            "Customer_user"
-        ) get() = this["user"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.String>
-    val org.jetbrains.kotlinx.dataframe.DataRow<Customer>.user: kotlin.String @JvmName("Customer_user") get() = this["user"] as kotlin.String
+            "Customer_user",
+        )
+        get() = this["user"] as org.jetbrains.kotlinx.dataframe.DataColumn<kotlin.String>
+    val org.jetbrains.kotlinx.dataframe.DataRow<Customer>.user: kotlin.String
+        @JvmName("Customer_user")
+        get() = this["user"] as kotlin.String
 
     private val customers: List<Customer> = df.cast<Customer>().toList()
 
@@ -129,7 +146,7 @@ class Generate : DataFrameSampleHelper("generate_docs", "api") {
         // SampleStart
         df.cast<_DataFrameType1>().filter { orders.all { orderId >= 102 } }
         // SampleEnd
-        //.saveDfHtmlSample()
+        // .saveDfHtmlSample()
     }
 
     @Test