@knowledge-medium/agent-cli 0.1.0

package/dist/kernel-types/src/services/uploadErrorClassifier.d.ts

@@ -0,0 +1,16 @@
+/** Classifies an error thrown during a PowerSync upload attempt as either
+ *  recoverable on retry (`transient`) or guaranteed to fail again the
+ *  same way (`permanent`).
+ *
+ *  Permanent rejections are dropped from the upload queue and copied to
+ *  `ps_crud_rejected` for inspection; transient errors are re-thrown so
+ *  PowerSync retries the batch.
+ *
+ *  Default for unknown shapes is `transient` — defaulting permanent would
+ *  silently drop user data on any error class we haven't seen yet. The
+ *  trade-off is that an unfamiliar permanent error keeps jamming the
+ *  queue until we add it to the list below; we accept that in exchange
+ *  for never losing writes silently. */
+export type UploadErrorClass = 'transient' | 'permanent';
+export declare const classifyUploadError: (err: unknown) => UploadErrorClass;
+//# sourceMappingURL=uploadErrorClassifier.d.ts.map

package/dist/kernel-types/src/services/uploadErrorClassifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadErrorClassifier.d.ts","sourceRoot":"","sources":["../../../../../../src/services/uploadErrorClassifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;wCAYwC;AACxC,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,WAAW,CAAA;AA0BxD,eAAO,MAAM,mBAAmB,GAAI,KAAK,OAAO,KAAG,gBAWlD,CAAA"}

package/dist/kernel-types/src/shortcuts/ActiveContexts.d.ts

@@ -0,0 +1,26 @@
+import { PropsWithChildren } from 'react';
+import { ActionContextType, BaseShortcutDependencies } from '@/shortcuts/types.js';
+export type ActiveContextsMap = ReadonlyMap<ActionContextType, BaseShortcutDependencies>;
+export interface ActiveContextsDispatch {
+    /**
+     * Activate a context with validated dependencies. If the context is already
+     * active it is moved to the end of the activation order (matching prior
+     * singleton semantics).
+     */
+    activate: (context: ActionContextType, dependencies: BaseShortcutDependencies) => void;
+    /** Deactivate a context. No-op when inactive. */
+    deactivate: (context: ActionContextType) => void;
+}
+export declare function ActiveContextsProvider({ children }: PropsWithChildren): import("react/jsx-runtime").JSX.Element;
+/**
+ * Read the map of currently-active contexts. Consumers of this hook re-render
+ * on every activation change — use sparingly (HotkeyReconciler, useRunAction).
+ */
+export declare function useActiveContextsState(): ActiveContextsMap;
+/**
+ * Access the stable {activate, deactivate} callbacks. Consumers of this hook
+ * do NOT re-render on activation changes, which is the common case for block
+ * components that only register/unregister their shortcut surfaces.
+ */
+export declare function useActiveContextsDispatch(): ActiveContextsDispatch;
+//# sourceMappingURL=ActiveContexts.d.ts.map

package/dist/kernel-types/src/shortcuts/ActiveContexts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActiveContexts.d.ts","sourceRoot":"","sources":["../../../../../../src/shortcuts/ActiveContexts.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,iBAAiB,EAOlB,MAAM,OAAO,CAAA;AAGd,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,iBAAiB,EAAE,wBAAwB,CAAC,CAAA;AAExF,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,wBAAwB,KAAK,IAAI,CAAA;IACtF,iDAAiD;IACjD,UAAU,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;CACjD;AAWD,wBAAgB,sBAAsB,CAAC,EAAC,QAAQ,EAAC,EAAE,iBAAiB,2CAgEnE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,iBAAiB,CAM1D;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,sBAAsB,CAMlE"}

