Release notes

Upcoming release#

0.1.0-next.13 (2026-01-01)#

Enhancements#

• YouTube Shorts support: Auto-detects Shorts URLs and applies portrait dimensions (#51)
  • Automatically uses 9:16 portrait dimensions (347×616) for Shorts URLs
  • Respects user-specified dimensions when explicitly set via attributes
  • Uses getAttribute() to distinguish between default and user-set values

Refactoring#

• Decorator-free Lit syntax: Converted from @property decorators to static properties pattern (#50)
  • Fixes esm.sh GitHub CDN source which failed with “Unsupported decorator location: field”
  • Uses static properties = { ... } and customElements.define() instead of decorators
  • No functional changes - same component API and behavior

Development#

• Testing Infrastructure: Migrated from Web Test Runner to Vitest with Browser testing:

  • Removed Web Test Runner dependencies and configuration
  • Removed old test file (o-embed_test.ts)
  • All tests now use Vitest browser testing with Playwright

• Type Safety: Enhanced test suite with type checking (#42)

  • Added TypeScript type checking to Vitest configuration
  • Support for .test-d.ts type tests that validate component types
  • Isolated type checking within the package to prevent cross-package type issues

• Build System: TypeScript and module resolution improvements (#45)

  • Updated moduleResolution to "bundler" for modern tooling compatibility
  • Added skipLibCheck to handle third-party type declaration issues
  • Applied Biome 2.0 formatting rules across all source files
  • Improved import organization and code consistency

Documentation#

• Domain migration: Documentation links updated from social-embed.git-pull.com to social-embed.org

• README overhaul: Completely revitalized documentation with:

  • Clearer introduction and value proposition
  • Improved installation and usage instructions
  • Enhanced code examples
  • Better formatting and structure

• Migration Notes: Added detailed documentation on the migration from Web Test Runner to Vitest, including completed tasks and remaining items.

0.1.0-next.12 (2025-01-05)#

Breaking Changes#

• OEmbedElement.ts: Removed usage of the Provider enum.
  • Now checks provider.name (a string) from getProviderFromUrl(...).
  • Fallback logic for valid but unknown URLs creates a generic <iframe>, and invalid URLs produce a “No provider found” message.

Enhancements#

• Refactored <o-embed> to handle the new approach from @social-embed/lib:
  • No direct enum references—just .name for recognized providers.
  • Cleaned up dimension logic and error handling.
  • Consolidated allowfullscreen checks into a single helper method (shouldAllowFullscreen()).

Tests#

• Added fallback tests:
  • For unrecognized but valid URLs (renders a plain <iframe>).
  • For invalid URLs (renders a “No provider found…” message).
• Existing YouTube, Vimeo, DailyMotion, EdPuzzle, Loom, Wistia tests remain valid and updated to confirm the new approach.

0.1.0-next.11 (2025-01-01)#

Maintenance release only, no bug fixes or new features.

Development#

• Package manager: yarn classic -> pnpm (#29)
• @social-embed/lib: From v0.1.0-next.8 to v0.1.0-next.9

0.1.0-next.10 (2024-12-31)#

Re-release of 0.1.0-next.9 with dist/ artifacts included.

0.1.0-next.9 (2024-12-31)#

Yanked: Missing build artifacts.

Maintenance release only, no bug fixes or new features.

Development#

• @social-embed/lib: From v0.1.0-next.7 to v0.1.0-next.8

0.1.0-next.8 (2023-11-25)#

Improvements#

• Spotify: Set default height to 352px (for default player size, #23)

  • Docs: Add example of compat player using 152px height.

• lit: 3.0.2 -> 3.1.0 (#20)

  See also:

  • https://github.com/lit/lit/blob/lit%403.1.0/packages/lit/CHANGELOG.md
  • https://github.com/lit/lit/blob/lit%403.1.0/packages/lit-html/CHANGELOG.md

• @social-embed/lib: From v0.1.0-next.5 to v0.1.0-next.7

  • Regex improvements

Development#

• vite: 4.5.0 -> 5.0.0 (#21)

  See also:

  • https://vitejs.dev/blog/announcing-vite5
  • https://vitejs.dev/guide/migration
  • https://github.com/vitejs/vite/blob/v5.0.0/packages/vite/CHANGELOG.md
  • https://github.com/vitejs/vite/blob/531d3cb/packages/vite/CHANGELOG.md

• Move from prettier to biome (#27)

• Move from eslint to oxlint (#26) biome (#27)

  Faster linting, as it is rust-based.

0.1.0-next.7 (2023-11-11)#

Improvements#

• lit: 3.0.1 -> 3.0.2 (#16)

  See also:

  • https://github.com/lit/lit/blob/lit%403.0.2/packages/lit/CHANGELOG.md
  • https://github.com/lit/lit/blob/lit-element%403.0.2/packages/lit-element/CHANGELOG.md
  • https://github.com/lit/lit/blob/lit-html%403.0.2/packages/lit-html/CHANGELOG.md

Development#

• Update @web/dev-server-esbuild 0.4.4 -> 1.0.0 (release notes) (#14)

• Update @web/test-runner + @web/test-runner-puppeteer (#15)

  • @web/test-runner <0.17.0 -> ^0.18.0 (release notes)
  • @web/test-runner-puppeteer <0.14.0 -> ^0.15.0 (release notes)

0.1.0-next.6 (2023-11-01)#

• Docs (README): Further README updates in relation to vite

0.1.0-next.5 (2023-11-01)#

• Docs (README): Fix links and example code

0.1.0-next.4 (2023-08-26)#

Breaking changes#

• Minimum Node.js version to v18+ (#12)

• Lit 3.0 (#13)

  • https://lit.dev/blog/2023-10-10-lit-3.0/
  • https://lit.dev/blog/2023-10-10-lit-3.0/#lit-3.0

Development#

• Bump lib to v0.1.0-next.5

  Dev package updates

0.1.0-next.3 (2023-08-26)#

• Prettier: Add css and JS import ordering (#9)

• Bump lib to v0.1.0-next.4

  Lib has improved prettier linting, including css rule and import ordering.

0.1.0-next.2 (2023-06-12)#

• Include typings

  • Add vite-plugin-dts
  • package.json Add back "typings": "..."

• Bump lib dependency to v0.1.0-next.3 (Fix typing inclusion in package.json)

See commits

0.1.0-next.1 (2023-06-12)#

• Bump lib dependency to v0.1.0-next.2 (adds typings)

See commits

0.1.0-next.0 (2023-06-12)#

• Move to vite (#8)
• Bump lib dependency to v0.1.0-next.1

See commits

0.0.5-next.1 (2022-11-10)#

• Bump @social-embed/lib from 0.1.0-next.12 -> 0.0.2-next.1

See commits

0.0.5-next.0 (2022-11-06)#

• Move from tsc to rollup (#43)

  This handles legacy builds and UMD build (for documentation)

  Before hand, site/ had its own rollup configuration just for handling a UMD build.

See commits

0.0.4-next.0 (2021-09-25)#

Update lit-element to lit

See commits

0.0.3-next.5 (2021-06-03)#

See commits

• DailyMotion: Fix dimension customization

0.0.3-next.4 (2021-06-03)#

See commits

• Update lib to @social-embed/lib to ^0.1.0-next.12 to assure generic regexes provided.
• Rollup: 2.50.5 -> 2.50.6

0.0.3-next.3 (2021-06-02)#

See commits

• Accept css variables in generic iframe embeds

0.0.3-next.2 (2021-06-02)#

• Update TypeScript 4.2 -> 4.3
• Fallback to iframes for valid URLs not supported in providers

0.0.3-next.1 (2021-05-19)#

• <o-embed> is now a block-level element
• More dimension support, add examples to docs

0.0.3-next.0 (2021-05-19)#

• Support passing --social-embed-iframe-width and --social-embed-iframe-height

0.0.2 (2021-05-16)#

• lit-element 2.4.0 -> 2.5.1 (changelog)

current#

• Added normal documentation: https://social-embed.org/wc/
• #29 - Simplify test runner with esbuild. No need to wait for builds to dist/
• Disable specRunner (runs before diff outputs on errors, making errosr harder to see. Also the logger.log() doesn’t work from the earlier example.
• #30: Add loom, wistia and edpuzzle