Automated commit of generated code

Author: github-actions[bot]

core/generated-sources/src/main/kotlin/org/jetbrains/kotlinx/dataframe/api/format.kt

@@ -19,7 +19,6 @@ import org.jetbrains.kotlinx.dataframe.columns.ColumnReference
 import org.jetbrains.kotlinx.dataframe.columns.toColumnSet
 import org.jetbrains.kotlinx.dataframe.dataTypes.IFRAME
 import org.jetbrains.kotlinx.dataframe.dataTypes.IMG
-import org.jetbrains.kotlinx.dataframe.documentation.ExportAsHtml
 import org.jetbrains.kotlinx.dataframe.documentation.SelectingColumns
 import org.jetbrains.kotlinx.dataframe.documentation.SelectingRows
 import org.jetbrains.kotlinx.dataframe.impl.api.MergedAttributes
@@ -34,6 +33,10 @@ import org.jetbrains.kotlinx.dataframe.io.toHtml
 import org.jetbrains.kotlinx.dataframe.io.toStandaloneHtml
 import org.jetbrains.kotlinx.dataframe.jupyter.RenderedContent.Companion.media
 import org.jetbrains.kotlinx.dataframe.util.DEPRECATED_ACCESS_API
+import org.jetbrains.kotlinx.dataframe.util.FORMATTING_DSL
+import org.jetbrains.kotlinx.dataframe.util.FORMATTING_DSL_REPLACE
+import org.jetbrains.kotlinx.dataframe.util.RGB_COLOR
+import org.jetbrains.kotlinx.dataframe.util.RGB_COLOR_REPLACE
 import kotlin.reflect.KProperty
 
 // region docs
