@bendyline/docblocks-react 1.1.2 → 2.1.0

package/src/fonts/licenses/LICENSE-source-serif-4.txt

@@ -1,93 +0,0 @@
-Copyright 2014 The Source Serif 4 Project Authors (https://github.com/adobe-fonts/source-serif)
-
-This Font Software is licensed under the SIL Open Font License, Version 1.1.
-This license is copied below, and is also available with a FAQ at:
-https://openfontlicense.org
-
-
------------------------------------------------------------
-SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
------------------------------------------------------------
-
-PREAMBLE
-The goals of the Open Font License (OFL) are to stimulate worldwide
-development of collaborative font projects, to support the font creation
-efforts of academic and linguistic communities, and to provide a free and
-open framework in which fonts may be shared and improved in partnership
-with others.
-
-The OFL allows the licensed fonts to be used, studied, modified and
-redistributed freely as long as they are not sold by themselves. The
-fonts, including any derivative works, can be bundled, embedded, 
-redistributed and/or sold with any software provided that any reserved
-names are not used by derivative works. The fonts and derivatives,
-however, cannot be released under any other type of license. The
-requirement for fonts to remain under this license does not apply
-to any document created using the fonts or their derivatives.
-
-DEFINITIONS
-"Font Software" refers to the set of files released by the Copyright
-Holder(s) under this license and clearly marked as such. This may
-include source files, build scripts and documentation.
-
-"Reserved Font Name" refers to any names specified as such after the
-copyright statement(s).
-
-"Original Version" refers to the collection of Font Software components as
-distributed by the Copyright Holder(s).
-
-"Modified Version" refers to any derivative made by adding to, deleting,
-or substituting -- in part or in whole -- any of the components of the
-Original Version, by changing formats or by porting the Font Software to a
-new environment.
-
-"Author" refers to any designer, engineer, programmer, technical
-writer or other person who contributed to the Font Software.
-
-PERMISSION & CONDITIONS
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of the Font Software, to use, study, copy, merge, embed, modify,
-redistribute, and sell modified and unmodified copies of the Font
-Software, subject to the following conditions:
-
-1) Neither the Font Software nor any of its individual components,
-in Original or Modified Versions, may be sold by itself.
-
-2) Original or Modified Versions of the Font Software may be bundled,
-redistributed and/or sold with any software, provided that each copy
-contains the above copyright notice and this license. These can be
-included either as stand-alone text files, human-readable headers or
-in the appropriate machine-readable metadata fields within text or
-binary files as long as those fields can be easily viewed by the user.
-
-3) No Modified Version of the Font Software may use the Reserved Font
-Name(s) unless explicit written permission is granted by the corresponding
-Copyright Holder. This restriction only applies to the primary font name as
-presented to the users.
-
-4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
-Software shall not be used to promote, endorse or advertise any
-Modified Version, except to acknowledge the contribution(s) of the
-Copyright Holder(s) and the Author(s) or with their explicit written
-permission.
-
-5) The Font Software, modified or unmodified, in part or in whole,
-must be distributed entirely under this license, and must not be
-distributed under any other license. The requirement for fonts to
-remain under this license does not apply to any document created
-using the Font Software.
-
-TERMINATION
-This license becomes null and void if any of the above conditions are
-not met.
-
-DISCLAIMER
-THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
-OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
-COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
-INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
-DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
-OTHER DEALINGS IN THE FONT SOFTWARE.

package/src/hooks/index.ts

@@ -1 +0,0 @@
-export { useAutoSave } from './useAutoSave.js';

package/src/hooks/useAutoSave.ts

