@fuzdev/fuz_ui 0.169.0

package/dist/csp.js

@@ -0,0 +1,354 @@
+/**
+ * This is designed for compatibility with SvelteKit
+ * and maps to the `KitConfig` `directives` option.
+ * The goal is to provide an ergonomic, modern, and safe API
+ * for Content Security Policy (CSP) creation
+ * that's simple to write and audit, and isn't error-prone.
+ *
+ * Things like validation and rendering to a string
+ * are out of scope and left to SvelteKit.
+ */
+export function create_csp_directives(options = {}) {
+    const { directives: directives_option, trusted_sources, value_defaults_base = csp_directive_value_defaults, value_defaults: value_defaults_option, required_trust_defaults_base = csp_directive_required_trust_defaults, required_trust_defaults: required_trust_defaults_option, } = options;
+    const directives = {};
+    // Shallowly merge any provided defaults with the base defaults
+    const value_defaults = { ...value_defaults_base, ...value_defaults_option };
+    // Merge required trust defaults with the base
+    const required_trust_defaults = {
+        ...required_trust_defaults_base,
+        ...required_trust_defaults_option,
+    };
+    // Apply defaults from directive specs
+    for (const spec of csp_directive_specs) {
+        const default_value = value_defaults[spec.name];
+        if (default_value == null)
+            continue; // omit null and undefined
+        directives[spec.name] = Array.isArray(default_value)
+            ? [...default_value]
+            : default_value;
+    }
+    // Get trust requirements (with overrides applied)
+    const trust_requirements = new Map();
+    for (const spec of csp_directive_specs) {
+        const required_trust = required_trust_defaults[spec.name];
+        if (required_trust == null)
+            continue; // omit null and undefined
+        trust_requirements.set(spec.name, required_trust);
+    }
+    // Validate trusted_sources directives
+    if (trusted_sources?.length) {
+        for (const spec of trusted_sources) {
+            if (spec.directives) {
+                for (const directive of spec.directives) {
+                    if (parse_csp_directive(directive) === null) {
+                        throw new Error(`Invalid directive in trusted_sources: ${directive}`);
+                    }
+                }
+            }
+        }
+    }
+    // Apply trusted sources to directives
+    if (trusted_sources?.length) {
+        for (const [key, value] of Object.entries(directives)) {
+            const directive = parse_csp_directive(key);
+            if (directive === null) {
+                throw new Error(`Invalid directive in options.directives: ${key}`);
+            }
+            // Skip if directive is ['none'] or not an array
+            if (is_none_directive(value) || !Array.isArray(value)) {
+                continue;
+            }
+            // Get required trust for this directive
+            const required_trust = trust_requirements.get(directive);
+            if (required_trust == null)
+                continue;
+            // Add matching sources - separate the filtering into trust-based and directive-based inclusion
+            const sources_to_add = trusted_sources
+                .filter((spec) => {
+                // Check for explicit inclusion in directives list
+                const explicitly_included = spec.directives?.includes(directive) ?? false;
+                // Check for trust level based inclusion
+                const has_trust_level = spec.trust !== undefined;
+                const include_by_trust = has_trust_level && is_csp_trusted(required_trust, spec.trust);
+                // Include the source if either condition is met
+                return explicitly_included || include_by_trust;
+            })
+                .map((spec) => spec.source);
+            if (sources_to_add.length > 0) {
+                directives[directive] = [...value, ...sources_to_add];
+            }
+        }
+    }
+    // Apply directive overrides/transformations
+    if (directives_option) {
+        for (const [key, value_or_fn] of Object.entries(directives_option)) {
+            const directive = parse_csp_directive(key);
+            if (directive === null) {
+                throw new Error(`Invalid directive in options.directives: ${key}`);
+            }
+            const current = directives[directive];
+            const result = typeof value_or_fn === 'function' ? value_or_fn(current) : value_or_fn;
+            // Handle `undefined` too just in case
+            if (result == null) {
+                delete directives[directive]; // eslint-disable-line @typescript-eslint/no-dynamic-delete
+            }
+            else {
+                directives[directive] = structuredClone(result);
+            }
+        }
+    }
+    return directives;
+}
+export const parse_csp_directive = (directive) => typeof directive === 'string' && csp_directive_spec_by_name.has(directive)
+    ? directive
+    : null;
+export const csp_trust_levels = ['low', 'medium', 'high'];
+/**
+ * Numeric values for CSP trust levels, `csp_trust_levels`.
+ * Lower is less trusted.
+ * Includes `undefined` in the type for safety.
+ */
+export const csp_trust_level_value = {
+    low: 0,
+    medium: 1,
+    high: 2,
+};
+/**
+ * Validates and extracts a CSP trust level from an unknown value.
+ */
+export const parse_csp_trust_level = (trust) => csp_trust_levels.includes(trust) ? trust : null;
+/**
+ * Determines if a granted trust level is sufficient to satisfy a required trust level.
+ *
+ * Trust levels have the following hierarchy:
+ * - 'high' sources can be used in high, medium, and low trust directives (highest privilege)
+ * - 'medium' sources can be used in medium and low trust directives
+ * - 'low' sources can only be used in low trust directives (lowest privilege)
+ */
+export const is_csp_trusted = (required_trust, granted_trust) => {
+    const required_value = required_trust && csp_trust_level_value[required_trust];
+    const granted_value = granted_trust && csp_trust_level_value[granted_trust];
+    if (required_value == null || granted_value == null) {
+        return false;
+    }
+    // A source with higher trust privilege (higher value)
+    // can be used in a directive with less privilege (lower value).
+    return granted_value >= required_value;
+};
+/**
+ * Helper to check if a directive value is `['none']`,
+ * or more precisely for robustness with malformed values, checks for an array with `'none'`.
+ */
+const is_none_directive = (value) => Array.isArray(value) && value.includes('none');
+export const COLOR_SCHEME_SCRIPT_HASH = 'sha256-QOxqn7EUzb3ydF9SALJoJGWSvywW9R0AfTDSenB83Z8=';
+/**
+ * The base CSP directive defaults.
+ * Prioritizes safety but loosens around media and styles, relying on defense-in-depth.
+ * Customizable via `CreateCspDirectivesOptions.defaults`.
+ */
+export const csp_directive_value_defaults = {
+    'default-src': ['none'],
+    'script-src': ['self', COLOR_SCHEME_SCRIPT_HASH], // Eval is opt-in, scripting is locked down except for self and the color scheme loader script
+    'script-src-elem': ['self', COLOR_SCHEME_SCRIPT_HASH], // Block script elements except for self and the color scheme loader
+    'script-src-attr': ['none'], // Block scripts in HTML attributes
+    'style-src': ['self', 'unsafe-inline'], // Main style directive (uses unsafe-inline but network connections are disallowed by other directives)
+    'style-src-elem': ['self', 'unsafe-inline'], // Style elements (standalone stylesheets)
+    'style-src-attr': ['unsafe-inline'], // Style attributes
+    'img-src': ['self', 'data:', 'blob:', 'filesystem:'], // Images
+    'media-src': ['self', 'data:', 'blob:', 'mediastream:', 'filesystem:'], // Audio/video
+    'font-src': ['self', 'data:'], // Fonts
+    'manifest-src': ['self'], // Web app manifests
+    'child-src': ['none'], // Not trusted, extends default-src so worker-src and frame-src are additionally blocked
+    'connect-src': ['self'], // Fetch, WebSockets
+    'frame-src': ['self'], // Frames/iframes
+    'frame-ancestors': ['self'], // Control what can embed this page
+    'form-action': ['self'], // Form submission targets
+    'worker-src': ['self', 'blob:'], // Web workers
+    'object-src': ['none'], // Block plugins (Flash, Java, etc.)
+    'base-uri': ['none'], // Prevent base tag hijacking
+    'upgrade-insecure-requests': true, // Upgrade http to https
+    'report-to': null, // Report violations (e.g. `'/csp-violation-report'`)
+    'require-trusted-types-for': null,
+    'trusted-types': null,
+    sandbox: null,
+};
+/**
+ * Sources that meet this trust requirement are included for it by default.
+ * If null, no trusted sources are added to the directive automatically.
+ * Directives that don't support sources or default to `['none']` are null.
+ *
+ * Feedback is welcome, please see the issues - https://github.com/ryanatkn/fuz/issues
+ */
+export const csp_directive_required_trust_defaults = {
+    'default-src': null,
+    'script-src': 'high',
+    'script-src-elem': 'high',
+    'script-src-attr': null,
+    'style-src': 'medium',
+    'style-src-elem': 'medium',
+    'style-src-attr': 'medium',
+    'img-src': 'low',
+    'media-src': 'low',
+    'font-src': 'low',
+    'manifest-src': null,
+    'child-src': null,
+    'connect-src': 'medium',
+    'frame-src': 'medium',
+    'frame-ancestors': 'medium',
+    'form-action': 'medium',
+    'worker-src': 'medium',
+    'object-src': null,
+    'base-uri': null,
+    'upgrade-insecure-requests': null,
+    'report-to': null,
+    'require-trusted-types-for': null,
+    'trusted-types': null,
+    sandbox: null,
+};
+/**
+ * Static data descriptors for the CSP directives.
+ * Fuz excludes deprecated directives, so those are intentionally omitted,
+ * but any newer missing directives are bugs.
+ *
+ * Could be moved to `csp.ts` but is currently here to keep that module smaller.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Security-Policy
+ */
+export const csp_directive_specs = [
+    {
+        name: 'default-src',
+        fallback: null,
+        fallback_of: [
+            'script-src',
+            'script-src-elem',
+            'script-src-attr',
+            'style-src',
+            'style-src-elem',
+            'style-src-attr',
+            'img-src',
+            'media-src',
+            'font-src',
+            'manifest-src',
+            'child-src',
+            'connect-src',
+            'worker-src',
+            'object-src',
+        ],
+    },
+    {
+        name: 'script-src',
+        fallback: ['default-src'],
+        fallback_of: ['script-src-elem', 'script-src-attr', 'worker-src'],
+    },
+    {
+        name: 'script-src-elem',
+        fallback: ['script-src', 'default-src'],
+        fallback_of: null,
+    },
+    {
+        name: 'script-src-attr',
+        fallback: ['script-src', 'default-src'],
+        fallback_of: null,
+    },
+    {
+        name: 'style-src',
+        fallback: ['default-src'],
+        fallback_of: ['style-src-elem', 'style-src-attr'],
+    },
+    {
+        name: 'style-src-elem',
+        fallback: ['style-src', 'default-src'],
+        fallback_of: null,
+    },
+    {
+        name: 'style-src-attr',
+        fallback: ['style-src', 'default-src'],
+        fallback_of: null,
+    },
+    {
+        name: 'img-src',
+        fallback: ['default-src'],
+        fallback_of: null,
+    },
+    {
+        name: 'media-src',
+        fallback: ['default-src'],
+        fallback_of: null,
+    },
+    {
+        name: 'font-src',
+        fallback: ['default-src'],
+        fallback_of: null,
+    },
+    {
+        name: 'manifest-src',
+        fallback: ['default-src'],
+        fallback_of: null,
+    },
+    {
+        name: 'child-src',
+        fallback: ['default-src'],
+        fallback_of: ['frame-src', 'worker-src'],
+    },
+    {
+        name: 'connect-src',
+        fallback: ['default-src'],
+        fallback_of: null,
+    },
+    {
+        name: 'frame-src',
+        fallback: ['child-src'],
+        fallback_of: null,
+    },
+    {
+        name: 'frame-ancestors',
+        fallback: null,
+        fallback_of: null,
+    },
+    {
+        name: 'form-action',
+        fallback: null,
+        fallback_of: null,
+    },
+    {
+        name: 'worker-src',
+        fallback: ['child-src', 'script-src', 'default-src'],
+        fallback_of: null,
+    },
+    {
+        name: 'object-src',
+        fallback: ['default-src'],
+        fallback_of: null,
+    },
+    {
+        name: 'base-uri',
+        fallback: null,
+        fallback_of: null,
+    },
+    {
+        name: 'upgrade-insecure-requests',
+        fallback: null,
+        fallback_of: null,
+    },
+    {
+        name: 'report-to',
+        fallback: null,
+        fallback_of: null,
+    },
+    {
+        name: 'require-trusted-types-for',
+        fallback: null,
+        fallback_of: null,
+    },
+    {
+        name: 'trusted-types',
+        fallback: null,
+        fallback_of: null,
+    },
+    {
+        name: 'sandbox',
+        fallback: null,
+        fallback_of: null,
+    },
+];
+export const csp_directive_spec_by_name = new Map(csp_directive_specs.map((s) => [s.name, s]));

