@emdzej/bimmerz-ui 0.1.0

package/LICENSE

@@ -0,0 +1,131 @@
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose.  However, you may
+only distribute the software according to [Distribution
+License](#distribution-license) and make changes or new works
+based on the software according to [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software.  Your license
+to distribute covers distributing the software with
+changes and new works permitted by [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization,
+or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting
+from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.

package/README.md

@@ -0,0 +1,73 @@
+# @emdzej/bimmerz-ui
+
+Shared **Svelte 5** components for the bimmerz app family. Source-only —
+consumer apps' Vite + svelte-plugin compiles them. No pre-compiled output.
+
+## Convention: source-only Svelte libs
+
+Svelte components ship as `.svelte` files, not pre-compiled JS. The
+`package.json` carries:
+
+```json
+{
+  "svelte": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "svelte": "./src/index.ts",
+      "import": "./src/index.ts"
+    }
+  }
+}
+```
+
+The `svelte` export condition is what the consumer's Vite plugin reads to
+locate the source. The `types` condition lets `svelte-check` resolve them
+the same way without an explicit `.d.ts` step.
+
+**Why:** Svelte 5's compiler output depends on the consumer's compiler
+version + rune config. Pre-compiling locks the output to whichever Svelte
+version the lib was built against and breaks tree-shaking + HMR in the
+consuming app. Letting consumers compile means every version, every dev
+mode, every runes setting works.
+
+A consumer's `vite.config.ts` should also tell `optimizeDeps` about us so
+the dev server pre-bundles the source:
+
+```ts
+optimizeDeps: {
+  include: ["@emdzej/bimmerz-ui"],
+}
+```
+
+## Required peer setup
+
+Components use semantic colour tokens (`bg-surface`, `text-foreground`,
+`text-accent`, …) from [`@emdzej/bimmerz-theme`](../theme). Wire that
+preset into the consumer app's `tailwind.config.ts` first; the
+components break visually without it.
+
+## Components
+
+| Name | Purpose |
+|---|---|
+| `<Brand body="EDIABAS" suffix="X" />` | Split-colour wordmark — body in foreground, suffix in accent. |
+
+More to come — About dialog, Settings dialog scaffolding, Connect button,
+install picker. The existing app-specific implementations in inpax-web /
+ncsx-web / ediabasx-web are slated for consolidation here once their
+shapes stabilise.
+
+## Usage
+
+```svelte
+<script lang="ts">
+  import { Brand } from "@emdzej/bimmerz-ui";
+</script>
+
+<Brand body="EDIABAS" suffix="X" />
+```
+
+Pair with `@emdzej/bimmerz-theme` for the colour tokens. Each consumer
+app picks its own `accent` colour via `tailwind.config.ts` extend.

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@emdzej/bimmerz-ui",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Shared Svelte 5 components for the bimmerz app family — About dialog, Settings scaffolding, Connect button, brand wordmark, install picker. Source-only — consumer apps' Vite compiles them.",
+  "svelte": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "svelte": "./src/index.ts",
+      "import": "./src/index.ts"
+    }
+  },
+  "files": [
+    "src"
+  ],
+  "peerDependencies": {
+    "svelte": "^5.0.0"
+  },
+  "devDependencies": {
+    "@tsconfig/svelte": "^5.0.4",
+    "svelte": "^5.0.0",
+    "svelte-check": "^4.0.0",
+    "typescript": "^5.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/emdzej/bimmerz.git",
+    "directory": "packages/ui"
+  },
+  "scripts": {
+    "build": "svelte-check --tsconfig ./tsconfig.json",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "svelte-check --tsconfig ./tsconfig.json",
+    "clean": "rm -rf .turbo *.tsbuildinfo"
+  }
+}

package/src/Brand.svelte

@@ -0,0 +1,25 @@
+<script lang="ts">
+  /**
+   * Split-colour wordmark used by every bimmerz app:
+   *   `INPAX`, `NCSX`, `EDIABASX`, `XBUSX` — the body in the primary
+   * text colour, the suffix in the per-app accent. Mirrors the
+   * convention each app set independently; centralised here so any
+   * future re-skin only touches one file.
+   *
+   * Pass `body` + `suffix` to render. Default styling is `text-sm
+   * font-bold tracking-wide`; override via the `class` prop if a
+   * larger size is needed (welcome screen vs. top bar).
+   */
+  interface Props {
+    body: string;
+    suffix: string;
+    /** Extra Tailwind classes appended to the default wordmark sizing. */
+    class?: string;
+  }
+
+  const { body, suffix, class: extraClass = "" }: Props = $props();
+</script>
+
+<span class="text-sm font-bold tracking-wide {extraClass}">
+  <span class="text-foreground">{body}</span><span class="text-accent">{suffix}</span>
+</span>

package/src/MStripe.svelte

@@ -0,0 +1,32 @@
+<script lang="ts">
+  /**
+   * BMW M tricolour stripe — three thin bars in the canonical
+   * light-blue / dark-blue / red order, identical to the signature
+   * carried on M cars' kidney grilles and side skirts and the visual
+   * top-bar bimmerz.app + hub.bimmerz.app both use.
+   *
+   * Renders a `<div role="presentation">` with the `.m-stripe` /
+   * `.m-stripe__band--{light|dark|red}` classes from
+   * `@emdzej/bimmerz-theme/tokens.css`. Consumer must have those
+   * tokens imported for the colours to resolve.
+   *
+   * Default height is 4px (the tokens.css default); override via the
+   * `class` prop if you want a thicker bar for a hero or a thinner
+   * one for a sidebar:
+   *
+   *   <MStripe class="h-1" />   ; 4px (default)
+   *   <MStripe class="h-2" />   ; 8px
+   */
+  interface Props {
+    /** Extra Tailwind classes appended to the default `.m-stripe`. */
+    class?: string;
+  }
+
+  const { class: extraClass = "" }: Props = $props();
+</script>
+
+<div class="m-stripe {extraClass}" aria-hidden="true">
+  <div class="m-stripe__band m-stripe__band--light"></div>
+  <div class="m-stripe__band m-stripe__band--dark"></div>
+  <div class="m-stripe__band m-stripe__band--red"></div>
+</div>

package/src/index.ts

@@ -0,0 +1,16 @@
+/**
+ * Public surface of `@emdzej/bimmerz-ui` — Svelte 5 components +
+ * helper types shared across the bimmerz app family.
+ *
+ * Components are exported as `.svelte` source. The consumer app's
+ * Vite + svelte-plugin compiles them — pre-compiling locks the
+ * output to a specific Svelte version and breaks tree-shaking, HMR,
+ * and rune handling.
+ *
+ * Tokens (`bg-surface`, `text-foreground`, etc.) come from
+ * `@emdzej/bimmerz-theme`'s Tailwind preset; the consumer app must
+ * have that preset applied for these components to render correctly.
+ */
+
+export { default as Brand } from "./Brand.svelte";
+export { default as MStripe } from "./MStripe.svelte";