@@ -1,116 +0,0 @@
-/**
- * useAutoSave — debounced auto-save hook.
- *
- * Writes content to the FileSystemProvider after a delay
- * whenever the content changes. Returns a `flush` function so callers
- * (e.g. an explicit Ctrl/Cmd+S handler) can force an immediate write
- * and await its completion.
- */
-
-import { useEffect, useRef, useCallback } from 'react';
-import type { FileSystemProvider } from '@bendyline/docblocks/filesystem';
-
-export interface UseAutoSaveResult {
-  /** Cancel any pending debounce and write the current content immediately. */
-  flush: () => Promise<void>;
-}
-
-export function useAutoSave(
-  provider: FileSystemProvider | null,
-  filePath: string | null,
-  content: string,
-  delayMs = 500,
-  onSaved?: (filePath: string, content: string) => void,
-): UseAutoSaveResult {
-  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
-  const contentRef = useRef(content);
-  const onSavedRef = useRef(onSaved);
-  const targetRef = useRef<{
-    provider: FileSystemProvider;
-    filePath: string;
-    lastSaved: string;
-  } | null>(null);
-
-  const clearTimer = useCallback(() => {
-    if (timerRef.current) {
-      clearTimeout(timerRef.current);
-      timerRef.current = null;
-    }
-  }, []);
-
-  const flushTarget = useCallback(
-    async (
-      target: {
-        provider: FileSystemProvider;
-        filePath: string;
-        lastSaved: string;
-      },
-      nextContent: string,
-    ) => {
-      if (nextContent === target.lastSaved) return;
-      const previous = target.lastSaved;
-      target.lastSaved = nextContent;
-      try {
-        await target.provider.writeFile(target.filePath, nextContent);
-        onSavedRef.current?.(target.filePath, nextContent);
-      } catch (err) {
-        target.lastSaved = previous;
-        throw err;
-      }
-    },
-    [],
-  );
-
-  useEffect(() => {
-    onSavedRef.current = onSaved;
-  }, [onSaved]);
-
-  useEffect(() => {
-    contentRef.current = content;
-  }, [content]);
-
-  useEffect(() => {
-    clearTimer();
-    targetRef.current = provider && filePath ? { provider, filePath, lastSaved: content } : null;
-    contentRef.current = content;
-
-    return () => {
-      clearTimer();
-      const target = targetRef.current;
-      if (target) {
-        void flushTarget(target, contentRef.current).catch(() => undefined);
-      }
-      targetRef.current = null;
-    };
-    // `content` is intentionally captured only when the save target changes.
-    // Content edits are handled by the debounced effect below.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [provider, filePath, clearTimer, flushTarget]);
-
-  useEffect(() => {
-    const target = targetRef.current;
-    if (!target) return;
-    clearTimer();
-
-    if (content !== target.lastSaved) {
-      timerRef.current = setTimeout(() => {
-        const currentTarget = targetRef.current;
-        if (!currentTarget) return;
-        void flushTarget(currentTarget, contentRef.current).catch(() => undefined);
-      }, delayMs);
-    }
-
-    return () => {
-      clearTimer();
-    };
-  }, [content, delayMs, clearTimer, flushTarget]);
-
-  const flush = useCallback(async () => {
-    clearTimer();
-    const target = targetRef.current;
-    if (!target) return;
-    await flushTarget(target, contentRef.current);
-  }, [clearTimer, flushTarget]);
-
-  return { flush };
-}

package/src/icons.tsx

@@ -1,70 +0,0 @@
-import type { SVGProps } from 'react';
-
-const defaults: SVGProps<SVGSVGElement> = {
-  width: 16,
-  height: 16,
-  viewBox: '0 0 16 16',
-  fill: 'none',
-  stroke: 'currentColor',
-  strokeWidth: 1.5,
-  strokeLinecap: 'round' as const,
-  strokeLinejoin: 'round' as const,
-};
-
-export function NewFileIcon(props: SVGProps<SVGSVGElement>) {
-  return (
-    <svg {...defaults} {...props}>
-      {/* Page outline */}
-      <path d="M9.5 1.5H4a1 1 0 0 0-1 1v11a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1V5l-3.5-3.5Z" />
-      {/* Fold */}
-      <path d="M9.5 1.5V5H13" />
-      {/* Plus sign */}
-      <line x1="6.5" y1="10" x2="9.5" y2="10" />
-      <line x1="8" y1="8.5" x2="8" y2="11.5" />
-    </svg>
-  );
-}
-
-export function NewFolderIcon(props: SVGProps<SVGSVGElement>) {
-  return (
-    <svg {...defaults} {...props}>
-      {/* Folder outline */}
-      <path d="M2 3.5a1 1 0 0 1 1-1h3l1.5 1.5H13a1 1 0 0 1 1 1v7a1 1 0 0 1-1 1H3a1 1 0 0 1-1-1V3.5Z" />
-      {/* Plus sign */}
-      <line x1="6" y1="8.5" x2="10" y2="8.5" />
-      <line x1="8" y1="6.5" x2="8" y2="10.5" />
-    </svg>
-  );
-}
-
-export function RefreshIcon(props: SVGProps<SVGSVGElement>) {
-  return (
-    <svg {...defaults} {...props}>
-      <path d="M13.5 8A5.5 5.5 0 1 1 8 2.5" />
-      <polyline points="13.5 3 13.5 6.5 10 6.5" />
-    </svg>
-  );
-}
-
-export function MoreIcon(props: SVGProps<SVGSVGElement>) {
-  return (
-    <svg {...defaults} {...props}>
-      <circle cx="3.5" cy="8" r="1" fill="currentColor" stroke="none" />
-      <circle cx="8" cy="8" r="1" fill="currentColor" stroke="none" />
-      <circle cx="12.5" cy="8" r="1" fill="currentColor" stroke="none" />
-    </svg>
-  );
-}
-
-export function WorkspaceIcon(props: SVGProps<SVGSVGElement>) {
-  return (
-    <svg {...defaults} {...props}>
-      {/* Desk surface (top-down rectangle) */}
-      <rect x="1.5" y="2.5" width="13" height="11" rx="1" />
-      {/* Blotter/pad with two vertical lines */}
-      <rect x="4" y="4.5" width="8" height="7" rx="0.5" />
-      <line x1="6.5" y1="5.5" x2="6.5" y2="10.5" strokeWidth="1" />
-      <line x1="9.5" y1="5.5" x2="9.5" y2="10.5" strokeWidth="1" />
-    </svg>
-  );
-}

package/src/index.ts

@@ -1,31 +0,0 @@
-/**
- * @bendyline/docblocks-react — React components for DocBlocks
- */
-
-// FileExplorer
-export { FileExplorer } from './FileExplorer/index.js';
-export type { FileExplorerProps } from './FileExplorer/index.js';
-export { FileTreeNode } from './FileExplorer/index.js';
-export type { FileTreeNodeProps } from './FileExplorer/index.js';
-export { useFileTree } from './FileExplorer/index.js';
-
-// WorkspacePicker
-export { WorkspacePicker } from './WorkspacePicker/index.js';
-export type { WorkspacePickerProps } from './WorkspacePicker/index.js';
-
-// DocBlocksShell
-export { DocBlocksShell } from './DocBlocksShell/index.js';
-export type { DocBlocksShellProps } from './DocBlocksShell/index.js';
-
-// AppMenu
-export { AppMenu } from './AppMenu/index.js';
-export type { AppMenuProps, ThemePreference } from './AppMenu/index.js';
-
-// Export
-export { ExportToolbarControls } from './Export/index.js';
-export type { ExportToolbarControlsProps, ExportFormat, ExportOptions } from './Export/index.js';
-export { ExportDialog } from './Export/index.js';
-export type { ExportDialogProps } from './Export/index.js';
-
-// Hooks
-export { useAutoSave } from './hooks/index.js';

package/src/monaco-slim.ts

@@ -1,20 +0,0 @@
-/**
- * Slim Monaco editor bundle for DocBlocks browser surfaces.
- *
- * Squisq's raw editor lazy-loads `monaco-editor/esm/vs/editor/editor.main.js`
- * so syntax highlighting works in raw mode. Alias both that subpath and the
- * bare `monaco-editor` specifier to this file to keep the lazy chunk focused
- * on markdown plus the languages users most often place in fenced blocks.
- */
-
-export * from 'monaco-editor/esm/vs/editor/editor.api';
-
-import 'monaco-editor/esm/vs/basic-languages/markdown/markdown.contribution';
-import 'monaco-editor/esm/vs/basic-languages/javascript/javascript.contribution';
-import 'monaco-editor/esm/vs/basic-languages/typescript/typescript.contribution';
-import 'monaco-editor/esm/vs/basic-languages/html/html.contribution';
-import 'monaco-editor/esm/vs/basic-languages/css/css.contribution';
-import 'monaco-editor/esm/vs/basic-languages/yaml/yaml.contribution';
-import 'monaco-editor/esm/vs/basic-languages/python/python.contribution';
-import 'monaco-editor/esm/vs/basic-languages/shell/shell.contribution';
-import 'monaco-editor/esm/vs/basic-languages/xml/xml.contribution';

package/src/preferences/versioning.ts

@@ -1,69 +0,0 @@
-/**
- * Versioning preferences — global default + per-workspace resolution.
- *
- * The global preference controls whether DocBlocks writes version
- * snapshots (under `<basename>_files/.versions/`) when editing. The
- * default is `'browser-only'` so local-folder workspaces stay clean by
- * default and only IndexedDB workspaces accumulate version history.
- *
- * Each workspace can override the global default with its own setting
- * stored on the WorkspaceDescriptor. `'inherit'` (or absent) defers to
- * the global preference; `'on'` / `'off'` force the behavior regardless.
- */
-
-import type { WorkspaceDescriptor } from '@bendyline/docblocks/workspace';
-
-export type VersioningPreference = 'on' | 'browser-only' | 'off';
-
-const STORAGE_KEY = 'docblocks:versioningPreference';
-const DEFAULT_PREFERENCE: VersioningPreference = 'browser-only';
-
-export function loadVersioningPreference(): VersioningPreference {
-  try {
-    const raw = localStorage.getItem(STORAGE_KEY);
-    if (raw === 'on' || raw === 'browser-only' || raw === 'off') return raw;
-  } catch {
-    // ignore
-  }
-  return DEFAULT_PREFERENCE;
-}
-
-export function saveVersioningPreference(value: VersioningPreference): void {
-  try {
-    localStorage.setItem(STORAGE_KEY, value);
-  } catch {
-    // ignore quota errors
-  }
-}
-
-/** Whether a workspace type is "local" (writes to a real folder on disk). */
-export function isLocalWorkspaceType(type: WorkspaceDescriptor['type']): boolean {
-  return type === 'native' || type === 'electron-native';
-}
-
-/**
- * Compute the effective versioning state for a workspace, honoring the
- * per-workspace override first and falling back to the global preference.
- *
- * Returns `false` whenever no workspace is provided so callers can use
- * this directly during initial render before a workspace loads.
- */
-export function resolveVersioningEnabled(
-  workspace: WorkspaceDescriptor | null,
-  globalPref: VersioningPreference,
-): boolean {
-  if (!workspace) return false;
-
-  const override = workspace.versioningOverride;
-  if (override === 'on') return true;
-  if (override === 'off') return false;
-
-  switch (globalPref) {
-    case 'on':
-      return true;
-    case 'off':
-      return false;
-    case 'browser-only':
-      return !isLocalWorkspaceType(workspace.type);
-  }
-}