@@ -214,82 +217,6 @@ internal interface FormatDocs {
      */
     interface Grammar {
 
-        /**
-         * ### Definitions:
-         * `cellFormatter: `[FormattingDsl][org.jetbrains.kotlinx.dataframe.api.FormatDocs.Grammar.FormattingDslGrammarDef]`.(cell: C) -> `[CellAttributes][org.jetbrains.kotlinx.dataframe.api.CellAttributes]`?`
-         *
-         *     
-         *
-         * `rowColFormatter: `[FormattingDsl][org.jetbrains.kotlinx.dataframe.api.FormatDocs.Grammar.FormattingDslGrammarDef]`.(row: `[DataRow][org.jetbrains.kotlinx.dataframe.DataRow]`<T>, col: `[DataColumn][org.jetbrains.kotlinx.dataframe.DataColumn]`<C>) -> `[CellAttributes][org.jetbrains.kotlinx.dataframe.api.CellAttributes]`?`
-         *
-         * ### Notation:
-         *
-         * [**format**][DataFrame.format]**`  {  `**[`columns`][SelectingColumns]**` }`**
-         *
-         * &nbsp;&nbsp;&nbsp;&nbsp;
-         * `[ `__`.`__[**`where`**][FormatClause.where]**`  {  `**[`filter`][SelectingRows.RowValueCondition]`: `[`RowValueFilter`][RowValueFilter]**`  }  `**`]`
-         *
-         * &nbsp;&nbsp;&nbsp;&nbsp;
-         * `[ `__`.`__[**`at`**][FormatClause.at]**`(`**`rowIndices: `[Collection][Collection]`<`[Int][Int]`> | `[IntRange][IntRange]` | `**`vararg`**` `[Int][Int]**`)`**` ]`
-         *
-         * &nbsp;&nbsp;&nbsp;&nbsp;
-         * `[ `__`.`__[**`notNull`**][FormatClause.notNull]**`()`**` ]`
-         *
-         * &nbsp;&nbsp;&nbsp;&nbsp;
-         * __`.`__[**`with`**][FormatClause.with]**`  {  `**[cellFormatter][org.jetbrains.kotlinx.dataframe.api.FormatDocs.Grammar.CellFormatterDef]**` }`**
-         *
-         * &nbsp;&nbsp;&nbsp;&nbsp;
-         * `| `__`.`__[**`notNull`**][FormatClause.notNull]**`  {  `**[cellFormatter][org.jetbrains.kotlinx.dataframe.api.FormatDocs.Grammar.CellFormatterDef]**` }`**
-         *
-         * &nbsp;&nbsp;&nbsp;&nbsp;
-         * `| `__`.`__[**`perRowCol`**][FormatClause.perRowCol]**`  {  `**[rowColFormatter][org.jetbrains.kotlinx.dataframe.api.FormatDocs.Grammar.RowColFormatterDef]**` }`**
-         *
-         * &nbsp;&nbsp;&nbsp;&nbsp;
-         * `| `__`.`__[**`linearBg`**][FormatClause.linearBg]**`(`**`from: `[Pair][Pair]`<`[Number][Number]`, `[RgbColor][RgbColor]`>`**`,`**` to: `[Pair][Pair]`<`[Number][Number]`, `[RgbColor][RgbColor]`>`**`)`**
-         *
-         * `[ `__`.`__[**format**][FormattedFrame.format]` ↺ ]`
-         *
-         * &nbsp;&nbsp;&nbsp;&nbsp;
-         *
-         * ## Formatting DSL Grammar
-         *
-         * ### Definitions:
-         * `cellAttributes: `[CellAttributes][org.jetbrains.kotlinx.dataframe.api.CellAttributes]
-         *
-         * &nbsp;&nbsp;&nbsp;&nbsp;
-         *
-         * `color: `[RgbColor][org.jetbrains.kotlinx.dataframe.api.RgbColor]
-         *
-         * ### Notation:
-         * _- Returning [CellAttributes][org.jetbrains.kotlinx.dataframe.api.CellAttributes]_:
-         *
-         * [cellAttributes][org.jetbrains.kotlinx.dataframe.api.FormatDocs.Grammar.CellAttributesDef]` `[**`and`**][org.jetbrains.kotlinx.dataframe.api.CellAttributes.and]` `[cellAttributes][org.jetbrains.kotlinx.dataframe.api.FormatDocs.Grammar.CellAttributesDef]
-         *
-         * `| `[**`italic`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.italic]`  |  `[**`bold`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.bold]`  |  `[**`underline`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.underline]
-         *
-         * `| `[**`background`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.background]**`(`**[color][org.jetbrains.kotlinx.dataframe.api.FormatDocs.Grammar.RgbColorDef]**`)`**
-         *
-         * `| `[**`background`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.background]**`(`**`r: `[Short][Short]**`,`**` g: `[Short][Short]**`,`**` b: `[Short][Short]**`)`**
-         *
-         * `| `[**`linearBg`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.linearBg]**`(`**`value: `[Number][Number]**`,`**` from: `[Pair][Pair]`<`[Number][Number]`, `[RgbColor][org.jetbrains.kotlinx.dataframe.api.RgbColor]`>`**`,`**` to: `[Pair][Pair]`<`[Number][Number]`, `[RgbColor][org.jetbrains.kotlinx.dataframe.api.RgbColor]`>`**`)`**
-         *
-         * `| `[**`textColor`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.textColor]**`(`**[color][org.jetbrains.kotlinx.dataframe.api.FormatDocs.Grammar.RgbColorDef]**`)`**
-         *
-         * `| `[**`textColor`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.textColor]**`(`**`r: `[Short][Short]**`,`**` g: `[Short][Short]**`,`**` b: `[Short][Short]**`)`**
-         *
-         * `| `[**`attr`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.attr]**`(`**`name: `[String][String]**`,`**` value: `[String][String]**`)`**
-         *
-         * _- Returning [RgbColor][org.jetbrains.kotlinx.dataframe.api.RgbColor]:_
-         *
-         * [**`black`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.black]`  |  `[**`white`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.white]`  |  `[**`green`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.green]`  |  `[**`red`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.red]`  |  `[**`blue`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.blue]`  |  `[**`gray`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.gray]`  |  `[**`darkGray`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.darkGray]`  |  `[**`lightGray`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.lightGray]
-         *
-         * `| `[**`rgb`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.rgb]**`(`**`r: `[Short][Short]**`,`**` g: `[Short][Short]**`,`**` b: `[Short][Short]**`)`**
-         *
-         * `| `[**`linear`**][org.jetbrains.kotlinx.dataframe.api.FormattingDsl.linear]**`(`**`value: `[Number][Number]**`,`**` from: `[Pair][Pair]`<`[Number][Number]`, `[RgbColor][org.jetbrains.kotlinx.dataframe.api.RgbColor]`>`**`,`**` to: `[Pair][Pair]`<`[Number][Number]`, `[RgbColor][org.jetbrains.kotlinx.dataframe.api.RgbColor]`>`**`)`**
-         */
-        @ExportAsHtml
-        interface ForHtml
-
         /**
          * ## Formatting DSL Grammar
          *
@@ -1134,14 +1061,18 @@ public typealias CellFormatter<C> = FormattingDsl.(cell: C) -> CellAttributes?
  *
  * Call [toHtml] or [toStandaloneHtml] to get the HTML representation of the [DataFrame].
  *
+ * In Jupyter kernel (Kotlin Notebook) environments, you can often output this class directly.
+ * Use [toHtml] or [toStandaloneHtml] when this produces unexpected results.
+ *
  * You can apply further formatting to this [FormattedFrame] by calling [format()][FormattedFrame.format] once again.
  */
 public class FormattedFrame<T>(internal val df: DataFrame<T>, internal val formatter: RowColFormatter<T, *>? = null) {
 
     /**
      * Returns a [DataFrameHtmlData] without additional definitions.
-     * Can be rendered in Jupyter kernel (Notebook) environments or other environments that already have
+     * Can be rendered in Jupyter kernel (Kotlin Notebook) environments or other environments that already have
      * CSS- and script definitions for DataFrame.
+     *
      * Use [toStandaloneHtml] if you need the [DataFrameHtmlData] to include CSS- and script definitions.
      *
      * By default, cell content is formatted as text
@@ -1157,6 +1088,8 @@ public class FormattedFrame<T>(internal val df: DataFrame<T>, internal val forma
     /**
      * Returns a [DataFrameHtmlData] with CSS- and script definitions for DataFrame.
      *
+     * Use [toHtml] if you don't need the [DataFrameHtmlData] to include CSS- and script definitions.
+     *
      * The [DataFrameHtmlData] can be saved as an *.html file and displayed in the browser.
      * If you save it as a file and find it in the project tree,
      * the ["Open in browser"](https://www.jetbrains.com/help/idea/editing-html-files.html#ws_html_preview_output_procedure)
@@ -1165,6 +1098,10 @@ public class FormattedFrame<T>(internal val df: DataFrame<T>, internal val forma
      * By default, cell content is formatted as text
      * Use [RenderedContent.media][media] or [IMG], [IFRAME] if you need custom HTML inside a cell.
      *
+     * __NOTE:__ In Kotlin Notebook, output [FormattedFrame] directly, or use [toHtml],
+     * as that environment already has CSS- and script definitions for DataFrame.
+     * Using [toStandaloneHtml] might produce unexpected results.
+     *
      * @param [configuration] The [DisplayConfiguration] to use as a base for this [FormattedFrame].
      *   Default: [DisplayConfiguration.DEFAULT].
      * @see toHtml
@@ -1213,3 +1150,21 @@ public class FormatClause<T, C>(
 }
 
 // endregion
+
+// region Deprecated
+
+@Deprecated(
+    message = FORMATTING_DSL,
+    replaceWith = ReplaceWith(FORMATTING_DSL_REPLACE),
+    level = DeprecationLevel.ERROR,
+)
+public typealias FormattingDSL = FormattingDsl
+
+@Deprecated(
+    message = RGB_COLOR,
+    replaceWith = ReplaceWith(RGB_COLOR_REPLACE),
+    level = DeprecationLevel.ERROR,
+)
+public typealias RGBColor = RgbColor
+
+// endregion

core/generated-sources/src/main/kotlin/org/jetbrains/kotlinx/dataframe/io/html.kt

@@ -559,17 +559,30 @@ public fun <T> DataFrame<T>.toStandaloneHTML(
 ): DataFrameHtmlData = toStandaloneHtml(configuration, cellRenderer, getFooter)
 
 /**
- * By default, cell content is formatted as text
- * Use [RenderedContent.media] or [IMG], [IFRAME] if you need custom HTML inside a cell.
+ * Returns a [DataFrameHtmlData] with CSS- and script definitions for DataFrame.
  *
  * To change the formatting of certain cells or columns in the dataframe,
  * use [DataFrame.format].
  *
+ * Use [toHtml] if you don't need the [DataFrameHtmlData] to include CSS- and script definitions.
+ *
  * The [DataFrameHtmlData] can be saved as an *.html file and displayed in the browser.
  * If you save it as a file and find it in the project tree,
  * the ["Open in browser"](https://www.jetbrains.com/help/idea/editing-html-files.html#ws_html_preview_output_procedure)
  * feature of IntelliJ IDEA will automatically reload the file content when it's updated.
- * @return DataFrameHtmlData with table script and css definitions
+ *
+ * By default, cell content is formatted as text
+ * Use [RenderedContent.media] or [IMG], [IFRAME] if you need custom HTML inside a cell.
+ *
+ * __NOTE:__ In Kotlin Notebook, output [DataFrame] directly, or use [toHtml],
+ * as that environment already has CSS- and script definitions for DataFrame.
+ * Using [toStandaloneHtml] might produce unexpected results.
+ *
+ * @param [configuration] The [DisplayConfiguration] to use. Default: [DisplayConfiguration.DEFAULT].
+ * @param [cellRenderer] Mostly for internal usage, use [DefaultCellRenderer] if unsure.
+ * @param [getFooter] Allows you to specify how to render the footer text beneath the dataframe.
+ *   Default: `"DataFrame [rows x cols]"`
+ * @see toHtml
  */
 public fun <T> DataFrame<T>.toStandaloneHtml(
     configuration: DisplayConfiguration = DisplayConfiguration.DEFAULT,
@@ -578,13 +591,23 @@ public fun <T> DataFrame<T>.toStandaloneHtml(
 ): DataFrameHtmlData = toHtml(configuration, cellRenderer, getFooter).withTableDefinitions()
 
 /**
- * By default, cell content is formatted as text
- * Use [RenderedContent.media] or [IMG], [IFRAME] if you need custom HTML inside a cell.
+ * Returns a [DataFrameHtmlData] without additional definitions.
+ * Can be rendered in Jupyter kernel (Kotlin Notebook) environments or other environments that already have
+ * CSS- and script definitions for DataFrame.
  *
  * To change the formatting of certain cells or columns in the dataframe,
  * use [DataFrame.format].
  *
- * @return DataFrameHtmlData without additional definitions. Can be rendered in Jupyter kernel environments
+ * Use [toStandaloneHtml] if you need the [DataFrameHtmlData] to include CSS- and script definitions.
+ *
+ * By default, cell content is formatted as text
+ * Use [RenderedContent.media] or [IMG], [IFRAME] if you need custom HTML inside a cell.
+ *
+ * @param [configuration] The [DisplayConfiguration] to use. Default: [DisplayConfiguration.DEFAULT].
+ * @param [cellRenderer] Mostly for internal usage, use [DefaultCellRenderer] if unsure.
+ * @param [getFooter] Allows you to specify how to render the footer text beneath the dataframe.
+ *   Default: `"DataFrame [rows x cols]"`
+ * @see toStandaloneHtml
  */
 public fun <T> DataFrame<T>.toHtml(
     configuration: DisplayConfiguration = DisplayConfiguration.DEFAULT,

core/generated-sources/src/main/kotlin/org/jetbrains/kotlinx/dataframe/util/deprecationMessages.kt

@@ -113,6 +113,12 @@ internal const val TO_URL_REPLACE = "toUrl()"
 internal const val FILTER_BY = "This function is deprecated in favor of `filter { }`. $MESSAGE_1_0"
 internal const val FILTER_BY_REPLACE = "filter { column }"
 
+internal const val FORMATTING_DSL = "Replaced by `FormattingDsl`. $MESSAGE_1_0"
+internal const val FORMATTING_DSL_REPLACE = "FormattingDsl"
+
+internal const val RGB_COLOR = "Replaced by `RgbColor`. $MESSAGE_1_0"
+internal const val RGB_COLOR_REPLACE = "RgbColor"
+
 // endregion
 
 // region WARNING in 1.0, ERROR in 1.1