Merge branch 'master' into kodex_iframes_fix

Author: AndreiKingsley

.gitignore

@@ -1,5 +1,9 @@
 # Default ignored files
 .idea
+!.idea/runConfigurations
+!.idea/runConfigurations/*.xml
+!.idea/externalDependencies.xml
+!.idea/vcs.xml
 .gradle
 .kotlin
 build

.idea/externalDependencies.xml

@@ -189,7 +189,7 @@ allprojects {
     afterEvaluate {
         try {
             configure<KtlintExtension> {
-                version = "1.4.1"
+                version = "1.6.0"
                 // rules are set up through .editorconfig
             }
         } catch (_: UnknownDomainObjectException) {

.idea/runConfigurations/Build_Docs_Website.xml

@@ -3,6 +3,7 @@ package org.jetbrains.kotlinx.dataframe.puzzles
 import io.kotest.matchers.shouldBe
 import kotlinx.datetime.LocalDate
 import kotlinx.datetime.Month
+import kotlinx.datetime.isoDayNumber
 import kotlinx.datetime.toJavaLocalDate
 import org.jetbrains.kotlinx.dataframe.api.add
 import org.jetbrains.kotlinx.dataframe.api.aggregate
@@ -113,7 +114,7 @@ class DateTests {
 
         (start..end).toList().toColumn("3thu").filter {
             it.toJavaLocalDate()[WeekFields.of(Locale.ENGLISH).weekOfMonth()] == 3 &&
-                it.dayOfWeek.value == 4
+                it.dayOfWeek.isoDayNumber == 4
         } shouldBe expected
     }
 }

.idea/runConfigurations/Run_Docs_Website_Locally.xml

@@ -3,6 +3,7 @@ package org.jetbrains.kotlinx.dataframe.puzzles
 import io.kotest.matchers.shouldBe
 import kotlinx.datetime.LocalDate
 import kotlinx.datetime.Month
+import kotlinx.datetime.isoDayNumber
 import kotlinx.datetime.toJavaLocalDate
 import org.jetbrains.kotlinx.dataframe.api.add
 import org.jetbrains.kotlinx.dataframe.api.aggregate
@@ -113,7 +114,7 @@ class DateTests {
 
         (start..end).toList().toColumn("3thu").filter {
             it.toJavaLocalDate()[WeekFields.of(Locale.ENGLISH).weekOfMonth()] == 3 &&
-                it.dayOfWeek.value == 4
+                it.dayOfWeek.isoDayNumber == 4
         } shouldBe expected
     }
 }

.idea/vcs.xml

@@ -12,6 +12,32 @@ and included in the [StardustDocs/d.tree](./StardustDocs/d.tree) file.
 
 Images all README files can be stored in [docs/imgs](./imgs).
 
+## Running the Documentation Website Locally
+
+⚠️ IFrames are not displayed when using the Writerside plugin preview. To view them correctly, you need to run the website locally.
+
+### Option 1: Using IntelliJ IDEA Configurations
+
+> Requires: `unzip` utility and **Python 3** installed in the environment. May not work properly on Windows.
+
+1. Run the `Build Docs Website` configuration.
+2. Run the `Run Docs Website Locally` configuration.
+3. Open [http://localhost:8000/home.html](http://localhost:8000/home.html) in your browser.
+4. Shut down the server with Ctrl+C or close the terminal window.
+
+### Option 2: Manual Steps
+
+1. Go to `Writerside > DataFrame(d) > Export To > Build Docs Website` or find Writerside web archive build in IDEA configuration.
+2. Unzip the archive located at: `./build/ws/webHelpD2-all.zip`
+3. Start a local web server in the extracted folder (e.g., using Python or `http-server` utility):
+   ```bash
+   python3 -m http.server
+   # or
+   http-server
+   ```
+4. Open [http://localhost:8000/home.html](http://localhost:8000/home.html) in your browser.
+5. Shut down the server with Ctrl+C or close the terminal window.
+
 ### Explainer dataframes
 `@TransformDataFrameExpressions` annotated test functions generate sample
 dataframe HTML files that can be used as iFrames on the documentation website.