@design.estate/wcctools 5.1.0 → 6.1.0

package/dist_ts_shell/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * The wcctools shell bundle: the catalog UI that `wcctools dev` serves on `/wcctools/`.
+ */
+export { WccShell } from './elements/wcc-shell.js';

package/dist_ts_shell/index.js

@@ -0,0 +1,5 @@
+/**
+ * The wcctools shell bundle: the catalog UI that `wcctools dev` serves on `/wcctools/`.
+ */
+export { WccShell } from './elements/wcc-shell.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19zaGVsbC9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7R0FFRztBQUNILE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQyJ9

package/dist_ts_shell/plugins.d.ts

@@ -0,0 +1,4 @@
+import * as deesDomtools from '@design.estate/dees-domtools';
+import * as interfaces from '../dist_ts_interfaces/index.js';
+import * as shared from '../dist_ts_shared/index.js';
+export { deesDomtools, interfaces, shared, };

package/dist_ts_shell/plugins.js

@@ -0,0 +1,5 @@
+import * as deesDomtools from '@design.estate/dees-domtools';
+import * as interfaces from '../dist_ts_interfaces/index.js';
+import * as shared from '../dist_ts_shared/index.js';
+export { deesDomtools, interfaces, shared, };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzX3NoZWxsL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLFlBQVksTUFBTSw4QkFBOEIsQ0FBQztBQUU3RCxPQUFPLEtBQUssVUFBVSxNQUFNLDJCQUEyQixDQUFDO0FBQ3hELE9BQU8sS0FBSyxNQUFNLE1BQU0sdUJBQXVCLENBQUM7QUFFaEQsT0FBTyxFQUNMLFlBQVksRUFDWixVQUFVLEVBQ1YsTUFBTSxHQUNQLENBQUMifQ==

package/dist_ts_shell/previewconnection.d.ts

@@ -0,0 +1,30 @@
+import * as plugins from './plugins.js';
+export interface IWccPreviewConnectionHandlers {
+    /** A preview document installed its bridge; called again after every reload of the frame. */
+    onReady: (bridgeArg: plugins.interfaces.IWccPreviewBridge) => void;
+    /** The connected preview document is going away (reload or navigation). */
+    onDisconnect: () => void;
+    onEscape: () => void;
+    onScroll: (scrollYArg: number) => void;
+}
+/**
+ * The shell's connection to the preview document in its preview iframe. Each preview document posts
+ * a ready message once its bridge is installed; the connection then binds that document's
+ * bridge and listeners, and releases them when the document is hidden, so nothing of a
+ * replaced document stays referenced.
+ */
+export declare class WccPreviewConnection {
+    private readonly getIframe;
+    private readonly handlers;
+    private bridgeValue;
+    private documentDisposers;
+    private started;
+    constructor(getIframe: () => HTMLIFrameElement | null, handlers: IWccPreviewConnectionHandlers);
+    get bridge(): plugins.interfaces.IWccPreviewBridge | null;
+    start(): void;
+    dispose(): void;
+    scrollPreviewTo(scrollYArg: number): void;
+    private handleMessage;
+    private bindDocument;
+    private releaseDocument;
+}

package/dist_ts_shell/previewconnection.js

