Skip to content

Changelog

Backward-compatible changes (new fields, new optional parameters, new event types) are made in the current version; breaking changes are announced with a new version. See API overview and the Widget versioning policy.

  • Widget v1.1 (loader 1.1.0, protocol version: 1). Backward compatible; existing integrations keep working unchanged. See the Widget versioning policy.
    • Live updates and a programmatic API: MiracOzdemirWidget.update, setInputs, calculate (Promise), reset, get, getResult, unmountAll; version, build and features. See JavaScript API.
    • Prefilled inputs and autorun: data-input-<field>, data-inputs, data-autorun, i.<field> for iframes; the result-only view data-view="result". See Installation.
    • New events and richer detail: mo:input, mo:select; tool, features, inputs, requestId and fields on mo:ready, mo:result and mo:error. See Events.
    • Appearance options: data-accent, data-radius, data-density, data-theme="inherit".
    • New kinds: a search box and a category list (data-mo-search, data-mo-category; target is only _blank or event). See Widget kinds.
    • Custom elements and an SDK: <mo-calculator>, <mo-search>, <mo-category>; a typed SDK package (React/Vue components) is ready as a source package and is not published to npm yet. See Custom elements and SDK.
    • Layout shift (CLS) fix: a skeleton placeholder, learned height (localStorage), data-lazy, preconnect.
    • Accessibility: a localized iframe title and data-title. Console warnings are now in English.
    • Immutable loader and SRI: /widget/v1.1.0.js and /widget/manifest.json (sha384 integrity). /widget.js and /widget/v1.js continue to be served with max-age=3600.
    • Anonymous embed usage counting: the embed page records the embedding page’s domain (the domain only) in daily aggregate counters; no inputs or results are stored. See Security and privacy.
  • The widget configurator was renewed: kind selection, live updates, calculate/setInputs/reset buttons, an SRI option, HTML/element/iframe/React/Vue/JS API tabs. See Configurator.
  • Documentation site published. The public API guides, the API Reference, the widget guide, the configurator, the tool catalog and the playground are on this site.
  • The API home page became a live status page. https://api.mirac-ozdemir.com/ shows component statuses, a traffic summary and the last 60 minutes. See Status.
  • Contract fixes. The example addresses in the public OpenAPI description were corrected to /v1/public/... and the MAINTENANCE error code was added to the error list.
  • The API was rewritten (NestJS). Response bodies and the error envelope stayed the same. Paths changed: public endpoints are now under /v1/public/*; the old /api/v1/public/* addresses are not used. In your integrations, update the base URL to https://api.mirac-ozdemir.com/v1/public.
  • The widget loader (/widget.js, /widget/v1.js) and the embed address (/{locale}/embed/{key}) did not change.
  • /openapi.json continues to serve only the public contract (7 operations).