package/dist/csp_of_ryanatkn.d.ts

@@ -0,0 +1,6 @@
+import type { CspSourceSpec } from './csp.js';
+/**
+ * Trusted sources owned by ryanatkn.
+ */
+export declare const csp_trusted_sources_of_ryanatkn: Array<CspSourceSpec>;
+//# sourceMappingURL=csp_of_ryanatkn.d.ts.map

package/dist/csp_of_ryanatkn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csp_of_ryanatkn.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/csp_of_ryanatkn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,+BAA+B,EAAE,KAAK,CAAC,aAAa,CAUhE,CAAC"}

package/dist/csp_of_ryanatkn.js

@@ -0,0 +1,14 @@
+/**
+ * Trusted sources owned by ryanatkn.
+ */
+export const csp_trusted_sources_of_ryanatkn = [
+    { source: 'https://*.ryanatkn.com/', trust: 'low' },
+    { source: 'https://*.spiderspace.org/', trust: 'low' },
+    { source: 'https://*.webdevladder.net/', trust: 'low' },
+    { source: 'https://*.dealt.dev/', trust: 'low' },
+    { source: 'https://*.fuz.dev/', trust: 'low' },
+    { source: 'https://*.ztack.net/', trust: 'low' },
+    { source: 'https://*.zzz.software/', trust: 'low' },
+    { source: 'https://*.cosmicplayground.org/', trust: 'low' },
+    { source: 'https://ryanatkn.github.io/', trust: 'low' },
+];

