docs: fix templateFile() behavior inconsistencies and chunk:index comment

- Align docs, website, and playground on consistent templateFile() behavior: omitting it in Gradle disables auto-discovery; use common config for inheritance.
- Fix method signature to templateFile(path: RegularFile).
Correct chunk:index comment from 0-based to 1-based.

Author: rafaeltonholo

docs/TEMPLATES.md

@@ -342,8 +342,10 @@ When no explicit template path is given, the tool walks up from the output
 directory looking for `s2c.template.toml`. This matches the behavior of
 `.editorconfig` discovery.
 
-Disable auto-discovery with `--no-template` (CLI) or by omitting
-`templateFile()` from the Gradle DSL.
+Disable auto-discovery with `--no-template` (CLI). In the Gradle DSL,
+omitting `templateFile()` disables auto-discovery for that configuration;
+set `templateFile()` in `common` to share a template across all
+configurations via inheritance.
 
 ## Gradle Plugin: Per-Configuration Templates
 
@@ -375,7 +377,7 @@ svgToCompose {
             destinationPackage("com.example.icons.filled")
             icons {
                 theme("com.example.theme.AppTheme")
-                // No templateFile() → inherits from common or auto-discovery
+                // No templateFile() -> inherits from common config
             }
         }
     }

playground/s2c.template.toml

@@ -57,7 +57,7 @@ path_builder = "${def:icon_path}(fill = ${path:fill}, fillAlpha = ${path:fill_al
 group_builder = "group(rotate = ${group:rotate}, pivotX = ${group:pivot_x}, pivotY = ${group:pivot_y})"
 # chunk_function_name / chunk_function_definition: customize how large icons
 # are split into helper functions. ${icon:name} is camelCase, ${chunk:index}
-# is the 0-based chunk number, ${chunk:name} is the resolved function name,
+# is the 1-based chunk number, ${chunk:name} is the resolved function name,
 # and ${chunk:body} is the emitted node code for the chunk.
 chunk_function_name = "${icon:name}Part${chunk:index}"
 chunk_function_definition = "private fun ImageVector.Builder.${chunk:name}() {\n${chunk:body}\n}"

website/site/src/jsMain/kotlin/dev/tonholo/s2c/website/components/organisms/docs/GradlePluginDocsContent.kt

@@ -365,7 +365,7 @@ private fun IconParserConfigurationSubsection() {
                 description = "Persist generated files to the source directory (delicate API)",
             )
             OptionItem(
-                name = "templateFile(RegularFileProperty)",
+                name = "templateFile(path: RegularFile)",
                 description = "Path to an s2c.template.toml file for customizing generated code",
             )
         }

website/site/src/jsMain/kotlin/dev/tonholo/s2c/website/components/organisms/docs/TemplateDocsContent.kt

@@ -202,7 +202,7 @@ private val gradlePerConfigExample = """
 |            destinationPackage("com.example.icons.filled")
 |            icons {
 |                theme("com.example.theme.AppTheme")
-|                // No templateFile() -> inherits from common or auto-discovery
+|                // No templateFile() -> inherits from common config
 |            }
 |        }
 |    }

website/site/src/jsMain/kotlin/dev/tonholo/s2c/website/state/playground/TemplateTomlExtensions.kt

@@ -18,5 +18,4 @@ internal fun String.isTemplateStructuralOnly(): Boolean {
  * Returns the TOML string only when it contains real configuration
  * beyond section headers and comments (the default placeholder).
  */
-internal fun String.takeIfUsableTemplate(): String? =
-    if (isTemplateStructuralOnly()) null else this
+internal fun String.takeIfUsableTemplate(): String? = if (isTemplateStructuralOnly()) null else this