@andesine/extensions 0.0.0-stage → 0.6.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../private/contracts/src/primitives/unique.ts","../../../private/contracts/src/extensions/configuration.ts","../src/index.ts"],"sourcesContent":["const uniqueItems = <T>(values: T[]): boolean => new Set(values).size === values.length;\n\nexport { uniqueItems };\n","import * as z from \"zod\";\nimport { uniqueItems } from \"../primitives/unique\";\n\ntype ExtensionConfiguration = z.output<typeof extensionConfigurationType>;\ntype ExtensionConfigurationField = ExtensionConfiguration[\"properties\"][string];\ntype ExtensionConfigurationItem = Exclude<ExtensionConfigurationField, { type: \"array\" }>;\ntype ExtensionConfigurationPrimitive = string | number | boolean;\ntype ExtensionConfigurationValue =\n  ExtensionConfigurationPrimitive | ExtensionConfigurationPrimitive[];\n\nconst JSON_SCHEMA_DIALECT = \"https://json-schema.org/draft/2020-12/schema\";\nconst MAX_CONFIGURATION_FIELDS = 50;\nconst MAX_CONFIGURATION_STRING_LENGTH = 10_000;\nconst MAX_CONFIGURATION_ARRAY_ITEMS = 100;\nconst MAX_CONFIGURATION_ENUM_VALUES = 100;\nconst MAX_CONFIGURATION_PATTERN_LENGTH = 500;\nconst isValidPattern = (pattern: string): boolean => {\n  try {\n    new RegExp(pattern);\n\n    return true;\n  } catch {\n    return false;\n  }\n};\nconst fieldKeyType = z\n  .string()\n  .regex(/^[A-Za-z][A-Za-z0-9_]{0,63}$/, \"Use a letter, then letters, digits, or underscores\");\nconst lengthType = z.int().min(0).max(MAX_CONFIGURATION_STRING_LENGTH);\nconst metadata = {\n  title: z.string().min(1).max(100).optional(),\n  description: z.string().min(1).max(500).optional()\n};\nconst stringItemType = z.strictObject({\n  type: z.literal(\"string\"),\n  minLength: lengthType.optional(),\n  maxLength: lengthType.optional(),\n  pattern: z\n    .string()\n    .min(1)\n    .max(MAX_CONFIGURATION_PATTERN_LENGTH)\n    .refine(isValidPattern, \"Use a valid regular expression\")\n    .optional(),\n  format: z.enum([\"uri\", \"email\"]).optional()\n});\nconst enumItemType = z.strictObject({\n  type: z.literal(\"string\"),\n  enum: z\n    .array(z.string().min(1).max(200))\n    .min(1)\n    .max(MAX_CONFIGURATION_ENUM_VALUES)\n    .refine(uniqueItems, \"Options must be unique\")\n});\nconst numberItemType = z.strictObject({\n  type: z.enum([\"number\", \"integer\"]),\n  minimum: z.number().optional(),\n  maximum: z.number().optional(),\n  exclusiveMinimum: z.number().optional(),\n  exclusiveMaximum: z.number().optional(),\n  multipleOf: z.number().positive().optional()\n});\nconst booleanItemType = z.strictObject({ type: z.literal(\"boolean\") });\nconst stringFormatTypes = { uri: z.url(), email: z.email() };\nconst itemType = z.union([stringItemType, enumItemType, numberItemType, booleanItemType]);\nconst fieldType = z.union([\n  stringItemType.extend({\n    ...metadata,\n    default: z.string().optional(),\n    // Secret values are write-only and readable only by the extension backend.\n    secret: z.literal(true).optional(),\n    control: z.literal(\"textarea\").optional()\n  }),\n  enumItemType.extend({ ...metadata, default: z.string().optional() }),\n  numberItemType.extend({ ...metadata, default: z.number().optional() }),\n  booleanItemType.extend({ ...metadata, default: z.boolean().optional() }),\n  z.strictObject({\n    ...metadata,\n    type: z.literal(\"array\"),\n    items: itemType,\n    minItems: z.int().min(0).max(MAX_CONFIGURATION_ARRAY_ITEMS).optional(),\n    maxItems: z.int().min(0).max(MAX_CONFIGURATION_ARRAY_ITEMS).optional(),\n    uniqueItems: z.boolean().optional(),\n    default: z.array(z.union([z.string(), z.number(), z.boolean()])).optional()\n  })\n]);\n/** Flat JSON Schema 2020-12 subset; the host validates it without running extension code. */\nconst extensionConfigurationType = z\n  .strictObject({\n    $schema: z.literal(JSON_SCHEMA_DIALECT).optional(),\n    type: z.literal(\"object\"),\n    properties: z\n      .record(fieldKeyType, fieldType)\n      .refine(\n        (properties) => Object.keys(properties).length <= MAX_CONFIGURATION_FIELDS,\n        `Use at most ${MAX_CONFIGURATION_FIELDS} fields`\n      ),\n    required: z.array(fieldKeyType).refine(uniqueItems, \"Fields must be unique\").optional(),\n    additionalProperties: z.literal(false)\n  })\n  .superRefine((configuration, context) => {\n    for (const [index, key] of (configuration.required || []).entries()) {\n      if (!configuration.properties[key]) {\n        context.addIssue({ code: \"custom\", path: [\"required\", index], message: \"Unknown field\" });\n      }\n    }\n\n    for (const [key, field] of Object.entries(configuration.properties)) {\n      const isSecretWithDefault = \"secret\" in field && field.secret && field.default !== undefined;\n\n      if (isSecretWithDefault) {\n        context.addIssue({\n          code: \"custom\",\n          path: [\"properties\", key, \"default\"],\n          message: \"Secret fields cannot have defaults\"\n        });\n      } else if (field.default !== undefined) {\n        const result = createConfigurationValueType(field).safeParse(field.default);\n\n        if (!result.success) {\n          context.addIssue({\n            code: \"custom\",\n            path: [\"properties\", key, \"default\"],\n            message: \"The default does not match the field\"\n          });\n        }\n      }\n    }\n  });\nconst createConfigurationValueType = (\n  field: ExtensionConfigurationField | ExtensionConfigurationItem\n): z.ZodType<ExtensionConfigurationValue> => {\n  if (field.type === \"boolean\") return z.boolean();\n\n  if (field.type === \"array\") {\n    const maxItems = Math.min(\n      field.maxItems ?? MAX_CONFIGURATION_ARRAY_ITEMS,\n      MAX_CONFIGURATION_ARRAY_ITEMS\n    );\n    const items = z\n      .array(\n        createConfigurationValueType(field.items) as z.ZodType<ExtensionConfigurationPrimitive>\n      )\n      .min(field.minItems ?? 0)\n      .max(maxItems);\n\n    return field.uniqueItems ? items.refine(uniqueItems, \"Values must be unique\") : items;\n  }\n\n  if (\"enum\" in field) return z.enum(field.enum as [string, ...string[]]);\n\n  if (field.type === \"string\") {\n    const maxLength = Math.min(\n      field.maxLength ?? MAX_CONFIGURATION_STRING_LENGTH,\n      MAX_CONFIGURATION_STRING_LENGTH\n    );\n    const value = (field.format ? stringFormatTypes[field.format] : z.string())\n      .min(field.minLength ?? 0)\n      .max(maxLength);\n\n    return field.pattern ? value.regex(new RegExp(field.pattern)) : value;\n  }\n\n  let value = field.type === \"integer\" ? z.int() : z.number();\n\n  if (field.minimum !== undefined) value = value.gte(field.minimum);\n\n  if (field.maximum !== undefined) value = value.lte(field.maximum);\n\n  if (field.exclusiveMinimum !== undefined) value = value.gt(field.exclusiveMinimum);\n\n  if (field.exclusiveMaximum !== undefined) value = value.lt(field.exclusiveMaximum);\n\n  if (field.multipleOf !== undefined) value = value.multipleOf(field.multipleOf);\n\n  return value;\n};\n/** Known fields only; missing required fields are a state, not a validation error. */\nconst createConfigurationValuesType = (\n  configuration: ExtensionConfiguration\n): z.ZodType<Record<string, ExtensionConfigurationValue>> => {\n  const shape = Object.fromEntries(\n    Object.entries(configuration.properties).map(([key, field]) => {\n      return [key, createConfigurationValueType(field).optional()];\n    })\n  );\n\n  return z.strictObject(shape) as z.ZodType<Record<string, ExtensionConfigurationValue>>;\n};\n/** Converts an authoring Zod object to the configuration subset; unsupported constructs throw. */\nconst toExtensionConfiguration = (schema: z.ZodObject): ExtensionConfiguration => {\n  const jsonSchema = z.toJSONSchema(schema, {\n    io: \"input\",\n    target: \"draft-2020-12\",\n    unrepresentable: \"throw\"\n  });\n  const result = extensionConfigurationType.safeParse({\n    additionalProperties: false,\n    ...jsonSchema\n  });\n\n  if (!result.success) {\n    throw new Error(`Unsupported configuration schema:\\n${z.prettifyError(result.error)}`);\n  }\n\n  return result.data;\n};\n\nexport {\n  MAX_CONFIGURATION_FIELDS,\n  extensionConfigurationType,\n  createConfigurationValueType,\n  createConfigurationValuesType,\n  toExtensionConfiguration\n};\nexport type { ExtensionConfiguration, ExtensionConfigurationField, ExtensionConfigurationValue };\n","import { type extensionManifestType } from \"@andesine/contracts/extensions\";\n// The configuration module alone, so the bundle carries no other contracts code.\nimport {\n  type ExtensionConfiguration,\n  toExtensionConfiguration\n} from \"@andesine/contracts/extensions/configuration\";\nimport type * as z from \"zod\";\n\ninterface ExtensionDefinition extends Omit<ExtensionManifestInput, \"configuration\"> {\n  /** A Zod object of flat fields, or the configuration schema it converts to. */\n  configuration?: z.ZodObject | ExtensionConfiguration;\n}\n/** Options of `andesine extensions build`, exported from the config file as `build`. */\ninterface ExtensionBuildOptions {\n  /** The module exporting the manifest's view entries (default: `src/frontend/index.tsx`). */\n  frontend?: string;\n  /** Custom icon sets: a set prefix and a directory of SVG files, e.g. `{ acme: \"./icons\" }`. */\n  icons?: Record<string, string>;\n}\n\ntype ExtensionManifestInput = z.input<typeof extensionManifestType>;\n\nconst isZodObject = (value: object): value is z.ZodObject => \"_zod\" in value;\n/** Defines the `andesine.config.ts` manifest; a Zod configuration becomes JSON Schema. */\nconst defineExtension = (definition: ExtensionDefinition): ExtensionManifestInput => {\n  const { configuration, ...manifest } = definition;\n\n  if (!configuration) return manifest;\n\n  return {\n    ...manifest,\n    configuration: isZodObject(configuration)\n      ? toExtensionConfiguration(configuration)\n      : configuration\n  };\n};\nconst defineBuild = (options: ExtensionBuildOptions): ExtensionBuildOptions => options;\n\nexport { defineExtension, defineBuild };\nexport type { ExtensionDefinition, ExtensionBuildOptions, ExtensionManifestInput };\n"],"mappings":"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"}

