@fuzdev/fuz_ui 0.181.1 → 0.182.1

package/dist/package_helpers.d.ts

@@ -30,12 +30,16 @@ import type { PackageJson } from '@fuzdev/fuz_util/package_json.js';
  * @returns Full GitHub URL to the file on the main branch
  *
  * @example
+ * ```ts
  * url_github_file('https://github.com/foo/bar', 'src/index.ts')
  * // => 'https://github.com/foo/bar/blob/main/src/index.ts'
+ * ```
  *
  * @example
+ * ```ts
  * url_github_file('https://github.com/foo/bar', './src/index.ts', 42)
  * // => 'https://github.com/foo/bar/blob/main/src/index.ts#L42'
+ * ```
  */
 export declare const url_github_file: (repo_url: string, file_path: string, line?: number) => string;
 /**
@@ -46,8 +50,10 @@ export declare const url_github_file: (repo_url: string, file_path: string, line
  * @returns Organization URL, or null if repo_url doesn't end with repo_name
  *
  * @example
+ * ```ts
  * url_github_org('https://github.com/fuzdev/fuz_ui', 'fuz_ui')
  * // => 'https://github.com/fuzdev'
+ * ```
  */
 export declare const url_github_org: (repo_url: string, repo_name: string) => string | null;
 /**
@@ -57,12 +63,16 @@ export declare const url_github_org: (repo_url: string, repo_name: string) => st
  * @returns Owner name, or null if not a valid GitHub URL
  *
  * @example
+ * ```ts
  * repo_url_github_owner('https://github.com/fuzdev/fuz_ui')
  * // => 'fuzdev'
+ * ```
  *
  * @example
+ * ```ts
  * repo_url_github_owner('https://gitlab.com/foo/bar')
  * // => null (not a GitHub URL)
+ * ```
  */
 export declare const repo_url_github_owner: (repo_url: string) => string | null;
 /**
@@ -72,8 +82,10 @@ export declare const repo_url_github_owner: (repo_url: string) => string | null;
  * @returns Full npm package page URL
  *
  * @example
+ * ```ts
  * url_npm_package('@fuzdev/fuz_ui')
  * // => 'https://www.npmjs.com/package/@fuzdev/fuz_ui'
+ * ```
  */
 export declare const url_npm_package: (package_name: string) => string;
 /**
@@ -96,12 +108,16 @@ export declare const package_is_published: (package_json: PackageJson) => boolea
  * @throws Error if scoped package name is malformed
  *
  * @example
+ * ```ts
  * repo_name_parse('@fuzdev/fuz_ui')
  * // => 'fuz_ui'
+ * ```
  *
  * @example
+ * ```ts
  * repo_name_parse('lodash')
  * // => 'lodash'
+ * ```
  */
 export declare const repo_name_parse: (name: string) => string;
 /**
@@ -114,16 +130,22 @@ export declare const repo_name_parse: (name: string) => string;
  * @returns Clean repository URL, or null if not provided
  *
  * @example
+ * ```ts
  * repo_url_parse('https://github.com/foo/bar')
  * // => 'https://github.com/foo/bar'
+ * ```
  *
  * @example
+ * ```ts
  * repo_url_parse({url: 'git+https://github.com/foo/bar.git'})
  * // => 'https://github.com/foo/bar'
+ * ```
  *
  * @example
+ * ```ts
  * repo_url_parse(undefined)
  * // => null
+ * ```
  */
 export declare const repo_url_parse: (repository: PackageJson["repository"]) => string | null;
 /**
@@ -134,8 +156,10 @@ export declare const repo_url_parse: (repository: PackageJson["repository"]) =>
  * @returns Full URL to the .well-known file
  *
  * @example
+ * ```ts
  * url_well_known('https://fuz.dev', 'package.json')
  * // => 'https://fuz.dev/.well-known/package.json'
+ * ```
  */
 export declare const url_well_known: (homepage_url: string, filename: string) => string;
 //# sourceMappingURL=package_helpers.d.ts.map

