Merge pull request #55 from zeixcom/feature/docs-v0.13

Feature/docs v0.13

Author: estherbrunner

.editorconfig

@@ -5,3 +5,8 @@ indent_style = tab
 indent_size = 4
 end_of_line = lf
 charset = utf-8
+
+[*.md]
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true

.gitignore

@@ -2,13 +2,10 @@
 logs
 *.log
 npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-lerna-debug.log*
-.pnpm-debug.log*
 
-# Rollup generated
+# Generated
 dist
+test/components/main.js*
 
 # Diagnostic reports (https://nodejs.org/api/report.html)
 report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
@@ -19,34 +16,8 @@ pids
 *.seed
 *.pid.lock
 
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
-
-# Coverage directory used by tools like istanbul
-coverage
-*.lcov
-
-# nyc test coverage
-.nyc_output
-
-# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Bower dependency directory (https://bower.io/)
-bower_components
-
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (https://nodejs.org/api/addons.html)
-build/Release
-
 # Dependency directories
 node_modules/
-jspm_packages/
-
-# Snowpack dependency directory (https://snowpack.dev/)
-web_modules/
 
 # TypeScript cache
 *.tsbuildinfo
@@ -60,21 +31,9 @@ web_modules/
 # Optional stylelint cache
 .stylelintcache
 
-# Microbundle cache
-.rpt2_cache/
-.rts2_cache_cjs/
-.rts2_cache_es/
-.rts2_cache_umd/
-
-# Optional REPL history
-.node_repl_history
-
 # Output of 'npm pack'
 *.tgz
 
-# Yarn Integrity file
-.yarn-integrity
-
 # dotenv environment variable files
 .env
 .env.development.local

.prettierrc

@@ -3,5 +3,15 @@
 	"useTabs": true,
 	"tabWidth": 4,
 	"singleQuote": true,
-	"arrowParens": "avoid"
+	"arrowParens": "avoid",
+	"experimentalOperatorPosition": "start",
+	"overrides": [
+		{
+			"files": "*.md",
+			"options": {
+				"useTabs": false,
+				"tabWidth": 2
+			}
+		}
+	]
 }

.rules

@@ -4,7 +4,7 @@ You are an expert TypeScript engineer assisting with a TypeScript library for re
 
 ## Project Guidelines
 
-- Read and strictly follow all guidelines in CONTRIBUTIONS.md, eslint.config.js, .editorconfig, and .prettierrc
+- Read and strictly follow all guidelines in CONTRIBUTIONS.md, biome.json, and .editorconfig
 - Maintain HTML-first approach and Web Platform standards compliance
 - Keep the library small, simple, and focused on reactive properties
 - Prefer functional programming style with pure functions and immutability
@@ -13,8 +13,8 @@ You are an expert TypeScript engineer assisting with a TypeScript library for re
 ## Code Standards
 
 - Use TypeScript with strict type checking
-- Follow the existing eslint configuration without exceptions
-- Apply prettier formatting as configured in .prettierrc
+- Follow the existing biome configuration without exceptions
+- Apply biome formatting as configured in biome.json
 - Respect .editorconfig settings for indentation and line endings
 - Use descriptive variable and function names that clearly indicate purpose
 - Prefer composition over inheritance
@@ -95,6 +95,19 @@ You are an expert TypeScript engineer assisting with a TypeScript library for re
 - Maintain focus on simplicity and Web Platform alignment
 - Balance feature completeness with library size constraints
 
+## LLM Note-Taking Process
+
+- Maintain LLM_NOTES.md to document unexpected behavior and solutions
+- When encountering unexpected library behavior, check if similar issues are documented
+- For new issues, document:
+  - What was expected vs actual behavior
+  - Root cause analysis
+  - Solution or workaround found
+  - Lessons learned and takeaways
+- Use these notes to identify patterns and potential library improvements
+- Flag recurring issues as candidates for library design changes
+- Structure notes with clear dates, components, and problem descriptions
+
 ## Always ask for user guidance when:
 
 - Multiple valid implementation strategies exist

.zed/settings.json

@@ -1,17 +1,44 @@
 {
+	"lsp": {
+		"biome": {
+			"settings": {
+				"require_config_file": true
+			}
+		}
+	},
 	"languages": {
 		"JavaScript": {
-			"formatter": {
-				"external": {
-					"command": "eslint",
-					"arguments": ["--fix", "--no-warn-ignored"]
-				}
-			},
+			"formatter": { "language_server": { "name": "biome" } },
 			"code_actions_on_format": {
-				"source.fixAll.eslint": true
+				"source.fixAll.biome": true,
+				"source.organizeImports.biome": true
 			}
-		}
+		},
+		"TypeScript": {
+			"formatter": { "language_server": { "name": "biome" } },
+			"code_actions_on_format": {
+				"source.fixAll.biome": true,
+				"source.organizeImports.biome": true
+			}
+		},
+		"JSX": {
+			"formatter": { "language_server": { "name": "biome" } },
+			"code_actions_on_format": {
+				"source.fixAll.biome": true,
+				"source.organizeImports.biome": true
+			}
+		},
+		"TSX": {
+			"formatter": { "language_server": { "name": "biome" } },
+			"code_actions_on_format": {
+				"source.fixAll.biome": true,
+				"source.organizeImports.biome": true
+			}
+		},
+		"JSON": { "formatter": { "language_server": { "name": "biome" } } },
+		"JSONC": { "formatter": { "language_server": { "name": "biome" } } },
+		"CSS": { "formatter": { "language_server": { "name": "biome" } } },
+		"GraphQL": { "formatter": { "language_server": { "name": "biome" } } }
 	},
-	"format_on_save": "on",
-	"eslint.rules.ignore": ["index.js", "docs/assets/main.js", "**/*.min.js"]
+	"format_on_save": "on"
 }