@archetypeai/ds-cli 0.14.0 → 0.15.0

package/files/ds-manifest.json

@@ -1,6 +1,6 @@
 {
 	"name": "archetypeai-design-system",
-	"version": "0.14.0",
+	"version": "0.15.0",
 	"components": [
 		{
 			"name": "alert",
@@ -754,11 +754,17 @@
 			"source": "https://design-system-labs.archetypeai.workers.dev/r/logo.json",
 			"description": "Archetype AI brand logo mark.",
 			"usage": [
-				"Headers: `<Logo class=\"h-6 w-auto\" />` next to the app title; sizes sm | default | lg."
+				"Headers: `<Logo class=\"h-6 w-auto\" />` next to the app title; sizes sm | default | lg.",
+				"Compact lockup: `variant=\"compact\"` is the stacked social/avatar artwork (~1.6:1 instead of the wordmark's ~5.4:1). Use it where a horizontal wordmark will not fit — square tiles, avatars, narrow sidebars, splash marks. Defaults to `variant=\"default\"`.",
+				"Sizing is shared: both variants honour size sm | default | lg (h-4 | h-6 | h-8) and take their width from the artwork aspect, so compact renders far narrower at the same height. Prefer default or lg for compact."
 			],
 			"variants": {
 				"logoVariants": {
 					"axes": {
+						"variant": [
+							"default",
+							"compact"
+						],
 						"size": [
 							"sm",
 							"default",
@@ -766,6 +772,7 @@
 						]
 					},
 					"defaults": {
+						"variant": "default",
 						"size": "default"
 					}
 				}
@@ -1120,8 +1127,11 @@
 			"description": "Hover hint.",
 			"usage": [
 				"Wrap the app/section in `Tooltip.Provider delayDuration={200}`.",
-				"Field help: `Tooltip.Trigger variant=\"info\"` holding an InfoIcon placed next to a Label sectionHeader, explanation in Tooltip.Content.",
-				"`variant=\"inlineLink\"` — underlined trigger flowing inside prose (supported file requirements)."
+				"Field help: `Tooltip.Trigger variant=\"info\"` is a filled 20px disc holding a mono `i` — pass it no children, it renders its own glyph. Explanation goes in `Tooltip.Content`.",
+				"`aria-label` on the info trigger is required and is the caller's: name what is being explained (`aria-label=\"About Detection Log\"`). The glyph is `aria-hidden`, so without a label the button has no accessible name.",
+				"The info disc squares against `Counter`'s height on purpose — a list title, its `Counter` and its info disc in one `flex items-center gap-2` row is the intended cluster, the solid pill reading as the count and the muted one as the meaning.",
+				"`variant=\"inlineLink\"` — underlined trigger flowing inside prose (supported file requirements).",
+				"The arrow centres itself on the trigger on all four sides and protrudes half its box — `arrowClasses` is for its ink or size, not for centring corrections. If a tip looks off, it is a bug in `tooltipArrowVariants`, not something to counter-shift at the call site."
 			],
 			"variants": {
 				"tooltipTriggerVariants": {
@@ -1142,9 +1152,16 @@
 			"name": "video-player",
 			"import": "@archetypeai/ds-ui-svelte-labs/primitives/video-player",
 			"source": "https://design-system-labs.archetypeai.workers.dev/r/video-player.json",
-			"description": "Media-playback card with controls and aspect ratio; composes Card + AspectRatio + Button + Slider.",
+			"description": "Media-playback card whose seek track doubles as a timeline: named marker windows, tinted highlight bands and bindable playback state. Composes Card + AspectRatio + Button + Slider.",
 			"usage": [
-				"`<VideoPlayer src muted />` for the standard controlled player; `controls={false}` for ambient/looping footage."
+				"`<VideoPlayer src muted />` for the standard controlled player; `controls={false}` for ambient/looping footage. `preload=\"metadata\"` by default, so `duration` is known before the first play.",
+				"Playback state: `bind:time` / `bind:duration` / `bind:paused` mirror the media element out, and `time` and `paused` are writable - assigning to `time` seeks, assigning `paused = false` plays. That is how another view drives the player.",
+				"Markers: `markers={[{ start, end, label?, color? }]}` in **seconds, not fractions** draws one focusable dot per window on the seek track. Clicking a dot expands it into a range pill, seeks to its start and plays; one is expanded at a time, and `bind:activeMarker` is its index (or null). Scrubbing by hand, or a click on the video surface, collapses it. `loopActiveMarker` loops playback inside the expanded window.",
+				"Linked brushing: `highlights={[{ start, end, color? }]}` tints regions another view is pointing at (brushing in), and `onMarkerHover(index | null)` fires on hover **and focus** so a hovered marker can highlight the matching row elsewhere (brushing out).",
+				"Two lifecycle traps when `src` changes: a new `src` remounts the player and Svelte's media bindings write your bound values into the fresh element, so reset `time = 0` and `paused = true` yourself or a stale position becomes the new clip's start; and `bind:duration` holds the previous clip's value until `loadedmetadata`, so reseed `duration` from a known length if marker geometry must be right on the first frame (`duration === 0` collapses every marker to the left edge).",
+				"`controlsVisibility=\"always\"` pins the control bar open - required whenever markers must stay clickable during playback, since the default `\"auto\"` fades the bar (and the markers with it) 2.5s into playback. `formatTime` replaces the mm:ss clock in the time readout and the marker captions.",
+				"Style hooks: `data-slot` on `video-player`, `-video`, `-overlay`, `-controls`, `-time`, `-markers`, `-marker` (carries `data-expanded`), `-marker-caption`, `-highlight`. A per-marker `color` inks the outline and fill via `currentColor`.",
+				"Marker seeking needs an origin that serves HTTP Range requests; against one that does not, seeks silently do nothing (serve the clip from a blob URL instead)."
 			],
 			"variants": {
 				"videoPlayerOverlayVariants": {
@@ -1168,6 +1185,28 @@
 					"defaults": {
 						"visible": "true"
 					}
+				},
+				"videoPlayerMarkerVariants": {
+					"axes": {
+						"expanded": [
+							"true",
+							"false"
+						],
+						"filled": [
+							"true",
+							"false"
+						],
+						"emphasis": [
+							"hidden",
+							"full",
+							"ambient"
+						]
+					},
+					"defaults": {
+						"expanded": "false",
+						"filled": "false",
+						"emphasis": "ambient"
+					}
 				}
 			}
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archetypeai/ds-cli",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "Archetype AI Design System CLI Tool",
   "type": "module",
   "bin": {