@clepit/core 0.4.0 → 0.5.0-beta.350

package/dist/types.d.ts

@@ -30,6 +30,8 @@ import { HeaderInput } from './tools/block/header/input';
 import { HeaderOutput } from './tools/block/header/output';
 import { ImageInput } from './tools/block/image/input';
 import { ImageOutput } from './tools/block/image/output';
+import { IssuesInput } from './tools/block/issues/input';
+import { IssuesOutput } from './tools/block/issues/output';
 import { ListInput } from './tools/block/list/input';
 import { ListOutput } from './tools/block/list/output';
 import { OpenApiInput } from './tools/block/openapi/input';
@@ -55,8 +57,8 @@ export declare const DELIMITER_VARIANTS: readonly ["line", "stars"];
 export declare const LIST_TYPES: readonly ["ordered", "unordered"];
 export declare const ALIGNMENTS: readonly ["center", "left", "right"];
 export declare const HEADER_LEVELS: readonly ["h1", "h2", "h3", "h4", "h5", "h6"];
-export declare const INLINE_TOOLS: readonly ["bold", "inline-code", "italic", "link", "marker", "strikethrough", "tooltip", "underline"];
-export declare const BLOCK_TOOLS: readonly ["alert", "audio", "checklist", "code", "collapsible", "collection", "columns", "date", "delimiter", "doc_card", "embed", "file", "glance", "header", "image", "latex", "list", "mermaid", "openapi", "paragraph", "quote", "sketch", "table", "toc", "updates", "video"];
+export declare const INLINE_TOOLS: readonly ["bold", "inline-code", "italic", "link", "marker", "status", "strikethrough", "tooltip", "underline"];
+export declare const BLOCK_TOOLS: readonly ["alert", "audio", "checklist", "code", "collapsible", "collection", "columns", "date", "delimiter", "doc_card", "embed", "file", "glance", "header", "image", "issues", "latex", "list", "mermaid", "openapi", "paragraph", "quote", "sketch", "table", "toc", "updates", "video"];
 export type CodeLanguage = 'assembly' | 'bash' | 'clojure' | 'cobol' | 'cpp' | 'csharp' | 'css' | 'dart' | 'diff' | 'dockerfile' | 'erlang' | 'fortran' | 'go' | 'graphql' | 'groovy' | 'haskell' | 'html' | 'java' | 'javascript' | 'json' | 'jsx' | 'julia' | 'kotlin' | 'lua' | 'markdown' | 'nginx' | 'objectivec' | 'pascal' | 'perl' | 'php' | 'plaintext' | 'powershell' | 'protobuf' | 'python' | 'r' | 'ruby' | 'rust' | 'scala' | 'scheme' | 'shell' | 'sql' | 'swift' | 'toml' | 'tsx' | 'typescript' | 'vb' | 'verilog' | 'vhdl' | 'xml' | 'yaml';
 export type CodeTheme = 'auto' | 'dark' | 'default' | 'dracula' | 'github' | 'github-dark' | 'light' | 'monokai' | 'solarized' | 'solarized-dark' | 'tomorrow';
 export type AlertVariant = (typeof ALERT_VARIANTS)[number];
