@elmethis/core 0.10.0 → 0.12.0

package/dist/index.d.cts

@@ -3234,4 +3234,131 @@ declare function assembleCatalog(envelope: CatalogEnvelope, components: readonly
 declare const BLOCK_CATALOG_ID = "https://46ki75.github.io/elmethis/a2ui/v0_9/block_catalog.json";
 declare const blockCatalogJson: AssembledCatalog;
 //#endregion
-export { type AssembledCatalog, BLOCK_CATALOG_ID, BlockImageApi, BlockQuoteApi, BookmarkApi, CalloutApi, type CatalogEnvelope, CodeBlockApi, ColumnApi, ColumnListApi, ContentTabApi, ContentTabsApi, DividerApi, FileApi, HeadingApi, IconApi, KatexApi, LinkTextApi, ListApi, ListItemApi, MermaidApi, ParagraphApi, RichTextApi, RowApi, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, assembleCatalog, blockCatalogJson };
+//#region src/icon/languages/types.d.ts
+/**
+ * Framework-agnostic description of a language glyph's SVG artwork.
+ *
+ * Each {@link LanguageIcon} is authored once here and rendered by a thin,
+ * per-framework component that walks the node tree into that framework's JSX.
+ * The geometry (path data, gradients, brand colors) lives in exactly one place
+ * so the `qwik`/`react`/`vue` libraries no longer duplicate it.
+ */
+/** A single SVG element node: a tag, its literal attributes, and children. */
+interface SvgNode {
+  tag: string;
+  attrs?: Record<string, string>;
+  /**
+   * Inline style. Used for theme-aware fills that can't be a static
+   * presentation attribute (e.g. `fill: light-dark(...)`).
+   */
+  style?: Record<string, string>;
+  children?: SvgNode[];
+}
+/** A complete language glyph: the root `<svg>` payload minus sizing props. */
+interface LanguageIcon {
+  /** The `viewBox` of the root `<svg>`. */
+  viewBox: string;
+  /** Literal attributes carried on the root `<svg>` (e.g. a shared `fill`). */
+  attrs?: Record<string, string>;
+  /** The glyph's child elements. */
+  children: SvgNode[];
+}
+//#endregion
+//#region src/icon/languages/registry.d.ts
+/**
+ * The single source of truth for every language. {@link LANGUAGES},
+ * {@link normalizeLanguage}, and {@link languageIcons} are all derived from
+ * this array, so a language is declared in exactly one place.
+ */
+declare const LANGUAGE_REGISTRY: readonly [{
+  readonly key: "rust";
+  readonly aliases: readonly ["rs"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "javascript";
+  readonly aliases: readonly ["js"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "typescript";
+  readonly aliases: readonly ["ts"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "shell";
+  readonly aliases: readonly ["bash", "sh"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "terraform";
+  readonly aliases: readonly ["tf", "hcl"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "html";
+  readonly aliases: readonly ["html5"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "css";
+  readonly aliases: readonly ["css3"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "npm";
+  readonly aliases: readonly [];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "java";
+  readonly aliases: readonly [];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "kotlin";
+  readonly aliases: readonly ["kt"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "go";
+  readonly aliases: readonly ["golang"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "python";
+  readonly aliases: readonly ["py"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "sql";
+  readonly aliases: readonly [];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "json";
+  readonly aliases: readonly [];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "lua";
+  readonly aliases: readonly [];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "csharp";
+  readonly aliases: readonly ["cs", "c#"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "cpp";
+  readonly aliases: readonly ["c++"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "c";
+  readonly aliases: readonly ["clang"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "file";
+  readonly aliases: readonly [];
+  readonly icon: null;
+}];
+/**
+ * Canonical language keys. `"file"` is the generic fallback and has no glyph
+ * here — consumers render it with their own code-tags icon.
+ */
+type Language = (typeof LANGUAGE_REGISTRY)[number]["key"];
+/** Languages that have an authored glyph (every {@link Language} except `file`). */
+type GlyphLanguage = Exclude<Language, "file">;
+/** Canonical language keys, in registry order. */
+declare const LANGUAGES: readonly Language[];
+/** Maps an arbitrary language hint (alias, extension) onto a {@link Language}. */
+declare const normalizeLanguage: (language: string) => Language;
+/** The authored glyph artwork for every {@link GlyphLanguage}. */
+declare const languageIcons: Record<GlyphLanguage, LanguageIcon>;
+//#endregion
+export { type AssembledCatalog, BLOCK_CATALOG_ID, BlockImageApi, BlockQuoteApi, BookmarkApi, CalloutApi, type CatalogEnvelope, CodeBlockApi, ColumnApi, ColumnListApi, ContentTabApi, ContentTabsApi, DividerApi, FileApi, type GlyphLanguage, HeadingApi, IconApi, KatexApi, LANGUAGES, type Language, type LanguageIcon, LinkTextApi, ListApi, ListItemApi, MermaidApi, ParagraphApi, RichTextApi, RowApi, type SvgNode, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, assembleCatalog, blockCatalogJson, languageIcons, normalizeLanguage };

package/dist/index.d.mts

@@ -3234,4 +3234,131 @@ declare function assembleCatalog(envelope: CatalogEnvelope, components: readonly
 declare const BLOCK_CATALOG_ID = "https://46ki75.github.io/elmethis/a2ui/v0_9/block_catalog.json";
 declare const blockCatalogJson: AssembledCatalog;
 //#endregion
-export { type AssembledCatalog, BLOCK_CATALOG_ID, BlockImageApi, BlockQuoteApi, BookmarkApi, CalloutApi, type CatalogEnvelope, CodeBlockApi, ColumnApi, ColumnListApi, ContentTabApi, ContentTabsApi, DividerApi, FileApi, HeadingApi, IconApi, KatexApi, LinkTextApi, ListApi, ListItemApi, MermaidApi, ParagraphApi, RichTextApi, RowApi, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, assembleCatalog, blockCatalogJson };
+//#region src/icon/languages/types.d.ts
+/**
+ * Framework-agnostic description of a language glyph's SVG artwork.
+ *
+ * Each {@link LanguageIcon} is authored once here and rendered by a thin,
+ * per-framework component that walks the node tree into that framework's JSX.
+ * The geometry (path data, gradients, brand colors) lives in exactly one place
+ * so the `qwik`/`react`/`vue` libraries no longer duplicate it.
+ */
+/** A single SVG element node: a tag, its literal attributes, and children. */
+interface SvgNode {
+  tag: string;
+  attrs?: Record<string, string>;
+  /**
+   * Inline style. Used for theme-aware fills that can't be a static
+   * presentation attribute (e.g. `fill: light-dark(...)`).
+   */
+  style?: Record<string, string>;
+  children?: SvgNode[];
+}
+/** A complete language glyph: the root `<svg>` payload minus sizing props. */
+interface LanguageIcon {
+  /** The `viewBox` of the root `<svg>`. */
+  viewBox: string;
+  /** Literal attributes carried on the root `<svg>` (e.g. a shared `fill`). */
+  attrs?: Record<string, string>;
+  /** The glyph's child elements. */
+  children: SvgNode[];
+}
+//#endregion
+//#region src/icon/languages/registry.d.ts
+/**
+ * The single source of truth for every language. {@link LANGUAGES},
+ * {@link normalizeLanguage}, and {@link languageIcons} are all derived from
+ * this array, so a language is declared in exactly one place.
+ */
+declare const LANGUAGE_REGISTRY: readonly [{
+  readonly key: "rust";
+  readonly aliases: readonly ["rs"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "javascript";
+  readonly aliases: readonly ["js"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "typescript";
+  readonly aliases: readonly ["ts"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "shell";
+  readonly aliases: readonly ["bash", "sh"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "terraform";
+  readonly aliases: readonly ["tf", "hcl"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "html";
+  readonly aliases: readonly ["html5"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "css";
+  readonly aliases: readonly ["css3"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "npm";
+  readonly aliases: readonly [];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "java";
+  readonly aliases: readonly [];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "kotlin";
+  readonly aliases: readonly ["kt"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "go";
+  readonly aliases: readonly ["golang"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "python";
+  readonly aliases: readonly ["py"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "sql";
+  readonly aliases: readonly [];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "json";
+  readonly aliases: readonly [];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "lua";
+  readonly aliases: readonly [];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "csharp";
+  readonly aliases: readonly ["cs", "c#"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "cpp";
+  readonly aliases: readonly ["c++"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "c";
+  readonly aliases: readonly ["clang"];
+  readonly icon: LanguageIcon;
+}, {
+  readonly key: "file";
+  readonly aliases: readonly [];
+  readonly icon: null;
+}];
+/**
+ * Canonical language keys. `"file"` is the generic fallback and has no glyph
+ * here — consumers render it with their own code-tags icon.
+ */
+type Language = (typeof LANGUAGE_REGISTRY)[number]["key"];
+/** Languages that have an authored glyph (every {@link Language} except `file`). */
+type GlyphLanguage = Exclude<Language, "file">;
+/** Canonical language keys, in registry order. */
+declare const LANGUAGES: readonly Language[];
+/** Maps an arbitrary language hint (alias, extension) onto a {@link Language}. */
+declare const normalizeLanguage: (language: string) => Language;
+/** The authored glyph artwork for every {@link GlyphLanguage}. */
+declare const languageIcons: Record<GlyphLanguage, LanguageIcon>;
+//#endregion
+export { type AssembledCatalog, BLOCK_CATALOG_ID, BlockImageApi, BlockQuoteApi, BookmarkApi, CalloutApi, type CatalogEnvelope, CodeBlockApi, ColumnApi, ColumnListApi, ContentTabApi, ContentTabsApi, DividerApi, FileApi, type GlyphLanguage, HeadingApi, IconApi, KatexApi, LANGUAGES, type Language, type LanguageIcon, LinkTextApi, ListApi, ListItemApi, MermaidApi, ParagraphApi, RichTextApi, RowApi, type SvgNode, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, assembleCatalog, blockCatalogJson, languageIcons, normalizeLanguage };