@design.estate/wcctools 5.1.0

package/.smartconfig.json

@@ -0,0 +1,65 @@
+{
+  "@git.zone/cli": {
+    "projectType": "wcc",
+    "module": {
+      "githost": "code.foss.global",
+      "gitscope": "design.estate",
+      "gitrepo": "wcctools",
+      "description": "A set of web component tools for creating element catalogues, enabling the structured development and documentation of custom elements and pages.",
+      "npmPackagename": "@design.estate/wcctools",
+      "license": "MIT",
+      "projectDomain": "design.estate",
+      "keywords": [
+        "web components",
+        "element catalogues",
+        "custom elements",
+        "documentation",
+        "typescript",
+        "lit",
+        "component development",
+        "design system",
+        "element testing",
+        "page development"
+      ]
+    },
+    "release": {
+      "targets": {
+        "git": {
+          "enabled": true,
+          "remote": "origin",
+          "pushBranch": true,
+          "pushTags": true
+        },
+        "npm": {
+          "enabled": true,
+          "registries": [
+            "https://verdaccio.lossless.digital",
+            "https://registry.npmjs.org"
+          ],
+          "accessLevel": "public",
+          "alreadyPublished": "success"
+        },
+        "docker": {
+          "enabled": false
+        }
+      }
+    },
+    "schemaVersion": 2
+  },
+  "@git.zone/tsdoc": {
+    "legal": "\n## License and Legal Information\n\nThis repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license.md) file within this repository. \n\n**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.\n\n### Trademarks\n\nThis project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.\n\n### Company Information\n\nTask Venture Capital GmbH  \nRegistered at District court Bremen HRB 35230 HB, Germany\n\nFor any legal inquiries or if you require further information, please contact us via email at hello@task.vc.\n\nBy using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.\n"
+  },
+  "@git.zone/tsbundle": {
+    "bundles": [
+      {
+        "from": "./html/index.ts",
+        "to": "./dist_bundle/bundle.js",
+        "outputMode": "bundle",
+        "bundler": "esbuild"
+      }
+    ]
+  },
+  "@git.zone/tswatch": {
+    "preset": "element"
+  }
+}

package/changelog.md

