@mano8/astro-media-m8 0.1.0-alpha.2 → 1.0.0

package/README.md

@@ -1,23 +1,35 @@
 # @mano8/astro-media-m8
 
+![CI/CD](https://github.com/mano8/astro-media-m8/actions/workflows/CI.yaml/badge.svg?branch=main)
+
 Astro integration and headless client for [`media-service-m8`]. The media-side
 analog of `@mano8/astro-auth-m8`: typed Zod schemas, API wrappers for the full
 media contract, a presigned-upload controller, optional React provider/hooks,
 and injectable starter routes — so any Astro stack can drive media without
 re-implementing the contract.
 
-Part of the M8 media stack: [mano8/astro-media-m8](https://github.com/mano8/astro-media-m8) works with [mano8/astro-auth-m8](https://github.com/mano8/astro-auth-m8) for fa-auth-m8 token delegation, targets the media backend at [https://github.com/mano8/media-service-m8/tree/main](https://github.com/mano8/media-service-m8/tree/main), and composes into [mano8/fa-ui-m8](https://github.com/mano8/fa-ui-m8).
+Part of the M8 media stack: [mano8/astro-media-m8](https://github.com/mano8/astro-media-m8)
+requires [mano8/astro-auth-m8](https://github.com/mano8/astro-auth-m8) as its
+auth peer for fa-auth-m8 token delegation, consumes shared UI/registry blocks
+from [mano8/astro-ui-m8](https://github.com/mano8/astro-ui-m8), targets the
+media backend at [mano8/media-service-m8](https://github.com/mano8/media-service-m8),
+and composes into the [mano8/fa-ui-m8](https://github.com/mano8/fa-ui-m8) host app.
+
+### Related repositories
+
+- [`media-service-m8`](https://github.com/mano8/media-service-m8) — the FastAPI backend this plugin fronts.
+- [`astro-ui-m8`](https://github.com/mano8/astro-ui-m8) — canonical shared shadcn registry (data-table, state components) this plugin's admin views build on.
+- [`astro-auth-m8`](https://github.com/mano8/astro-auth-m8) — required auth peer; issues the fa-auth-m8 tokens this plugin's adapter consumes.
+- [`fa-ui-m8`](https://github.com/mano8/fa-ui-m8) — the Astro/Starlight host app this plugin installs into.
 
-Pinned to `media-service-m8@0.0` (supported service-version range
-`>=0.0.10 <0.1.0`; see `mediaServiceM8` in `package.json`).
+Pinned to `media-service-m8@1.0` (supported service-version range
+`>=1.0.0 <2.0.0`; see `mediaServiceM8` in `package.json`).
 
 ## Backend contract
 
-This package targets the `media-service-m8@0.0` API contract and was tested
-against `media-service-m8` service version `0.0.10`. Supported backend service
-versions are `>=0.0.10 <0.1.0` (the floor is the first release supporting the
-media library sorting contract). The contract major.minor tracks the pre-1.0
-package line.
+This package targets the `media-service-m8@1.0` API contract and was tested
+against `media-service-m8` service version `1.0.0`. Supported backend service
+versions are `>=1.0.0 <2.0.0`.
 
 Compatibility helpers are exported from `@mano8/astro-media-m8/compatibility`.
 `media-service-m8` (>= 0.0.10) exposes a public `GET {API_PREFIX}/meta` route
@@ -47,7 +59,8 @@ npm i @mano8/astro-media-m8 @mano8/astro-auth-m8 zod
 tokens). `@mano8/astro-ui-m8` is a normal dependency because the media registry
 skins compose the canonical shared table from its packaged registry output.
 `react`/`react-dom` are optional — only `./react`, `./hooks` and the starter
-views need them.
+views need them; `@tanstack/react-query` is a required peer once you use
+`./hooks` (`npm i @tanstack/react-query`).
 
 ## Modes
 
@@ -209,4 +222,4 @@ Consumers should install the shared UI block first or let `shadcn` resolve it fr
 - `npm run typecheck` — `tsc --noEmit`
 - `npm test` — Vitest with coverage (100% on the non-React runtime)
 
-[`media-service-m8`]: ../media-service-m8
+[`media-service-m8`]: https://github.com/mano8/media-service-m8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mano8/astro-media-m8",
-  "version": "0.1.0-alpha.2",
+  "version": "1.0.0",
   "description": "Astro integration and headless client for media-service-m8.",
   "type": "module",
   "license": "MIT",
@@ -58,10 +58,10 @@
     "test:unit": "vitest run"
   },
   "dependencies": {
-    "@mano8/astro-ui-m8": "^0.1.0-alpha.1"
+    "@mano8/astro-ui-m8": "^1.0.0"
   },
   "peerDependencies": {
-    "@mano8/astro-auth-m8": "^0.1.0-alpha.3",
+    "@mano8/astro-auth-m8": "^1.0.0",
     "@tanstack/react-query": "^5.101.1",
     "astro": "^5.0.0 || ^6.0.0",
     "react": "^18.0.0 || ^19.0.0",
@@ -78,7 +78,7 @@
   },
   "devDependencies": {
     "@astrojs/react": "^5.0.7",
-    "@mano8/astro-auth-m8": "^0.1.0-alpha.3",
+    "@mano8/astro-auth-m8": "^1.0.0",
     "@tanstack/react-query": "^5.101.1",
     "@types/node": "^22.0.0",
     "@types/react": "^19.0.0",

package/src/scaffold/styles/media.css

@@ -1,6 +1,6 @@
-/* Modest, framework-neutral styling for the media starter views. Consumers can
-   override every class; nothing here assumes Tailwind, Starlight, or a theme. */
-
+/* Modest, framework-neutral styling for the media starter views. Consumers can
+   override every class; nothing here assumes Tailwind, Starlight, or a theme. */
+
 .fa-media-panel {
   --fa-media-border: var(--fa-media-border-color, var(--border, color-mix(in srgb, CanvasText 14%, Canvas)));
   --fa-media-input-border: var(--fa-media-input-border-color, var(--fa-media-border));
@@ -21,19 +21,19 @@
   border-radius: 0.5rem;
   font-family: system-ui, sans-serif;
 }
-
-.fa-media-panel h2,
-.fa-media-panel h3 {
-  margin-top: 0;
-}
-
+
+.fa-media-panel h2,
+.fa-media-panel h3 {
+  margin-top: 0;
+}
+
 .fa-media-field,
 .fa-media-actions,
 .fa-media-toolbar {
   display: flex;
   flex-wrap: wrap;
-  gap: 0.75rem;
-  align-items: center;
+  gap: 0.75rem;
+  align-items: center;
   margin-bottom: 1rem;
 }
 
@@ -60,7 +60,7 @@
     align-items: center;
   }
 }
-
+
 .fa-media-panel fieldset {
   display: grid;
   gap: 1rem;
@@ -69,27 +69,27 @@
   border: 1px solid var(--fa-media-border);
   border-radius: 0.5rem;
 }
-
-.fa-media-panel legend {
-  padding: 0 0.25rem;
-  font-size: 0.875rem;
-  font-weight: 500;
-}
-
-.fa-media-panel label:has(input[type="checkbox"]),
-.fa-media-panel label:has(input[type="radio"]) {
-  flex-direction: row;
-  align-items: center;
-  gap: 0.5rem;
-}
-
-.fa-media-field-control {
-  display: flex;
-  flex-direction: column;
-  min-width: 12rem;
-  max-width: 100%;
-}
-
+
+.fa-media-panel legend {
+  padding: 0 0.25rem;
+  font-size: 0.875rem;
+  font-weight: 500;
+}
+
+.fa-media-panel label:has(input[type="checkbox"]),
+.fa-media-panel label:has(input[type="radio"]) {
+  flex-direction: row;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.fa-media-field-control {
+  display: flex;
+  flex-direction: column;
+  min-width: 12rem;
+  max-width: 100%;
+}
+
 .fa-media-control {
   box-sizing: border-box;
   height: 2rem;
@@ -105,18 +105,18 @@
   background-color: var(--fa-media-popover-bg);
   color: var(--fa-media-popover-fg);
 }
-
-.fa-media-control::file-selector-button {
-  height: 1.5rem;
-  margin: -0.125rem 0.5rem -0.125rem -0.125rem;
-  border: 0;
-  background: transparent;
-  color: inherit;
-  font: inherit;
-  font-size: 0.875rem;
-  font-weight: 500;
-}
-
+
+.fa-media-control::file-selector-button {
+  height: 1.5rem;
+  margin: -0.125rem 0.5rem -0.125rem -0.125rem;
+  border: 0;
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  font-size: 0.875rem;
+  font-weight: 500;
+}
+
 .fa-media-panel button {
   display: inline-flex;
   min-height: 2rem;
@@ -131,9 +131,9 @@
   font: inherit;
   font-size: 0.875rem;
   font-weight: 500;
-  cursor: pointer;
-}
-
+  cursor: pointer;
+}
+
 .fa-media-panel button:disabled {
   cursor: not-allowed;
   opacity: 0.5;
@@ -158,12 +158,12 @@
   gap: 0.5rem;
   align-items: center;
 }
-
-.fa-media-table {
-  width: 100%;
-  border-collapse: collapse;
-}
-
+
+.fa-media-table {
+  width: 100%;
+  border-collapse: collapse;
+}
+
 .fa-media-table th,
 .fa-media-table td {
   text-align: left;
@@ -193,14 +193,14 @@
 .fa-media-badge--pending_upload {
   background: var(--fa-media-badge-processing-bg);
 }
-
-.fa-media-progress {
-  display: flex;
-  align-items: center;
-  gap: 0.5rem;
-  margin: 0.75rem 0;
-}
-
+
+.fa-media-progress {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  margin: 0.75rem 0;
+}
+
 .fa-media-danger,
 .fa-media-danger-zone {
   color: var(--fa-media-danger-fg);