package/dist/package_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/package_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAElE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,EAAE,OAAO,MAAM,KAAG,MAIpF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,MAAM,GAAG,IAE7E,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,MAAM,GAAG,IAKjE,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAI,cAAc,MAAM,KAAG,MACP,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,WAAW,KAAG,OAEhE,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAS9C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,cAAc,GAAI,YAAY,WAAW,CAAC,YAAY,CAAC,KAAG,MAAM,GAAG,IAK/E,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,cAAc,MAAM,EAAE,UAAU,MAAM,KAAG,MAEvE,CAAC"}
+{"version":3,"file":"package_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/package_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAElE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,EAAE,OAAO,MAAM,KAAG,MAIpF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,MAAM,GAAG,IAE7E,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,MAAM,GAAG,IAKjE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAAI,cAAc,MAAM,KAAG,MACP,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,WAAW,KAAG,OAEhE,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAS9C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,cAAc,GAAI,YAAY,WAAW,CAAC,YAAY,CAAC,KAAG,MAAM,GAAG,IAK/E,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,cAAc,MAAM,EAAE,UAAU,MAAM,KAAG,MAEvE,CAAC"}

package/dist/package_helpers.js

@@ -30,12 +30,16 @@ import { ensure_end, strip_end, strip_start } from '@fuzdev/fuz_util/string.js';
  * @returns Full GitHub URL to the file on the main branch
  *
  * @example
+ * ```ts
  * url_github_file('https://github.com/foo/bar', 'src/index.ts')
  * // => 'https://github.com/foo/bar/blob/main/src/index.ts'
+ * ```
  *
  * @example