package/dist/declaration.svelte.d.ts

@@ -0,0 +1,84 @@
+import { type DeclarationJson } from '@fuzdev/fuz_util/source_json.js';
+import type { Module } from './module.svelte.js';
+/**
+ * Rich runtime representation of an exported declaration.
+ */
+export declare class Declaration {
+    readonly module: Module;
+    readonly declaration_json: DeclarationJson;
+    library: import("./library.svelte.ts").Library;
+    /**
+     * Module path where this declaration is defined.
+     */
+    module_path: string;
+    name: string;
+    kind: "function" | "type" | "json" | "variable" | "class" | "constructor" | "component" | "css";
+    /**
+     * GitHub source URL with line number.
+     */
+    url_github: string | undefined;
+    /**
+     * API documentation URL.
+     */
+    url_api: string;
+    /**
+     * Generated TypeScript import statement.
+     */
+    import_statement: string;
+    /**
+     * Public documentation link (if homepage_url is available).
+     */
+    url_api_full: string | undefined;
+    /**
+     * Display name with generic parameters.
+     */
+    display_name: string;
+    type_signature: string | undefined;
+    doc_comment: string | undefined;
+    deprecated_message: string | undefined;
+    parameters: {
+        [x: string]: unknown;
+        name: string;
+        type: string;
+        optional?: boolean | undefined;
+        description?: string | undefined;
+        default_value?: string | undefined;
+    }[] | undefined;
+    props: {
+        [x: string]: unknown;
+        name: string;
+        type: string;
+        optional?: boolean | undefined;
+        description?: string | undefined;
+        default_value?: string | undefined;
+        bindable?: boolean | undefined;
+    }[] | undefined;
+    return_type: string | undefined;
+    return_description: string | undefined;
+    generic_params: {
+        [x: string]: unknown;
+        name: string;
+        constraint?: string | undefined;
+        default_type?: string | undefined;
+    }[] | undefined;
+    extends: string[] | undefined;
+    implements: string[] | undefined;
+    throws: {
+        [x: string]: unknown;
+        description: string;
+        type?: string | undefined;
+    }[] | undefined;
+    since: string | undefined;
+    examples: string[] | undefined;
+    see_also: string[] | undefined;
+    members: Array<DeclarationJson> | undefined;
+    properties: Array<DeclarationJson> | undefined;
+    has_examples: boolean;
+    is_deprecated: boolean;
+    has_documentation: boolean;
+    has_parameters: boolean;
+    has_props: boolean;
+    has_generics: boolean;
+    constructor(module: Module, declaration_json: DeclarationJson);
+}
+//# sourceMappingURL=declaration.svelte.d.ts.map

