@newcms/core 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -566,4 +566,132 @@ declare class BootstrapManager {
     reset(): void;
 }
 
-export { type AddHookOptions, BOOTSTRAP_PHASES, BUILTIN_POST_TYPES, BUILTIN_TAXONOMIES, BootstrapManager, type BootstrapPhase, type CapabilityContext, type ExtensionEntry, type ExtensionManifest, ExtensionRegistry, type ExtensionStatus, HOOK_PRIORITY, type HasHookResult, type HookCallback, HookEngine, type HookHandler, type HookStackEntry, POST_STATUS, type PhaseHandler, type PostTypeDefinition, PostTypeRegistry, type TaxonomyDefinition, TaxonomyRegistry, type TemplateContext, type ThemeEntry, type ThemeManifest, ThemeRegistry, type ThemeSupports, USER_ROLES, resolveTemplateHierarchy };
+/**
+ * Shortcode system — register named patterns with callbacks,
+ * then process content to replace shortcodes with rendered output.
+ *
+ * Syntax: [name attr="value"]content[/name] or [name attr="value" /]
+ */
+type ShortcodeCallback = (attributes: Record<string, string>, content: string, tag: string) => string;
+declare class ShortcodeRegistry {
+    private handlers;
+    register(tag: string, callback: ShortcodeCallback): void;
+    unregister(tag: string): boolean;
+    has(tag: string): boolean;
+    /**
+     * Process a string, replacing all registered shortcodes with their output.
+     * Supports nesting: inner shortcodes are processed first.
+     */
+    process(content: string): string;
+    /**
+     * Strip all shortcodes from content (remove tags, keep content).
+     */
+    strip(content: string): string;
+    getAll(): string[];
+    reset(): void;
+}
+
+/**
+ * Menu navigation system — register menu locations and manage menu items.
+ */
+interface MenuLocation {
+    name: string;
+    description: string;
+}
+interface MenuItem {
+    id: number;
+    title: string;
+    url: string;
+    target?: string;
+    cssClasses?: string[];
+    description?: string;
+    /** Type: custom, post_type, taxonomy */
+    type: 'custom' | 'post_type' | 'taxonomy';
+    /** Object ID (post ID or term ID) for non-custom items */
+    objectId?: number;
+    /** Post type or taxonomy name */
+    objectType?: string;
+    /** Parent item ID (0 for top-level) */
+    parentId: number;
+    /** Sort order */
+    menuOrder: number;
+    /** Children (built client-side from parentId) */
+    children?: MenuItem[];
+}
+declare class MenuRegistry {
+    private locations;
+    /**
+     * Register a menu location (e.g., "primary", "footer").
+     */
+    registerLocation(name: string, description: string): void;
+    /**
+     * Unregister a menu location.
+     */
+    unregisterLocation(name: string): boolean;
+    /**
+     * Get all registered locations.
+     */
+    getLocations(): MenuLocation[];
+    /**
+     * Check if a location is registered.
+     */
+    hasLocation(name: string): boolean;
+    /**
+     * Build a tree from a flat list of menu items using parentId.
+     */
+    static buildTree(items: MenuItem[]): MenuItem[];
+    reset(): void;
+}
+
+/**
+ * URL Rewrite system — maps URL patterns to query variables.
+ *
+ * Permalink structures use tags like %year%, %monthnum%, %postname%.
+ * The rewriter converts these to regex patterns that capture named groups,
+ * then resolves a URL path into query parameters.
+ */
+interface RewriteRule {
+    /** Regex pattern to match against the URL path */
+    pattern: RegExp;
+    /** Named query variables extracted from the match */
+    queryVars: string[];
+    /** Source (e.g., "post_permalink", "category", "custom") */
+    source: string;
+    /** Priority for ordering (lower = earlier) */
+    priority: number;
+}
+interface RewriteResult {
+    matched: boolean;
+    rule?: RewriteRule;
+    queryVars: Record<string, string>;
+}
+declare class UrlRewriter {
+    private rules;
+    /**
+     * Add a rewrite rule.
+     */
+    addRule(pattern: RegExp, queryVars: string[], source: string, priority?: number): void;
+    /**
+     * Generate rules from a permalink structure string.
+     * E.g., "/%year%/%monthnum%/%postname%/"
+     */
+    addPermalinkStructure(structure: string, source?: string): void;
+    /**
+     * Add default rules for categories, tags, authors, search, pages, feeds.
+     */
+    addDefaultRules(): void;
+    /**
+     * Resolve a URL path to query variables.
+     */
+    resolve(path: string): RewriteResult;
+    /**
+     * Build a permalink URL from a structure and values.
+     * E.g., buildPermalink("/%year%/%monthnum%/%postname%/", { year: "2026", monthnum: "04", postname: "hello" })
+     * → "/2026/04/hello/"
+     */
+    static buildPermalink(structure: string, values: Record<string, string>): string;
+    getRules(): RewriteRule[];
+    reset(): void;
+}
+
+export { type AddHookOptions, BOOTSTRAP_PHASES, BUILTIN_POST_TYPES, BUILTIN_TAXONOMIES, BootstrapManager, type BootstrapPhase, type CapabilityContext, type ExtensionEntry, type ExtensionManifest, ExtensionRegistry, type ExtensionStatus, HOOK_PRIORITY, type HasHookResult, type HookCallback, HookEngine, type HookHandler, type HookStackEntry, type MenuItem, type MenuLocation, MenuRegistry, POST_STATUS, type PhaseHandler, type PostTypeDefinition, PostTypeRegistry, type RewriteResult, type RewriteRule, type ShortcodeCallback, ShortcodeRegistry, type TaxonomyDefinition, TaxonomyRegistry, type TemplateContext, type ThemeEntry, type ThemeManifest, ThemeRegistry, type ThemeSupports, USER_ROLES, UrlRewriter, resolveTemplateHierarchy };