@@ -0,0 +1,86 @@
+import * as plugins from './plugins.js';
+/**
+ * The shell's connection to the preview document in its preview iframe. Each preview document posts
+ * a ready message once its bridge is installed; the connection then binds that document's
+ * bridge and listeners, and releases them when the document is hidden, so nothing of a
+ * replaced document stays referenced.
+ */
+export class WccPreviewConnection {
+    getIframe;
+    handlers;
+    bridgeValue = null;
+    documentDisposers = [];
+    started = false;
+    constructor(getIframe, handlers) {
+        this.getIframe = getIframe;
+        this.handlers = handlers;
+    }
+    get bridge() {
+        return this.bridgeValue;
+    }
+    start() {
+        if (this.started) {
+            return;
+        }
+        this.started = true;
+        window.addEventListener('message', this.handleMessage);
+    }
+    dispose() {
+        window.removeEventListener('message', this.handleMessage);
+        this.started = false;
+        this.releaseDocument();
+    }
+    scrollPreviewTo(scrollYArg) {
+        if (this.bridgeValue) {
+            this.getIframe()?.contentWindow?.scrollTo(0, scrollYArg);
+        }
+    }
+    handleMessage = (eventArg) => {
+        const previewWindow = this.getIframe()?.contentWindow;
+        if (!previewWindow
+            || eventArg.source !== previewWindow
+            || eventArg.origin !== window.location.origin
+            || !plugins.shared.isPreviewReadyMessage(eventArg.data)) {
+            return;
+        }
+        // A document that reloaded again since it posted installs its own bridge and posts again
+        const bridge = previewWindow.wccPreview;
+        if (!bridge) {
+            return;
+        }
+        this.releaseDocument();
+        this.bindDocument(previewWindow, bridge);
+        this.handlers.onReady(bridge);
+    };
+    bindDocument(previewWindowArg, bridgeArg) {
+        this.bridgeValue = bridgeArg;
+        const onKeydown = (eventArg) => {
+            if (eventArg.key === 'Escape') {
+                this.handlers.onEscape();
+            }
+        };
+        const onScroll = () => {
+            this.handlers.onScroll(previewWindowArg.scrollY);
+        };
+        const onPagehide = () => {
+            this.releaseDocument();
+            this.handlers.onDisconnect();
+        };
+        previewWindowArg.addEventListener('keydown', onKeydown);
+        previewWindowArg.addEventListener('scroll', onScroll, { passive: true });
+        previewWindowArg.addEventListener('pagehide', onPagehide);
+        this.documentDisposers = [
+            () => previewWindowArg.removeEventListener('keydown', onKeydown),
+            () => previewWindowArg.removeEventListener('scroll', onScroll),
+            () => previewWindowArg.removeEventListener('pagehide', onPagehide),
+        ];
+    }
+    releaseDocument() {
+        for (const dispose of this.documentDisposers) {
+            dispose();
+        }
+        this.documentDisposers = [];
+        this.bridgeValue = null;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJldmlld2Nvbm5lY3Rpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19zaGVsbC9wcmV2aWV3Y29ubmVjdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQVd4Qzs7Ozs7R0FLRztBQUNILE1BQU0sT0FBTyxvQkFBb0I7SUFNWjtJQUNBO0lBTlgsV0FBVyxHQUFnRCxJQUFJLENBQUM7SUFDaEUsaUJBQWlCLEdBQXNCLEVBQUUsQ0FBQztJQUMxQyxPQUFPLEdBQUcsS0FBSyxDQUFDO0lBRXhCLFlBQ21CLFNBQXlDLEVBQ3pDLFFBQXVDO1FBRHZDLGNBQVMsR0FBVCxTQUFTLENBQWdDO1FBQ3pDLGFBQVEsR0FBUixRQUFRLENBQStCO0lBQ3ZELENBQUM7SUFFSixJQUFXLE1BQU07UUFDZixPQUFPLElBQUksQ0FBQyxXQUFXLENBQUM7SUFDMUIsQ0FBQztJQUVNLEtBQUs7UUFDVixJQUFJLElBQUksQ0FBQyxPQUFPLEVBQUUsQ0FBQztZQUNqQixPQUFPO1FBQ1QsQ0FBQztRQUNELElBQUksQ0FBQyxPQUFPLEdBQUcsSUFBSSxDQUFDO1FBQ3BCLE1BQU0sQ0FBQyxnQkFBZ0IsQ0FBQyxTQUFTLEVBQUUsSUFBSSxDQUFDLGFBQWEsQ0FBQyxDQUFDO0lBQ3pELENBQUM7SUFFTSxPQUFPO1FBQ1osTUFBTSxDQUFDLG1CQUFtQixDQUFDLFNBQVMsRUFBRSxJQUFJLENBQUMsYUFBYSxDQUFDLENBQUM7UUFDMUQsSUFBSSxDQUFDLE9BQU8sR0FBRyxLQUFLLENBQUM7UUFDckIsSUFBSSxDQUFDLGVBQWUsRUFBRSxDQUFDO0lBQ3pCLENBQUM7SUFFTSxlQUFlLENBQUMsVUFBa0I7UUFDdkMsSUFBSSxJQUFJLENBQUMsV0FBVyxFQUFFLENBQUM7WUFDckIsSUFBSSxDQUFDLFNBQVMsRUFBRSxFQUFFLGFBQWEsRUFBRSxRQUFRLENBQUMsQ0FBQyxFQUFFLFVBQVUsQ0FBQyxD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

package/dist_ts_shell/services/recorder.service.js

@@ -0,0 +1,353 @@
+/**
+ * RecorderService - Handles all MediaRecorder, audio monitoring, and video export logic.
+ * Recording always uses MediaRecorder → WebM (the reliable browser path).
+ * MP4 output is produced by converting WebM → MP4 via mediabunny at export time.
+ */
+export class RecorderService {
+    // Recording state
+    mediaRecorder = null;
+    recordedChunks = [];
+    durationInterval = null;
+    _duration = 0;
+    _recordedBlob = null;
+    _isRecording = false;
+    _outputFormat = 'webm';
+    // Audio monitoring state
+    audioContext = null;
+    audioAnalyser = null;
+    audioMonitoringInterval = null;
+    monitoringStream = null;
+    // Current recording stream
+    currentStream = null;
+    // Event callbacks
+    events = {};
+    constructor(events) {
+        if (events) {
+            this.events = events;
+        }
+    }
+    // Public getters
+    get isRecording() {
+        return this._isRecording;
+    }
+    get duration() {
+        return this._duration;
+    }
+    get recordedBlob() {
+        return this._recordedBlob;
+    }
+    get outputFormat() {
+        return this._outputFormat;
+    }
+    // Update event callbacks
+    setEvents(events) {
+        this.events = { ...this.events, ...events };
+    }
+    // ==================== Microphone Management ====================
+    async loadMicrophones(requestPermission = false) {
+        try {
+            if (requestPermission) {
+                // Request permission by getting a temporary stream
+                const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
+                stream.getTracks().forEach(track => track.stop());
+            }
+            const devices = await navigator.mediaDevices.enumerateDevices();
+            return devices.filter(d => d.kind === 'audioinput');
+        }
+        catch (error) {
+            console.error('Error loading microphones:', error);
+            return [];
+        }
+    }
+    async startAudioMonitoring(deviceId) {
+        this.stopAudioMonitoring();
+        if (!deviceId)
+            return;
+        try {
+            const stream = await navigator.mediaDevices.getUserMedia({
+                audio: { deviceId: { exact: deviceId } }
+            });
+            this.monitoringStream = stream;
+            this.audioContext = new AudioContext();
+            const source = this.audioContext.createMediaStreamSource(stream);
+            this.audioAnalyser = this.audioContext.createAnalyser();
+            this.audioAnalyser.fftSize = 256;
+            source.connect(this.audioAnalyser);
+            const dataArray = new Uint8Array(this.audioAnalyser.frequencyBinCount);
+            this.audioMonitoringInterval = window.setInterval(() => {
+                if (this.audioAnalyser) {
+                    this.audioAnalyser.getByteFrequencyData(dataArray);
+                    const average = dataArray.reduce((a, b) => a + b) / dataArray.length;
+                    const level = Math.min(100, (average / 128) * 100);
+                    this.events.onAudioLevelUpdate?.(level);
+                }
+            }, 50);
+        }
+        catch (error) {
+            console.error('Error starting audio monitoring:', error);
+            this.events.onAudioLevelUpdate?.(0);
+        }
+    }
+    stopAudioMonitoring() {
+        if (this.audioMonitoringInterval) {
+            clearInterval(this.audioMonitoringInterval);
+            this.audioMonitoringInterval = null;
+        }
+        if (this.audioContext) {
+            this.audioContext.close();
+            this.audioContext = null;
+        }
+        if (this.monitoringStream) {
+            this.monitoringStream.getTracks().forEach(track => track.stop());
+            this.monitoringStream = null;
+        }
+        this.audioAnalyser = null;
+    }
+    // ==================== Recording Control ====================
+    async startRecording(options) {
+        try {
+            this._outputFormat = options.outputFormat || 'webm';
+            // Stop audio monitoring before recording
+            this.stopAudioMonitoring();
+            // Get video stream based on mode
+            const displayMediaOptions = {
+                video: {
+                    displaySurface: options.mode === 'viewport' ? 'browser' : 'monitor',
+                    frameRate: { ideal: 60 },
+                },
+                audio: false
+            };
+            // Add preferCurrentTab hint for viewport mode
+            if (options.mode === 'viewport') {
+                displayMediaOptions.preferCurrentTab = true;
+            }
+            const videoStream = await navigator.mediaDevices.getDisplayMedia(displayMediaOptions);
+            // If viewport mode, try to crop to viewport element using Element Capture API
+            if (options.mode === 'viewport' && options.viewportElement) {
+                try {
+                    if ('CropTarget' in window) {
+                        const cropTarget = await window.CropTarget.fromElement(options.viewportElement);
+                        const [videoTrack] = videoStream.getVideoTracks();
+                        await videoTrack.cropTo(cropTarget);
+                    }
+                }
+                catch (e) {
+                    console.warn('Element Capture not supported, recording full tab:', e);
+                }
+            }
+            // Combine video with audio if enabled
+            let combinedStream = videoStream;
+            if (options.audioDeviceId) {
+                try {
+                    const audioStream = await navigator.mediaDevices.getUserMedia({
+                        audio: { deviceId: { exact: options.audioDeviceId } }
+                    });
+                    combinedStream = new MediaStream([
+                        ...videoStream.getVideoTracks(),
+                        ...audioStream.getAudioTracks()
+                    ]);
+                }
+                catch (audioError) {
+                    console.warn('Could not add audio:', audioError);
+                }
+            }
+            // Store stream for cleanup
+            this.currentStream = combinedStream;
+            // Handle stream ending (user clicks "Stop sharing")
+            videoStream.getVideoTracks()[0].onended = () => {
+                if (this._isRecording) {
+                    this.stopRecording();
+                    this.events.onStreamEnded?.();
+                }
+            };
+            // Always record as WebM — conversion to MP4 happens at export time
+            const mimeType = MediaRecorder.isTypeSupported('video/webm;codecs=vp9')
+                ? 'video/webm;codecs=vp9'
+                : 'video/webm';
+            this.mediaRecorder = new MediaRecorder(combinedStream, {
+                mimeType,
+                videoBitsPerSecond: 8_000_000, // 8 Mbps for smooth, high-quality capture
+            });
+            this.recordedChunks = [];
+            this.mediaRecorder.ondataavailable = (e) => {
+                if (e.data.size > 0) {
+                    this.recordedChunks.push(e.data);
+                }
+            };
+            this.mediaRecorder.onstop = () => this.handleRecordingComplete();
+            this.mediaRecorder.start(1000); // Capture in 1-second chunks
+            // Start duration timer
+            this._duration = 0;
+            this.durationInterval = window.setInterval(() => {
+                this._duration++;
+                this.events.onDurationUpdate?.(this._duration);
+            }, 1000);
+            this._isRecording = true;
+        }
+        catch (error) {
+            console.error('Error starting recording:', error);
+            this._isRecording = false;
+            this.events.onError?.(error);
+            throw error;
+        }
+    }
+    stopRecording() {
+        if (this.mediaRecorder && this.mediaRecorder.state !== 'inactive') {
+            this.mediaRecorder.stop();
+        }
+        if (this.durationInterval) {
+            clearInterval(this.durationInterval);
+            this.durationInterval = null;
+        }
+    }
+    async handleRecordingComplete() {
+        const blob = new Blob(this.recordedChunks, { type: 'video/webm' });
+        this._recordedBlob = blob;
+        // Stop all tracks
+        if (this.currentStream) {
+            this.currentStream.getTracks().forEach(track => track.stop());
+            this.currentStream = null;
+        }
+        this._isRecording = false;
+        this.events.onRecordingComplete?.(this._recordedBlob);
+    }
+    // ==================== Conversion & Export ====================
+    /**
+     * Converts a WebM blob to MP4 using mediabunny's Conversion API.
+     * Uses WebCodecs for hardware-accelerated H.264 encoding.
+     */
+    async convertToMp4(webmBlob) {
+        const { Input, Output, Conversion, BlobSource, BufferTarget, Mp4OutputFormat, WEBM, QUALITY_HIGH, } = await import('mediabunny');
+        const input = new Input({
+            source: new BlobSource(webmBlob),
+            formats: [WEBM],
+        });
+        const target = new BufferTarget();
+        const output = new Output({
+            format: new Mp4OutputFormat({ fastStart: 'in-memory' }),
+            target,
+        });
+        const conversion = await Conversion.init({
+            input,
+            output,
+            // Force transcoding from VP9 → H.264 and Opus → AAC
+            video: {
+                codec: 'avc',
+                bitrate: QUALITY_HIGH,
+                fit: 'contain',
+            },
+            audio: {
+                codec: 'aac',
+                bitrate: QUALITY_HIGH,
+            },
+        });
+        await conversion.execute();
+        const buffer = target.buffer;
+        if (!buffer || buffer.byteLength === 0) {
+            throw new Error('MP4 conversion produced empty output');
+        }
+        return new Blob([buffer], { type: 'video/mp4' });
+    }
+    async exportTrimmedVideo(videoElement, trimStart, trimEnd) {
+        return new Promise((resolve, reject) => {
+            // Create a canvas for capturing frames
+            const canvas = document.createElement('canvas');
+            canvas.width = videoElement.videoWidth || 1280;
+            canvas.height = videoElement.videoHeight || 720;
+            const ctx = canvas.getContext('2d');
+            if (!ctx) {
+                reject(new Error('Could not get canvas context'));
+                return;
+            }
+            // Create canvas stream for video
+            const canvasStream = canvas.captureStream(30);
+            // Try to capture audio from video element
+            let combinedStream;
+            try {
+                // Create audio context to capture video's audio
+                const audioCtx = new AudioContext();
+                const source = audioCtx.createMediaElementSource(videoElement);
+                const destination = audioCtx.createMediaStreamDestination();
+                source.connect(destination);
+                source.connect(audioCtx.destination); // Also play through speakers
+                // Combine video (from canvas) and audio (from video element)
+                combinedStream = new MediaStream([
+                    ...canvasStream.getVideoTracks(),
+                    ...destination.stream.getAudioTracks()
+                ]);
+                // Store audioCtx for cleanup
+                const cleanup = () => {
+                    audioCtx.close();
+                };
+                this.recordTrimmedStream(videoElement, canvas, ctx, combinedStream, trimStart, trimEnd, cleanup, resolve, reject);
+            }
+            catch (audioError) {
+                console.warn('Could not capture audio, recording video only:', audioError);
+                combinedStream = canvasStream;
+                this.recordTrimmedStream(videoElement, canvas, ctx, combinedStream, trimStart, trimEnd, () => { }, resolve, reject);
+            }
+        });
+    }
+    recordTrimmedStream(video, canvas, ctx, stream, trimStart, trimEnd, cleanup, resolve, reject) {
+        const mimeType = MediaRecorder.isTypeSupported('video/webm;codecs=vp9')
+            ? 'video/webm;codecs=vp9'
+            : 'video/webm';
+        const recorder = new MediaRecorder(stream, { mimeType });
+        const chunks = [];
+        recorder.ondataavailable = (e) => {
+            if (e.data.size > 0) {
+                chunks.push(e.data);
+            }
+        };
+        recorder.onstop = () => {
+            cleanup();
+            resolve(new Blob(chunks, { type: 'video/webm' }));
+        };
+        recorder.onerror = (e) => {
+            cleanup();
+            reject(new Error('Recording error: ' + e));
+        };
+        // Seek to trim start
+        video.currentTime = trimStart;
+        video.onseeked = () => {
+            // Start recording
+            recorder.start(100);
+            // Start playing
+            video.play();
+            // Draw frames to canvas
+            const drawFrame = () => {
+                if (video.currentTime >= trimEnd || video.paused || video.ended) {
+                    video.pause();
+                    video.onseeked = null;
+                    // Give a small delay before stopping to ensure last frame is captured
+                    setTimeout(() => {
+                        if (recorder.state === 'recording') {
+                            recorder.stop();
+                        }
+                    }, 100);
+                    return;
+                }
+                ctx.drawImage(video, 0, 0, canvas.width, canvas.height);
+                requestAnimationFrame(drawFrame);
+            };
+            drawFrame();
+        };
+    }
+    // ==================== Cleanup ====================
+    reset() {
+        this._recordedBlob = null;
+        this.recordedChunks = [];
+        this._duration = 0;
+        this._isRecording = false;
+    }
+    dispose() {
+        this.stopRecording();
+        this.stopAudioMonitoring();
+        this.reset();
+        if (this.currentStream) {
+            this.currentStream.getTracks().forEach(track => track.stop());
+            this.currentStream = null;
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVjb3JkZXIuc2VydmljZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzX3NoZWxsL3NlcnZpY2VzL3JlY29yZGVyLnNlcnZpY2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7R0FJRztBQW1CSCxNQUFNLE9BQU8sZUFBZTtJQUMxQixrQkFBa0I7SUFDVixhQUFhLEdBQXlCLElBQUksQ0FBQztJQUMzQyxjQUFjLEdBQVcsRUFBRSxDQUFDO0lBQzVCLGdCQUFnQixHQUFrQixJQUFJLENBQUM7SUFDdkMsU0FBUyxHQUFXLENBQUMsQ0FBQztJQUN0QixhQUFhLEdBQWdCLElBQUksQ0FBQztJQUNsQyxZQUFZLEdBQVksS0FBSyxDQUFDO0lBQzlCLGFBQWEsR0FBa0IsTUFBTSxDQUFDO0lBRTlDLHlCQUF5QjtJQUNqQixZQUFZLEdBQXdCLElBQUksQ0FBQztJQUN6QyxhQUFhLEdBQXdCLElBQUksQ0FBQztJQUMxQyx1QkFBdUIsR0FBa0IsSUFBSSxDQUFDO0lBQzlDLGdCQUFnQixHQUF1QixJQUFJLENBQUM7SUFFcEQsMkJBQTJCO0lBQ25CLGFBQWEsR0FBdUIsSUFBSSxDQUFDO0lBRWpELGtCQUFrQjtJQUNWLE1BQU0sR0FBb0IsRUFBRSxDQUFDO0lBRXJDLFlBQVksTUFBd0I7UUFDbEMsSUFBSSxNQUFNLEVBQUUsQ0FBQztZQUNYLElBQUksQ0FBQyxNQUFNLEdBQUcsTUFBTSxDQUFDO1FBQ3ZCLENBQUM7SUFDSCxDQUFDO0lBRUQsaUJBQWlCO0lBQ2pCLElBQUksV0FBVztRQUNiLE9BQU8sSUFBSSxDQUFDLFlBQVksQ0FBQztJQUMzQixDQUFDO0lBRUQsSUFBSSxRQUFRO1FBQ1YsT0FBTyxJQUFJLENBQUMsU0FBUyxDQUFDO0lBQ3hCLENBQUM7SUFFRCxJQUFJLFlBQVk7UUFDZCxPQUFPLElBQUksQ0FBQyxhQUFhLENBQUM7SUFDNUIsQ0FBQztJQUVELElBQUksWUFBWTtRQUNkLE9BQU8sSUFBSSxDQUFDLGFBQWEs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

package/dist_ts_web/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@design.estate/wcctools',
-    version: '5.1.0',
+    version: '6.1.0',
     description: 'A set of web component tools for creating element catalogues, enabling the structured development and documentation of custom elements and pages.'
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHNfd2ViLzAwX2NvbW1pdGluZm9fZGF0YS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7R0FFRztBQUNILE1BQU0sQ0FBQyxNQUFNLFVBQVUsR0FBRztJQUN4QixJQUFJLEVBQUUseUJBQXlCO0lBQy9CLE9BQU8sRUFBRSxPQUFPO0lBQ2hCLFdBQVcsRUFBRSxtSkFBbUo7Q0FDakssQ0FBQSJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHNfd2ViLzAwX2NvbW1pdGluZm9fZGF0YS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7R0FFRztBQUNILE1BQU0sQ0FBQyxNQUFNLFVBQVUsR0FBRztJQUN4QixJQUFJLEVBQUUseUJBQXlCO0lBQy9CLE9BQU8sRUFBRSxPQUFPO0lBQ2hCLFdBQVcsRUFBRSxtSkFBbUo7Q0FDakssQ0FBQSJ9

package/dist_ts_web/catalog.d.ts

@@ -0,0 +1,45 @@
+import * as plugins from './wcctools.plugins.js';
+import { type ICatalogElementConstructor, type TTemplateFactory } from './elements/wcctools.helpers.js';
+import type { IWccConfig, IWccSection } from './wcctools.interfaces.js';
+type TSectionEntry = [string, any];
+/**
+ * The navigable entries of a section, after classification and the section's own filter and sort.
+ * Elements sections keep only custom element classes with a usable static `demo`;
+ * pages sections keep only template factories.
+ */
+export declare const getSectionItems: (section: IWccSection) => TSectionEntry[];
+/**
+ * Registered custom elements of an elements section that have no usable demo.
+ * They are listed (not navigable) in the sidebar's "Without demo" group.
+ */
+export declare const getSectionItemsWithoutDemo: (section: IWccSection) => TSectionEntry[];
+/** What a selection resolves to: something to render, or the reason there is nothing. */
+export type TWccCatalogTarget = {
+    kind: 'element';
+    factory: TTemplateFactory;
+    elementClass: ICatalogElementConstructor;
+} | {
+    kind: 'page';
+    factory: TTemplateFactory;
+} | {
+    kind: 'empty';
+    reason: plugins.interfaces.TWccEmptyReason;
+    emptyState: plugins.interfaces.IWccEmptyState;
+};
+/**
+ * The catalog of one `setupWccTools` call: classifies its sections, describes them as a
+ * data-only manifest and resolves selections to template factories.
+ */
+export declare class WccCatalog {
+    private readonly sections;
+    constructor(configArg: IWccConfig);
+    getManifest(): plugins.interfaces.IWccCatalogManifest;
+    resolve(selectionArg: plugins.interfaces.IWccSelection | null): TWccCatalogTarget;
+    /**
+     * Resolve a section/item pair to a listed entry, or to the reason it cannot be previewed.
+     * The section names `element` and `page` of links from before sections existed search every section.
+     */
+    private resolveEntry;
+    private getUnavailableEmptyState;
+}
+export {};