@bquery/bquery 1.5.0 → 1.7.0

package/src/platform/index.ts

@@ -1,39 +1,39 @@
-/**
- * Platform module providing unified endpoints for web platform APIs.
- * Offers consistent, promise-based interfaces with predictable errors.
- *
- * @module bquery/platform
- */
-
-export { buckets } from './buckets';
-export type { Bucket } from './buckets';
-
-export { cache } from './cache';
-export type { CacheHandle } from './cache';
-
-export { useCookie } from './cookies';
-export type { UseCookieOptions } from './cookies';
-
-export { defineBqueryConfig, getBqueryConfig } from './config';
-export type {
-  BqueryAnnouncerConfig,
-  BqueryComponentLibraryConfig,
-  BqueryConfig,
-  BqueryCookieConfig,
-  BqueryFetchConfig,
-  BqueryFetchParseAs,
-  BqueryPageMetaConfig,
-  BqueryTransitionConfig,
-} from './config';
-
-export { notifications } from './notifications';
-export type { NotificationOptions } from './notifications';
-
-export { useAnnouncer } from './announcer';
-export type { AnnounceOptions, AnnouncerHandle, UseAnnouncerOptions } from './announcer';
-
-export { definePageMeta } from './meta';
-export type { PageLinkTag, PageMetaCleanup, PageMetaDefinition, PageMetaTag } from './meta';
-
-export { storage } from './storage';
-export type { IndexedDBOptions, StorageAdapter } from './storage';
+/**
+ * Platform module providing unified endpoints for web platform APIs.
+ * Offers consistent, promise-based interfaces with predictable errors.
+ *
+ * @module bquery/platform
+ */
+
+export { buckets } from './buckets';
+export type { Bucket } from './buckets';
+
+export { cache } from './cache';
+export type { CacheHandle } from './cache';
+
+export { useCookie } from './cookies';
+export type { UseCookieOptions } from './cookies';
+
+export { defineBqueryConfig, getBqueryConfig } from './config';
+export type {
+  BqueryAnnouncerConfig,
+  BqueryComponentLibraryConfig,
+  BqueryConfig,
+  BqueryCookieConfig,
+  BqueryFetchConfig,
+  BqueryFetchParseAs,
+  BqueryPageMetaConfig,
+  BqueryTransitionConfig,
+} from './config';
+
+export { notifications } from './notifications';
+export type { NotificationOptions } from './notifications';
+
+export { useAnnouncer } from './announcer';
+export type { AnnounceOptions, AnnouncerHandle, UseAnnouncerOptions } from './announcer';
+
+export { definePageMeta } from './meta';
+export type { PageLinkTag, PageMetaCleanup, PageMetaDefinition, PageMetaTag } from './meta';
+
+export { storage } from './storage';
+export type { IndexedDBOptions, StorageAdapter } from './storage';

package/src/platform/meta.ts

