Software for independent culture. Tools for discovering clips, searching recordings, making music visuals, publishing link pages, and organizing shows.
@subcult/archive-viewer (0.1.0)
Installation
@subcult:registry=https://git.subcult.tv/api/packages/subculture-collective/npm/npm install @subcult/[email protected]"@subcult/archive-viewer": "0.1.0"About this package
Shared archive viewer
@subcult/archive-viewer provides the typed video API, playback/schedule model,
viewer hook and composed player/library/channel components. React is supplied by
the consumer. The package includes no brand assets, global CSS or page layout.
import { useViewer, Screen, ChannelPanel, Library } from '@subcult/archive-viewer';
function Archive() {
const viewer = useViewer('democracy_now_vid');
return <main>
<Screen viewer={viewer}><p>Select an episode.</p></Screen>
<ChannelPanel viewer={viewer} />
<Library viewer={viewer} />
</main>;
}
Consumers own page composition and CSS for the documented classes already used
by the video apps. Player uses native video controls, source attribution,
caption controls and explicit loading/failure messages. A keyed player owns one
asset; channel clock updates do not reload it. useViewer exposes listener-local
state and commands independently of page layout. Set
useViewer(collection, { scrollTarget: false }) for consumer-owned navigation,
or supply a custom selector. The default retains the existing #screen scroll
behavior and honors reduced motion.
This release supports video API version 1. Compatibility verifies the exact
collection for standalone consumers. Mixed-collection support is not implemented
by this package extraction. Existing acquisition/publication policies stay on
the server.
Build with the pinned root pnpm version using pnpm build:packages. Packages
ship compiled ESM and declarations; consumers need no sibling source checkout.
The legacy scripts/export_viewer.py remains a compatibility path until every
consumer adopts released packages. Edit these sources; web compatibility barrels
and legacy exported copies are not separate editing authorities.
GPL-3.0-only software. Media and identity assets retain their separate owners.
Dependencies
Development Dependencies
| ID | Version |
|---|---|
| @eslint/js | ^9.39.1 |
| @types/react | ^19.2.15 |
| @types/react-dom | ^19.2.3 |
| eslint | ^9.39.4 |
| react | ^19.2.0 |
| react-dom | ^19.2.0 |
| typescript | ^5.9.3 |
| typescript-eslint | ^8.46.3 |
| vitest | ^4.0.8 |
Peer Dependencies
| ID | Version |
|---|---|
| react | ^19.2.0 |