package/dist/index.d.ts

@@ -566,4 +566,132 @@ declare class BootstrapManager {
     reset(): void;
 }
 
-export { type AddHookOptions, BOOTSTRAP_PHASES, BUILTIN_POST_TYPES, BUILTIN_TAXONOMIES, BootstrapManager, type BootstrapPhase, type CapabilityContext, type ExtensionEntry, type ExtensionManifest, ExtensionRegistry, type ExtensionStatus, HOOK_PRIORITY, type HasHookResult, type HookCallback, HookEngine, type HookHandler, type HookStackEntry, POST_STATUS, type PhaseHandler, type PostTypeDefinition, PostTypeRegistry, type TaxonomyDefinition, TaxonomyRegistry, type TemplateContext, type ThemeEntry, type ThemeManifest, ThemeRegistry, type ThemeSupports, USER_ROLES, resolveTemplateHierarchy };
+/**
+ * Shortcode system — register named patterns with callbacks,
+ * then process content to replace shortcodes with rendered output.
+ *
+ * Syntax: [name attr="value"]content[/name] or [name attr="value" /]
+ */
+type ShortcodeCallback = (attributes: Record<string, string>, content: string, tag: string) => string;
+declare class ShortcodeRegistry {
+    private handlers;
+    register(tag: string, callback: ShortcodeCallback): void;
+    unregister(tag: string): boolean;
+    has(tag: string): boolean;
+    /**
+     * Process a string, replacing all registered shortcodes with their output.
+     * Supports nesting: inner shortcodes are processed first.
+     */
+    process(content: string): string;
+    /**
+     * Strip all shortcodes from content (remove tags, keep content).
+     */
+    strip(content: string): string;
+    getAll(): string[];
+    reset(): void;
+}
+
+/**
+ * Menu navigation system — register menu locations and manage menu items.
+ */
+interface MenuLocation {
+    name: string;
+    description: string;
+}
+interface MenuItem {
+    id: number;
+    title: string;
+    url: string;
+    target?: string;
+    cssClasses?: string[];
+    description?: string;
+    /** Type: custom, post_type, taxonomy */
+    type: 'custom' | 'post_type' | 'taxonomy';
+    /** Object ID (post ID or term ID) for non-custom items */
+    objectId?: number;
+    /** Post type or taxonomy name */
+    objectType?: string;
+    /** Parent item ID (0 for top-level) */
+    parentId: number;
+    /** Sort order */
+    menuOrder: number;
+    /** Children (built client-side from parentId) */
+    children?: MenuItem[];
+}
+declare class MenuRegistry {
+    private locations;
+    /**
+     * Register a menu location (e.g., "primary", "footer").
+     */
+    registerLocation(name: string, description: string): void;
+    /**
+     * Unregister a menu location.
+     */
+    unregisterLocation(name: string): boolean;
+    /**
+     * Get all registered locations.
+     */
+    getLocations(): MenuLocation[];
+    /**
+     * Check if a location is registered.
+     */
+    hasLocation(name: string): boolean;
+    /**
+     * Build a tree from a flat list of menu items using parentId.
+     */
+    static buildTree(items: MenuItem[]): MenuItem[];
+    reset(): void;
+}
+
+/**
+ * URL Rewrite system — maps URL patterns to query variables.
+ *
+ * Permalink structures use tags like %year%, %monthnum%, %postname%.
+ * The rewriter converts these to regex patterns that capture named groups,
+ * then resolves a URL path into query parameters.
+ */
+interface RewriteRule {
+    /** Regex pattern to match against the URL path */
+    pattern: RegExp;
+    /** Named query variables extracted from the match */
+    queryVars: string[];
+    /** Source (e.g., "post_permalink", "category", "custom") */
+    source: string;
+    /** Priority for ordering (lower = earlier) */
+    priority: number;
+}
+interface RewriteResult {
+    matched: boolean;
+    rule?: RewriteRule;
+    queryVars: Record<string, string>;
+}
+declare class UrlRewriter {
+    private rules;
+    /**
+     * Add a rewrite rule.
+     */
+    addRule(pattern: RegExp, queryVars: string[], source: string, priority?: number): void;
+    /**
+     * Generate rules from a permalink structure string.
+     * E.g., "/%year%/%monthnum%/%postname%/"
+     */
+    addPermalinkStructure(structure: string, source?: string): void;
+    /**
+     * Add default rules for categories, tags, authors, search, pages, feeds.
+     */
+    addDefaultRules(): void;
+    /**
+     * Resolve a URL path to query variables.
+     */
+    resolve(path: string): RewriteResult;
+    /**
+     * Build a permalink URL from a structure and values.
+     * E.g., buildPermalink("/%year%/%monthnum%/%postname%/", { year: "2026", monthnum: "04", postname: "hello" })
+     * → "/2026/04/hello/"
+     */
+    static buildPermalink(structure: string, values: Record<string, string>): string;
+    getRules(): RewriteRule[];
+    reset(): void;
+}
+
+export { type AddHookOptions, BOOTSTRAP_PHASES, BUILTIN_POST_TYPES, BUILTIN_TAXONOMIES, BootstrapManager, type BootstrapPhase, type CapabilityContext, type ExtensionEntry, type ExtensionManifest, ExtensionRegistry, type ExtensionStatus, HOOK_PRIORITY, type HasHookResult, type HookCallback, HookEngine, type HookHandler, type HookStackEntry, type MenuItem, type MenuLocation, MenuRegistry, POST_STATUS, type PhaseHandler, type PostTypeDefinition, PostTypeRegistry, type RewriteResult, type RewriteRule, type ShortcodeCallback, ShortcodeRegistry, type TaxonomyDefinition, TaxonomyRegistry, type TemplateContext, type ThemeEntry, type ThemeManifest, ThemeRegistry, type ThemeSupports, USER_ROLES, UrlRewriter, resolveTemplateHierarchy };