@@ -1,168 +1,168 @@
-/**
- * Document title and meta helpers.
- *
- * @module bquery/platform
- */
-
-import { getBqueryConfig } from './config';
-
-/** Meta tag definition. */
-export interface PageMetaTag {
-  /** Standard meta name attribute. */
-  name?: string;
-  /** Open Graph / custom property attribute. */
-  property?: string;
-  /** http-equiv attribute. */
-  httpEquiv?: string;
-  /** Meta tag content. */
-  content: string;
-}
-
-/** Link tag definition. */
-export interface PageLinkTag {
-  /** Link relation. */
-  rel: string;
-  /** Link URL. */
-  href: string;
-  /** Optional type attribute. */
-  type?: string;
-  /** Optional media query. */
-  media?: string;
-  /** Optional crossOrigin attribute. */
-  crossOrigin?: 'anonymous' | 'use-credentials';
-}
-
-/** Page metadata definition. */
-export interface PageMetaDefinition {
-  /** Document title. */
-  title?: string;
-  /** Convenience shortcut for the description meta tag. */
-  description?: string;
-  /** Additional meta tags. */
-  meta?: PageMetaTag[];
-  /** Additional link tags. */
-  link?: PageLinkTag[];
-  /** Attributes applied to the html element. */
-  htmlAttributes?: Record<string, string>;
-  /** Attributes applied to the body element. */
-  bodyAttributes?: Record<string, string>;
-}
-
-/** Cleanup function returned by definePageMeta(). */
-export type PageMetaCleanup = () => void;
-
-const setAttributes = (target: HTMLElement, attributes: Record<string, string>): (() => void) => {
-  const previousValues = new Map<string, string | null>();
-
-  for (const [name, value] of Object.entries(attributes)) {
-    previousValues.set(name, target.getAttribute(name));
-    target.setAttribute(name, value);
-  }
-
-  return () => {
-    for (const [name, value] of previousValues.entries()) {
-      if (value == null) {
-        target.removeAttribute(name);
-      } else {
-        target.setAttribute(name, value);
-      }
-    }
-  };
-};
-
-const createElement = <T extends 'meta' | 'link'>(
-  tagName: T,
-  attributes: Record<string, string | undefined>
-): HTMLElementTagNameMap[T] => {
-  const element = document.createElement(tagName);
-  element.setAttribute('data-bquery-page-meta', 'true');
-
-  for (const [name, value] of Object.entries(attributes)) {
-    if (value !== undefined) {
-      element.setAttribute(name, value);
-    }
-  }
-
-  return element;
-};
-
-/**
- * Apply document metadata for the current page.
- *
- * @param definition - Title, meta tags, link tags, and document attributes
- * @returns Cleanup function that restores the previous document state
- *
- * @example
- * ```ts
- * const cleanup = definePageMeta({
- *   title: 'Dashboard',
- *   description: 'Overview of your account',
- * });
- * ```
- */
-export const definePageMeta = (definition: PageMetaDefinition): PageMetaCleanup => {
-  if (typeof document === 'undefined') {
-    return () => {};
-  }
-
-  const config = getBqueryConfig().pageMeta;
-  const title = definition.title
-    ? config?.titleTemplate
-      ? config.titleTemplate(definition.title)
-      : definition.title
-    : undefined;
-
-  const inserted: HTMLElement[] = [];
-  const restoreFns: Array<() => void> = [];
-  const previousTitle = document.title;
-
-  if (title !== undefined) {
-    document.title = title;
-  }
-
-  const metaEntries = [...(definition.meta ?? [])];
-  if (definition.description) {
-    metaEntries.unshift({ name: 'description', content: definition.description });
-  }
-
-  for (const entry of metaEntries) {
-    const meta = createElement('meta', {
-      name: entry.name,
-      property: entry.property,
-      'http-equiv': entry.httpEquiv,
-      content: entry.content,
-    });
-    document.head.appendChild(meta);
-    inserted.push(meta);
-  }
-
-  for (const entry of definition.link ?? []) {
-    const link = createElement('link', {
-      rel: entry.rel,
-      href: entry.href,
-      type: entry.type,
-      media: entry.media,
-      crossorigin: entry.crossOrigin,
-    });
-    document.head.appendChild(link);
-    inserted.push(link);
-  }
-
-  if (definition.htmlAttributes) {
-    restoreFns.push(setAttributes(document.documentElement, definition.htmlAttributes));
-  }
-
-  if (definition.bodyAttributes && document.body) {
-    restoreFns.push(setAttributes(document.body, definition.bodyAttributes));
-  }
-
-  return () => {
-    document.title = previousTitle;
-    for (const restore of restoreFns.reverse()) {
-      restore();
-    }
-    for (const element of inserted) {
-      element.remove();
-    }
-  };
-};
+/**
+ * Document title and meta helpers.
+ *
+ * @module bquery/platform
+ */
+
+import { getBqueryConfig } from './config';
+
+/** Meta tag definition. */
+export interface PageMetaTag {
+  /** Standard meta name attribute. */
+  name?: string;
+  /** Open Graph / custom property attribute. */
+  property?: string;
+  /** http-equiv attribute. */
+  httpEquiv?: string;
+  /** Meta tag content. */
+  content: string;
+}
+
+/** Link tag definition. */
+export interface PageLinkTag {
+  /** Link relation. */
+  rel: string;
+  /** Link URL. */
+  href: string;
+  /** Optional type attribute. */
+  type?: string;
+  /** Optional media query. */
+  media?: string;
+  /** Optional crossOrigin attribute. */
+  crossOrigin?: 'anonymous' | 'use-credentials';
+}
+
+/** Page metadata definition. */
+export interface PageMetaDefinition {
+  /** Document title. */
+  title?: string;
+  /** Convenience shortcut for the description meta tag. */
+  description?: string;
+  /** Additional meta tags. */
+  meta?: PageMetaTag[];
+  /** Additional link tags. */
+  link?: PageLinkTag[];
+  /** Attributes applied to the html element. */
+  htmlAttributes?: Record<string, string>;
+  /** Attributes applied to the body element. */
+  bodyAttributes?: Record<string, string>;
+}
+
+/** Cleanup function returned by definePageMeta(). */
+export type PageMetaCleanup = () => void;
+
+const setAttributes = (target: HTMLElement, attributes: Record<string, string>): (() => void) => {
+  const previousValues = new Map<string, string | null>();
+
+  for (const [name, value] of Object.entries(attributes)) {
+    previousValues.set(name, target.getAttribute(name));
+    target.setAttribute(name, value);
+  }
+
+  return () => {
+    for (const [name, value] of previousValues.entries()) {
+      if (value == null) {
+        target.removeAttribute(name);
+      } else {
+        target.setAttribute(name, value);
+      }
+    }
+  };
+};
+
+const createElement = <T extends 'meta' | 'link'>(
+  tagName: T,
+  attributes: Record<string, string | undefined>
+): HTMLElementTagNameMap[T] => {
+  const element = document.createElement(tagName);
+  element.setAttribute('data-bquery-page-meta', 'true');
+
+  for (const [name, value] of Object.entries(attributes)) {
+    if (value !== undefined) {
+      element.setAttribute(name, value);
+    }
+  }
+
+  return element;
+};
+
+/**
+ * Apply document metadata for the current page.
+ *
+ * @param definition - Title, meta tags, link tags, and document attributes
+ * @returns Cleanup function that restores the previous document state
+ *
+ * @example
+ * ```ts
+ * const cleanup = definePageMeta({
+ *   title: 'Dashboard',
+ *   description: 'Overview of your account',
+ * });
+ * ```
+ */
+export const definePageMeta = (definition: PageMetaDefinition): PageMetaCleanup => {
+  if (typeof document === 'undefined') {
+    return () => {};
+  }
+
+  const config = getBqueryConfig().pageMeta;
+  const title = definition.title
+    ? config?.titleTemplate
+      ? config.titleTemplate(definition.title)
+      : definition.title
+    : undefined;
+
+  const inserted: HTMLElement[] = [];
+  const restoreFns: Array<() => void> = [];
+  const previousTitle = document.title;
+
+  if (title !== undefined) {
+    document.title = title;
+  }
+
+  const metaEntries = [...(definition.meta ?? [])];
+  if (definition.description) {
+    metaEntries.unshift({ name: 'description', content: definition.description });
+  }
+
+  for (const entry of metaEntries) {
+    const meta = createElement('meta', {
+      name: entry.name,
+      property: entry.property,
+      'http-equiv': entry.httpEquiv,
+      content: entry.content,
+    });
+    document.head.appendChild(meta);
+    inserted.push(meta);
+  }
+
+  for (const entry of definition.link ?? []) {
+    const link = createElement('link', {
+      rel: entry.rel,
+      href: entry.href,
+      type: entry.type,
+      media: entry.media,
+      crossorigin: entry.crossOrigin,
+    });
+    document.head.appendChild(link);
+    inserted.push(link);
+  }
+
+  if (definition.htmlAttributes) {
+    restoreFns.push(setAttributes(document.documentElement, definition.htmlAttributes));
+  }
+
+  if (definition.bodyAttributes && document.body) {
+    restoreFns.push(setAttributes(document.body, definition.bodyAttributes));
+  }
+
+  return () => {
+    document.title = previousTitle;
+    for (const restore of restoreFns.reverse()) {
+      restore();
+    }
+    for (const element of inserted) {
+      element.remove();
+    }
+  };
+};

package/src/plugin/index.ts

@@ -0,0 +1,37 @@
+/**
+ * bQuery Plugin System — register plugins that extend bQuery with custom
+ * directives and components.
+ *
+ * @module bquery/plugin
+ *
+ * @example
+ * ```ts
+ * import { use, isInstalled, getInstalledPlugins } from '@bquery/bquery/plugin';
+ *
+ * use({
+ *   name: 'my-plugin',
+ *   install(ctx, options) {
+ *     ctx.directive('tooltip', (el, expr) => { ... });
+ *     ctx.component('my-widget', MyWidgetElement);
+ *   },
+ * });
+ * ```
+ */
+
+// Types
+export type {
+  BQueryPlugin,
+  CustomDirective,
+  CustomDirectiveHandler,
+  PluginInstallContext,
+} from './types';
+
+// Runtime API
+export {
+  use,
+  isInstalled,
+  getInstalledPlugins,
+  getCustomDirective,
+  getCustomDirectives,
+  resetPlugins,
+} from './registry';