package/dist/declaration.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/declaration.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,eAAe,EAGpB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAG/C;;GAEG;AACH,qBAAa,WAAW;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAiB;IACxC,QAAQ,CAAC,gBAAgB,EAAE,eAAe,CAAiB;IAE3D,OAAO,wCAAiC;IAExC;;OAEG;IACH,WAAW,SAA8B;IAEzC,IAAI,SAAwC;IAC5C,IAAI,4FAAwC;IAE5C;;OAEG;IACH,UAAU,qBAQR;IAEF;;OAEG;IACH,OAAO,SAA0D;IAEjE;;OAEG;IACH,gBAAgB,SAMd;IAEF;;OAEG;IACH,YAAY,qBAIV;IAEF;;OAEG;IACH,YAAY,SAAiE;IAE7E,cAAc,qBAAkD;IAChE,WAAW,qBAA+C;IAC1D,kBAAkB,qBAAsD;IACxE,UAAU;;;;;;;oBAA8C;IACxD,KAAK;;;;;;;;oBAAyC;IAC9C,WAAW,qBAA+C;IAC1D,kBAAkB,qBAAsD;IACxE,cAAc;;;;;oBAAkD;IAChE,OAAO,uBAA2C;IAClD,UAAU,uBAA8C;IACxD,MAAM;;;;oBAA0C;IAChD,KAAK,qBAAyC;IAC9C,QAAQ,uBAA4C;IACpD,QAAQ,uBAA4C;IACpD,OAAO,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,SAAS,CAEzC;IACF,UAAU,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,SAAS,CAE5C;IAEF,YAAY,UAA2D;IACvE,aAAa,UAAuC;IACpD,iBAAiB,UAAgC;IACjD,cAAc,UAA+D;IAC7E,SAAS,UAAqD;IAC9D,YAAY,UAAuE;gBAEvE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,eAAe;CAI7D"}