package/dist/index.js

@@ -946,6 +946,251 @@ var HOOK_PRIORITY = {
   LATE: 15,
   LATEST: 20
 };
+
+// src/shortcode.ts
+var ShortcodeRegistry = class {
+  handlers = /* @__PURE__ */ new Map();
+  register(tag, callback) {
+    this.handlers.set(tag, callback);
+  }
+  unregister(tag) {
+    return this.handlers.delete(tag);
+  }
+  has(tag) {
+    return this.handlers.has(tag);
+  }
+  /**
+   * Process a string, replacing all registered shortcodes with their output.
+   * Supports nesting: inner shortcodes are processed first.
+   */
+  process(content) {
+    if (this.handlers.size === 0) return content;
+    const tagPattern = [...this.handlers.keys()].map(escRegex).join("|");
+    const selfClosingRe = new RegExp(
+      `\\[(${tagPattern})(\\s[^\\]]*?)?\\s*\\/\\]`,
+      "g"
+    );
+    const enclosingRe = new RegExp(
+      `\\[(${tagPattern})(\\s[^\\]]*?)?\\]([\\s\\S]*?)\\[\\/\\1\\]`,
+      "g"
+    );
+    let result = content;
+    let prevResult = "";
+    let iterations = 0;
+    while (result !== prevResult && iterations < 10) {
+      prevResult = result;
+      result = result.replace(enclosingRe, (full, tag, attrStr, inner) => {
+        const handler = this.handlers.get(tag);
+        if (!handler) return full;
+        const attrs = parseShortcodeAttributes(attrStr?.trim() ?? "");
+        return handler(attrs, inner, tag);
+      });
+      iterations++;
+    }
+    result = result.replace(selfClosingRe, (full, tag, attrStr) => {
+      const handler = this.handlers.get(tag);
+      if (!handler) return full;
+      const attrs = parseShortcodeAttributes(attrStr?.trim() ?? "");
+      return handler(attrs, "", tag);
+    });
+    return result;
+  }
+  /**
+   * Strip all shortcodes from content (remove tags, keep content).
+   */
+  strip(content) {
+    const tagPattern = [...this.handlers.keys()].map(escRegex).join("|");
+    if (!tagPattern) return content;
+    let result = content;
+    result = result.replace(
+      new RegExp(`\\[(${tagPattern})(\\s[^\\]]*?)?\\]([\\s\\S]*?)\\[\\/\\1\\]`, "g"),
+      "$3"
+    );
+    result = result.replace(
+      new RegExp(`\\[(${tagPattern})(\\s[^\\]]*?)?\\s*\\/\\]`, "g"),
+      ""
+    );
+    return result;
+  }
+  getAll() {
+    return [...this.handlers.keys()];
+  }
+  reset() {
+    this.handlers.clear();
+  }
+};
+function parseShortcodeAttributes(attrStr) {
+  const attrs = {};
+  if (!attrStr) return attrs;
+  const re = /([a-zA-Z_][-a-zA-Z0-9_]*)\s*=\s*(?:"([^"]*)"|'([^']*)'|(\S+))|([a-zA-Z_][-a-zA-Z0-9_]*)/g;
+  let match;
+  while ((match = re.exec(attrStr)) !== null) {
+    if (match[1]) {
+      attrs[match[1]] = match[2] ?? match[3] ?? match[4] ?? "";
+    } else if (match[5]) {
+      attrs[match[5]] = "";
+    }
+  }
+  return attrs;
+}
+function escRegex(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// src/menu-registry.ts
+var MenuRegistry = class {
+  locations = /* @__PURE__ */ new Map();
+  /**
+   * Register a menu location (e.g., "primary", "footer").
+   */
+  registerLocation(name, description) {
+    this.locations.set(name, { name, description });
+  }
+  /**
+   * Unregister a menu location.
+   */
+  unregisterLocation(name) {
+    return this.locations.delete(name);
+  }
+  /**
+   * Get all registered locations.
+   */
+  getLocations() {
+    return [...this.locations.values()];
+  }
+  /**
+   * Check if a location is registered.
+   */
+  hasLocation(name) {
+    return this.locations.has(name);
+  }
+  /**
+   * Build a tree from a flat list of menu items using parentId.
+   */
+  static buildTree(items) {
+    const map = /* @__PURE__ */ new Map();
+    const roots = [];
+    const sorted = [...items].sort((a, b) => a.menuOrder - b.menuOrder);
+    for (const item of sorted) {
+      map.set(item.id, { ...item, children: [] });
+    }
+    for (const item of sorted) {
+      const node = map.get(item.id);
+      if (item.parentId === 0) {
+        roots.push(node);
+      } else {
+        const parent = map.get(item.parentId);
+        if (parent) {
+          parent.children = parent.children ?? [];
+          parent.children.push(node);
+        } else {
+          roots.push(node);
+        }
+      }
+    }
+    return roots;
+  }
+  reset() {
+    this.locations.clear();
+  }
+};
+
+// src/url-rewrite.ts
+var STRUCTURE_TAGS = {
+  "%year%": { regex: "(?<year>\\d{4})", queryVar: "year" },
+  "%monthnum%": { regex: "(?<monthnum>\\d{2})", queryVar: "monthnum" },
+  "%day%": { regex: "(?<day>\\d{2})", queryVar: "day" },
+  "%hour%": { regex: "(?<hour>\\d{2})", queryVar: "hour" },
+  "%minute%": { regex: "(?<minute>\\d{2})", queryVar: "minute" },
+  "%second%": { regex: "(?<second>\\d{2})", queryVar: "second" },
+  "%postname%": { regex: "(?<postname>[^/]+)", queryVar: "name" },
+  "%post_id%": { regex: "(?<post_id>\\d+)", queryVar: "p" },
+  "%category%": { regex: "(?<category>[^/]+)", queryVar: "category_name" },
+  "%tag%": { regex: "(?<tag>[^/]+)", queryVar: "tag" },
+  "%author%": { regex: "(?<author>[^/]+)", queryVar: "author_name" },
+  "%pagename%": { regex: "(?<pagename>[^/]+)", queryVar: "pagename" }
+};
+var UrlRewriter = class {
+  rules = [];
+  /**
+   * Add a rewrite rule.
+   */
+  addRule(pattern, queryVars, source, priority = 10) {
+    this.rules.push({ pattern, queryVars, source, priority });
+    this.rules.sort((a, b) => a.priority - b.priority);
+  }
+  /**
+   * Generate rules from a permalink structure string.
+   * E.g., "/%year%/%monthnum%/%postname%/"
+   */
+  addPermalinkStructure(structure, source = "post_permalink") {
+    let regexStr = structure;
+    const queryVars = [];
+    for (const [tag, def] of Object.entries(STRUCTURE_TAGS)) {
+      if (regexStr.includes(tag)) {
+        regexStr = regexStr.replace(tag, def.regex);
+        queryVars.push(def.queryVar);
+      }
+    }
+    regexStr = regexStr.replace(/^\//, "").replace(/\/$/, "");
+    const pattern = new RegExp(`^${regexStr}/?$`);
+    this.addRule(pattern, queryVars, source, 5);
+  }
+  /**
+   * Add default rules for categories, tags, authors, search, pages, feeds.
+   */
+  addDefaultRules() {
+    this.addRule(/^category\/(?<category>[^/]+)\/?$/, ["category_name"], "category", 10);
+    this.addRule(/^tag\/(?<tag>[^/]+)\/?$/, ["tag"], "tag", 10);
+    this.addRule(/^author\/(?<author>[^/]+)\/?$/, ["author_name"], "author", 10);
+    this.addRule(/^search\/(?<s>.+)\/?$/, ["s"], "search", 10);
+    this.addRule(/^page\/(?<paged>\d+)\/?$/, ["paged"], "paging", 10);
+    this.addRule(/^feed\/?(?<feed>rss2?|atom|rdf)?\/?$/, ["feed"], "feed", 10);
+    this.addRule(/^(?<pagename>[^/]+)\/?$/, ["pagename"], "page", 99);
+  }
+  /**
+   * Resolve a URL path to query variables.
+   */
+  resolve(path) {
+    const cleanPath = path.replace(/^\//, "").replace(/\/$/, "");
+    for (const rule of this.rules) {
+      const match = cleanPath.match(rule.pattern);
+      if (match?.groups) {
+        const queryVars = {};
+        for (const [key, value] of Object.entries(match.groups)) {
+          if (value !== void 0) {
+            const tag = Object.entries(STRUCTURE_TAGS).find(
+              ([_, def]) => def.regex.includes(`<${key}>`)
+            );
+            queryVars[tag ? tag[1].queryVar : key] = value;
+          }
+        }
+        return { matched: true, rule, queryVars };
+      }
+    }
+    return { matched: false, queryVars: {} };
+  }
+  /**
+   * Build a permalink URL from a structure and values.
+   * E.g., buildPermalink("/%year%/%monthnum%/%postname%/", { year: "2026", monthnum: "04", postname: "hello" })
+   * → "/2026/04/hello/"
+   */
+  static buildPermalink(structure, values) {
+    let result = structure;
+    for (const [tag, def] of Object.entries(STRUCTURE_TAGS)) {
+      if (result.includes(tag) && values[def.queryVar]) {
+        result = result.replace(tag, values[def.queryVar]);
+      }
+    }
+    return result;
+  }
+  getRules() {
+    return [...this.rules];
+  }
+  reset() {
+    this.rules = [];
+  }
+};
 export {
   BOOTSTRAP_PHASES,
   BUILTIN_POST_TYPES,
@@ -954,11 +1199,14 @@ export {
   ExtensionRegistry,
   HOOK_PRIORITY,
   HookEngine,
+  MenuRegistry,
   POST_STATUS,
   PostTypeRegistry,
+  ShortcodeRegistry,
   TaxonomyRegistry,
   ThemeRegistry,
   USER_ROLES,
+  UrlRewriter,
   resolveTemplateHierarchy
 };
 //# sourceMappingURL=index.js.map