@@ -73,8 +75,8 @@ export type Tool = {
     shortcut: string;
     testId: string;
     type: ToolType;
-    input: typeof AlertInput | typeof CollapsibleInput | typeof CollectionInput | typeof EmbedInput | typeof SketchInput | typeof LatexInput | typeof MermaidInput | typeof ColumnsInput | typeof DateInput | typeof DocCardInput | typeof FileInput | typeof TocInput | typeof UpdatesInput | typeof GlanceInput | typeof DelimiterInput | typeof ListInput | typeof OpenApiInput | typeof HeaderInput | typeof QuoteInput | typeof CodeInput | typeof TableInput | typeof ImageInput | typeof AudioInput | typeof VideoInput | typeof ParagraphInput | typeof ChecklistInput;
-    output: typeof AlertOutput | typeof CollapsibleOutput | typeof CollectionOutput | typeof EmbedOutput | typeof SketchOutput | typeof LatexOutput | typeof MermaidOutput | typeof ColumnsOutput | typeof DateOutput | typeof DocCardOutput | typeof FileOutput | typeof TocOutput | typeof UpdatesOutput | typeof GlanceOutput | typeof DelimiterOutput | typeof ListOutput | typeof OpenApiOutput | typeof HeaderOutput | typeof QuoteOutput | typeof CodeOutput | typeof TableOutput | typeof ImageOutput | typeof AudioOutput | typeof VideoOutput | typeof ParagraphOutput | typeof ChecklistOutput;
+    input: typeof AlertInput | typeof CollapsibleInput | typeof CollectionInput | typeof EmbedInput | typeof SketchInput | typeof LatexInput | typeof MermaidInput | typeof ColumnsInput | typeof DateInput | typeof DocCardInput | typeof FileInput | typeof IssuesInput | typeof TocInput | typeof UpdatesInput | typeof GlanceInput | typeof DelimiterInput | typeof ListInput | typeof OpenApiInput | typeof HeaderInput | typeof QuoteInput | typeof CodeInput | typeof TableInput | typeof ImageInput | typeof AudioInput | typeof VideoInput | typeof ParagraphInput | typeof ChecklistInput;
+    output: typeof AlertOutput | typeof CollapsibleOutput | typeof CollectionOutput | typeof EmbedOutput | typeof SketchOutput | typeof LatexOutput | typeof MermaidOutput | typeof ColumnsOutput | typeof DateOutput | typeof DocCardOutput | typeof FileOutput | typeof IssuesOutput | typeof TocOutput | typeof UpdatesOutput | typeof GlanceOutput | typeof DelimiterOutput | typeof ListOutput | typeof OpenApiOutput | typeof HeaderOutput | typeof QuoteOutput | typeof CodeOutput | typeof TableOutput | typeof ImageOutput | typeof AudioOutput | typeof VideoOutput | typeof ParagraphOutput | typeof ChecklistOutput;
 };
 export type CSSValue = string | number | ((val: CSSProperties) => string | number) | undefined;
 export type CSSProperties = Prettify<{
@@ -186,6 +188,55 @@ export type DateData = {
     date: string;
 };
 export type TocData = Record<string, never>;
+export type IssuesData = Record<string, never>;
+/** The four trackers of the Link and track group, by wire key. */
+export declare const ISSUE_TOOLS: readonly ["asana", "github_issues", "jira", "linear"];
+export type IssueTool = (typeof ISSUE_TOOLS)[number];
+/** The four states every tracker's own vocabulary folds into; the tool's own
+ * word rides beside it as `stateName`. */
+export type IssueCategory = 'cancelled' | 'done' | 'started' | 'todo';
+/** Why an issue could not be read, in the wire words the chip renders. */
+export type IssueReason = 'connect_tool' | 'no_access' | 'provider_unreachable';
+/** An issue as it stood when read. `key` is the tool's handle (`ENG-142`,
+ * `acme/app#88`) and empty for an Asana task; `stateName` is the tool's own
+ * word and empty where a tool has only a done flag. Every field but `url` and
+ * `tool` is empty or absent while `reason` stands. */
+export type IssueSnapshot = {
+    assigneeAvatarUrl?: string;
+    assigneeName?: string;
+    category: IssueCategory;
+    color?: string;
+    key: string;
+    pull?: boolean;
+    reason?: IssueReason;
+    stateName: string;
+    title: string;
+    tool: string;
+    updatedAt: string;
+    url: string;
+};
+/** What the classifier makes of a URL: the tool and the handle it can read off
+ * the address, and for Jira the site the read goes to. */
+export type IssueTarget = {
+    key: string;
+    site?: string;
+    tool: IssueTool;
+};
+/** The words the chip, the card and the Linked issues table draw. This
+ * package ships English fallbacks; a host passes translations through
+ * `EditorConfig.issueLabels`. */
+export declare const ISSUE_LABELS: readonly ["categoryCancelled", "categoryDone", "categoryStarted", "categoryTodo", "columnAssignee", "columnIssue", "columnStatus", "columnTitle", "connectAction", "connectTool", "linkedIssuesEmpty", "noAccess", "openInTool", "providerUnreachable", "showAsCard", "unassigned", "updatedRelative"];
+export type IssueLabel = (typeof ISSUE_LABELS)[number];
+/** The two parts of a chip a member may switch off (pick 2C, 2026-09-06). */
+export type IssueChipParts = {
+    assignee: boolean;
+    status: boolean;
+};
+/** Whether an issue link pasted on its own line becomes a card. Off by default. */
+export type IssueCards = 'off' | 'on';
+/** The fix beside an issue reason that only the host can perform: connecting
+ * the tool, which lands on the host's Integrations page. */
+export type IssueAction = 'connect';
 export type CollectionData = {
     collectionId: string;
 };
@@ -194,7 +245,40 @@ export type UpdatesData = {
 };
 /** `link` is a first-class outcome, not a failure: most services publish no
  * supported public iframe. `invalid` is a URL we refuse to render at all. */
-export type EmbedProvider = 'airtable' | 'drawio' | 'figma' | 'googleMaps' | 'invalid' | 'link' | 'miro' | 'youtube';
+export type EmbedProvider = 'airtable' | 'drawio' | 'figma' | 'githubGist' | 'googleDrive' | 'googleMaps' | 'invalid' | 'link' | 'loom' | 'miro' | 'youtube';
+/** Why a card shows where live content could: the wire words the server and
+ * the switch produce, rendered as one line under the title. */
+export type EmbedReason = 'connect_google' | 'no_access' | 'provider_unreachable' | 'switched_off';
+/** A Drive file as the paster's own Google account saw it. */
+export type EmbedFile = {
+    iconUrl: string;
+    mimeType: string;
+    name: string;
+};
+export type EmbedGistFile = {
+    content: string;
+    language: string | null;
+    name: string;
+    truncated: boolean;
+};
+/** A gist as pasted. The web frames GitHub's own script; every renderer
+ * without a browser draws these files as code. */
+export type EmbedGist = {
+    files: EmbedGistFile[];
+    htmlUrl: string;
+    id: string;
+    owner: string;
+};
+/** What a paste of a supported link does: the member's preference, `live` by
+ * default (pick 2A, 2026-09-05). */
+export type PasteEmbeds = 'card' | 'live' | 'offer';
+/** The words the embed block draws. This package ships English fallbacks; a
+ * host passes translations through `EditorConfig.embedLabels`. */
+export declare const EMBED_LABELS: readonly ["connectGoogle", "connectGoogleAction", "noAccess", "providerUnreachable", "tryAgain", "switchedOff", "offerShowLive", "viewOnGithub", "truncated"];
+export type EmbedLabel = (typeof EMBED_LABELS)[number];
+/** What the fix beside a reason asks the host to do. `retry` the core handles
+ * itself; `connectGoogle` only the host can, since it owns the routes. */
+export type EmbedAction = 'connectGoogle' | 'retry';
 /** Points are a FLAT x,y list — a sketch is thousands of points and the flat
  * form roughly halves the stored JSON. */
 export type SketchStroke = {
@@ -218,15 +302,26 @@ export type EmbedData = {
     title?: string;
     description?: string;
     imageUrl?: string;
+    display?: 'card';
+    file?: EmbedFile;
+    gist?: EmbedGist;
+    reason?: EmbedReason;
+    issue?: IssueSnapshot;
 };
 export type EmbedResolution = {
     url: string;
     provider: EmbedProvider;
     embedUrl: string | null;
     aspect?: number;
+    gist?: {
+        id: string;
+        owner: string;
+    };
+    switchedOff?: boolean;
 };
 export type EmbedResolveOptions = {
     mapsEmbedKey?: string;
+    disabledProviders?: readonly string[];
 };
 export type DocCardData = {
     pageId: string;
@@ -294,6 +389,11 @@ export type Block<T = BlockToolType> = T extends 'alert' ? {
     type: T;
     data: TocData;
     tunes?: BlockTunes;
+} : T extends 'issues' ? {
+    id?: string;
+    type: T;
+    data: IssuesData;
+    tunes?: BlockTunes;
 } : T extends 'glance' ? {
     id?: string;
     type: T;
@@ -804,6 +904,11 @@ export type OutputConfig = {
         content?: string;
         arrow?: string;
     };
+    disabledEmbedProviders?: readonly string[];
+    embedLabels?: Partial<Record<EmbedLabel, string>>;
+    issues?: Record<string, IssueSnapshot>;
+    issueChip?: IssueChipParts;
+    issueLabels?: Partial<Record<IssueLabel, string>>;
 };
 export interface OutputComponent {
     render: <T extends ToolType>(data: Block<T>['data'], config?: OutputConfig, styles?: BlockStyles[T], classNames?: BlockClassNames[T]) => HTMLElement;
@@ -893,10 +998,21 @@ export type EditorConfig = {
     inlineRewriteLabels?: Partial<Record<InlineRewriteAction, string>>;
     blockToolLabels?: Partial<Record<BlockToolType, string>>;
     blockToolbarLabels?: Partial<Record<BlockToolbarLabel, string>>;
+    resolveLink?: (url: string) => Promise<Partial<EmbedData>>;
+    onEmbedAction?: (action: EmbedAction, blockId: string) => void;
+    disabledEmbedProviders?: readonly string[];
+    pasteEmbeds?: PasteEmbeds;
+    embedLabels?: Partial<Record<EmbedLabel, string>>;
+    resolveIssues?: (urls: string[]) => Promise<Record<string, IssueSnapshot>>;
+    onIssueAction?: (action: IssueAction, tool: string) => void;
+    issueCards?: IssueCards;
+    issueChip?: IssueChipParts;
+    issueLabels?: Partial<Record<IssueLabel, string>>;
+    jiraSites?: readonly string[];
 };
 export declare const BLOCK_TOOLBAR_OPERATIONS: readonly ["convert", "moveUp", "moveDown", "delete"];
 export type BlockToolbarOperation = (typeof BLOCK_TOOLBAR_OPERATIONS)[number];
-export declare const BLOCK_MENU_LABELS: readonly ["searchBlocks", "searchOperations", "searchConvertOptions", "searchLanguages", "searchThemes", "noBlockTypesFound", "noOperationsFound", "noConvertOptionsFound", "alignLeft", "alignCenter", "alignRight", "codeLanguage", "codeTheme", "headingH1", "headingH2", "headingH3", "headingH4", "headingH5", "headingH6", "listUnordered", "listOrdered", "variantInfo", "variantWarning", "variantError", "variantSuccess", "variantPlain", "delimiterLine", "delimiterStars"];
+export declare const BLOCK_MENU_LABELS: readonly ["searchBlocks", "searchOperations", "searchConvertOptions", "searchLanguages", "searchThemes", "noBlockTypesFound", "noOperationsFound", "noConvertOptionsFound", "alignLeft", "alignCenter", "alignRight", "codeLanguage", "codeTheme", "headingH1", "headingH2", "headingH3", "headingH4", "headingH5", "headingH6", "listUnordered", "listOrdered", "variantInfo", "variantWarning", "variantError", "variantSuccess", "variantPlain", "delimiterLine", "delimiterStars", "embedShowLive", "embedShowCard", "embedShowLink", "embedCopyLink", "embedShowChip"];
 export type BlockMenuLabel = (typeof BLOCK_MENU_LABELS)[number];
 export type BlockToolbarLabel = BlockToolbarOperation | BlockMenuLabel;
 export declare const INLINE_REWRITE_ACTIONS: readonly ["improve", "shorten", "lengthen", "simplify", "fix_grammar"];
@@ -921,6 +1037,11 @@ export type RendererConfig = {
         light?: ThemeTokens;
         dark?: ThemeTokens;
     };
+    /** The freshest issue snapshots, by URL: chips, cards and tables redraw from these. */
+    issues?: Record<string, IssueSnapshot>;
+    /** The reader's two chip switches; both on when absent. */
+    issueChip?: IssueChipParts;
+    issueLabels?: Partial<Record<IssueLabel, string>>;
 };
 export interface EditorInstance {
     currentView: EditorView;

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "Bomdisoft",
   "dependencies": {},
-  "description": "A block-style editor with built-in plugins and renderer",
+  "description": "Clepit: a block-style editor with clean JSON output and a renderer that works with or without a browser. Framework-agnostic core.",
   "devDependencies": {
     "@bomdisoft/store": "0.0.0",
     "@bomdisoft/typescript-config": "0.0.0",
@@ -26,7 +26,7 @@
   },
   "files": ["dist", "!dist/**/*.map", "CHANGELOG.md", "LICENSE", "README.md"],
   "homepage": "https://clepit.com",
-  "keywords": ["editor", "block-editor", "wysiwyg", "typescript", "react", "vue", "vanilla", "json", "framework-agnostic"],
+  "keywords": ["clepit", "editor", "block-editor", "block-style editor", "rich-text", "wysiwyg", "renderer", "ssr", "typescript", "json", "framework-agnostic", "editorjs"],
   "license": "MIT",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -53,5 +53,5 @@
   },
   "sideEffects": false,
   "types": "dist/index.d.ts",
-  "version": "0.4.0"
+  "version": "0.5.0-beta.350"
 }