@@ -0,0 +1,414 @@
+# Changelog
+
+## 2026-10-06 - 5.1.0
+
+### Features
+
+- The package is published as `@design.estate/wcctools` (formerly `@design.estate/dees-wcctools`) from the `design.estate/wcctools` repository on code.foss.global. The API is unchanged: replace the dependency and the import specifier (readme section "Migrating from `@design.estate/dees-wcctools`").
+
+### Maintenance
+
+- Release tooling: pnpm 12.8.1 and `@git.zone/tstest` ^7.1.0.
+
+## 2026-10-03 - 5.0.0
+
+### Breaking Changes
+
+- The tools run on `@design.estate/dees-element` 4 and `@design.estate/dees-domtools` 5: the exported `WccRecordButton` and `WccRecordingPanel` extend dees-element 4's `DeesElement` (whose `domtools` drops `convenience.smartdelay` in favour of `convenience.smartpromise` and uses typedrequest 9); a catalogue still on dees-element 3 moves to 4 together with this release.
+- `setupWccTools()` takes only the config object: the two-argument `setupWccTools(elements, pages)` form is removed (pass `{ sections: [{ name: 'Pages', type: 'pages', items: pages }, { name: 'Elements', type: 'elements', items: elements }] }`), and the `@design.estate/dees-wcctools/demotools` subpath is removed (import `DeesDemoWrapper` from `@design.estate/dees-element/demotools`).
+
+### Fixes
+
+- The production tree no longer reaches the deprecated `@push.rocks/smartdelay` or `@push.rocks/isounique`; the lockfile takes lik 6.4.4, smartstring 4.2.1 and smarttime 5.0.1.
+
+### Maintenance
+
+- Release tooling: pnpm 12.7.0, `@git.zone/tsbuild` ^5.1.2, `@git.zone/tsbundle` ^3.1.3, `@git.zone/tsdoc` ^3.0.2, `@git.zone/tstest` ^7.0.0, `@git.zone/tswatch` ^6.0.1 and `@types/node` ^26.6.3.
+
+## 2026-10-01 - 4.0.1
+
+### Fixes
+
+- Remove the unused, deprecated `@push.rocks/smartdelay` dependency.
+
+### Maintenance
+
+- Release tooling currency: pin `packageManager` to `pnpm@12.6.0` (from 12.5.1) and `@git.zone/tsrun` `^3.0.2` (from ^3.0.1); `@git.zone/tsbuild` `^5.0.0`, `@git.zone/tsbundle` `^3.0.0`, `@git.zone/tstest` `^6.3.2` and `@types/node` `^26.6.2` are already current. Drop the empty `@ship.zone/szci` config block.
+- Raise `@git.zone/tsdoc` to `^3.0.0` (from ^2.2.2) and `@git.zone/tswatch` to `^5.0.0` (from ^4.0.2). `buildDocs` keeps calling `tsdoc` without arguments, which tsdoc 3 still runs as its default TypeDoc build; `watch` keeps calling `tswatch`, which reads the existing `element` preset from `.smartconfig.json`.
+
+## 2026-09-29 - 4.0.0
+
+### Breaking Changes
+
+- The tools run on `@design.estate/dees-element` 3 and `@design.estate/dees-domtools` 3 (from 2.4 and 2.5). The exported `WccRecordButton` and `WccRecordingPanel` extend dees-element 3's `DeesElement`, and `./demotools` re-exports dees-element 3's demo tools; a catalogue still on dees-element 2 moves to 3 together with this release.
+- `WccDashboard.setWarning()` and `WccDashboard.warning` are removed, and so is `WccFrame.getDisplayedInstance()`, which resolved nothing; the properties panel finds the displayed demo instance itself.
+- The sidebar no longer lists exports that are not elements with a demo; a section `filter` sees only those entries.
+
+### Features
+
+- The sidebar lists only elements that have a demo. Exports that are not elements — helpers, types, constants — are left out, and registered elements without a demo sit in a collapsed "Without demo" group, so the element list is the catalogue of demos and nothing else. Routes to an entry that cannot be shown get an empty state instead of a blank frame.
+- The sidebar is a keyboard-navigable tree: arrows, Home, End, Enter and Space move and open, the search field hands over with ArrowDown and clears with Escape, and the context menu opens with the menu key or Shift+F10. The toolbar's theme and viewport buttons report their state, the resize handle is a separator that arrow keys move, and the frame and properties panel are named regions.
+
+### Fixes
+
+- A demo renders once when it is selected and no longer again on every dashboard update, so its state survives viewport and theme changes; the route is applied once, stale renders are dropped, and the dashboard's route handlers and Escape listener end when it is removed.
+- The dashboard's scroll listeners and its scroll, route and setup timers end when it is removed and return when it is added again, so a removed dashboard no longer rewrites the URL or updates its frame; the sidebar's native-mode hide and group highlight timers end the same way, and leaving native mode within 300 ms no longer hides the sidebar anyway.
+- Debug logging is gone from the dashboard, frame and properties panel.
+
+### Maintenance
+
+- The development plan and hints moved out of the repository into the untracked `.nogit/` folder, so the published package no longer carries `readme.plan.md` and `readme.hints.md`.
+- Release tooling currency: `packageManager` pnpm@12.5.1, `@git.zone/tsbuild` ^5.0.0, `@git.zone/tsbundle` ^3.0.0, `@git.zone/tstest` ^6.3.2, `@git.zone/tswatch` ^4.0.2, `@git.zone/tsrun` ^3.0.1, `@git.zone/tsdoc` ^2.2.2 and `@types/node` ^26.6.2. No migration moves anything: no source folder has its own `tsconfig.json`, the demo bundle is not a production bundle and so carries no third-party notices, the tests use no `TapNodeTools` helpers, and nothing reads `process.argv`.
+
+## 2026-09-05 - 3.9.4
+
+### Fixes
+
+- find demo instances through deeply composed DOM (properties)
+  - Replace the properties panel's depth-limited recursive search with a reusable helper that traverses light DOM and open shadow roots.
+  - Add browser test coverage for deeply nested composed demo instances and nearest-match selection.
+  - Document composed demo instance discovery in the properties panel.
+- update development tooling dependencies (deps)
+  - Bump @git.zone/tsbundle to ^2.13.0
+  - Bump @types/node to ^26.4.1
+  - Update package manager to pnpm 12.3.4
+- remove tag release job from default workflow (ci)
+  - Removes the tag-triggered npm publish job from .gitea/workflows/default_tags.yaml.
+  - Keeps tag-based metadata handling dependent on the test job.
+
+## 2026-08-10 - 3.9.3
+
+### Fixes
+
+- Make property inspection compatible with Lit standard accessors by skipping internal state and properties without supported runtime type metadata.
+- Keep phone, phablet, and tablet preview containers at their declared widths without body-width-derived padding.
+- Stack and constrain WCC chrome on narrow browser viewports so the preview and toolbar remain usable without document overflow, including after resize.
+- keep WCC layout contained on narrow viewports (dashboard)
+  - Constrain dashboard, sidebar, frame, and property controls on browser viewports up to 600px to prevent document overflow.
+  - Preserve exact phone, phablet, and tablet preview widths inside the scrollable frame.
+  - Centralize property type detection and skip internal state or unsupported runtime metadata before rendering editors.
+  - Add Chromium coverage for property metadata classification, 375px layouts, resize behavior, and fixed preview widths.
+
+### Tests
+
+- Cover standard-decorator property metadata, fresh 375px layout, desktop-to-375px resize, and fixed phone/tablet preview widths in Chromium.
+
+### Changes
+
+- Refresh the release toolchain and include changelog and license files in the published package.
+
+## 2026-06-16 - 3.9.2
+
+### Fixes
+
+- re-export demo wrapper from dees-element (demotools)
+  - Use the canonical @design.estate/dees-element/demotools implementation while keeping the existing dees-wcctools demotools subpath available
+  - Update demotools documentation to recommend importing from dees-element
+  - Bump @design.estate/dees-element to ^2.4.0
+
+## 2026-06-08 - 3.9.1
+
+### Fixes
+
+- update release and pnpm workspace configuration (config)
+  - Migrate smartconfig release settings to target-based schema
+  - Move pnpm overrides into pnpm-workspace.yaml with explicit build allowances
+  - Update pnpm version and development tooling dependencies
+  - Align commitinfo metadata with patch release
+
+## 2026-04-12 - 3.9.0 - feat(docs)
+document MP4 export support and enhanced recording capabilities
+
+- Update recording documentation to cover MP4/WebM export options, 60fps capture, and conversion via RecorderService
+- Add API and type references for output format selection and MP4 conversion in the TypeScript web docs
+- Clarify related UI capabilities such as recording panel format selection and sidebar search support
+
+## 2026-04-12 - 3.8.5 - fix(recording)
+improve recording capture quality and align preview button loading state
+
+- request 60fps screen capture and increase recorder bitrate to 8 Mbps for smoother, higher-quality videos
+- update preview button layout to use inline flex alignment so spinner and label stay properly aligned
+
+## 2026-04-12 - 3.8.4 - fix(repo)
+no changes to commit
+
+
+## 2026-04-12 - 3.8.3 - fix(sidebar)
+include component tag names in sidebar search filtering
+
+- Updates sidebar section and entry filtering to match search queries against each item's custom element tag name via the `is` field.
+- Keeps existing name and demo group matching behavior while making search results easier to find by tag.
+
+## 2026-04-12 - 3.8.2 - fix(sidebar)
+restore search input focus after clearing the sidebar search
+
+- Updates the sidebar clearSearch behavior to focus the .search-input element after resetting the query and dispatching searchChanged.
+- Improves search usability by letting users continue typing immediately after clearing the current search.
+
+## 2026-04-12 - 3.8.1 - fix(build)
+migrate smart config and update build tooling for latest tsbundle and TypeScript defaults
+
+- rename npmextra.json to .smartconfig.json and add tsbundle bundle configuration
+- update build script to use the new tsbundle invocation without the removed element subcommand
+- adjust tsconfig and dashboard property defaults for newer TypeScript compiler behavior
+- refresh package dependencies and include the new config file in published package contents
+
+## 2026-01-27 - 3.8.0 - feat(sidebar)
+rename demoGroup to demoGroups, add multi-group support, search by group name, and context menu group navigation
+
+- Static property demoGroup renamed to demoGroups; accepts string | string[] for multi-group membership
+- Elements with multiple demoGroups appear in each group's sidebar section simultaneously and show the library_books icon instead of featured_video
+- Sidebar search now matches group names in addition to element names; groups are sorted alphabetically by group name
+- Context menu for elements includes a "Show in Group:" section with navigable group entries that scroll to and briefly highlight the target group; group headers also have a context menu entry to filter by that group
+- Added data-group attribute on .item-group for DOM querying and visual classes for group highlight and filter match
+- Updated test elements to use demoGroups and updated docs/changelog/readme.hints to document the new behavior
+- Bumped several devDependencies (@api.global/typedserver, @git.zone/tsbuild, @git.zone/tsbundle, @git.zone/tstest, @git.zone/tswatch, @types/node) and adjusted npm script `watch` to use tswatch
+
+## 2026-01-27 - 3.8.0 - feat(sidebar)
+rename demoGroup to demoGroups, add multi-group support, search by group name, and context menu group navigation
+
+- Rename static property `demoGroup` to `demoGroups` on element classes; accepts `string | string[]` for multi-group membership
+- Elements with an array of `demoGroups` appear in each group's sidebar section simultaneously
+- Search now matches group names in addition to element names (e.g. searching "Buttons" shows all elements in the Buttons group)
+- Groups are sorted alphabetically by group name instead of by first element name
+- Elements belonging to multiple groups display a `library_books` icon instead of `featured_video`
+- Right-click context menu on elements with groups shows "Show in Group:" section with navigable group entries
+- Clicking a group name in the context menu scrolls to and briefly highlights that group in the sidebar
+- Updated test elements (test-button-primary, test-button-secondary, test-button-danger, test-input-text, test-input-checkbox) to use `demoGroups`
+
+## 2026-01-04 - 3.7.1 - fix(sidebar)
+increase scrolled sidebar header box-shadow intensity and size to improve visual separation
+
+- Changed .sidebar-header.scrolled box-shadow from `0 4px 12px -2px rgba(0, 0, 0, 0.4)` to `0 8px 24px -2px rgba(0, 0, 0, 1)`
+- File modified: ts_web/elements/wcc-sidebar.ts — stronger, larger, and fully opaque shadow for better contrast when scrolled
+
+## 2026-01-04 - 3.7.0 - feat(wcc-sidebar)
+add header shadow and scrolled state for sidebar menu to show elevation when content is scrolled
+
+- Introduce isMenuScrolled state to track whether the menu has been scrolled
+- Add handleMenuScroll handler and bind it to the menu scroll event
+- Apply a 'scrolled' class to .sidebar-header to add box-shadow and border-bottom color with transitions
+- Update template to conditionally add scrolled class and attach scroll listener
+
+## 2026-01-04 - 3.6.2 - fix(wcc-sidebar)
+use sidebar's internal .menu element for scroll management and expose scrollableContainer getter
+
+- Add public scrollableContainer getter to wcc-sidebar that returns the .menu element for external scroll control
+- Update wcc-dashboard to query wcc-sidebar as WccSidebar and attach scroll listeners to sidebar.scrollableContainer instead of the host element
+- Restore sidebar scroll position by setting scrollTop on the scrollableContainer when applying saved positions
+- TypeScript casting added to avoid nullable/implicit any issues when querying the sidebar element
+
+## 2026-01-04 - 3.6.1 - fix(wcc-sidebar)
+sort sidebar items alphabetically and unify grouped and ungrouped items for consistent ordering
+
+- Unifies ungrouped elements and groups into a single render list using a RenderItem type with a sortKey.
+- Sorts all top-level items alphabetically by element name (case-insensitive via toLowerCase) so sidebar order is deterministic.
+- Groups are ordered by the first element's name; individual items inside a group preserve their original order.
+- Replaces previous separate rendering paths with a single sorted render pass that returns TemplateResult array.
+
+## 2026-01-04 - 3.6.0 - feat(sidebar)
+restructure sidebar layout, add search clear button, and improve scrolling behavior
+
+- Change sidebar root to a flex column layout and add a .sidebar-header to separate header content from the scrollable menu
+- Move pinned section into the header and make .menu flex: 1 with min-height: 0 so the menu becomes the scrollable area
+- Replace overflow-y on the root with overflow:hidden to avoid double scrolling and constrain scrolling to .menu
+- Add a clear button for the search input (.search-clear) with positioning, hover styles, and a clearSearch() method to reset the query and emit searchChanged
+- Adjust search input padding and make .search-container position: relative to correctly position the clear button
+
+## 2026-01-04 - 3.5.3 - fix(deps)
+bump dependency versions: @design.estate/dees-domtools to ^2.3.7, @design.estate/dees-element to ^2.1.5, lit to ^3.3.2; update devDependencies @api.global/typedserver to ^8.1.0 and @git.zone/tstest to ^3.1.4
+
+- Updated runtime dependencies: @design.estate/dees-domtools ^2.3.7, @design.estate/dees-element ^2.1.5, lit ^3.3.2.
+- Updated devDependencies: @api.global/typedserver ^8.1.0 (major bump), @git.zone/tstest ^3.1.4.
+- @api.global/typedserver major bump affects development tooling only (devDependency), not runtime API.
+- Current package version is 3.5.2; recommend a patch release to 3.5.3.
+
+## 2026-01-04 - 3.5.2 - fix(elements)
+delay hiding sidebar and properties panels during native-mode transition and use transparent rgba border for frame to avoid layout jumps
+
+- Add isHidden state to wcc-sidebar and wcc-properties and switch display bindings to use isHidden instead of directly using isNative
+- Introduce a 300ms delayed hide when entering native mode so UI hides after frame animation completes; show immediately when exiting native mode
+- Replace hardcoded hex border values in wcc-frame with rgba and set native border to a transparent 0px to prevent abrupt visual jumps
+
+## 2026-01-04 - 3.5.1 - fix(sidebar)
+disable frame CSS transition while user is resizing the sidebar to prevent janky animations
+
+- Added isResizing boolean property to wcc-frame to toggle transitions during resize
+- Set frame.isResizing = true at resize start and false on mouseup to re-enable transitions
+- Updated CSS to skip transition while isResizing is true
+- Files changed: ts_web/elements/wcc-frame.ts, ts_web/elements/wcc-sidebar.ts
+
+## 2026-01-04 - 3.5.0 - feat(wcctools)
+add context menu and pinning support, persist pinned state in URL, and add grouped demo test elements
+
+- Add wcc-contextmenu custom element with a static show() API, proper positioning, visibility transitions, outside-click and Escape handling, and menu item actions.
+- Introduce pinnedItems (Set<string>) on wcc-dashboard and wcc-sidebar; pass pinnedItems to the sidebar, handle pinnedChanged events, and persist pinned item keys in the URL query param 'pinned'. Changes include defensive updates to avoid unnecessary update loops.
+- Enhance wcc-sidebar to render pinned state: new styles for pinned items and pinned sections, contextmenu integration for element items, adjusted layout (grid-template-columns) and improved element/demo rendering logic.
+- Add grouped demo test components and exports to demo the demoGroup feature: test-button-primary, test-button-secondary, test-button-danger, test-input-text, and test-input-checkbox.
+- Misc: adjust dashboard URL state serialization/deserialization to include pinned items and ensure scroll/search state handling remains stable.
+
+## 2025-12-30 - 3.4.0 - feat(sidebar)
+add searchable sidebar with URL-backed query state and highlighted matches
+
+- Add search input to wcc-sidebar and expose a searchQuery property
+- Filter sidebar sections and items client-side based on the search query and hide sections with no matches
+- Highlight matching substrings in sidebar item labels
+- Emit a 'searchChanged' event from the sidebar and handle it in wcc-dashboard to keep dashboard.searchQuery in sync
+- Persist the search query in the route query parameter 'search' when building URLs and restore/clear it on navigation
+- Preserve existing scroll-state handling while adding search state to URL updates
+
+## 2025-12-28 - 3.3.0 - feat(wcctools)
+Add section-based configuration API for setupWccTools, new Views, and section-aware routing/sidebar
+
+- Introduce IWccSection and IWccConfig types and migrate setupWccTools to accept a sections config while preserving legacy (elements, pages) format
+- WccDashboard and WccSidebar updated to support sections, filtering, sorting, collapsed sections, and section-aware URL routing (uses sectionName in routes with legacy fallbacks)
+- Add Views: view-dashboard, view-settings, view-empty-state plus test/views index exports and demo variations
+- Add helpers: getSectionItems, convertLegacyToConfig and isWccConfig; update build URL and routing logic to be section-aware
+- Update docs and README/readme.hints with sections API, examples, migration notes and UI/UX updates
+
+## 2025-12-22 - 3.2.0 - feat(wcc-sidebar)
+auto-expand sidebar folder when selecting an element with multiple demos
+
+- Add updated() lifecycle to auto-expand folder when selectedItem changes
+- Find element name by matching selectedItem against dashboardRef.elements
+- Only auto-expand when the element has multiple demos (checks item.demo and hasMultipleDemos)
+- Immutably update expandedElements set to trigger re-render and avoid duplicate additions
+
+## 2025-12-21 - 3.1.2 - fix(wcc-properties)
+Use LitElement.updated to recreate properties only when selectedItem changes and handle errors; remove custom scheduleUpdate implementation
+
+- Replaced public async scheduleUpdate() with protected updated(changedProperties) lifecycle method
+- Call super.updated(...) and only recreate properties when selectedItem changed to avoid unnecessary work
+- Preserve error handling and clear propertyContent on failure
+- Removed explicit super.scheduleUpdate() call to rely on LitElement's update lifecycle
+
+## 2025-12-21 - 3.1.1 - fix(wcc-properties)
+Improve wcc-properties CSS to prevent grid overflow, properly size and center icon glyphs, and adjust right-side offset
+
+- Use minmax(0, 1fr) for grid-template-columns (selectorButtons1/2/4/5) to avoid flexbox overflow and ensure consistent column sizing
+- Add min-width/min-height and inline-flex centering to .material-symbols-outlined to stabilize icon sizing and vertical/horizontal alignment
+- Increase right calc offset from 520px to 600px to accommodate wider content/controls
+- Changes applied in ts_web/elements/wcc-properties.ts
+
+## 2025-12-19 - 3.1.0 - feat(wcc-properties)
+add Share selector with inline Record button and adjust properties panel grid layout
+
+- Increase rightmost column width from 70px to 100px in properties grid
+- Introduce .shareSelector and .selectorButtons1 CSS classes and markup
+- Replace <wcc-record-button> with inline Record button that toggles icon based on isRecording
+- Add Share panel heading and integrate record control into selector area
+
+## 2025-12-19 - 3.0.0 - BREAKING CHANGE(ts_web)
+Replace fullscreen boolean with native viewport mode across components, add native viewport selector and toggle, and update dev deps and npmextra config
+
+- Introduce isNative (derived from selectedViewport === 'native') replacing isFullscreen on WccDashboard, WccFrame, WccProperties and WccSidebar (property and styling changes).
+- WccDashboard: remove isFullscreen property, add isNative getter, implement toggleNative to switch selectedViewport between 'native' and 'desktop', update ESC handler to exit native mode and call buildUrl().
+- WccProperties: add Native button to viewport selector, adjust grid columns and selector layout, replace fullscreen toggle with toggleNative (dispatches 'toggleNative' event).
+- WccFrame: rename isFullscreen -> isNative and update style/markup branching to use isNative.
+- WccSidebar: visibility now driven by isNative instead of isFullscreen.
+- API/event changes: 'toggleFullscreen' event renamed to 'toggleNative' — this is an incompatible change for consumers relying on the old event/property.
+- package.json: bump devDependencies @git.zone/tsbuild -> ^4.0.2, @git.zone/tsrun -> ^2.0.1, @git.zone/tswatch -> ^2.3.13, @types/node -> ^25.0.3.
+- npmextra.json: rename keys (e.g. "gitzone" -> "@git.zone/cli", "tsdoc" -> "@git.zone/tsdoc"), add @ship.zone/szci entry and add release registries/accessLevel for @git.zone/cli.
+
+## 2025-12-11 - 2.0.1 - fix(@git.zone/tswatch)
+Bump @git.zone/tswatch devDependency to ^2.3.12
+
+- Updated devDependency @git.zone/tswatch from ^2.3.11 to ^2.3.12 in package.json
+
+## 2025-12-11 - 2.0.0 - BREAKING CHANGE(recorder)
+Remove FFmpeg-based MP4 conversion; simplify recorder/export to WebM and improve recorder/editor robustness
+
+- Removed FFmpegService and all client-side MP4 conversion logic — exports are now WebM-only (MP4 conversion and related UI/controls removed).
+- ts_web/elements/wcc-recording-panel: dropped outputFormat and conversion states/UI; download flow simplified to always export WebM.
+- ts_web/index.ts: removed FFmpegService exports and conversion types from public API.
+- package.json: removed @ffmpeg/* dependencies.
+- RecorderService: handleRecordingComplete is now async and fixes recorded blob assignment and cleanup timing.
+- wcc-properties: improved element detection and robustness — recursive search through light/shadow DOM with retry/delay, plus an advanced JSON editor for Object/Array props (supports multiple open editors and frame resize events).
+- wcc-sidebar: force re-render after selecting demos to ensure child demo selection indicators update correctly.
+- dees-demowrapper: ensure slotted content is rendered before calling runAfterRender (small timing/stability improvements).
+- Test update: demo definitions can be arrays (multiple demos) — test-demoelement updated to use multiple demo entries.
+
+## 2025-12-11 - 1.3.0 - feat(recording-panel)
+Add demo wrapper utilities, improve recording trim behavior, and harden property panel element detection; update documentation
+
+- Add dees-demowrapper (ts_demotools) with runAfterRender callback to run post-render demo logic (supports async callbacks).
+- Improve recording UI and trimming: handle WebM files with Infinity/NaN durations by falling back to tracked recording duration; replace numeric handle positioning with CSS calc strings for responsive trim handles.
+- Harden property extraction: implement recursive element search (including shadowRoots), add an initial delay and retry loop to wait for demo rendering, and add an advanced JSON editor for Object/Array properties with open/save/cancel and per-editor error reporting.
+- Add and expand documentation: new ts_web/ and ts_demotools/ READMEs, reorganized main README with clearer feature list, usage examples, and API reference.
+- Minor exports and module/docs housekeeping (index exports, readme reorder, examples updated to import classes).
+
+## 2025-11-16 - 1.2.1 - fix(dependencies)
+Bump dependencies and developer tooling versions
+
+- Bump @design.estate/dees-domtools from ^2.3.3 to ^2.3.6
+- Bump @design.estate/dees-element from ^2.1.2 to ^2.1.3
+- Upgrade @git.zone/tsbuild from ^2.6.8 to ^2.7.1
+- Upgrade @git.zone/tsrun from ^1.2.44 to ^1.6.2
+- Upgrade @git.zone/tstest from ^2.3.8 to ^2.7.0
+
+## 2025-09-19 - 1.2.0 - feat(wcc-properties)
+Add advanced property editors, recursive element detection, demo wrapper, UI refresh and test fixtures
+
+- Advanced JSON property editor: multiple side-by-side editors with save/cancel, syntax validation and inline error display; editors affect frame layout (frame bottom increases when editors open).
+- Improved properties panel element detection: recursive search through nested children and shadow DOM, initial delay and retry mechanism to handle async Lit rendering.
+- Add dees-demowrapper component in ts_demotools to run post-render callbacks and support async demo setup and DOM access for demos.
+- UI refresh with shadcn-like styles: CSS variables for theming, redesigned properties panel and sidebar, improved form controls, theme and viewport selectors.
+- Viewport and frame improvements: responsive padding based on viewport type, theme-aware background rendering, and scroll position tracking with URL/state restoration for frame and sidebar.
+- Add test fixtures and demo elements/pages under test/ to exercise properties, complex types, nested elements and scroll restoration; include node test for resolveTemplateFactory.
+- Expose setupWccTools entry point and plugin wiring (wcctools.plugins exports for dees-domtools and smartdelay) for easier integration.
+
+## 2025-06-27 - 1.1.0 - feat(wcctools)
+Enhance component tools with an advanced property editor, improved element detection and modernized UI styling for a more responsive dashboard experience.
+
+- Updated documentation and in-code hints with new shadcn-like design patterns for the dashboard UI.
+- Introduced an advanced complex properties editor supporting JSON validation and multi-editor handling.
+- Refined recursive element search in the properties panel to improve asynchronous rendering detection.
+- Expanded test coverage with scenarios for edge cases, nested elements and wrapper components.
+
+## 2025-06-26 - 1.0.101 - fix(wcc-dashboard)
+Improve scroll listener management and add new test pages
+
+- Removed the pages/ directory entry from .gitignore to allow test pages to be tracked
+- Added new test pages: page1 and pageLongScroll for enhanced scroll and navigation testing
+- Refactored wcc-dashboard: changed scroll position properties to private variables and added a flag to prevent duplicate scroll listener attachment
+
+## 2025-06-26 - 1.0.100 - fix(wcc-dashboard)
+Prevent duplicate application of scroll positions in dashboard to avoid interfering with user scrolling
+
+- Added a private 'scrollPositionsApplied' property to track if scroll positions have already been applied
+- Introduced a guard in the applyScrollPositions method to ensure the scroll state is applied only once
+
+## 2025-06-26 - 1.0.99 - fix(dashboard)
+Fix scroll state preservation in dashboard by tracking frame and sidebar scroll positions and updating the URL accordingly.
+
+- Added frameScrollY and sidebarScrollY properties to capture scroll positions.
+- Set up scroll listeners on wcc-frame and wcc-sidebar to update scroll state.
+- Implemented debounced updates to modify the URL with current scroll positions without navigation.
+- Restored scroll positions from URL query parameters during initialization.
+
+## 2025-06-16 - 1.0.97 - properties-panel
+- Improve element detection timing and value handling in properties panel
+
+## 2025-06-16 - 1.0.96 - properties-panel
+- Enhance element detection and error handling for nested structures
+
+## 2025-06-16 - 1.0.95 - package
+- Correct path for demotools export in package.json
+
+## 2025-06-16 - 1.0.94 - demotools
+- Enhance runAfterRender to provide full DOM API access and improve element selection
+
+## 2025-06-16 - 1.0.92 - demotools
+- Update DeesDemoWrapper to handle multiple slotted elements in runAfterRender callback
+
+## 2025-06-16 - 1.0.91 - readme
+- Update documentation with comprehensive overview, quick start guide, and detailed feature descriptions
+
+## 2025-06-16 - 1.0.90 - demo/properties/refactor
+- Add DeesDemoWrapper component for enhanced demo element handling
+- Enhance element detection in properties panel with recursive search and retry mechanism
+- Refactor code structure for improved readability and maintainability
+
+## 2024-05-06 to 2020-05-10 - 1.0.89–1.0.17 - core
+- Over a series of releases, trivial core fixes and updates were applied.
+- (Note: Version 1.0.87 also included an update to the documentation.)