package/dist/declaration.svelte.js

@@ -0,0 +1,66 @@
+import { declaration_generate_import, declaration_get_display_name, } from '@fuzdev/fuz_util/source_json.js';
+import { url_github_file } from './library_helpers.js';
+/**
+ * Rich runtime representation of an exported declaration.
+ */
+export class Declaration {
+    module = $state.raw();
+    declaration_json = $state.raw();
+    library = $derived(this.module.library);
+    /**
+     * Module path where this declaration is defined.
+     */
+    module_path = $derived(this.module.path);
+    name = $derived(this.declaration_json.name);
+    kind = $derived(this.declaration_json.kind);
+    /**
+     * GitHub source URL with line number.
+     */
+    url_github = $derived(this.library.repo_url && this.declaration_json.source_line
+        ? url_github_file(this.library.repo_url, `src/lib/${this.module_path}`, this.declaration_json.source_line)
+        : undefined);
+    /**
+     * API documentation URL.
+     */
+    url_api = $derived(`/docs/api/${this.module_path}#${this.name}`);
+    /**
+     * Generated TypeScript import statement.
+     */
+    import_statement = $derived(declaration_generate_import(this.declaration_json, this.module_path, this.library.package_json.name));
+    /**
+     * Public documentation link (if homepage_url is available).
+     */
+    url_api_full = $derived(this.library.homepage_url
+        ? `${this.library.homepage_url.replace(/\/$/, '')}/docs/api/${this.module_path}#${this.name}`
+        : undefined);
+    /**
+     * Display name with generic parameters.
+     */
+    display_name = $derived(declaration_get_display_name(this.declaration_json));
+    type_signature = $derived(this.declaration_json.type_signature);
+    doc_comment = $derived(this.declaration_json.doc_comment);
+    deprecated_message = $derived(this.declaration_json.deprecated_message);
+    parameters = $derived(this.declaration_json.parameters);
+    props = $derived(this.declaration_json.props);
+    return_type = $derived(this.declaration_json.return_type);
+    return_description = $derived(this.declaration_json.return_description);
+    generic_params = $derived(this.declaration_json.generic_params);
+    extends = $derived(this.declaration_json.extends);
+    implements = $derived(this.declaration_json.implements);
+    throws = $derived(this.declaration_json.throws);
+    since = $derived(this.declaration_json.since);
+    examples = $derived(this.declaration_json.examples);
+    see_also = $derived(this.declaration_json.see_also);
+    members = $derived(this.declaration_json.members);
+    properties = $derived(this.declaration_json.properties);
+    has_examples = $derived(!!(this.examples && this.examples.length > 0));
+    is_deprecated = $derived(!!this.deprecated_message);
+    has_documentation = $derived(!!this.doc_comment);
+    has_parameters = $derived(!!(this.parameters && this.parameters.length > 0));
+    has_props = $derived(!!(this.props && this.props.length > 0));
+    has_generics = $derived(!!(this.generic_params && this.generic_params.length > 0));
+    constructor(module, declaration_json) {
+        this.module = module;
+        this.declaration_json = declaration_json;
+    }
+}