package/dist/solid.d.ts

@@ -0,0 +1,397 @@
+import { Component, JSX } from "solid-js";
+//#region src/solid/protocol.d.ts
+type RequestErrorCode = "invalid_request" | "forbidden" | "too_many_requests" | "user_interaction_required" | "unavailable" | "failed";
+type JSONValue = string | number | boolean | null | JSONValue[] | {
+  [key: string]: JSONValue;
+};
+//#endregion
+//#region src/solid/renderer.d.ts
+/** A node of the serialized view tree; it mirrors the host tree, which has the real DOM. */
+interface ViewNode {
+  id: number;
+  type: string;
+  parent?: ViewNode;
+  children: ViewNode[];
+  callbacks: Map<string, number>;
+}
+export declare const render: (code: () => ViewNode, node: ViewNode) => () => void, effect: <T>(fn: (prev?: T) => T, init?: T) => void, memo: <T>(fn: () => T, equal: boolean) => () => T, createComponent: <T>(Comp: (props: T) => ViewNode, props: T) => ViewNode, createElement: (tag: string) => ViewNode, createTextNode: (value: string) => ViewNode, insertNode: (parent: ViewNode, node: ViewNode, anchor?: ViewNode | undefined) => void, insert: <T>(parent: any, accessor: T | (() => T), marker?: any | null, initial?: any) => ViewNode, spread: <T>(node: any, accessor: (() => T) | T, skipChildren?: boolean) => void, setProp: <T>(node: ViewNode, name: string, value: T, prev?: T | undefined) => T, mergeProps: (...sources: unknown[]) => unknown, use: <A, T>(fn: (element: ViewNode, arg: A) => T, element: ViewNode, arg: A) => T;
+//#endregion
+//#region src/solid/components.d.ts
+interface ParentProps {
+  children?: JSX.Element;
+}
+interface StyleProps {
+  /** Utility classes of the Andesine UnoCSS preset; the extension build generates their CSS. */
+  class?: string;
+}
+interface ButtonBaseProps {
+  /** Defaults to `secondary` for buttons and `ghost` for icon buttons. */
+  variant?: "primary" | "secondary" | "ghost" | "link" | "danger";
+  size?: "small" | "medium";
+  disabled?: boolean;
+  onClick?(): void;
+}
+interface FieldProps {
+  value?: string;
+  placeholder?: string;
+  label?: string;
+  disabled?: boolean;
+  onInput?(value: string): void;
+}
+interface Option {
+  value: string;
+  label: string;
+}
+interface ChoiceProps {
+  value?: string;
+  options: Option[];
+  placeholder?: string;
+  disabled?: boolean;
+  onChange?(value: string): void;
+}
+interface ToggleProps {
+  checked?: boolean;
+  label?: string;
+  disabled?: boolean;
+  onChange?(checked: boolean): void;
+}
+interface StackProps extends ParentProps, StyleProps {
+  direction?: "row" | "column";
+  gap?: Gap;
+  align?: "start" | "center" | "end" | "stretch";
+  justify?: "start" | "center" | "end" | "between";
+  wrap?: boolean;
+}
+interface GridProps extends ParentProps, StyleProps {
+  columns?: number;
+  gap?: Gap;
+}
+interface BoxProps extends ParentProps, StyleProps {
+  padding?: Gap;
+  background?: "none" | "soft" | "contrast";
+  border?: boolean;
+}
+interface ScrollAreaProps extends ParentProps {
+  maxHeight?: Size;
+}
+interface TextProps extends ParentProps, StyleProps {
+  size?: "xs" | "sm" | "base" | "lg";
+  weight?: "normal" | "medium" | "semibold";
+  tone?: Tone;
+}
+interface HeadingProps extends ParentProps, StyleProps {
+  level?: 1 | 2 | 3;
+}
+interface LinkProps extends ParentProps {
+  /** An `https:` URL within the extension's declared request URLs. */
+  href: string;
+}
+interface BadgeProps extends ParentProps {
+  color?: "base" | "primary" | "danger" | "success";
+}
+interface IconProps {
+  /** An icon class, e.g. `i-lucide:rocket`, or `i-acme:logo?bg` for a colored icon. */
+  name: string;
+  size?: Size;
+  tone?: Tone;
+}
+interface ButtonProps extends ButtonBaseProps, ParentProps {
+  loading?: boolean;
+}
+interface IconButtonProps extends ButtonBaseProps {
+  icon: string;
+  label: string;
+}
+interface InputProps extends FieldProps {
+  type?: "text" | "url" | "number";
+  onEnter?(): void;
+}
+interface TextareaProps extends FieldProps {
+  rows?: number;
+}
+interface ToggleGroupProps {
+  value?: string;
+  options: Option[];
+  disabled?: boolean;
+  onChange?(value: string): void;
+}
+interface ColorInputProps {
+  /** A hex color, e.g. `#ff3617`. */
+  value?: string;
+  disabled?: boolean;
+  onInput?(value: string): void;
+}
+interface TooltipProps extends ParentProps {
+  content: string;
+}
+/**
+ * A modal, shown while rendered. Outside block actions, render it right after an interaction,
+ * e.g. from `onClick`; otherwise it isn't shown. In a block action, closing it closes the action.
+ */
+interface DialogProps extends ParentProps {
+  title: string;
+  description?: string;
+  size?: Size;
+  /** Whether Escape, an outside click, or the close button call `onClose` (default true). */
+  dismissible?: boolean;
+  onClose?(): void;
+}
+/**
+ * A dropdown menu of `MenuItem`, `MenuGroup`, `MenuSeparator`, and `MenuContent` children,
+ * opened by its `MenuTrigger`, or with `contextMenu` by a right click on it. At a block action
+ * view's root it needs no trigger: it opens where the block menu was, and closing it closes the action.
+ */
+interface MenuProps extends ParentProps {
+  /** The title of the bottom sheet on small screens. */
+  title?: string;
+  /** Controls the open state; without it, the menu opens and closes on its own. */
+  opened?: boolean;
+  contextMenu?: boolean;
+  placement?: "bottom-start" | "bottom-end" | "top-start" | "top-end" | "right-start" | "left-start";
+  size?: "small" | "medium";
+  onOpenChange?(opened: boolean): void;
+}
+/** Nested items make a submenu, which replaces `onSelect`. */
+interface MenuItemProps extends ParentProps {
+  label: string;
+  icon?: string;
+  /** Shown next to the label; handle the keys yourself. */
+  shortcut?: string;
+  color?: "base" | "danger";
+  disabled?: boolean;
+  /** A spinner replaces the icon, and the item is disabled. */
+  loading?: boolean;
+  selected?: boolean;
+  closeOnSelect?: boolean;
+  onSelect?(): void;
+}
+interface MenuGroupProps extends ParentProps {
+  label?: string;
+}
+interface SettingProps extends ParentProps {
+  label: string;
+  description?: string;
+}
+interface ListProps extends ParentProps {
+  addLabel?: string;
+  emptyLabel?: string;
+  disabled?: boolean;
+  onAdd?(): void;
+  onRemove?(index: number): void;
+  onMove?(from: number, to: number): void;
+}
+interface CardProps extends ParentProps {
+  color?: "base" | "contrast" | "soft";
+}
+interface TreeItem {
+  id: string;
+  label: string;
+  icon?: string;
+  /** The parent item ID; top level when unset. */
+  parent?: string;
+}
+interface TreeProps {
+  items: TreeItem[];
+  selected?: string;
+  emptyLabel?: string;
+  onSelect?(id: string): void;
+}
+interface TabsProps extends ParentProps {
+  value?: string;
+  onChange?(value: string): void;
+}
+interface TabProps extends ParentProps {
+  value: string;
+  label: string;
+}
+interface DisclosureProps extends ParentProps {
+  label: string;
+  open?: boolean;
+}
+interface CalloutProps extends ParentProps {
+  tone?: "info" | "warning" | "danger" | "success";
+  title?: string;
+}
+interface StepProps extends ParentProps {
+  title: string;
+}
+interface FigureProps {
+  /** An `https:` image URL within the extension's declared request URLs. */
+  src: string;
+  alt: string;
+  caption?: string;
+}
+interface CodeBlockProps {
+  code: string;
+  language?: string;
+}
+interface TimeAgoProps {
+  /** An ISO date-time. */
+  date: string;
+}
+interface SpinnerProps {
+  size?: Size;
+}
+interface SkeletonProps {
+  height?: Size;
+}
+type Gap = "none" | "small" | "medium" | "large";
+type Size = "small" | "medium" | "large";
+type Tone = "default" | "muted" | "danger" | "success";
+type EmptyProps = Record<string, never>;
+declare const Stack: (props: StackProps) => JSX.Element;
+declare const Grid: (props: GridProps) => JSX.Element;
+declare const Box: (props: BoxProps) => JSX.Element;
+declare const Divider: (props: EmptyProps) => JSX.Element;
+declare const ScrollArea: (props: ScrollAreaProps) => JSX.Element;
+declare const Text: (props: TextProps) => JSX.Element;
+declare const Heading: (props: HeadingProps) => JSX.Element;
+declare const Code: (props: ParentProps) => JSX.Element;
+declare const Link: (props: LinkProps) => JSX.Element;
+declare const Badge: (props: BadgeProps) => JSX.Element;
+declare const Icon: (props: IconProps) => JSX.Element;
+declare const Button: (props: ButtonProps) => JSX.Element;
+declare const IconButton: (props: IconButtonProps) => JSX.Element;
+declare const Input: (props: InputProps) => JSX.Element;
+declare const Textarea: (props: TextareaProps) => JSX.Element;
+declare const Select: (props: ChoiceProps) => JSX.Element;
+declare const Combobox: (props: ChoiceProps) => JSX.Element;
+declare const Checkbox: (props: ToggleProps) => JSX.Element;
+declare const Toggle: (props: ToggleProps) => JSX.Element;
+declare const ToggleGroup: (props: ToggleGroupProps) => JSX.Element;
+declare const ColorInput: (props: ColorInputProps) => JSX.Element;
+declare const Tooltip: (props: TooltipProps) => JSX.Element;
+declare const Dialog: (props: DialogProps) => JSX.Element;
+declare const Menu: (props: MenuProps) => JSX.Element;
+declare const MenuTrigger: (props: ParentProps) => JSX.Element;
+declare const MenuItem: (props: MenuItemProps) => JSX.Element;
+declare const MenuGroup: (props: MenuGroupProps) => JSX.Element;
+declare const MenuSeparator: (props: EmptyProps) => JSX.Element;
+/** A custom menu item: any content, e.g. a result or a form. */
+declare const MenuContent: (props: ParentProps) => JSX.Element;
+declare const Setting: (props: SettingProps) => JSX.Element;
+declare const List: (props: ListProps) => JSX.Element;
+declare const Card: (props: CardProps) => JSX.Element;
+declare const Tree: (props: TreeProps) => JSX.Element;
+declare const Tabs: (props: TabsProps) => JSX.Element;
+declare const Tab: (props: TabProps) => JSX.Element;
+declare const Disclosure: (props: DisclosureProps) => JSX.Element;
+declare const Callout: (props: CalloutProps) => JSX.Element;
+declare const Steps: (props: ParentProps) => JSX.Element;
+declare const Step: (props: StepProps) => JSX.Element;
+declare const Figure: (props: FigureProps) => JSX.Element;
+declare const CodeBlock: (props: CodeBlockProps) => JSX.Element;
+declare const TimeAgo: (props: TimeAgoProps) => JSX.Element;
+declare const Spinner: (props: SpinnerProps) => JSX.Element;
+declare const Skeleton: (props: SkeletonProps) => JSX.Element;
+/** Where an element view shows the element's editable content (element views only). */
+declare const ContentSlot: (props: EmptyProps) => JSX.Element;
+//#endregion
+//#region src/solid/runtime.d.ts
+type ExtensionViews = Record<string, Component<never>>;
+/** Starts the frontend worker; `entries` maps manifest view entries to Solid components. */
+declare const startExtension: (entries: ExtensionViews) => void;
+//#endregion
+//#region src/solid/actions.d.ts
+/** Copies text; the host shows a fallback dialog if the browser refuses. */
+declare const copyText: (text: string) => Promise<void>;
+/** Downloads a text file, for example `downloadFile("andesine.config.ts", source)`. */
+declare const downloadFile: (name: string, text: string, type?: string) => Promise<void>;
+/** Opens an `https:` URL in a new tab; URLs outside the declared URLs need confirmation. */
+declare const openURL: (url: string) => Promise<void>;
+/** Shows a short notification, e.g. the result of a block action without UI; it needs no interaction. */
+declare const notify: (text: string, type?: "success" | "error") => Promise<void>;
+//#endregion
+//#region src/solid/requests.d.ts
+/** A host request failed; `code` says why, for example `user_interaction_required`. */
+declare class ExtensionRequestError extends Error {
+  readonly code: RequestErrorCode;
+  constructor(code: RequestErrorCode, message: string);
+}
+//#endregion
+//#region src/solid/editor.d.ts
+/** Editor JSON block, e.g. `{ type: "paragraph", content: [{ type: "text", text: "Hi" }] }`. */
+interface ContentNode {
+  type: string;
+  attrs?: Record<string, JSONValue>;
+  content?: ContentNode[];
+  marks?: Array<{
+    type: string;
+    attrs?: Record<string, JSONValue>;
+  }>;
+  text?: string;
+}
+interface ViewEditor {
+  /** Block action views: replaces the blocks the action was opened for. */
+  replace(content: ContentNode[]): Promise<void>;
+  /** Block action views: inserts blocks after those the action was opened for. */
+  insertAfter(content: ContentNode[]): Promise<void>;
+  /** Element views: updates the element's props; call it from a user interaction. */
+  setElementProps(props: Record<string, JSONValue>): Promise<void>;
+  /** Block action views: closes the view. */
+  close(): Promise<void>;
+}
+/** Edits the document as the member; invalid edits reject with `ExtensionRequestError`. */
+declare const useEditor: () => ViewEditor;
+//#endregion
+//#region src/solid/storage.d.ts
+interface StorageEntry<T extends JSONValue = JSONValue> {
+  key: string;
+  value: T;
+  /** An ISO date-time. */
+  updatedAt: string;
+}
+interface StorageListOptions {
+  /** Only keys that start with the prefix. */
+  prefix?: string;
+  /** Entries after this key, from the previous page. */
+  after?: string;
+  /** At most 100 (the default). */
+  limit?: number;
+}
+interface StoragePage {
+  data: StorageEntry[];
+  hasMore: boolean;
+}
+/**
+ * JSON key-value storage shared with the backend; the last write wins.
+ * Limits: 256-character keys, 128 KiB values, 10,000 entries, and 10 MiB in total.
+ */
+declare const storage: {
+  /** The entry, or null when the key is not set. */
+  get<T extends JSONValue = JSONValue>(key: string): Promise<StorageEntry<T> | null>;
+  /** Creates or replaces an entry; resolves with its update time. */
+  set(key: string, value: JSONValue): Promise<{
+    updatedAt: string;
+  }>;
+  /** Resolves with whether the key was set. */
+  delete(key: string): Promise<boolean>;
+  /** Entries in key order; a page can have fewer entries than `limit` when values are large. */
+  list(options?: StorageListOptions): Promise<StoragePage>;
+};
+//#endregion
+//#region src/solid/context.d.ts
+/** The origin `apiFetch` accepts; use it as the SDK `baseURL`. */
+declare const EXTENSION_API_URL = "https://api.andesine.invalid";
+/** The non-secret configuration values with defaults (reactive); only the backend reads secrets. */
+declare const useConfiguration: <T extends Record<string, JSONValue> = Record<string, JSONValue>>() => () => Partial<T>;
+/** The member's effective permissions for this extension (reactive), e.g. `read:entries`. */
+declare const usePermissions: () => import("solid-js").Accessor<string[]>;
+/** Whether the effective permissions include `permission`; a write permission includes its read. */
+declare const hasPermission: (permission: string) => boolean;
+/**
+ * SDK `fetch` that calls Andesine with the member's session; forbidden operations return HTTP 403.
+ * @example createClient({ baseURL: EXTENSION_API_URL, fetch: apiFetch })
+ */
+declare const apiFetch: typeof fetch;
+/** The extension's own backend, as declared in the manifest. */
+declare const backend: {
+  /**
+   * Fetches a backend path with `Authorization`, `Andesine-Extension`, and `Andesine-Instance`
+   * headers (CORS must allow them); verify them with `verifySession` of `@andesine/sdk/extensions`.
+   */
+  fetch(path: string, init?: RequestInit): Promise<Response>;
+};
+//#endregion
+export { Badge, type BadgeProps, Box, type BoxProps, Button, type ButtonProps, Callout, type CalloutProps, Card, type CardProps, Checkbox, type ChoiceProps, Code, CodeBlock, type CodeBlockProps, ColorInput, type ColorInputProps, Combobox, type ContentNode, ContentSlot, Dialog, type DialogProps, Disclosure, type DisclosureProps, Divider, EXTENSION_API_URL, type EmptyProps, ExtensionRequestError, Figure, type FigureProps, Grid, type GridProps, Heading, type HeadingProps, Icon, IconButton, type IconButtonProps, type IconProps, Input, type InputProps, Link, type LinkProps, List, type ListProps, Menu, MenuContent, MenuGroup, type MenuGroupProps, MenuItem, type MenuItemProps, type MenuProps, MenuSeparator, MenuTrigger, type Option, type ParentProps, ScrollArea, type ScrollAreaProps, Select, Setting, type SettingProps, Skeleton, type SkeletonProps, Spinner, type SpinnerProps, Stack, type StackProps, Step, type StepProps, Steps, type StorageEntry, type StorageListOptions, type StoragePage, type StyleProps, Tab, type TabProps, Tabs, type TabsProps, Text, type TextProps, Textarea, type TextareaProps, TimeAgo, type TimeAgoProps, Toggle, ToggleGroup, type ToggleGroupProps, type ToggleProps, Tooltip, type TooltipProps, Tree, type TreeItem, type TreeProps, type ViewEditor, apiFetch, backend, copyText, downloadFile, hasPermission, notify, openURL, startExtension, storage, useConfiguration, useEditor, usePermissions };
+//# sourceMappingURL=solid.d.ts.map