@gridui/audio-waveform 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -23,6 +23,16 @@ import { AudioWaveform } from "@gridui/audio-waveform";
23
23
  </div>;
24
24
  ```
25
25
 
26
+ ## Styles
27
+
28
+ Load Theme once. Use `@gridui/audio-waveform/styled` for automatic component CSS in
29
+ CSS-aware bundlers, or keep the CSS-free root import and load `@gridui/audio-waveform/styles.css`.
30
+ Both entries expose the same root API. The standalone stylesheet includes component
31
+ dependency styles; Theme/reset remain separate. See the
32
+ [integration guide](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/docs/usage/integration.md)
33
+ for static HTML loading, SSR limits, and avoiding duplicate CSS.
34
+
35
+
26
36
  ## Content and Grid ownership
27
37
 
28
38
  The root SVG fills its parent's content box with no padding, margin, border,
@@ -1,3 +1,9 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Audio Waveform
4
+ * @namespace AudioWaveform
5
+ * @description Audio Waveform
6
+ */
1
7
  import { type ComponentPropsWithRef } from "react";
2
8
  import type { AudioWaveformData } from "./types";
3
9
  export type AudioWaveformProps = Omit<ComponentPropsWithRef<"svg">, "children" | "viewBox" | "preserveAspectRatio"> & {
@@ -1,3 +1,9 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Audio Waveform
4
+ * @namespace AudioWaveform
5
+ * @description Model
6
+ */
1
7
  import type { AudioWaveformData, WaveformModel } from "./types";
2
8
  /** Keep time gaps and signed extrema instead of stretching available data over a window. */
3
9
  export declare function waveformModel(data: AudioWaveformData, barCount: number, viewStart?: number, viewEnd?: number): WaveformModel;
@@ -1,3 +1,9 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Audio Waveform
4
+ * @namespace AudioWaveform
5
+ * @description Types
6
+ */
1
7
  /** Uniform time buckets of signed PCM extrema; arrays have equal lengths. */
2
8
  export type AudioWaveformData = {
3
9
  readonly startTime: number;
package/dist/index.d.ts CHANGED
@@ -1,2 +1,8 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Audio Waveform
4
+ * @namespace Root
5
+ * @description Index
6
+ */
1
7
  export { AudioWaveform, type AudioWaveformProps } from "./audio-waveform/audio-waveform";
2
8
  export type { AudioWaveformData } from "./audio-waveform/types";
package/dist/index.js.map CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../src/audio-waveform/audio-waveform.tsx", "../src/audio-waveform/model.ts"],
4
- "sourcesContent": ["import { cn } from \"@gridui/style-utils\";\nimport { useId, type ComponentPropsWithRef } from \"react\";\nimport { waveformModel, waveformPath } from \"./model\";\nimport type { AudioWaveformData } from \"./types\";\n\nexport type AudioWaveformProps = Omit<ComponentPropsWithRef<\"svg\">, \"children\" | \"viewBox\" | \"preserveAspectRatio\"> & {\n /** Accessible description of the audio source; not a visible heading. */\n readonly label: string;\n readonly data: AudioWaveformData;\n readonly variant?: \"bars\" | \"envelope\";\n /** Maximum display buckets. Peak aggregation preserves short transients. */\n readonly barCount?: number;\n readonly barGap?: number;\n /** Seconds on the same clock as data.startTime. */\n readonly viewStart?: number;\n readonly viewEnd?: number;\n /** Controlled playhead in seconds. Omit for unplayed/live input. */\n readonly playhead?: number;\n};\n\nexport function AudioWaveform({\n label, data, variant = \"bars\", barCount = 128, barGap = 0.3,\n viewStart, viewEnd, playhead, className, ...rest\n}: AudioWaveformProps) {\n const clipId = useId();\n const model = waveformModel(data, barCount, viewStart, viewEnd);\n const path = waveformPath(model, variant, barGap);\n const hasPlayhead = playhead !== undefined && Number.isFinite(playhead) && model.end > model.start;\n const position = hasPlayhead ? (playhead - model.start) / (model.end - model.start) * 1000 : 0;\n const playedWidth = Math.max(0, Math.min(1000, position));\n return <svg\n role=\"img\"\n aria-label={label}\n {...rest}\n className={cn(\"gridui-audio-waveform\", className)}\n data-gridui-component=\"audio-waveform\"\n data-gridui-draw=\"graphic\"\n viewBox=\"0 0 1000 100\"\n preserveAspectRatio=\"none\"\n >\n <path d={path} fill=\"currentColor\" opacity={hasPlayhead ? 0.25 : 1} />\n {hasPlayhead && <>\n <defs><clipPath id={clipId}><rect width={playedWidth} height={100} /></clipPath></defs>\n <path d={path} fill=\"currentColor\" clipPath={`url(#${clipId})`} />\n {position >= 0 && position <= 1000 && <line\n className=\"gridui-audio-waveform-playhead\"\n x1={position} x2={position} y1={0} y2={100}\n strokeWidth={1} vectorEffect=\"non-scaling-stroke\"\n />}\n </>}\n </svg>;\n}\n", "import type { AudioWaveformData, WaveformBucket, WaveformModel } from \"./types\";\n\n/** Keep time gaps and signed extrema instead of stretching available data over a window. */\nexport function waveformModel(data: AudioWaveformData, barCount: number, viewStart?: number, viewEnd?: number): WaveformModel {\n if (!Number.isFinite(data.startTime) || !Number.isFinite(data.bucketDuration) || data.bucketDuration <= 0\n || data.min.length !== data.max.length || !Number.isSafeInteger(data.min.length) || data.min.length < 0\n || !Number.isInteger(barCount) || barCount < 1 || barCount > 512) {\n throw new RangeError(\"AudioWaveform requires a finite startTime, positive bucketDuration, equal extrema lengths, and 1\u2013512 bars.\");\n }\n const dataEnd = data.startTime + data.min.length * data.bucketDuration;\n const start = viewStart ?? data.startTime;\n const end = viewEnd ?? dataEnd;\n if (!Number.isFinite(start) || !Number.isFinite(end) || !Number.isFinite(dataEnd) || !Number.isFinite(end - start)\n || end < start || (end === start && (data.min.length !== 0 || viewStart !== undefined || viewEnd !== undefined))) {\n throw new RangeError(\"AudioWaveform requires an increasing finite time window.\");\n }\n if (data.min.length === 0) {return { buckets: [], start, end };}\n const count = Math.min(barCount, Math.max(1, Math.ceil((end - start) / data.bucketDuration)));\n const duration = (end - start) / count;\n const buckets = Array.from({ length: count }, (_, index): WaveformBucket | null => {\n const from = start + index * duration;\n const to = start + (index + 1) * duration;\n const first = Math.max(0, Math.floor((from - data.startTime) / data.bucketDuration));\n const last = Math.min(data.min.length, Math.ceil((to - data.startTime) / data.bucketDuration));\n let low = Infinity;\n let high = -Infinity;\n let actualStart = to;\n let actualEnd = from;\n for (let source = first; source < last; source++) {\n const sourceStart = data.startTime + source * data.bucketDuration;\n const sourceEnd = data.startTime + (source + 1) * data.bucketDuration;\n if (sourceEnd <= from || sourceStart >= to) {continue;}\n const min = data.min[source];\n const max = data.max[source];\n if (min === undefined || max === undefined || !Number.isFinite(min) || !Number.isFinite(max) || min > max) {continue;}\n low = Math.min(low, Math.max(-1, Math.min(1, min)));\n high = Math.max(high, Math.max(-1, Math.min(1, max)));\n actualStart = Math.min(actualStart, Math.max(from, sourceStart));\n actualEnd = Math.max(actualEnd, Math.min(to, sourceEnd));\n }\n return low === Infinity ? null : { start: actualStart, end: actualEnd, min: low, max: high };\n });\n return { buckets, start, end };\n}\n\nexport function waveformPath(model: WaveformModel, variant: \"bars\" | \"envelope\", barGap: number): string {\n if (!Number.isFinite(barGap) || barGap < 0 || barGap >= 1) {\n throw new RangeError(\"AudioWaveform barGap must be a finite fraction from 0 (inclusive) to 1 (exclusive).\");\n }\n const { buckets, start, end } = model;\n if (end <= start || buckets.length === 0) {return \"\";}\n const x = (time: number): number => (time - start) / (end - start) * 1000;\n const y = (value: number): number => (1 - value) * 50;\n if (variant === \"bars\") {\n return buckets.map((bucket, index) => {\n if (!bucket || bucket.min === bucket.max) {return \"\";}\n // Only interior edges get a bar gap; the first and last data edges stay flush.\n const gap = (x(bucket.end) - x(bucket.start)) * barGap / 2;\n const left = x(bucket.start) + (index === 0 ? 0 : gap);\n const right = x(bucket.end) - (index === buckets.length - 1 ? 0 : gap);\n return `M${left},${y(bucket.max)}H${right}V${y(bucket.min)}H${left}Z`;\n }).join(\" \");\n }\n const paths: string[] = [];\n let run: WaveformBucket[] = [];\n const flush = (): void => {\n if (run.length === 0) {return;}\n const first = run[0]!;\n const last = run[run.length - 1]!;\n const top = run.map(bucket => `L${x((bucket.start + bucket.end) / 2)},${y(bucket.max)}`).join(\" \");\n const bottom = [...run].reverse().map(bucket => `L${x((bucket.start + bucket.end) / 2)},${y(bucket.min)}`).join(\" \");\n paths.push(`M${x(first.start)},${y(first.max)} ${top} L${x(last.end)},${y(last.max)} L${x(last.end)},${y(last.min)} ${bottom} L${x(first.start)},${y(first.min)}Z`);\n run = [];\n };\n for (const bucket of buckets) {\n if (bucket) {\n if (run.length > 0 && bucket.start > run[run.length - 1]!.end) {flush();}\n run.push(bucket);\n } else {flush();}\n }\n flush();\n return paths.join(\" \");\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["/**\n * @author WMXPY\n * @package Audio Waveform\n * @namespace AudioWaveform\n * @description Audio Waveform\n */\n\nimport { cn } from \"@gridui/style-utils\";\nimport { useId, type ComponentPropsWithRef } from \"react\";\nimport { waveformModel, waveformPath } from \"./model\";\nimport type { AudioWaveformData } from \"./types\";\n\nexport type AudioWaveformProps = Omit<ComponentPropsWithRef<\"svg\">, \"children\" | \"viewBox\" | \"preserveAspectRatio\"> & {\n /** Accessible description of the audio source; not a visible heading. */\n readonly label: string;\n readonly data: AudioWaveformData;\n readonly variant?: \"bars\" | \"envelope\";\n /** Maximum display buckets. Peak aggregation preserves short transients. */\n readonly barCount?: number;\n readonly barGap?: number;\n /** Seconds on the same clock as data.startTime. */\n readonly viewStart?: number;\n readonly viewEnd?: number;\n /** Controlled playhead in seconds. Omit for unplayed/live input. */\n readonly playhead?: number;\n};\n\nexport function AudioWaveform({\n label, data, variant = \"bars\", barCount = 128, barGap = 0.3,\n viewStart, viewEnd, playhead, className, ...rest\n}: AudioWaveformProps) {\n const clipId = useId();\n const model = waveformModel(data, barCount, viewStart, viewEnd);\n const path = waveformPath(model, variant, barGap);\n const hasPlayhead = playhead !== undefined && Number.isFinite(playhead) && model.end > model.start;\n const position = hasPlayhead ? (playhead - model.start) / (model.end - model.start) * 1000 : 0;\n const playedWidth = Math.max(0, Math.min(1000, position));\n return <svg\n role=\"img\"\n aria-label={label}\n {...rest}\n className={cn(\"gridui-audio-waveform\", className)}\n data-gridui-component=\"audio-waveform\"\n data-gridui-draw=\"graphic\"\n viewBox=\"0 0 1000 100\"\n preserveAspectRatio=\"none\"\n >\n <path d={path} fill=\"currentColor\" opacity={hasPlayhead ? 0.25 : 1} />\n {hasPlayhead && <>\n <defs><clipPath id={clipId}><rect width={playedWidth} height={100} /></clipPath></defs>\n <path d={path} fill=\"currentColor\" clipPath={`url(#${clipId})`} />\n {position >= 0 && position <= 1000 && <line\n className=\"gridui-audio-waveform-playhead\"\n x1={position} x2={position} y1={0} y2={100}\n strokeWidth={1} vectorEffect=\"non-scaling-stroke\"\n />}\n </>}\n </svg>;\n}\n", "/**\n * @author WMXPY\n * @package Audio Waveform\n * @namespace AudioWaveform\n * @description Model\n */\n\nimport type { AudioWaveformData, WaveformBucket, WaveformModel } from \"./types\";\n\n/** Keep time gaps and signed extrema instead of stretching available data over a window. */\nexport function waveformModel(data: AudioWaveformData, barCount: number, viewStart?: number, viewEnd?: number): WaveformModel {\n if (!Number.isFinite(data.startTime) || !Number.isFinite(data.bucketDuration) || data.bucketDuration <= 0\n || data.min.length !== data.max.length || !Number.isSafeInteger(data.min.length) || data.min.length < 0\n || !Number.isInteger(barCount) || barCount < 1 || barCount > 512) {\n throw new RangeError(\"AudioWaveform requires a finite startTime, positive bucketDuration, equal extrema lengths, and 1\u2013512 bars.\");\n }\n const dataEnd = data.startTime + data.min.length * data.bucketDuration;\n const start = viewStart ?? data.startTime;\n const end = viewEnd ?? dataEnd;\n if (!Number.isFinite(start) || !Number.isFinite(end) || !Number.isFinite(dataEnd) || !Number.isFinite(end - start)\n || end < start || (end === start && (data.min.length !== 0 || viewStart !== undefined || viewEnd !== undefined))) {\n throw new RangeError(\"AudioWaveform requires an increasing finite time window.\");\n }\n if (data.min.length === 0) {return { buckets: [], start, end };}\n const count = Math.min(barCount, Math.max(1, Math.ceil((end - start) / data.bucketDuration)));\n const duration = (end - start) / count;\n const buckets = Array.from({ length: count }, (_, index): WaveformBucket | null => {\n const from = start + index * duration;\n const to = start + (index + 1) * duration;\n const first = Math.max(0, Math.floor((from - data.startTime) / data.bucketDuration));\n const last = Math.min(data.min.length, Math.ceil((to - data.startTime) / data.bucketDuration));\n let low = Infinity;\n let high = -Infinity;\n let actualStart = to;\n let actualEnd = from;\n for (let source = first; source < last; source++) {\n const sourceStart = data.startTime + source * data.bucketDuration;\n const sourceEnd = data.startTime + (source + 1) * data.bucketDuration;\n if (sourceEnd <= from || sourceStart >= to) {continue;}\n const min = data.min[source];\n const max = data.max[source];\n if (min === undefined || max === undefined || !Number.isFinite(min) || !Number.isFinite(max) || min > max) {continue;}\n low = Math.min(low, Math.max(-1, Math.min(1, min)));\n high = Math.max(high, Math.max(-1, Math.min(1, max)));\n actualStart = Math.min(actualStart, Math.max(from, sourceStart));\n actualEnd = Math.max(actualEnd, Math.min(to, sourceEnd));\n }\n return low === Infinity ? null : { start: actualStart, end: actualEnd, min: low, max: high };\n });\n return { buckets, start, end };\n}\n\nexport function waveformPath(model: WaveformModel, variant: \"bars\" | \"envelope\", barGap: number): string {\n if (!Number.isFinite(barGap) || barGap < 0 || barGap >= 1) {\n throw new RangeError(\"AudioWaveform barGap must be a finite fraction from 0 (inclusive) to 1 (exclusive).\");\n }\n const { buckets, start, end } = model;\n if (end <= start || buckets.length === 0) {return \"\";}\n const x = (time: number): number => (time - start) / (end - start) * 1000;\n const y = (value: number): number => (1 - value) * 50;\n if (variant === \"bars\") {\n return buckets.map((bucket, index) => {\n if (!bucket || bucket.min === bucket.max) {return \"\";}\n // Only interior edges get a bar gap; the first and last data edges stay flush.\n const gap = (x(bucket.end) - x(bucket.start)) * barGap / 2;\n const left = x(bucket.start) + (index === 0 ? 0 : gap);\n const right = x(bucket.end) - (index === buckets.length - 1 ? 0 : gap);\n return `M${left},${y(bucket.max)}H${right}V${y(bucket.min)}H${left}Z`;\n }).join(\" \");\n }\n const paths: string[] = [];\n let run: WaveformBucket[] = [];\n const flush = (): void => {\n if (run.length === 0) {return;}\n const first = run[0]!;\n const last = run[run.length - 1]!;\n const top = run.map(bucket => `L${x((bucket.start + bucket.end) / 2)},${y(bucket.max)}`).join(\" \");\n const bottom = [...run].reverse().map(bucket => `L${x((bucket.start + bucket.end) / 2)},${y(bucket.min)}`).join(\" \");\n paths.push(`M${x(first.start)},${y(first.max)} ${top} L${x(last.end)},${y(last.max)} L${x(last.end)},${y(last.min)} ${bottom} L${x(first.start)},${y(first.min)}Z`);\n run = [];\n };\n for (const bucket of buckets) {\n if (bucket) {\n if (run.length > 0 && bucket.start > run[run.length - 1]!.end) {flush();}\n run.push(bucket);\n } else {flush();}\n }\n flush();\n return paths.join(\" \");\n}\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
package/dist/styled.js ADDED
@@ -0,0 +1,2 @@
1
+ import "./styles.local.css";
2
+ export * from "./index.js";
@@ -0,0 +1,19 @@
1
+ /*! tailwindcss v4.3.5 | MIT License | https://tailwindcss.com */
2
+ @layer theme, base, components, utilities;
3
+ @layer utilities;
4
+ @layer components {
5
+ .gridui-audio-waveform {
6
+ display: block;
7
+ inline-size: 100%;
8
+ block-size: 100%;
9
+ min-inline-size: 0;
10
+ padding: 0;
11
+ margin: 0;
12
+ border: 0;
13
+ background: transparent;
14
+ color: var(--gridui-accent-background);
15
+ }
16
+ .gridui-audio-waveform-playhead {
17
+ stroke: var(--gridui-foreground);
18
+ }
19
+ }
package/docs/catalog.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "name": "@gridui/audio-waveform",
4
- "version": "1.0.0",
4
+ "version": "1.1.0",
5
5
  "category": "data",
6
6
  "description": "Content-only GridUI time-domain audio visualization",
7
7
  "usage": "`AudioWaveform` displays signed audio extrema over time, as bars or a continuous envelope. Import `AudioWaveform`, `AudioWaveformProps`, and `AudioWaveformData` from the package root. Load `@gridui/theme/styles.css`, then `@gridui/audio-waveform/styles.css`.",
@@ -31,6 +31,7 @@
31
31
  "@gridui/theme/styles.css",
32
32
  "@gridui/audio-waveform/styles.css"
33
33
  ],
