@flareapp/svelte 2.11.0 → 2.12.0

package/README.md

@@ -97,6 +97,15 @@ Profiling and component tracking are independent. You can run either on its own:
 withFlareConfig(config, { componentTracking: false, profileComponents: [/\+page$/] });
 ```
 
+### Self time
+
+Every component span carries `flare.component.self_time_ns`: the span's duration minus the time its own
+profiled children account for. Children that overlap in time are counted once, so the value never goes
+below zero.
+
+A child that mounts after its parent's span closed is not subtracted. Its work happened outside the
+parent's window, so the parent keeps its full duration.
+
 ### Preprocessor ordering
 
 Both features are injected by a Svelte preprocessor, which `withFlareConfig` installs for you. It parses

package/dist/getErrorOrigin.d.ts

@@ -1,7 +1,3 @@
 import type ErrorStackParser from 'error-stack-parser';
 import type { SvelteErrorOrigin } from './types.js';
-/**
- * Classify a parsed stack trace's error origin: 'event' (DOM handler), 'effect' (async side-effect),
- * 'render' (component render phase), or 'unknown' (no frames or no recognizable pattern).
- */
 export declare function getErrorOrigin(frames: ErrorStackParser.StackFrame[]): SvelteErrorOrigin;

package/dist/getErrorOrigin.js

@@ -1,6 +1,5 @@
-// Origins are indistinguishable at the boundary catch site; the stack trace is the only signal.
-// Checked in priority order event > effect > render > unknown, so an event handler inside a
-// component wins over the .svelte filename check.
+// The boundary catch site can't tell origins apart, so the stack trace is the only signal.
+// Checked in order event > effect > render > unknown: an event handler wins over a .svelte match.
 // Inline event handlers and DOM event API calls. Svelte compiles `onclick={handler}` to
 // `.onclick = ...` or `addEventListener(...)`, so these match compiled output and manual DOM calls.
 const EVENT_PATTERNS = [
@@ -28,10 +27,8 @@ const EVENT_PATTERNS = [
 // Async side-effects: $effect callbacks (Svelte 5 schedules via queueMicrotask), onMount
 // microtasks, promise continuations, MutationObserver callbacks. Not render-phase code.
 const EFFECT_PATTERNS = [/queueMicrotask/, /Promise\.then/, /Promise\.catch/, /MutationObserver/];
-/**
- * Classify a parsed stack trace's error origin: 'event' (DOM handler), 'effect' (async side-effect),
- * 'render' (component render phase), or 'unknown' (no frames or no recognizable pattern).
- */
+// Classify a parsed stack trace's error origin: 'event' (DOM handler), 'effect' (async side-effect),
+// 'render' (component render phase), or 'unknown' (no frames or no recognizable pattern).
 export function getErrorOrigin(frames) {
     if (frames.length === 0) {
         return 'unknown';

package/dist/identify.d.ts

@@ -1,5 +1,3 @@
 import type { Flare } from '@flareapp/js/browser';
-/** Web path: full identity on the default singleton. Svelte's framework has no version. */
 export declare function registerSvelteSdkIdentity(flare: Flare): void;
-/** Injected path: framework tag only, never sdkInfo. */
 export declare function tagSvelteFramework(flare: Flare): void;

package/dist/identify.js

@@ -5,12 +5,12 @@ const tagger = createIdentityTagger({
     sdkVersion: PACKAGE_VERSION,
     frameworkName: FrameworkName.Svelte,
 });
-/** Web path: full identity on the default singleton. Svelte's framework has no version. */
+// Web path: full identity on the default singleton. Svelte's framework has no version.
 export function registerSvelteSdkIdentity(flare) {
     tagger.registerSdkIdentity(flare);
     tagger.tagFramework(flare, undefined);
 }
-/** Injected path: framework tag only, never sdkInfo. */
+// Injected path: framework tag only, never sdkInfo.
 export function tagSvelteFramework(flare) {
     tagger.tagFramework(flare, undefined);
 }

package/dist/inject.js

@@ -1,6 +1,5 @@
-// Electron-safe entry. No @flareapp/js root import, no default registration, no import-time
-// identity. The caller must pass `flare` (handler option / boundary prop); resolveFlare throws
-// at wiring time if absent.
+// Electron-safe entry: no @flareapp/js root import, no default registration, no import-time identity.
+// The caller must pass `flare` (handler option or boundary prop); resolveFlare throws at wiring time if absent.
 export { default as FlareErrorBoundary } from './FlareErrorBoundary.svelte';
 export { createFlareErrorHandler } from './createFlareErrorHandler.js';
 export { __flareRegisterComponent, getComponentTreeContext } from './componentTree.js';

package/dist/preprocessor.js

@@ -58,30 +58,25 @@ export function flarePreprocessor(options) {
         },
     };
 }
-/** Keeps the merged sourcemap's `sources` from carrying an absolute build-machine path. */
+// Keeps the merged sourcemap's `sources` from carrying an absolute build-machine path.
 function basename(filename) {
     return filename.split(/[/\\]/).pop() ?? filename;
 }
-/**
- * The name error reports use. Stays a bare basename rather than reusing `resolveProfileName`, because
- * changing it would change component hierarchies people already have.
- */
+// The name error reports use. Stays a bare basename instead of `resolveProfileName`, because changing
+// it would change component hierarchies people already have.
 function extractComponentName(filename) {
     return basename(filename).replace(/\.svelte$/, '');
 }
 function escapeString(str) {
     return str.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
 }
-/** Copied from Svelte's own preprocessor, so we agree with it on what counts as a style tag. */
+// Copied from Svelte's own preprocessor, so we agree with it on what counts as a style tag.
 const REGEX_STYLE_TAGS = /<!--[^]*?-->|<style((?:\s+[^=>'"/\s]+=(?:"[^"]*"|'[^']*'|[^>\s]+)|\s+[^=>'"/\s]+)*\s*)(?:\/>|>([\S\s]*?)<\/style>)/g;
 const CLOSING_STYLE_TAG = '</style>';
-/** One warning per file per process. A dev server runs this hook again on every save. */
+// One warning per file per process. A dev server runs this hook again on every save.
 const warnedFiles = new Set();
-/**
- * Blanks out every `<style>` body, keeping the exact character count so offsets into the original
- * still line up. Svelte parses style bodies as CSS, so `lang="scss"` and friends throw and would
- * otherwise cost the file its registration.
- */
+// Blanks out every `<style>` body, keeping the character count so offsets into the original still
+// line up. Svelte parses style bodies as CSS, so `lang="scss"` and similar would throw otherwise.
 function blankStyleBodies(content) {
     return content.replace(REGEX_STYLE_TAGS, (match, _attributes, body) => {
         // The first branch of the regex matches comments, which have no body to blank.
@@ -101,7 +96,7 @@ function warnOnce(filename, reason) {
     // Silence here reads as "component tracking works", which is worse than a noisy build.
     console.warn(`[flare] Skipped component tracking for ${filename}: ${reason}`);
 }
-/** How many BOM characters sit at the very start of the source, back to back. */
+// How many BOM characters sit at the very start of the source, back to back.
 function countLeadingBoms(content) {
     let count = 0;
     while (content.charCodeAt(count) === 0xfeff) {
@@ -109,16 +104,11 @@ function countLeadingBoms(content) {
     }
     return count;
 }
-/**
- * Where the instance script's body begins, `null` when the component has none, `undefined` when the
- * source cannot be parsed. Svelte hands a script hook every `<script>` in the file, nested ones
- * included, so only the parser can say which one belongs to the component. `bomCount` rides along
- * because the null case still needs to know how many bytes of BOM it must insert after.
- */
+// Where the instance script body begins (null = none, undefined = unparseable). Only the parser can
+// tell which `<script>` belongs to the component; `bomCount` tags along for the null case's BOM insert.
 async function instanceScriptStart(content, filename) {
-    // parse() strips exactly one leading BOM itself and reports offsets against the stripped source.
-    // Stripping every leading BOM here (not just one) before parsing means none are left for parse()'s
-    // own stripping to act on, so the count we add back is exact no matter how many there were.
+    // parse() strips one leading BOM and reports offsets against the stripped source. Stripping all
+    // of them here first means the count we add back is exact, no matter how many BOMs there were.
     const bomCount = countLeadingBoms(content);
     const source = content.slice(bomCount);
     try {
@@ -137,14 +127,13 @@ async function instanceScriptStart(content, filename) {
         return undefined;
     }
 }
-/** The map matters: inserting lines shifts everything below, throwing off stack frames and breakpoints. */
+// The map matters: inserting lines shifts everything below, throwing off stack frames and breakpoints.
 function injectWithMap(content, injection, filename, start, bomCount) {
     const magicSource = new MagicString(content);
     if (start === null) {
         const scriptBlock = `<script>\n${injection}</script>\n`;
-        // prepend() inserts at offset 0, which would land ahead of the BOM(s) and move them into the
-        // template. appendRight(bomCount, ...) inserts right after all of them instead, keeping every
-        // BOM at the front so compile()'s own BOM stripping still fires.
+        // prepend() inserts at offset 0, ahead of any BOM, and would move it into the template.
+        // appendRight(bomCount, ...) inserts after the BOM(s) instead, so compile()'s own stripping still fires.
         if (bomCount > 0) {
             magicSource.appendRight(bomCount, scriptBlock);
         }

package/dist/profileComponent.d.ts

@@ -1,7 +1 @@
-/**
- * Records one `browser_component` span for this component's mount. The preprocessor injects the call,
- * don't write it by hand.
- *
- * Init runs top-down, so a child can point at a span id its parent reserved but hasn't recorded yet.
- */
 export declare function __flareProfileComponent(name: string): void;

package/dist/profileComponent.js

@@ -3,12 +3,9 @@ import { getContext, onMount, setContext } from 'svelte';
 // Separate from the component tree's key: that one chains every component, this one only the
 // profiled ones.
 const PROFILE_KEY = '__flare_component_profile';
-/**
- * Records one `browser_component` span for this component's mount. The preprocessor injects the call,
- * don't write it by hand.
- *
- * Init runs top-down, so a child can point at a span id its parent reserved but hasn't recorded yet.
- */
+// Records one `browser_component` span for this component's mount. The preprocessor injects this call;
+// don't write it by hand. Init runs top-down, so a child may point at a span id its parent reserved
+// but hasn't recorded yet.
 export function __flareProfileComponent(name) {
     try {
         const inherited = getContext(PROFILE_KEY) ?? null;

package/dist/resolveProfileName.d.ts

@@ -1,10 +1 @@
-/**
- * The name a profiled component reports, and what `profileComponents` matches against.
- *
- * Separate from `extractComponentName`, which feeds error reports and has to keep its bare basenames.
- * Profiling needs the route path too, otherwise every route in a SvelteKit app is just `+page`.
- *
- * @param filename Absolute path as a Svelte preprocessor receives it.
- * @param routesDir Project-relative routes directory, from `kit.files.routes`.
- */
 export declare function resolveProfileName(filename: string, routesDir?: string): string;

package/dist/resolveProfileName.js

@@ -1,12 +1,9 @@
-/**
- * The name a profiled component reports, and what `profileComponents` matches against.
- *
- * Separate from `extractComponentName`, which feeds error reports and has to keep its bare basenames.
- * Profiling needs the route path too, otherwise every route in a SvelteKit app is just `+page`.
- *
- * @param filename Absolute path as a Svelte preprocessor receives it.
- * @param routesDir Project-relative routes directory, from `kit.files.routes`.
- */
+// The name a profiled component reports, and what `profileComponents` matches against.
+// Separate from `extractComponentName`, which feeds error reports and needs bare basenames.
+// Profiling needs the route path too, or every SvelteKit route is just `+page`.
+//
+// `filename` is the absolute path as a Svelte preprocessor receives it; `routesDir` is the
+// project-relative routes directory, from `kit.files.routes`.
 export function resolveProfileName(filename, routesDir = 'src/routes') {
     const normalized = filename.replace(/\\/g, '/');
     const base = normalized.split('/').pop() ?? normalized;
@@ -27,10 +24,8 @@ export function resolveProfileName(filename, routesDir = 'src/routes') {
     const relativeDir = normalized.slice(start, normalized.lastIndexOf('/'));
     return relativeDir ? `${relativeDir}/${name}` : name;
 }
-/**
- * Index just past the routes directory, or -1 when the path isn't in there. Anchors on the last
- * occurrence, so a project checked out under something like /home/src/routes/ still works.
- */
+// Index just past the routes directory, or -1 when the path isn't there. Anchors on the last
+// occurrence, so a project checked out under something like /home/src/routes/ still works.
 function routeDirStart(normalized, normalizedRoutesDir) {
     const nested = normalized.lastIndexOf(`/${normalizedRoutesDir}/`);
     if (nested !== -1) {

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const PACKAGE_VERSION = "2.11.0";
+export declare const PACKAGE_VERSION = "2.12.0";

package/dist/version.js

@@ -1,2 +1,2 @@
 // generated during release, do not modify
-export const PACKAGE_VERSION = '2.11.0';
+export const PACKAGE_VERSION = '2.12.0';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@flareapp/svelte",
-    "version": "2.11.0",
+    "version": "2.12.0",
     "description": "Svelte client for flareapp.io",
     "homepage": "https://flareapp.io",
     "bugs": "https://github.com/spatie/flare-client-js/issues",
@@ -73,14 +73,14 @@
         "vitest": "^4.0.0"
     },
     "peerDependencies": {
-        "@flareapp/js": "^2.11.0",
+        "@flareapp/js": "^2.12.0",
         "svelte": "^5.3.0"
     },
     "publishConfig": {
         "access": "public"
     },
     "dependencies": {
-        "@flareapp/core": "2.11.0",
+        "@flareapp/core": "2.12.0",
         "error-stack-parser": "^2.1.4",
         "magic-string": "^0.30.21"
     }