docs(readme): add documentation and storybook start instructions

The README was missing instructions for running the documentation
site and Storybook locally, so contributors had to guess or dig
through package.json scripts to find them. Documents the existing
`pnpm run docs` command and the current Storybook workflow, including
the known limitation that it must be run from within
`packages/luna-charts` until a root-level filter script is set up.

README.md

@@ -4,6 +4,14 @@ LUNA Charts is a reusable, developer-friendly charting library designed to make
 
 > **Project status:** Groundwork phase. Core architecture and tooling are in place; production-ready chart components (starting with `BarChart`) are still in development. See the [Roadmap](./docs/src/content/docs/getting-started/roadmap.mdx) for details.
 
+## Preface & Repository Mirror Notice
+
+Please be aware of our repository structure:
+
+* **Official Repository:** [git.byting-pandas.ninja/Ninosaurier/LUNA-Charts](https://git.byting-pandas.ninja/Ninosaurier/LUNA-Charts)
+
+**Important:** All development, including issue tracking and contribution management, takes place exclusively on our self-hosted server. Issues and pull requests cannot be created or processed on this GitHub mirror. Please visit the original link above to report bugs or request features.
+
 ## Why LUNA Charts
 
 Most charting libraries treat accessibility as an add-on. LUNA Charts builds it in from the start:
@@ -71,6 +79,18 @@ pnpm install
 | `pnpm test:component` | Run component/browser tests inside the containerized Playwright environment |
 | `pnpm test` | Run the full test suite (unit + component) |
 | `pnpm changeset` | Record a changeset for your change (required for any user-facing change) |
+| `pnpm run docs` | Start the documentation site locally (astroJS) |
+
+### Storybook
+
+Storybook currently needs to be started from within the library package directly:
+
+```bash
+cd packages/luna-charts
+pnpm run storybook
+```
+
+> **Note:** Running Storybook from the repository root isn't set up yet. This is a known gap — contributions to add a root-level `pnpm --filter` script are welcome.
 
 Component and browser tests run inside Docker (`docker-compose.test.yaml`) to guarantee a reproducible browser environment across all contributors and CI — you don't need Playwright browsers installed locally.
 

package.json

@@ -4,6 +4,7 @@
   "description": "",
   "main": "index.js",
   "scripts": {
+    "docs": "pnpm --filter docs run dev",
     "lint": "eslint .",
     "format": "prettier --write .",
     "changeset": "changeset",

packages/luna-charts/custom-elements.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-12T12:51:52",
+  "timestamp": "2026-07-22T21:49:28",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.43.5",
@@ -17,10 +17,10 @@
       "props": [
         {
           "name": "first",
-          "type": "string",
+          "type": "string | undefined",
           "complexType": {
             "original": "string",
-            "resolved": "string",
+            "resolved": "string | undefined",
             "references": {}
           },
           "mutable": false,
@@ -31,6 +31,9 @@
           "values": [
             {
               "type": "string"
+            },
+            {
+              "type": "undefined"
             }
           ],
           "optional": true,
@@ -40,10 +43,10 @@
         },
         {
           "name": "last",
-          "type": "string",
+          "type": "string | undefined",
           "complexType": {
             "original": "string",
-            "resolved": "string",
+            "resolved": "string | undefined",
             "references": {}
           },
           "mutable": false,
@@ -54,6 +57,9 @@
           "values": [
             {
               "type": "string"
+            },
+            {
+              "type": "undefined"
             }
           ],
           "optional": true,
@@ -63,10 +69,10 @@
         },
         {
           "name": "middle",
-          "type": "string",
+          "type": "string | undefined",
           "complexType": {
             "original": "string",
-            "resolved": "string",
+            "resolved": "string | undefined",
             "references": {}
           },
           "mutable": false,
@@ -77,6 +83,9 @@
           "values": [
             {
               "type": "string"
+            },
+            {
+              "type": "undefined"
             }
           ],
           "optional": true,

packages/luna-charts/package.json

@@ -42,6 +42,8 @@
     "storybook": "storybook dev -p 6006 --no-open"
   },
   "devDependencies": {
+    "@oxc-parser/binding-linux-x64-gnu": "^0.141.0",
+    "@rolldown/binding-linux-x64-gnu": "^1.2.0",
     "@stencil/core": "^4.43.5",
     "@stencil/storybook-plugin": "^0.7.0",
     "@stencil/vitest": "^1.8.3",

pnpm-workspace.yaml

@@ -1,8 +1,10 @@
 packages:
   - "packages/*"
+  - "docs/"
 
 allowBuilds:
-  esbuild: false
+  esbuild: true
+  sharp: true
 
 onlyBuiltDependencies:
   - playwright