34
+ "styledImport": "@gridui/audio-waveform/styled",
34
35
  "examples": [
35
36
  "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-data/audio-waveform/stories/getting-started.mdx",
36
37
  "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-data/audio-waveform/stories/recordings-and-windows.mdx",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gridui/audio-waveform",
3
- "version": "1.0.0",
3
+ "version": "1.1.0",
4
4
  "description": "Content-only GridUI time-domain audio visualization",
5
5
  "license": "UNLICENSED",
6
6
  "type": "module",
@@ -10,14 +10,19 @@
10
10
  "docs"
11
11
  ],
12
12
  "sideEffects": [
13
- "**/*.css"
13
+ "**/*.css",
14
+ "./dist/styled.js"
14
15
  ],
15
16
  "exports": {
16
17
  ".": {
17
18
  "types": "./dist/index.d.ts",
18
19
  "import": "./dist/index.js"
19
20
  },
20
- "./styles.css": "./dist/styles.css"
21
+ "./styles.css": "./dist/styles.css",
22
+ "./styled": {
23
+ "types": "./dist/index.d.ts",
24
+ "import": "./dist/styled.js"
25
+ }
21
26
  },
22
27
  "publishConfig": {
23
28
  "access": "public"
@@ -28,7 +33,7 @@
28
33
  },
29
34
  "dependencies": {
30
35
  "@gridui/style-utils": "^4.0.0",
31
- "@gridui/theme": "^3.0.0"
36
+ "@gridui/theme": "^4.0.0"
32
37
  },
33
38
  "devDependencies": {
34
39
  "@gridui-internal/configuration": "0.0.0-internal",