nextpress-core 1.0.0 → 1.0.1

package/{lib/router/routes/term-archive.tsx → dist/router/routes/term-archive.js}

@@ -1,35 +1,10 @@
-import { MetadataResult, RouteProps, TemplateResult } from "../types";
+import { jsx as _jsx } from "react/jsx-runtime";
 import { getPageNumber } from "../helpers";
 import { notFound } from "next/navigation";
 import { CategoryMetadata, CategoryTemplate } from "@/template-heirarchy/archive/category";
 import { TagMetadata, TagTemplate } from "@/template-heirarchy/archive/tag";
 import { TaxonomyMetadata, TaxonomyTemplate } from "@/template-heirarchy/archive/taxonomy";
 import { queriedObjectState } from "@/globals/globals";
-
-/**
- * Resolves the term archive route and maps it to the template hierarchy to return Metadata.
- * * Routing Behavior:
- * - If the taxonomy is 'category', it routes to `CategoryMetadata`.
- * - If the taxonomy is 'tag', it routes to `TagMetadata`.
- * - For all other taxonomies, it routes to `TaxonomyMetadata`.
- *
- * @param {{ path: string[], metadata: true }} props - Route properties requesting metadata.
- * @returns {Promise<MetadataResult>} The generated metadata.
- */
-export function TermArchive(props: { path: string[], metadata: true }): Promise<MetadataResult>;
-
-/**
- * Resolves the term archive route and maps it to the template hierarchy to return a Template.
- * * Routing Behavior:
- * - If the taxonomy is 'category', it routes to `CategoryTemplate`.
- * - If the taxonomy is 'tag', it routes to `TagTemplate`.
- * - For all other taxonomies, it routes to `TaxonomyTemplate`.
- *
- * @param {{ path: string[], metadata?: false }} props - Route properties requesting a template.
- * @returns {Promise<TemplateResult>} The rendered template component.
- */
-export function TermArchive(props: { path: string[], metadata?: false }): Promise<TemplateResult>;
-
 /**
  * Core implementation for the term archive route.
  * Retrieves posts for a specific taxonomy term and updates the queried object state.
@@ -38,25 +13,24 @@ export function TermArchive(props: { path: string[], metadata?: false }): Promis
  * @returns {Promise<MetadataResult | TemplateResult>} The metadata or template result based on the hierarchy.
  * @throws {Error} Throws a Next.js notFound error if the term does not exist.
  */