+ * ```ts
  * url_github_file('https://github.com/foo/bar', './src/index.ts', 42)
  * // => 'https://github.com/foo/bar/blob/main/src/index.ts#L42'
+ * ```
  */
 export const url_github_file = (repo_url, file_path, line) => {
     const clean_path = file_path.replace(/^\.\//, '');
@@ -50,8 +54,10 @@ export const url_github_file = (repo_url, file_path, line) => {
  * @returns Organization URL, or null if repo_url doesn't end with repo_name
  *
  * @example
+ * ```ts
  * url_github_org('https://github.com/fuzdev/fuz_ui', 'fuz_ui')
  * // => 'https://github.com/fuzdev'
+ * ```
  */
 export const url_github_org = (repo_url, repo_name) => {
     return repo_url.endsWith('/' + repo_name) ? strip_end(repo_url, '/' + repo_name) : null;
@@ -63,12 +69,16 @@ export const url_github_org = (repo_url, repo_name) => {
  * @returns Owner name, or null if not a valid GitHub URL
  *
  * @example
+ * ```ts
  * repo_url_github_owner('https://github.com/fuzdev/fuz_ui')
  * // => 'fuzdev'
+ * ```
  *
  * @example
+ * ```ts
  * repo_url_github_owner('https://gitlab.com/foo/bar')
  * // => null (not a GitHub URL)
+ * ```
  */
 export const repo_url_github_owner = (repo_url) => {
     const stripped = strip_start(repo_url, 'https://github.com/');
@@ -84,8 +94,10 @@ export const repo_url_github_owner = (repo_url) => {
  * @returns Full npm package page URL
  *
  * @example
+ * ```ts
  * url_npm_package('@fuzdev/fuz_ui')
  * // => 'https://www.npmjs.com/package/@fuzdev/fuz_ui'
+ * ```
  */
 export const url_npm_package = (package_name) => 'https://www.npmjs.com/package/' + package_name;
 /**
@@ -110,12 +122,16 @@ export const package_is_published = (package_json) => {
  * @throws Error if scoped package name is malformed
  *
  * @example
+ * ```ts
  * repo_name_parse('@fuzdev/fuz_ui')
  * // => 'fuz_ui'
+ * ```
  *
  * @example
+ * ```ts
  * repo_name_parse('lodash')
  * // => 'lodash'
+ * ```
  */
 export const repo_name_parse = (name) => {
     if (name[0] === '@') {
@@ -137,16 +153,22 @@ export const repo_name_parse = (name) => {
  * @returns Clean repository URL, or null if not provided
  *
  * @example
+ * ```ts
  * repo_url_parse('https://github.com/foo/bar')
  * // => 'https://github.com/foo/bar'
+ * ```
  *
  * @example
+ * ```ts
  * repo_url_parse({url: 'git+https://github.com/foo/bar.git'})
  * // => 'https://github.com/foo/bar'
+ * ```
  *
  * @example
+ * ```ts
  * repo_url_parse(undefined)
  * // => null
+ * ```
  */
 export const repo_url_parse = (repository) => {
     if (!repository)
@@ -164,8 +186,10 @@ export const repo_url_parse = (repository) => {
  * @returns Full URL to the .well-known file
  *
  * @example
+ * ```ts
  * url_well_known('https://fuz.dev', 'package.json')
  * // => 'https://fuz.dev/.well-known/package.json'
+ * ```
  */
 export const url_well_known = (homepage_url, filename) => {
     return `${ensure_end(homepage_url, '/')}.well-known/${filename}`;

package/dist/svelte_preprocess_mdz.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Svelte preprocessor that compiles static `Mdz` content to Svelte markup at build time.
+ *
+ * Detects `Mdz` components with static string `content` props, parses the mdz content,
+ * renders each `MdzNode` to equivalent Svelte markup via `mdz_to_svelte`, and replaces
+ * the `Mdz` with `MdzPrecompiled` containing pre-rendered children.
+ *
+ * Also handles ternary chains (`content={a ? 'x' : b ? 'y' : 'z'}`) where all leaf
+ * values are statically resolvable strings, emitting `{#if a}markup_x{:else if b}markup_y{:else}markup_z{/if}`
+ * as children of a single `MdzPrecompiled`.
+ *
+ * Truly dynamic `content` props are left untouched.
+ *
+ * @module
+ */
+import { type PreprocessorGroup } from 'svelte/compiler';
+/**
+ * Options for `svelte_preprocess_mdz`.
+ */
+export interface SveltePreprocessMdzOptions {
+    /** File patterns to exclude. */
+    exclude?: Array<string | RegExp>;
+    /**
+     * Component import mapping for mdz content.
+     * Key: component name as used in mdz (e.g., 'Alert').
+     * Value: import path (e.g., '$lib/Alert.svelte').
+     *
+     * If mdz content references a component not in this map,
+     * that Mdz usage is skipped (left as runtime).
+     */
+    components?: Record<string, string>;
+    /**
+     * Allowed HTML elements in mdz content.
+     * If mdz content references an element not in this list,
+     * that Mdz usage is skipped (left as runtime).
+     */
+    elements?: Array<string>;
+    /**
+     * Import sources that resolve to the Mdz component.
+     * Used to verify that `Mdz` in templates refers to fuz_ui's Mdz.svelte.
+     *
+     * @default ['@fuzdev/fuz_ui/Mdz.svelte']
+     */
+    component_imports?: Array<string>;
+    /**
+     * Import path for the precompiled wrapper component.
+     *
+     * @default '@fuzdev/fuz_ui/MdzPrecompiled.svelte'
+     */
+    compiled_component_import?: string;
+    /**
+     * How to handle errors during mdz parsing or rendering.
+     *
+     * @default 'throw' in CI, 'log' otherwise
+     */
+    on_error?: 'log' | 'throw';
+}
+/**
+ * Creates a Svelte preprocessor that compiles static `Mdz` content at build time.
+ *
+ * @param options Configuration for component/element resolution and file filtering.
+ * @returns A Svelte `PreprocessorGroup` for use in `svelte.config.js`.
+ */
+export declare const svelte_preprocess_mdz: (options?: SveltePreprocessMdzOptions) => PreprocessorGroup;
+//# sourceMappingURL=svelte_preprocess_mdz.d.ts.map

package/dist/svelte_preprocess_mdz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svelte_preprocess_mdz.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/svelte_preprocess_mdz.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAQ,KAAK,iBAAiB,EAAW,MAAM,iBAAiB,CAAC;AA+BxE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C,gCAAgC;IAChC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAEjC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAElC;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;CAC3B;AAID;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GACjC,UAAS,0BAA+B,KACtC,iBAsFF,CAAC"}