package/dist/kernel-types/src/shortcuts/HotkeyReconciler.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Keeps `hotkeys-js` in sync with the facet runtime's declared actions and the
+ * currently-active contexts from `<ActiveContextsProvider>`.
+ *
+ * - When the action set changes (runtime regeneration) all bindings are torn
+ *   down and re-installed. This is uncommon; runtime regenerates only on
+ *   dynamic extension reloads.
+ * - When active contexts change, bindings are installed/uninstalled per action
+ *   based on whether the action's context is active. Handlers read deps via
+ *   refs so intra-context dependency changes (e.g. new focused block) don't
+ *   require rebinding.
+ * - Also installs `hotkeys.filter` for per-context event filtering and the
+ *   module-level `runActionById` dispatcher for external callers.
+ *
+ * NOTE: an earlier pass replaced the latest-ref pattern below with
+ * `useEffectEvent`. That broke shortcut delivery in the browser (likely
+ * because hotkeys-js fires its handlers from a global keydown listener,
+ * not a React-tracked event handler — outside that scope the
+ * effect-event indirection doesn't see the latest closure reliably).
+ * Reverted to the ref pattern; the refs are written in a useLayoutEffect
+ * so we don't trip the new react-hooks/refs rule.
+ */
+export declare function HotkeyReconciler(): null;
+//# sourceMappingURL=HotkeyReconciler.d.ts.map

package/dist/kernel-types/src/shortcuts/HotkeyReconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HotkeyReconciler.d.ts","sourceRoot":"","sources":["../../../../../../src/shortcuts/HotkeyReconciler.tsx"],"names":[],"mappings":"AAkCA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CA+HvC"}

package/dist/kernel-types/src/shortcuts/blockActions.d.ts

@@ -0,0 +1,39 @@
+import { Block } from '../data/block';
+import { Repo } from '../data/repo';
+import { type EditorSelectionState } from '@/data/properties.js';
+import { ActionConfig, ActionContextType, ActionIcon, ActionTrigger, BlockShortcutDependencies, ShortcutBinding } from '@/shortcuts/types.js';
+export interface BlockAction {
+    id: string;
+    description: string;
+    handler: (dependencies: BlockShortcutDependencies, trigger: ActionTrigger) => void | Promise<void>;
+    defaultBinding?: Omit<ShortcutBinding, 'action'>;
+    /** Optional glyph for visual surfaces (swipe menus, mobile toolbars,
+     *  future command-palette icons). Carried verbatim through
+     *  `bindBlockActionContext` onto the resulting `ActionConfig`. */
+    icon?: ActionIcon;
+}
+export interface SharedBlockActions {
+    indentBlock: BlockAction;
+    outdentBlock: BlockAction;
+    moveBlockUp: BlockAction;
+    moveBlockDown: BlockAction;
+    deleteBlock: BlockAction;
+    togglePropertiesDisplay: BlockAction;
+    toggleBlockCollapse: BlockAction;
+    extendSelectionUp: BlockAction;
+    extendSelectionDown: BlockAction;
+    copyBlock: BlockAction;
+    copyBlockRef: BlockAction;
+    copyBlockEmbed: BlockAction;
+}
+export declare const bindBlockActionContext: <T extends ActionContextType>(context: T, action: BlockAction, { idPrefix }?: {
+    idPrefix?: string;
+}) => ActionConfig<T>;
+export declare const requestEditorFocusIfEditing: (uiStateBlock: Block) => void;
+export declare const enterEditMode: (uiStateBlock: Block, selection?: EditorSelectionState) => void;
+export declare const extendSelectionDown: (uiStateBlock: Block, repo: Repo) => Promise<void>;
+export declare const extendSelectionUp: (uiStateBlock: Block, repo: Repo) => Promise<void>;
+export declare const createSharedBlockActions: ({ repo }: {
+    repo: Repo;
+}) => SharedBlockActions;
+//# sourceMappingURL=blockActions.d.ts.map

package/dist/kernel-types/src/shortcuts/blockActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockActions.d.ts","sourceRoot":"","sources":["../../../../../../src/shortcuts/blockActions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAInC,OAAO,EAUL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,yBAAyB,EACzB,eAAe,EAChB,MAAM,sBAAsB,CAAA;AAQ7B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,CAAC,YAAY,EAAE,yBAAyB,EAAE,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClG,cAAc,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAA;IAChD;;sEAEkE;IAClE,IAAI,CAAC,EAAE,UAAU,CAAA;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,WAAW,CAAA;IACxB,YAAY,EAAE,WAAW,CAAA;IACzB,WAAW,EAAE,WAAW,CAAA;IACxB,aAAa,EAAE,WAAW,CAAA;IAC1B,WAAW,EAAE,WAAW,CAAA;IACxB,uBAAuB,EAAE,WAAW,CAAA;IACpC,mBAAmB,EAAE,WAAW,CAAA;IAChC,iBAAiB,EAAE,WAAW,CAAA;IAC9B,mBAAmB,EAAE,WAAW,CAAA;IAChC,SAAS,EAAE,WAAW,CAAA;IACtB,YAAY,EAAE,WAAW,CAAA;IACzB,cAAc,EAAE,WAAW,CAAA;CAC5B;AAED,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,iBAAiB,EAChE,SAAS,CAAC,EACV,QAAQ,WAAW,EACnB,eAAY;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,KACrC,YAAY,CAAC,CAAC,CAKf,CAAA;AAuCF,eAAO,MAAM,2BAA2B,GAAI,cAAc,KAAK,SAI9D,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,cAAc,KAAK,EAAE,YAAY,oBAAoB,SAWlF,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAU,cAAc,KAAK,EAAE,MAAM,IAAI,kBAWxE,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAU,cAAc,KAAK,EAAE,MAAM,IAAI,kBAWtE,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI,UAAQ;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,KAAG,kBA0NjE,CAAA"}

package/dist/kernel-types/src/shortcuts/defaultContexts.d.ts

@@ -0,0 +1,3 @@
+import { ActionContextConfig } from '@/shortcuts/types.js';
+export declare const defaultActionContextConfigs: readonly ActionContextConfig[];
+//# sourceMappingURL=defaultContexts.d.ts.map

package/dist/kernel-types/src/shortcuts/defaultContexts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultContexts.d.ts","sourceRoot":"","sources":["../../../../../../src/shortcuts/defaultContexts.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EAOpB,MAAM,sBAAsB,CAAA;AAsB7B,eAAO,MAAM,2BAA2B,EAAE,SAAS,mBAAmB,EAiCrE,CAAA"}

package/dist/kernel-types/src/shortcuts/defaultShortcuts.d.ts

@@ -0,0 +1,22 @@
+import { ActionConfig } from './types';
+import { Repo } from '@/data/repo';
+import { AppExtension } from '@/extensions/facet.js';
+export declare const CREATE_NODE_IN_ACTIVE_PANEL_ACTION_ID = "create_node_in_active_panel";
+export declare const OPEN_PREFERENCES_ACTION_ID = "open_preferences";
+export declare const RELOAD_IN_SAFE_MODE_ACTION_ID = "reload_in_safe_mode";
+export declare function getDefaultActionGroups({ repo }: {
+    repo: Repo;
+}): {
+    globalActions: ActionConfig<"global">[];
+    normalModeActions: ActionConfig<"normal-mode">[];
+    editModeCMActions: ActionConfig<"edit-mode-cm">[];
+    multiSelectModeActions: ActionConfig<"multi-select-mode">[];
+};
+export declare function getDefaultActions({ repo }: {
+    repo: Repo;
+}): ActionConfig[];
+export declare const defaultActionContextsExtension: AppExtension;
+export declare function defaultActionsExtension({ repo }: {
+    repo: Repo;
+}): AppExtension;
+//# sourceMappingURL=defaultShortcuts.d.ts.map

package/dist/kernel-types/src/shortcuts/defaultShortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultShortcuts.d.ts","sourceRoot":"","sources":["../../../../../../src/shortcuts/defaultShortcuts.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,YAAY,EAKb,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAwClC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAqDpD,eAAO,MAAM,qCAAqC,gCAAgC,CAAA;AAClF,eAAO,MAAM,0BAA0B,qBAAqB,CAAA;AAC5D,eAAO,MAAM,6BAA6B,wBAAwB,CAAA;AA4BlE,wBAAgB,sBAAsB,CAAC,EAAC,IAAI,EAAC,EAAE;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE;;;;;EAiwB5D;AAED,wBAAgB,iBAAiB,CAAC,EAAC,IAAI,EAAC,EAAE;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG,YAAY,EAAE,CAcxE;AAED,eAAO,MAAM,8BAA8B,EAAE,YAKqC,CAAA;AAElF,wBAAgB,uBAAuB,CAAC,EAAC,IAAI,EAAC,EAAE;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG,YAAY,CAoB5E"}

package/dist/kernel-types/src/shortcuts/effectiveActions.d.ts

@@ -0,0 +1,7 @@
+import type { FacetRuntime } from '@/extensions/facet.js';
+import type { ActionConfig } from '@/shortcuts/types.js';
+import type { ActiveContextsMap } from './ActiveContexts.tsx';
+export declare const actionRuntimeKey: (action: Pick<ActionConfig, "context" | "id">) => string;
+export declare const getEffectiveActions: (runtime: FacetRuntime) => readonly ActionConfig[];
+export declare const getActiveActionById: (actions: readonly ActionConfig[], active: ActiveContextsMap, actionId: string) => ActionConfig | null;
+//# sourceMappingURL=effectiveActions.d.ts.map

package/dist/kernel-types/src/shortcuts/effectiveActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effectiveActions.d.ts","sourceRoot":"","sources":["../../../../../../src/shortcuts/effectiveActions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE7D,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,IAAI,CAAC,KAC3C,MAA0C,CAAA;AAS7C,eAAO,MAAM,mBAAmB,GAAI,SAAS,YAAY,KAAG,SAAS,YAAY,EAsBhF,CAAA;AAED,eAAO,MAAM,mBAAmB,GAC9B,SAAS,SAAS,YAAY,EAAE,EAChC,QAAQ,iBAAiB,EACzB,UAAU,MAAM,KACf,YAAY,GAAG,IAYjB,CAAA"}

package/dist/kernel-types/src/shortcuts/runAction.d.ts

@@ -0,0 +1,20 @@
+import { ActionTrigger } from '@/shortcuts/types.js';
+export type RunActionByIdFn = (actionId: string, trigger: ActionTrigger) => void | Promise<void>;
+/**
+ * Installed by <HotkeyReconciler/> on mount. Keeps the module-level
+ * `runActionById` in sync with the current FacetRuntime and active contexts.
+ */
+export declare function setRunActionDispatcher(next: RunActionByIdFn | null): void;
+/**
+ * Run an action by ID from anywhere — including outside React (e.g. from
+ * evaluated code in useAgentRuntimeBridge or one-off imperative callsites).
+ *
+ * Throws if called before the app mounts <HotkeyReconciler/>.
+ */
+export declare const runActionById: RunActionByIdFn;
+/**
+ * Hook variant for React callers. Re-computes on runtime/activeContexts changes
+ * so consumers re-render when the action's availability changes.
+ */
+export declare function useRunAction(): RunActionByIdFn;
+//# sourceMappingURL=runAction.d.ts.map

package/dist/kernel-types/src/shortcuts/runAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runAction.d.ts","sourceRoot":"","sources":["../../../../../../src/shortcuts/runAction.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGpD,MAAM,MAAM,eAAe,GAAG,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,KACnB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAIzB;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAEzE;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,eAO3B,CAAA;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,eAAe,CAgB9C"}

package/dist/kernel-types/src/shortcuts/types.d.ts

@@ -0,0 +1,118 @@
+import type { ComponentType, SVGProps } from 'react';
+import { Block } from '../data/block';
+import { EditorView } from '@codemirror/view';
+/** Action icon — same SVG-component shape lucide-react emits, so the
+ *  default action set can use those directly without an adapter. The
+ *  type stays SVG-only on purpose: actions render in command palettes,
+ *  toolbars, and menus where a vector glyph is the only sensible shape. */
+export type ActionIcon = ComponentType<SVGProps<SVGSVGElement>>;
+export type KeyCombination = string;
+export interface EventOptions {
+    preventDefault?: boolean;
+    stopPropagation?: boolean;
+}
+export type DependencyValidator<T extends ActionContextType> = (dependencies: unknown) => dependencies is ShortcutDependenciesMap[T];
+export interface ActionContextConfig<T extends ActionContextType = ActionContextType> {
+    type: T;
+    /** User-friendly name for this context, shown in shortcut-aware UI. */
+    displayName: string;
+    defaultEventOptions?: EventOptions;
+    /**
+     * Optional filter function to determine if the context should handle the event.
+     * If any active context's eventFilter returns true, the event is processed.
+     * If no active context's eventFilter returns true, the defaultEventFilter is used.
+     */
+    eventFilter?: (event: KeyboardEvent) => boolean;
+    /**
+     * Type guard function to validate the dependencies provided when activating the context.
+     */
+    validateDependencies: DependencyValidator<T>;
+}
+export type BuiltInActionContextType = 'global' | 'normal-mode' | 'edit-mode-cm' | 'property-editing' | 'multi-select-mode';
+export type ActionContextType = BuiltInActionContextType | (string & {});
+export declare const ActionContextTypes: {
+    readonly GLOBAL: "global";
+    readonly NORMAL_MODE: "normal-mode";
+    readonly EDIT_MODE_CM: "edit-mode-cm";
+    readonly PROPERTY_EDITING: "property-editing";
+    readonly MULTI_SELECT_MODE: "multi-select-mode";
+};
+export interface BaseShortcutDependencies {
+    uiStateBlock: Block;
+}
+export interface BlockShortcutDependencies extends BaseShortcutDependencies {
+    block: Block;
+    visualTargetId?: string;
+}
+export interface CodeMirrorEditModeDependencies extends BaseShortcutDependencies {
+    block: Block;
+    editorView: EditorView;
+}
+export interface PropertyEditingDependencies extends BlockShortcutDependencies {
+    input: HTMLInputElement;
+}
+export interface MultiSelectModeDependencies extends BaseShortcutDependencies {
+    selectedBlocks: Block[];
+    anchorBlock: Block | null;
+}
+export interface ShortcutDependenciesMap {
+    [context: string]: BaseShortcutDependencies;
+    [ActionContextTypes.GLOBAL]: BaseShortcutDependencies;
+    [ActionContextTypes.NORMAL_MODE]: BlockShortcutDependencies;
+    [ActionContextTypes.EDIT_MODE_CM]: CodeMirrorEditModeDependencies;
+    [ActionContextTypes.PROPERTY_EDITING]: PropertyEditingDependencies;
+    [ActionContextTypes.MULTI_SELECT_MODE]: MultiSelectModeDependencies;
+}
+export interface ActiveContextInfo {
+    config: ActionContextConfig;
+    dependencies: BaseShortcutDependencies;
+}
+export interface ActionContextActivation {
+    context: ActionContextType;
+    dependencies?: Record<string, unknown> | null;
+    enabled?: boolean;
+}
+export type ActionTrigger = KeyboardEvent | CustomEvent;
+export type ActionHandler<T extends ActionContextType = ActionContextType> = {
+    bivarianceHack(dependencies: ShortcutDependenciesMap[T], trigger: ActionTrigger): void | Promise<void>;
+}['bivarianceHack'];
+export type ActionCanRun<T extends ActionContextType = ActionContextType> = {
+    bivarianceHack(dependencies: ShortcutDependenciesMap[T]): boolean;
+}['bivarianceHack'];
+export interface Action<T extends ActionContextType = ActionContextType> {
+    id: string;
+    description: string;
+    context: T;
+    handler: ActionHandler<T>;
+    defaultBinding?: Omit<ShortcutBinding, 'action'>;
+    /** Optional icon for surfaces that render actions visually (toolbars,
+     *  swipe menus, eventual command-palette icon column). Surfaces that
+     *  don't render icons just ignore the field. */
+    icon?: ActionIcon;
+    /** Optional synchronous predicate for "is this action meaningfully
+     *  applicable to its current dependencies?". Surfaces that list
+     *  actions (command palette, swipe menu) hide the action when this
+     *  returns false, so the user doesn't see an entry that would silently
+     *  no-op. It is NOT a security gate on `handler` — direct callers can
+     *  still invoke a handler whose `canRun` is false; the contract is
+     *  presentational. Omit to mean "always applicable when the context is
+     *  active". */
+    canRun?: ActionCanRun<T>;
+}
+export type ActionConfig<T extends ActionContextType = ActionContextType> = Action<T>;
+export interface ActionOverride<T extends ActionContextType = ActionContextType> {
+    actionId: string;
+    context?: T;
+    apply: (action: ActionConfig<T>) => ActionConfig<T> | null;
+}
+export interface ActionDecorator<T extends ActionContextType = ActionContextType> {
+    actionId: string;
+    context?: T;
+    decorate: (action: ActionConfig<T>) => ActionConfig<T>;
+}
+export interface ShortcutBinding {
+    action: string;
+    keys: KeyCombination | KeyCombination[];
+    eventOptions?: EventOptions;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/kernel-types/src/shortcuts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/shortcuts/types.ts"],"names":[],"mappings":"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"}

package/dist/kernel-types/src/shortcuts/useActionContext.d.ts

@@ -0,0 +1,25 @@
+import { ActionContextType, ActionContextActivation, BaseShortcutDependencies, PropertyEditingDependencies, BlockShortcutDependencies, CodeMirrorEditModeDependencies } from './types';
+/**
+ * Hook to activate any number of shortcut contexts described by facet contributions.
+ */
+export declare function useActionContextActivations(activations: readonly ActionContextActivation[]): void;
+/**
+ * Hook to activate a shortcut context
+ * @param context The context to activate
+ * @param dependencies Dependencies to pass to the handlers
+ * @param enabled Whether the context is enabled (defaults to true)
+ */
+export declare function useActionContext(context: ActionContextType, dependencies?: Omit<BaseShortcutDependencies, 'uiStateBlock'> | null, enabled?: boolean): void;
+/**
+ * Hook for normal mode shortcuts
+ */
+export declare function useNormalModeShortcuts(dependencies: Omit<BlockShortcutDependencies, 'uiStateBlock'>, enabled?: boolean): void;
+/**
+ * Hook for CodeMirror edit mode shortcuts
+ */
+export declare function useCodeMirrorEditModeShortcuts<T extends boolean>(dependencies: T extends true ? Omit<CodeMirrorEditModeDependencies, 'uiStateBlock'> : Partial<CodeMirrorEditModeDependencies>, enabled: T): void;
+/**
+ * Hook for property editing shortcuts
+ */
+export declare function usePropertyEditingShortcuts(dependencies: Omit<PropertyEditingDependencies, 'uiStateBlock'>, enabled?: boolean): void;
+//# sourceMappingURL=useActionContext.d.ts.map

package/dist/kernel-types/src/shortcuts/useActionContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActionContext.d.ts","sourceRoot":"","sources":["../../../../../../src/shortcuts/useActionContext.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EAExB,2BAA2B,EAC3B,yBAAyB,EACzB,8BAA8B,EAC/B,MAAM,SAAS,CAAA;AAGhB;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,SAAS,uBAAuB,EAAE,GAC9C,IAAI,CA+BN;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,iBAAiB,EAC1B,YAAY,GAAE,IAAI,CAAC,wBAAwB,EAAE,cAAc,CAAC,GAAG,IAAW,EAC1E,OAAO,GAAE,OAAc,GACtB,IAAI,CAQN;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,IAAI,CAAC,yBAAyB,EAAE,cAAc,CAAC,EAAE,OAAO,GAAE,OAAc,GAAG,IAAI,CAEnI;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,SAAS,OAAO,EAC9D,YAAY,EAAE,CAAC,SAAS,IAAI,GACxB,IAAI,CAAC,8BAA8B,EAAE,cAAc,CAAC,GACpD,OAAO,CAAC,8BAA8B,CAAC,EAC3C,OAAO,EAAE,CAAC,GACT,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,IAAI,CAAC,2BAA2B,EAAE,cAAc,CAAC,EAAE,OAAO,GAAE,OAAc,GAAG,IAAI,CAE1I"}

package/dist/kernel-types/src/shortcuts/utils.d.ts

@@ -0,0 +1,90 @@
+import type { Block } from '@/data/block';
+import { ActionConfig, Action, ActionContextType, ActionContextTypes, ActionIcon } from './types';
+export declare const hasEditableTarget: (event: KeyboardEvent) => boolean;
+/**
+ * Checks if a KeyboardEvent represents a single key press.
+ * This means either:
+ * 1. A non-modifier key was pressed with NO modifier keys active.
+ * 2. A modifier key was pressed, and it was the ONLY modifier key active.
+ *
+ * Returns false for combinations like Shift+A, Ctrl+Shift, etc.
+ *
+ * @param {KeyboardEvent} event The keyboard event object.
+ * @returns {boolean} True if the event represents a single key press (modifier or non-modifier), false otherwise.
+ */
+export declare function isSingleKeyPress(event: KeyboardEvent): boolean;
+export declare const createAction: <T extends ActionContextType>(config: ActionConfig<T>) => Action<T>;
+/**
+ * Creates a multi-select version of an action that applies the original action to each selected block.
+ * Uses makeModeAction under the hood with a specialized handler override.
+ */
+export declare const applyToAllBlocksInSelection: <T extends ActionContextType>(actionConfig: ActionConfig<T>, { applyInReverseOrder }?: {
+    applyInReverseOrder?: boolean;
+}) => ActionConfig<typeof ActionContextTypes.MULTI_SELECT_MODE>;
+/**
+ * Creates a higher-order function that transforms an action config for a specific mode.
+ * This allows creating mode-specific action transformers like makeNormalMode, makeVisualMode, etc.
+ *
+ * @param mode The mode context type to transform the action into
+ * @param idPrefix The prefix to add to the action ID (e.g. 'normal', 'visual', etc)
+ * @returns A function that transforms an action config for the specified mode
+ */
+export declare const makeModeAction: <TargetMode extends ActionContextType>(mode: TargetMode, idPrefix: string) => <T extends ActionContextType>(actionConfig: ActionConfig<T>) => ActionConfig<TargetMode>;
+export declare const makeNormalMode: <T extends ActionContextType>(actionConfig: ActionConfig<T>) => ActionConfig<"normal-mode">;
+export declare const makeCMMode: <T extends ActionContextType>(actionConfig: ActionConfig<T>) => ActionConfig<"edit-mode-cm">;
+export declare const makeMultiSelect: <T extends ActionContextType>(actionConfig: ActionConfig<T>) => ActionConfig<"multi-select-mode">;
+export interface DefineBlocksActionConfig {
+    /** Id for the NORMAL_MODE variant. The MULTI_SELECT_MODE variant
+     *  is registered under `multi_select.<id>` (matching the
+     *  `makeMultiSelect` convention) so dispatch by id stays
+     *  unambiguous when both contexts are active simultaneously —
+     *  e.g. focus moves to an unselected block while a selection
+     *  remains. */
+    id: string;
+    /** Optional icon shown by any surface that renders actions. */
+    icon?: ActionIcon;
+    /** Description shown for the NORMAL_MODE variant (e.g. "Tag
+     *  block"). Appears in the command palette when a single block
+     *  is focused. */
+    blockDescription: string;
+    /** Description shown for the MULTI_SELECT_MODE variant
+     *  (e.g. "Tag selected blocks"). Appears in the palette during a
+     *  real multi-select and labels the group-header button. */
+    blocksDescription: string;
+    /** Per-block applicability predicate. When provided, the
+     *  NORMAL_MODE variant's `canRun` gates on `appliesTo(block)`,
+     *  and the MULTI_SELECT_MODE variant's `canRun` gates on at
+     *  least one selected block matching. Omit to mean "always". */
+    appliesTo?: (block: Block) => boolean;
+    /** The actual operation. Both variants forward to this with the
+     *  blocks they respectively hold (one or many). */
+    flow: (blocks: readonly Block[]) => Promise<void> | void;
+}
+export interface BlocksActionPair {
+    block: ActionConfig<typeof ActionContextTypes.NORMAL_MODE>;
+    blocks: ActionConfig<typeof ActionContextTypes.MULTI_SELECT_MODE>;
+}
+export declare const multiSelectActionId: (baseId: string) => string;
+/** Pair an "operation over a set of blocks" with the two natural
+ *  action contexts: NORMAL_MODE (focused block as a one-element set)
+ *  and MULTI_SELECT_MODE (the current selection).
+ *
+ *  Reach for this when the operation collects shared user input
+ *  ONCE (a dialog asking for parameters, a confirm step, …) and
+ *  then applies the result to every block in the set.
+ *
+ *  Why not `applyToAllBlocksInSelection`: that wrapper invokes the
+ *  per-block handler N times for an N-block selection, which would
+ *  prompt the user N times for any operation that opens a dialog
+ *  in its handler. This helper passes the whole set into a single
+ *  `flow` call instead.
+ *
+ *  The two variants get distinct ids (NORMAL: `id`, MULTI_SELECT:
+ *  `multi_select.<id>`) because the command palette dispatches by
+ *  id alone — `getActiveActionById` picks the most-recently-active
+ *  matching context — so a shared id can route a click on the
+ *  "block" row to the multi-select handler when both contexts are
+ *  active. Distinct ids keep each row's behaviour grounded in the
+ *  context it advertises. */
+export declare const defineBlocksAction: ({ id, icon, blockDescription, blocksDescription, appliesTo, flow, }: DefineBlocksActionConfig) => BlocksActionPair;
+//# sourceMappingURL=utils.d.ts.map

package/dist/kernel-types/src/shortcuts/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../../src/shortcuts/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EACL,YAAY,EACZ,MAAM,EACN,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EAIX,MAAM,SAAS,CAAA;AAGhB,eAAO,MAAM,iBAAiB,GAAI,OAAO,aAAa,YAQrD,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAoC9D;AAsBD,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,iBAAiB,EAAE,QAAQ,YAAY,CAAC,CAAC,CAAC,KAAG,MAAM,CAAC,CAAC,CAE1F,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,GAAI,CAAC,SAAS,iBAAiB,EACrE,cAAc,YAAY,CAAC,CAAC,CAAC,EAC7B,0BAAuB;IAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAiC,KACrF,YAAY,CAAC,OAAO,kBAAkB,CAAC,iBAAiB,CAmC1D,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,SAAS,iBAAiB,EACjE,MAAM,UAAU,EAChB,UAAU,MAAM,MAER,CAAC,SAAS,iBAAiB,EACjC,cAAc,YAAY,CAAC,CAAC,CAAC,KAC5B,YAAY,CAAC,UAAU,CAK3B,CAAA;AAED,eAAO,MAAM,cAAc,GATjB,CAAC,SAAS,iBAAiB,+DASiD,CAAA;AACtF,eAAO,MAAM,UAAU,GAVb,CAAC,SAAS,iBAAiB,gEAU+C,CAAA;AACpF,eAAO,MAAM,eAAe,GAXlB,CAAC,SAAS,iBAAiB,qEAW8D,CAAA;AAEnG,MAAM,WAAW,wBAAwB;IACvC;;;;;mBAKe;IACf,EAAE,EAAE,MAAM,CAAA;IACV,+DAA+D;IAC/D,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB;;sBAEkB;IAClB,gBAAgB,EAAE,MAAM,CAAA;IACxB;;gEAE4D;IAC5D,iBAAiB,EAAE,MAAM,CAAA;IACzB;;;oEAGgE;IAChE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;IACrC;uDACmD;IACnD,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CACzD;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,CAAC,OAAO,kBAAkB,CAAC,WAAW,CAAC,CAAA;IAC1D,MAAM,EAAE,YAAY,CAAC,OAAO,kBAAkB,CAAC,iBAAiB,CAAC,CAAA;CAClE;AAOD,eAAO,MAAM,mBAAmB,GAAI,QAAQ,MAAM,KAAG,MACd,CAAA;AAEvC;;;;;;;;;;;;;;;;;;;;6BAoB6B;AAC7B,eAAO,MAAM,kBAAkB,GAAI,qEAOhC,wBAAwB,KAAG,gBAwB5B,CAAA"}

package/dist/kernel-types/src/tutorial/outline.d.ts

@@ -0,0 +1,39 @@
+export type TutorialNode = {
+    /** Pre-allocated block id. When omitted the seeder generates a UUID.
+     *  Used by ref / embed demos so a later bullet can embed
+     *  `((<id>))` / `!((<id>))` pointing at this block by id. */
+    id?: string;
+    content: string;
+    /** Property overrides set directly on the row at create time. */
+    properties?: Record<string, unknown>;
+    /** When set, the seeder emits an `addTypeInTx` call. */
+    type?: string;
+    /** Property overrides passed to `addTypeInTx` (e.g. `aliases`). */
+    typeProperties?: Record<string, unknown>;
+    children?: TutorialNode[];
+};
+export type TutorialVariant = 'vim' | 'default';
+export declare const TUTORIAL_VIM_TITLE = "Tutorial";
+export declare const TUTORIAL_DEFAULT_TITLE = "Tutorial (no vim)";
+export declare const EXTENSIONS_PAGE_TITLE = "extensions";
+/**
+ * Returns the ordered list of top-level children for a Tutorial page.
+ * The page itself (`Tutorial` or `Tutorial (no vim)`) is created by
+ * `seedTutorial`; this outline plugs in beneath it.
+ */
+export declare const tutorialOutline: (variant: TutorialVariant) => TutorialNode[];
+/**
+ * Children of the shared, parent-less `extensions` page. Lives outside
+ * the per-variant Tutorial outline because both Tutorial variants link
+ * to it via `[[extensions]]` — a single source of truth instead of
+ * duplicating the seven example sources under each Tutorial. The page
+ * itself is seeded by `seedTutorial`.
+ *
+ * Each example is wrapped in a title bullet whose children are:
+ *   1. a "how to use it" description (what to do after enabling), and
+ *   2. the source block (typed `extension`, carries name/description
+ *      properties) — and optionally a try-it block tagged with the
+ *      gating property so a user can see the effect live.
+ */
+export declare const extensionsPageOutline: () => TutorialNode[];
+//# sourceMappingURL=outline.d.ts.map

package/dist/kernel-types/src/tutorial/outline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outline.d.ts","sourceRoot":"","sources":["../../../../../../src/tutorial/outline.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,YAAY,GAAG;IACzB;;iEAE6D;IAC7D,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,SAAS,CAAA;AAE/C,eAAO,MAAM,kBAAkB,aAAa,CAAA;AAC5C,eAAO,MAAM,sBAAsB,sBAAsB,CAAA;AACzD,eAAO,MAAM,qBAAqB,eAAe,CAAA;AA0DjD;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,eAAe,KAAG,YAAY,EAgKtE,CAAA;AAcD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,QAAO,YAAY,EAQpD,CAAA"}

package/dist/kernel-types/src/types.d.ts

@@ -0,0 +1,104 @@
+import { FunctionComponent } from 'react';
+import type { BlockData } from '@/data/api';
+import { Block } from './data/block';
+export type { BlockData, BlockReference } from '@/data/api';
+/** Loose alias for any decoded property value. The new shape stores
+ *  encoded values (untyped JSON) in `BlockData.properties` and decodes
+ *  via `block.get(schema)` / `block.peekProperty(schema)` at the
+ *  boundary — `BlockPropertyValue` is just the union of plausible
+ *  decoded shapes. */
+export type BlockPropertyValue = string | number | boolean | object | undefined | null | Array<BlockPropertyValue>;
+/** Map of decoded property values keyed by name. Mirrors
+ *  `BlockData['properties']` (which holds the encoded JSON) but typed
+ *  as the decoded view for callers that work with the values
+ *  pre-codec. */
+export type BlockProperties = Record<string, unknown>;
+export type WorkspaceRole = 'owner' | 'editor' | 'viewer';
+export interface Workspace {
+    id: string;
+    name: string;
+    ownerUserId: string;
+    createTime: number;
+    updateTime: number;
+}
+export interface WorkspaceMembership {
+    id: string;
+    workspaceId: string;
+    userId: string;
+    role: WorkspaceRole;
+    createTime: number;
+}
+export interface WorkspaceInvitation {
+    id: string;
+    workspaceId: string;
+    workspaceName?: string;
+    email: string;
+    role: Exclude<WorkspaceRole, 'owner'>;
+    invitedByUserId: string;
+    createTime: number;
+}
+export interface WorkspaceMemberWithEmail extends WorkspaceMembership {
+    email: string;
+}
+export interface BlockRendererProps {
+    block: Block;
+    context?: BlockContextType;
+}
+/**
+ * Should this actually be an object with a `render` method?
+ */
+export interface BlockRenderer extends FunctionComponent<BlockRendererProps> {
+    canRender?: (props: BlockRendererProps) => boolean;
+    priority?: (props: BlockRendererProps) => number;
+}
+export interface RendererRegistry {
+    [key: string]: BlockRenderer;
+}
+/** EditorSelectionState now lives at @/data/properties — re-exported
+ *  here during the 1.6 migration so call sites that still import from
+ *  @/types compile. Once consumers shift onto @/data/properties this
+ *  re-export drops. */
+export type { EditorSelectionState } from '@/data/properties';
+export interface BlockContextType {
+    /** Layout-dispatch boundary — gates which top-level renderer fires
+     *  (`TopLevelRenderer` / `LayoutRenderer` / `PanelRenderer`). Reset
+     *  by every layout boundary as it descends, so by the time
+     *  `DefaultBlockRenderer` runs this is always `false`. Orthogonal
+     *  to focal-block identity (`block.id === topLevelBlockId`) and to
+     *  render surface (`isNestedSurface` and friends below). */
+    layoutBoundary?: boolean;
+    safeMode?: boolean;
+    user?: {
+        id: string;
+        name: string;
+    };
+    panelId?: string;
+    layoutSessionBlockId?: string;
+    /** Single visible panel mode: widen the panel's scroll target to the
+     *  whole layout surface while constraining its document content inside
+     *  the panel renderer. */
+    wideScrollSurface?: boolean;
+    /** Umbrella surface flag — set by every non-document mount
+     *  (`BlockEmbed`, `BacklinkEntry`, breadcrumb list). Consulted by
+     *  `useIsFocalRender` / `isFocalRender` so a new surface only has
+     *  to set the umbrella to be excluded from focal affordances. */
+    isNestedSurface?: boolean;
+    /** Specific descriptors — set alongside `isNestedSurface` so
+     *  consumers that need to discriminate the surface (e.g. a future
+     *  embed-only header decoration) can ask the specific question.
+     *  Composes in nested cases (a backlink containing an embed has
+     *  both `isBacklink` and `isEmbedded` true). */
+    isEmbedded?: boolean;
+    isBacklink?: boolean;
+    isBreadcrumb?: boolean;
+    [key: string]: unknown;
+}
+export interface User {
+    id: string;
+    name: string;
+}
+export interface ClipboardData {
+    markdown: string;
+    blocks: BlockData[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/kernel-types/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/kernel-types/src/utils/AliasCollisionToast.d.ts

@@ -0,0 +1,13 @@
+import type { Repo } from '@/data/repo';
+export interface AliasCollisionToastProps {
+    toastId: string | number;
+    message: string;
+    alias: string;
+    attemptedOn: string;
+    conflictingBlockId: string;
+    conflictingBlockTitle: string;
+    workspaceId: string;
+    repo: Repo;
+}
+export declare const AliasCollisionToast: ({ toastId, message, alias, attemptedOn, conflictingBlockId, conflictingBlockTitle, workspaceId, repo, }: AliasCollisionToastProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AliasCollisionToast.d.ts.map

package/dist/kernel-types/src/utils/AliasCollisionToast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AliasCollisionToast.d.ts","sourceRoot":"","sources":["../../../../../../src/utils/AliasCollisionToast.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,IAAI,CAAA;CACX;AAKD,eAAO,MAAM,mBAAmB,GAAI,yGASjC,wBAAwB,4CA+C1B,CAAA"}