-export async function TermArchive({ path, metadata = false }: RouteProps) {
-    const postsPerPage = Number(await getOption('posts_per_page')) ?? 10;
-
+export async function TermArchive({ path, metadata = false }) {
+    var _a, _b;
+    const postsPerPage = (_a = Number(await getOption('posts_per_page'))) !== null && _a !== void 0 ? _a : 10;
     let page = getPageNumber(path);
     if (page) {
         path = path.slice(0, -2);
-    } else {
+    }
+    else {
         page = 1;
     }
-
-    const taxonomy = path[0] ?? '';
+    const taxonomy = (_b = path[0]) !== null && _b !== void 0 ? _b : '';
     const pathString = path.slice(1).join('/');
-
     const termQuery = await termLoader.findAndPrime({
         taxonomy,
         path: `/${pathString}`
     });
-    if (!termQuery.ids.length) notFound();
-
+    if (!termQuery.ids.length)
+        notFound();
     const postIds = await postLoader.findAndPrime({
         termIn: termQuery.ids,
         noFoundRows: false,
@@ -67,10 +41,8 @@ export async function TermArchive({ path, metadata = false }: RouteProps) {
         postStatus: 'publish',
         orderBy: 'date'
     });
-
     const terms = await getTerms(termQuery.ids);
-    const mainTerm = terms.find(term => term.slug === path[path.length - 1])!;
-
+    const mainTerm = terms.find(term => term.slug === path[path.length - 1]);
     const currentQueriedObject = {
         objectType: 'term',
         posts: postIds.ids,
@@ -79,15 +51,15 @@ export async function TermArchive({ path, metadata = false }: RouteProps) {
         mainTerm: mainTerm.termId,
         terms: termQuery.ids
     };
-
     const state = queriedObjectState();
     state.currentState = currentQueriedObject;
-
     if (taxonomy === 'category') {
-        return metadata ? await CategoryMetadata() : <CategoryTemplate/>;
-    } else if (taxonomy === 'tag') {
-        return metadata ? await TagMetadata() : <TagTemplate/>;
-    } else {
-        return metadata ? await TaxonomyMetadata() : <TaxonomyTemplate/>;
+        return metadata ? await CategoryMetadata() : _jsx(CategoryTemplate, {});
+    }
+    else if (taxonomy === 'tag') {
+        return metadata ? await TagMetadata() : _jsx(TagTemplate, {});
+    }
+    else {
+        return metadata ? await TaxonomyMetadata() : _jsx(TaxonomyTemplate, {});
     }
 }

package/dist/services/get-menu.d.ts

@@ -0,0 +1,13 @@
+import { IMenuItem } from "../entities/post/post.interface";
+type Menu = {
+    menuItem: IMenuItem;
+    children: Menu[];
+};
+/**
+ * Retrieves a menu by its location identifier.
+ *
+ * @param {string} menuLocation - The location identifier of the menu.
+ * @returns {Promise<Menu[] | undefined>} An array of menu items representing the menu tree, or undefined if the menu is not found.
+ */
+export declare function getMenu(menuLocation: string): Promise<Menu[] | undefined>;
+export {};

package/{lib/services/get-menu.ts → dist/services/get-menu.js}

@@ -1,104 +1,80 @@
-import { IMenuItem } from "../entities/post/post.interface";
 import { getThemeMods } from "./get-theme-mods";
-
-type Menu = {
-    menuItem: IMenuItem,
-    children: Menu[]
-}
-
 /**
  * Retrieves a menu by its location identifier.
  *
  * @param {string} menuLocation - The location identifier of the menu.
  * @returns {Promise<Menu[] | undefined>} An array of menu items representing the menu tree, or undefined if the menu is not found.
  */
-export async function getMenu(menuLocation: string): Promise<Menu[] | undefined> {
+export async function getMenu(menuLocation) {
+    var _a, _b, _c, _d;
     const navMenuLocations = await getThemeMods('nav_menu_locations');
-    if (!navMenuLocations || typeof navMenuLocations !== 'object') return;
-
-    const menuTermId = Number((navMenuLocations as Record<string, any>)[menuLocation]) || undefined;
-    if (!menuTermId) return;
-
+    if (!navMenuLocations || typeof navMenuLocations !== 'object')
+        return;
+    const menuTermId = Number(navMenuLocations[menuLocation]) || undefined;
+    if (!menuTermId)
+        return;
     const postQuery = await postLoader.findAndPrime({
         termId: menuTermId,
         postStatus: 'publish',
         postType: 'nav_menu_item',
         noFoundRows: true,
         noPaging: true
-    })
-
-    const menuItems: IMenuItem[] = (await getPosts(postQuery.ids)).sort((a, b) => a.menuOrder - b.menuOrder);
-
+    });
+    const menuItems = (await getPosts(postQuery.ids)).sort((a, b) => a.menuOrder - b.menuOrder);
     // Prime cache to get paths in bunch later
     for (const item of menuItems) {
-        if (!item.menuItemAttributes) continue;
-
+        if (!item.menuItemAttributes)
+            continue;
         if (item.menuItemAttributes.type === 'post_type') {
-            postLoader.prime([item.menuItemAttributes.objectId])
-        } else if (item.menuItemAttributes.type === 'taxonomy') {
-            termLoader.prime([item.menuItemAttributes.objectId])
+            postLoader.prime([item.menuItemAttributes.objectId]);
+        }
+        else if (item.menuItemAttributes.type === 'taxonomy') {
+            termLoader.prime([item.menuItemAttributes.objectId]);
         }
     }
-
-    const map = new Map<number, Menu>();
-    const tree: Menu[] = [];
-
+    const map = new Map();
+    const tree = [];
     for (const item of menuItems) {
-        if (!item.menuItemAttributes) continue;
-
-        const menuItemAttributes = { ...item.menuItemAttributes };
-
+        if (!item.menuItemAttributes)
+            continue;
+        const menuItemAttributes = Object.assign({}, item.menuItemAttributes);
         if (item.menuItemAttributes.type === 'post_type') {
             const post = await getPost(menuItemAttributes.objectId);
-
-            menuItemAttributes.url = post?.path ?? '';
-
+            menuItemAttributes.url = (_a = post === null || post === void 0 ? void 0 : post.path) !== null && _a !== void 0 ? _a : '';
             if (!menuItemAttributes.label) {
-                menuItemAttributes.label = post?.postTitle ?? '';
+                menuItemAttributes.label = (_b = post === null || post === void 0 ? void 0 : post.postTitle) !== null && _b !== void 0 ? _b : '';
             }
-        } else if (item.menuItemAttributes.type === 'taxonomy') {
+        }
+        else if (item.menuItemAttributes.type === 'taxonomy') {
             const term = await getTerm(menuItemAttributes.objectId);
-
-            menuItemAttributes.url = term?.path ?? '';
-
+            menuItemAttributes.url = (_c = term === null || term === void 0 ? void 0 : term.path) !== null && _c !== void 0 ? _c : '';
             if (!menuItemAttributes.label) {
-                menuItemAttributes.label = term?.name ?? '';
+                menuItemAttributes.label = (_d = term === null || term === void 0 ? void 0 : term.name) !== null && _d !== void 0 ? _d : '';
             }
         }
-
-        const safeItem: IMenuItem = {
-            ...item,
-            menuItemAttributes
-        };
-
-        const node: Menu = {
+        const safeItem = Object.assign(Object.assign({}, item), { menuItemAttributes });
+        const node = {
             menuItem: safeItem,
             children: []
         };
-
         map.set(item.ID, node);
     }
-
     for (const item of menuItems) {
-        if (!item.menuItemAttributes) continue;
-
+        if (!item.menuItemAttributes)
+            continue;
         const currentNode = map.get(item.ID);
-        if (!currentNode) continue;
-
+        if (!currentNode)
+            continue;
         const parentId = item.menuItemAttributes.parentId;
-
         if (parentId === 0) {
             tree.push(currentNode);
             continue;
         }
-
         const parentNode = map.get(parentId);
-
         if (parentNode) {
             parentNode.children.push(currentNode);
             map.set(parentNode.menuItem.ID, parentNode);
         }
     }
-
     return tree;
 }

package/dist/services/get-theme-mods.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Retrieves a theme modification value by key.
+ *
+ * @param {string} key - The key of the theme modification to retrieve.
+ * @returns {Promise<unknown | undefined>} The theme modification value, or undefined if not found.
+ */
+export declare function getThemeMods(key: string): Promise<unknown | undefined>;

package/{lib/services/get-theme-mods.ts → dist/services/get-theme-mods.js}

@@ -1,16 +1,14 @@
 import { unserialize } from "php-serialize";
-
 /**
  * Retrieves a theme modification value by key.
  *
  * @param {string} key - The key of the theme modification to retrieve.
  * @returns {Promise<unknown | undefined>} The theme modification value, or undefined if not found.
  */
-export async function getThemeMods(key: string): Promise<unknown | undefined> {
+export async function getThemeMods(key) {
     const themeModOption = await getOption('theme_mods_nextpress_theme');
-
-    const themeMods: Record<string, unknown> | unknown[] = unserialize(themeModOption ?? 'a:0:{}');
-    if (Array.isArray(themeMods)) return;
-
+    const themeMods = unserialize(themeModOption !== null && themeModOption !== void 0 ? themeModOption : 'a:0:{}');
+    if (Array.isArray(themeMods))
+        return;
     return themeMods[key];
 }

package/dist/services/metadata/get-blogname.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Retrieves the blog name.
+ *
+ * @returns {Promise<string>} The blog name, defaulting to 'My Blog' if not found.
+ */
+export declare function getBlogname(): Promise<string>;

package/{lib/services/metadata/get-blogname.ts → dist/services/metadata/get-blogname.js}

@@ -3,7 +3,7 @@
  *
  * @returns {Promise<string>} The blog name, defaulting to 'My Blog' if not found.
  */
-export async function getBlogname(): Promise<string> {
+export async function getBlogname() {
     const blognameOption = await getOption('blogname');
-    return blognameOption ?? 'My Blog';
+    return blognameOption !== null && blognameOption !== void 0 ? blognameOption : 'My Blog';
 }

package/dist/services/metadata/get-favicon-url.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Retrieves the URL of the site favicon.
+ *
+ * @returns {Promise<string|undefined>} The URL of the favicon, or undefined if not set.
+ */
+export declare function getFaviconURL(): Promise<string | undefined>;

package/{lib/services/metadata/get-favicon-url.ts → dist/services/metadata/get-favicon-url.js}

@@ -3,11 +3,10 @@
  *
  * @returns {Promise<string|undefined>} The URL of the favicon, or undefined if not set.
  */
-export async function getFaviconURL(): Promise<string|undefined> {
+export async function getFaviconURL() {
     const iconID = await getOption('site_icon');
-    if (!iconID) return;
-
+    if (!iconID)
+        return;
     const iconMediaPost = await getPost(Number(iconID));
-
-    return iconMediaPost?.guid;
+    return iconMediaPost === null || iconMediaPost === void 0 ? void 0 : iconMediaPost.guid;
 }

package/dist/services/metadata/get-language-attribute.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Retrieves the language attribute.
+ *
+ * @returns {Promise<string>} The language attribute, defaulting to 'en_US' if not found.
+ */
+export declare function getLanguageAttributes(): Promise<string>;

package/{lib/services/metadata/get-language-attribute.ts → dist/services/metadata/get-language-attribute.js}

@@ -3,7 +3,7 @@
  *
  * @returns {Promise<string>} The language attribute, defaulting to 'en_US' if not found.
  */
-export async function getLanguageAttributes(): Promise<string> {
+export async function getLanguageAttributes() {
     const wplang = await getOption('WPLANG');
     return wplang || 'en_US';
 }

package/{lib/services/services.ts → dist/services/services.d.ts}

@@ -1,7 +1,3 @@
 import { getMenu } from "./get-menu";
 import { getThemeMods } from "./get-theme-mods";
-
-export {
-    getMenu,
-    getThemeMods
-}
+export { getMenu, getThemeMods };

package/dist/services/services.js

@@ -0,0 +1,3 @@
+import { getMenu } from "./get-menu";
+import { getThemeMods } from "./get-theme-mods";
+export { getMenu, getThemeMods };

package/dist/services/utilities/capitalise-first-letter.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Capitalizes the first letter of a string.
+ *
+ * @param {string} string - The string to process.
+ * @returns {string} The string with its first letter capitalized.
+ */
+export declare function capitalizeFirstLetter(string: string): string;

package/{lib/services/utilities/capitalise-first-letter.ts → dist/services/utilities/capitalise-first-letter.js}

@@ -4,7 +4,8 @@
  * @param {string} string - The string to process.
  * @returns {string} The string with its first letter capitalized.
  */
-export function capitalizeFirstLetter(string: string): string {
-    if (!string) return string;
+export function capitalizeFirstLetter(string) {
+    if (!string)
+        return string;
     return string.charAt(0).toUpperCase() + string.slice(1);
 }

package/dist/services/utilities/esc-html.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Sanitizes an HTML string.
+ *
+ * @param {string} string - The string to sanitize.
+ * @returns {string} The sanitized string.
+ */
+export declare function escHtml(string: string): string;

package/{lib/services/utilities/esc-html.ts → dist/services/utilities/esc-html.js}

@@ -1,12 +1,10 @@
 import DOMPurify from "isomorphic-dompurify";
-
 /**
  * Sanitizes an HTML string.
  *
  * @param {string} string - The string to sanitize.
  * @returns {string} The sanitized string.
  */
-export function escHtml(string: string) {
+export function escHtml(string) {
     return DOMPurify.sanitize(string);
 }
-

package/dist/services/utilities/get-date-time-formatter.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Creates a DateTimeFormat instance based on WordPress settings.
+ *
+ * @returns {Promise<Intl.DateTimeFormat>} The formatter instance.
+ */
+export declare function getDateTimeFormatter(): Promise<Intl.DateTimeFormat>;

package/{lib/services/utilities/get-date-time-formatter.ts → dist/services/utilities/get-date-time-formatter.js}

@@ -1,49 +1,39 @@
 import { getLanguageAttributes } from "../metadata/get-language-attribute";
-
 /**
  * Creates a DateTimeFormat instance based on WordPress settings.
  *
  * @returns {Promise<Intl.DateTimeFormat>} The formatter instance.
  */
-export async function getDateTimeFormatter(): Promise<Intl.DateTimeFormat> {
-    const dateFormat = await getOption('date_format') ?? 'F j, Y';
+export async function getDateTimeFormatter() {
+    var _a;
+    const dateFormat = (_a = await getOption('date_format')) !== null && _a !== void 0 ? _a : 'F j, Y';
     const lang = await getLanguageAttributes();
-
-    const dateTimeOptionsMap: Record<string, Intl.DateTimeFormatOptions> = {
+    const dateTimeOptionsMap = {
         'd': { day: '2-digit' },
         'j': { day: 'numeric' },
-
         'l': { weekday: 'long' },
         'D': { weekday: 'short' },
-
         'm': { month: '2-digit' },
         'n': { month: 'numeric' },
         'F': { month: 'long' },
         'M': { month: 'short' },
-
         'Y': { year: 'numeric' },
         'y': { year: '2-digit' },
-
         'a': { hour12: true },
         'A': { hour12: true },
-
         'g': { hour: 'numeric', hour12: true },
         'h': { hour: '2-digit', hour12: true },
         'G': { hour: 'numeric', hour12: false },
         'H': { hour: '2-digit', hour12: false },
-
         'i': { minute: '2-digit' },
         's': { second: '2-digit' },
-
         'T': { timeZoneName: 'short' }
     };
-
     const dateTimeOptions = dateFormat.split('').reduce((options, char) => {
         if (dateTimeOptionsMap[char]) {
-            return { ...options, ...dateTimeOptionsMap[char] };
+            return Object.assign(Object.assign({}, options), dateTimeOptionsMap[char]);
         }
         return options;
-    }, {} as Intl.DateTimeFormatOptions);
-
+    }, {});
     return new Intl.DateTimeFormat(lang.replace('_', '-'), dateTimeOptions);
 }

package/dist/services/utilities/index.js

@@ -0,0 +1 @@
+"use strict";

package/dist/services/utilities/kses-post.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Sanitizes and parses an HTML string into React elements.
+ *
+ * @param {string} html - The HTML string to process.
+ * @returns {string | JSX.Element | JSX.Element[]} The parsed React elements.
+ */
+export declare function wpKsesPost(html: string): string | import("react").JSX.Element | import("react").JSX.Element[];

package/{lib/services/utilities/kses-post.ts → dist/services/utilities/kses-post.js}

@@ -1,13 +1,12 @@
 import parse from 'html-react-parser';
 import DOMPurify from "isomorphic-dompurify";
-
 /**
  * Sanitizes and parses an HTML string into React elements.
  *
  * @param {string} html - The HTML string to process.
  * @returns {string | JSX.Element | JSX.Element[]} The parsed React elements.
  */
-export function wpKsesPost(html: string) {
+export function wpKsesPost(html) {
     const cleanHtml = DOMPurify.sanitize(html, { USE_PROFILES: { html: true } });
     return parse(cleanHtml);
 }

package/dist/services/utilities/process-url.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Processes a URL by stripping the site URL prefix if it is present.
+ *
+ * @param {string} url - The URL to process.
+ * @returns {string} The processed URL.
+ */
+export declare function processURL(url: string): string;

package/{lib/services/utilities/process-url.ts → dist/services/utilities/process-url.js}

@@ -4,12 +4,11 @@
  * @param {string} url - The URL to process.
  * @returns {string} The processed URL.
  */
-export function processURL(url: string): string {
-    if (!process.env.WP_SITE_URL) return url;
-
+export function processURL(url) {
+    if (!process.env.WP_SITE_URL)
+        return url;
     if (url.startsWith(process.env.WP_SITE_URL)) {
         url = url.slice(process.env.WP_SITE_URL.length);
     }
-
     return url || '/';
 }

package/dist/template-heirarchy/_autoloader/template-autoloader.d.ts

@@ -0,0 +1,9 @@
+import { Metadata } from 'next';
+/**
+ * Loads the exported metadata configuration for a given template.
+ *
+ * @param {string} template - The name of the template file to load metadata from.
+ * @returns {Promise<Metadata | undefined>} The metadata object, or undefined if the metadata does not exist.
+ */
+export declare function loadMetadata(template: string): Promise<Metadata | undefined>;
+export declare function loadTemplate(template: string): Promise<React.ComponentType<any> | undefined>;

package/{lib/template-heirarchy/_autoloader/template-autoloader.ts → dist/template-heirarchy/_autoloader/template-autoloader.js}

@@ -1,7 +1,5 @@
 import fs from 'fs';
-import { Metadata } from 'next';
 import path from 'path';
-
 /**
  * Loads a specified export suffix from a given template file.
  *
@@ -9,46 +7,39 @@ import path from 'path';
  * @param {'Metadata' | 'Template'} exportSuffix - The suffix of the export to retrieve from the file.
  * @returns {Promise<any | undefined>} The requested export, or undefined if not found or an error occurs.
  */
-async function loadFile(template: string, exportSuffix: 'Metadata' | 'Template'): Promise<any | undefined> {
+async function loadFile(template, exportSuffix) {
     const absolutePath = path.join(process.cwd(), 'src', 'app', '_templates');
     const files = fs.readdirSync(absolutePath);
-
-    const imports: any[] = [];
-
+    const imports = [];
     for (const file of files) {
-        if (file !== (`${template.toLowerCase()}.tsx`)) continue;
-
+        if (file !== (`${template.toLowerCase()}.tsx`))
+            continue;
         try {
             const imported = await import(`@/app/_templates/${file}`);
-
             const exported = imported[`${template}${exportSuffix}`];
-
             imports.push(exported);
-        } catch (_error) {
+        }
+        catch (_error) {
             return undefined;
         }
     }
-
     return imports[0];
 }
-
 /**
  * Loads the exported metadata configuration for a given template.
  *
  * @param {string} template - The name of the template file to load metadata from.
  * @returns {Promise<Metadata | undefined>} The metadata object, or undefined if the metadata does not exist.
  */
-export async function loadMetadata(template: string): Promise<Metadata | undefined> {
+export async function loadMetadata(template) {
     const metadataFn = await loadFile(template, 'Metadata');
     if (metadataFn) {
         return typeof metadataFn === 'function' ? metadataFn() : metadataFn;
     }
 }
-
-export async function loadTemplate(template: string): Promise<React.ComponentType<any> | undefined> {
+export async function loadTemplate(template) {
     const element = await loadFile(template, 'Template');
     if (element) {
-        return element as React.ComponentType<any>;
+        return element;
     }
 }
-

package/dist/template-heirarchy/archive/archive.d.ts

@@ -0,0 +1,16 @@
+import { Metadata } from "next";
+import { JSX } from "react";
+/**
+ * Loads the metadata for the Archive template.
+ * Fallback: Index
+ *
+ * @returns {Promise<Metadata>} The merged metadata object.
+ */
+export declare function ArchiveMetadata(): Promise<Metadata>;
+/**
+ * Renders the Archive template. Falls back to the Index template if not found.
+ * Fallback: Index
+ *
+ * @returns {Promise<JSX.Element>} The rendered template component.
+ */
+export declare function ArchiveTemplate(): Promise<JSX.Element>;