package/dist/declaration_contextmenu.d.ts

@@ -0,0 +1,4 @@
+import type { Declaration } from './declaration.svelte.js';
+import type { ContextmenuParams } from './contextmenu_state.svelte.js';
+export declare const create_declaration_contextmenu: (declaration: Declaration) => Array<ContextmenuParams>;
+//# sourceMappingURL=declaration_contextmenu.d.ts.map

package/dist/declaration_contextmenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration_contextmenu.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/declaration_contextmenu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,+BAA+B,CAAC;AAIrE,eAAO,MAAM,8BAA8B,GAC1C,aAAa,WAAW,KACtB,KAAK,CAAC,iBAAiB,CAczB,CAAC"}

package/dist/declaration_contextmenu.js

@@ -0,0 +1,14 @@
+// TODO @many expand contextmenus for docs
+export const create_declaration_contextmenu = (declaration) => {
+    const entries = [];
+    // View source on GitHub
+    if (declaration.url_github) {
+        entries.push({
+            snippet: 'link',
+            props: {
+                href: declaration.url_github,
+            },
+        });
+    }
+    return entries;
+};

package/dist/dialog.d.ts

@@ -0,0 +1,24 @@
+import type { ComponentProps, Component } from 'svelte';
+import type Dialog from './Dialog.svelte';
+/**
+ * This helper function is needed to construct `DialogParams` with type safety.
+ * It uses TypeScript's inferred generics for functions,
+ * which do not work for plain objects as of v5.0.4.
+ * * `ContextmenuParams` uses a similar strategy.
+ */
+export declare const to_dialog_params: <T extends Component<any>>(Component: T, props: ComponentProps<T>, dialog_props?: Partial<ComponentProps<typeof Dialog>>) => DialogParams<T>;
+/**
+ * This pattern is based on:
+ * https://github.com/ivanhofer/sveltekit-typescript-showcase/blob/main/src/01-props/09-svelte-component/Component.svelte
+ * The main limitation is that the generic cannot be inferred automatically,
+ * so we use `to_dialog_params` to construct instances in most cases.
+ * Definining `DialogParams` with no concrete `T` lacks typechecking for `props`.
+ */
+export interface DialogParams<T extends Component<any> = Component<any>> {
+    Component: T;
+    props: ComponentProps<T>;
+    dialog_props?: Partial<ComponentProps<typeof Dialog>> | undefined;
+}
+export type DialogLayout = 'centered' | 'page';
+export declare const dialog_layouts: Array<DialogLayout>;
+//# sourceMappingURL=dialog.d.ts.map

package/dist/dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/dialog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAE,SAAS,EAAC,MAAM,QAAQ,CAAC;AAEtD,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,EACxD,WAAW,CAAC,EACZ,OAAO,cAAc,CAAC,CAAC,CAAC,EACxB,eAAe,OAAO,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,CAAC,KACnD,YAAY,CAAC,CAAC,CAIf,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC;IACtE,SAAS,EAAE,CAAC,CAAC;IACb,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;CAClE;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;AAC/C,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,YAAY,CAAwB,CAAC"}

package/dist/dialog.js

@@ -0,0 +1,12 @@
+/**
+ * This helper function is needed to construct `DialogParams` with type safety.
+ * It uses TypeScript's inferred generics for functions,
+ * which do not work for plain objects as of v5.0.4.
+ * * `ContextmenuParams` uses a similar strategy.
+ */
+export const to_dialog_params = (Component, props, dialog_props) => ({
+    Component,
+    props,
+    dialog_props,
+});
+export const dialog_layouts = ['centered', 'page'];

package/dist/dimensions.svelte.d.ts

@@ -0,0 +1,5 @@
+export declare class Dimensions {
+    width: number;
+    height: number;
+}
+//# sourceMappingURL=dimensions.svelte.d.ts.map

package/dist/dimensions.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/dimensions.svelte.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAU;IACtB,KAAK,EAAE,MAAM,CAAa;IAC1B,MAAM,EAAE,MAAM,CAAa;CAC3B"}

package/dist/dimensions.svelte.js

@@ -0,0 +1,4 @@
+export class Dimensions {
+    width = $state(0);
+    height = $state(0);
+}

package/dist/docs_helpers.svelte.d.ts

@@ -0,0 +1,48 @@
+import { SvelteMap, SvelteSet } from 'svelte/reactivity';
+/**
+ * Convert a string to a URL-safe fragment identifier, preserving case for API declarations.
+ * Only transforms spaces and special characters, keeping valid identifier characters intact.
+ * Used for hash anchors in documentation.
+ * @param str - The string to convert to a fragment
+ * @returns A URL-safe fragment identifier
+ */
+export declare const docs_slugify: (str: string) => string;
+export declare const DOCS_PATH_DEFAULT = "/docs";
+export declare const DOCS_PATH: string;
+export declare const DOCS_API_PATH: string;
+export declare const to_docs_path_info: (path_slug: string, pathname: string, root_path?: string) => {
+    path: string;
+    path_is_selected: boolean;
+    path_segment: string | undefined;
+};
+export declare const docs_links_context: {
+    get: (error_message?: string) => DocsLinks;
+    get_maybe: () => DocsLinks | undefined;
+    set: (value: DocsLinks) => DocsLinks;
+};
+export type DocsLinkTag = 'h2' | 'h3' | 'h4';
+export interface DocsLinkInfo {
+    id: string;
+    text: string;
+    fragment: string;
+    tag: DocsLinkTag | undefined;
+    depth: number;
+    order: number;
+    parent_id: string | undefined;
+}
+export declare class DocsLinks {
+    #private;
+    readonly root_path: string;
+    readonly links: SvelteMap<string, DocsLinkInfo>;
+    docs_links: DocsLinkInfo[];
+    readonly fragments_onscreen: SvelteSet<string>;
+    constructor(root_path?: string);
+    add(fragment: string, text: string, pathname: string, tag?: DocsLinkTag, depth?: number, parent_id?: string, explicit_id?: string): string;
+    remove(id: string): void;
+    /**
+     * Generate a unique section ID for the current page render.
+     * This counter is instance-scoped, ensuring SSR/client consistency.
+     */
+    generate_section_id(): string;
+}
+//# sourceMappingURL=docs_helpers.svelte.d.ts.map

package/dist/docs_helpers.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs_helpers.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/docs_helpers.svelte.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,SAAS,EAAE,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAKvD;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAY1C,CAAC;AAEF,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,SAAS,QAAmB,CAAC;AAC1C,eAAO,MAAM,aAAa,QAAqB,CAAC;AAEhD,eAAO,MAAM,iBAAiB,GAC7B,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,kBAA6B,KAC3B;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;CAK5E,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;CAA8B,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,WAAW,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,qBAAa,SAAS;;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAmB;IAgBlE,UAAU,iBA4BP;IAEH,QAAQ,CAAC,kBAAkB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAmB;gBAErD,SAAS,SAAoB;IAIzC,GAAG,CACF,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,WAAW,EACjB,KAAK,SAAI,EACT,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GAClB,MAAM;IAkBT,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB;;;OAGG;IACH,mBAAmB,IAAI,MAAM;CAG7B"}