@alanizcreative/formation-static 0.0.1

package/lib/wordpress/wordpressDataNormal.d.ts

@@ -0,0 +1,9 @@
+import type { WordPressDataItem, WordPressDataMenuItem, WordPressDataMenu } from './wordpressDataTypes.js';
+import type { RenderItem } from '../render/renderTypes.js';
+import type { NavigationList, NavigationItem } from '../components/Navigation/NavigationTypes.js';
+declare const normalRoutes: Map<string, string>;
+declare const normalMetaKeys: Map<string, string>;
+declare const normalizeWordPressMenuItems: (items: WordPressDataMenuItem[]) => NavigationItem[];
+declare const normalizeWordPressMenus: (menus: WordPressDataMenu[]) => NavigationList[];
+declare const normalizeWordPressData: (data: WordPressDataItem[], route?: string, _newData?: RenderItem[]) => RenderItem[];
+export { normalizeWordPressData, normalizeWordPressMenuItems, normalizeWordPressMenus, normalRoutes, normalMetaKeys };

package/lib/wordpress/wordpressDataNormal.js

@@ -0,0 +1 @@
+import{parse}from"@wordpress/block-serialization-default-parser";import{normalizeContentType}from"../utils/contentType/contentType.js";import{getObjectKeys}from"../utils/object/objectUtils.js";import{getStoreItem,setStoreItem}from"../store/store.js";import{isString,isStringStrict}from"../utils/string/string.js";import{isArrayStrict}from"../utils/array/array.js";import{isObjectStrict}from"../utils/object/object.js";import{isNumber}from"../utils/number/number.js";import{config}from"../config/config.js";const normalRoutes=new Map([["page","pages"],["post","posts"],["taxonomy","taxonomies"],["category","categories"],["tag","tags"],["attachment","media"],["nav_menu","menus"],["nav_menu_item","menu-items"]]),normalMetaKeys=new Map,menusById=new Map,excludeProps=["_links","auto_add"],getTaxonomy=id=>{const taxonomy=getStoreItem("taxonomies")[id],{title:title="",slug:slug="",contentTypes:contentTypes=[]}=isObjectStrict(taxonomy)?taxonomy:{};return{id:id,title:title,slug:slug,contentTypes:contentTypes}},normalizeFile=file=>{const{url:url,filename:filename,alt:alt,width:width,height:height,filesizeInBytes:filesizeInBytes,subtype:subtype,mime:mime,sizes:sizes}=file;let newSizes;if(isObjectStrict(sizes)){newSizes={};for(const[,value]of Object.entries(sizes)){const{width:width,source_url:src}=value;let{url:url}=value;isStringStrict(src)&&(url=src),isNumber(width)&&isStringStrict(url)&&(newSizes[width]=url)}}return{url:isString(url)?url:"",name:isString(filename)?filename:"",alt:isString(alt)?alt:"",width:isNumber(width)?width:0,height:isNumber(height)?height:0,size:isNumber(filesizeInBytes)?filesizeInBytes:0,format:"jpeg"===subtype?"jpg":subtype,type:mime,sizes:newSizes}},normalizeEmbedded=(value,item,newItem)=>{getObjectKeys(value).forEach(k=>{const embeds=value[k];if(isArrayStrict(embeds)){if("author"===k){const exclude=[...excludeProps,"id","avatar_urls"];embeds.forEach(embed=>{if(!isObjectStrict(embed))return;const{id:id}=embed;if(item.author!==id)return;const newAuthor={id:id.toString()};Object.entries(embed).forEach(([key,val])=>{exclude.includes(key)||(newAuthor[key]=val)}),newItem.author=newAuthor})}if("up"===k&&embeds.forEach(embed=>{if(!isObjectStrict(embed))return;const{id:id,title:parentTitle,name:name,type:type,taxonomy:taxonomy,slug:slug}=embed;if(item.parent!==id)return;let title="";isString(parentTitle?.rendered)&&(title=parentTitle.rendered),isString(name)&&(title=name),newItem.parent={id:id.toString(),contentType:isString(taxonomy)?"term":type,title:title,slug:slug}}),"wp:featuredmedia"===k&&embeds.forEach(embed=>{if(!isObjectStrict(embed))return;const{id:id,source_url:url,media_details:details,mime_type:mimeType,alt_text:alt}=embed;if(!isObjectStrict(details))return;const{file:file,filesize:filesize,width:width,height:height,sizes:sizes}=details;item.featured_media===id&&(newItem.featured_media=normalizeFile({url:url,filename:file?.split("/").pop(),alt:alt,width:width,height:height,filesizeInBytes:filesize,subtype:mimeType?.split("/").pop(),mime:mimeType,sizes:sizes}))}),"wp:term"===k){const exclude=[...excludeProps,"id","name","taxonomy"];embeds.forEach(embed=>{isArrayStrict(embed)&&embed.forEach(e=>{if(!isObjectStrict(e))return;const{id:id,name:name,taxonomy:taxonomy=""}=e;let taxonomyLookup=taxonomy;"category"===taxonomy&&(taxonomyLookup="categories"),"post_tag"===taxonomy&&(taxonomyLookup="tags");const itemTaxonomy=newItem[taxonomyLookup]??item[taxonomyLookup];isArrayStrict(itemTaxonomy)&&(newItem[taxonomyLookup]=itemTaxonomy.map(taxonomyId=>{if(taxonomyId!==id)return taxonomyId;const newTerm={id:id.toString(),title:name,contentType:"term",taxonomy:getTaxonomy(taxonomy)};return Object.entries(e).forEach(([key,val])=>{exclude.includes(key)||(newTerm[key]=val)}),newTerm}))})})}}})},normalizeBlocks=blocks=>{const newItems=[];return blocks.forEach(block=>{const{blockName:blockName,attrs:attrs,innerBlocks:innerBlocks}=block,contentType=blockName;if(!isStringStrict(contentType))return;const{isItem:isItem}=attrs,attrItemArr=(isStringStrict(isItem)?isItem:"").split(","),attrItemExists=attrItemArr.length;for(const[key,value]of Object.entries(attrs))if(isObjectStrict(value)){if(attrItemExists&&attrItemArr.includes(key)){const itemValue=normalizeItem(value);itemValue.content=void 0,attrs[key]=itemValue}isStringStrict(value.mime)&&(attrs[key]=normalizeFile(value))}const newItem={contentType:contentType,...attrs},renderType=config.renderTypes[contentType];return isString(renderType)&&(newItem.renderType=renderType),isArrayStrict(innerBlocks)&&(newItem.content=normalizeBlocks(innerBlocks)),newItems.push(newItem)}),newItems},normalizeItem=item=>{const newItem={};for(const[key,value]of Object.entries(item)){if(excludeProps.includes(key))continue;let val=value,k=key;const isObj=isObjectStrict(value),isStr=isStringStrict(value);if("id"!==key&&"object_id"!==k||(val=value?.toString()),"type"===key&&isStr)newItem.contentType=normalizeContentType(value),isString(config.renderTypes[value])&&(newItem.renderType=config.renderTypes[value]);else{if("types"===key&&(k="contentTypes"),isObj){const{rendered:rendered}=value;isString(rendered)&&(val=rendered)}if("name"===key&&(k="title"),"_embedded"===key&&isObj)normalizeEmbedded(value,item,newItem);else{if(isStringStrict(val)){if("excerpt"===key&&(val=val.replace(/<[^>]*>|\[.*?\]/g,"").trim()),"content"===key){const normalVal=normalizeBlocks(parse(val));val=normalVal.length?normalVal:val}"taxonomy"===key&&(newItem.contentType="term",val=getTaxonomy(val))}if("meta"===key&&isObj)for(const[metaKey,metaValue]of Object.entries(val)){newItem[normalMetaKeys.get(metaKey)??metaKey]=metaValue}else{if("media_details"===k&&isObj){const valObj=val,valFull=valObj.sizes?.full,sourceUrl=item.source_url,mimeType=item.mime_type;val=normalizeFile({url:sourceUrl,filename:sourceUrl?.split("/").pop(),alt:item.alt_text,width:valFull?.width,height:valFull?.height,filesizeInBytes:valObj.filesize,subtype:mimeType?.split("/")[1],mime:mimeType,sizes:valObj.sizes})}newItem[k]=val}}}}return newItem},normalizeWordPressMenuItems=items=>{const itemsObj=Object.fromEntries(items.map(item=>[item.id,item]));menusById.clear(),items.forEach(item=>{const{id:id="",title:title="",menu_order:menu_order=0,menus:menus=0}=item,parent=item.parent,hasMenuOrder=isNumber(menu_order);if(hasMenuOrder&&isObjectStrict(itemsObj[parent])&&(null==itemsObj[parent].children&&(itemsObj[parent].children=[]),itemsObj[parent].children.push({id:id,menu_order:menu_order,title:title})),hasMenuOrder&&isNumber(menus)&&0===parent){const menuId=menus.toString();null==menusById.get(menuId)&&menusById.set(menuId,[]),menusById.get(menuId)?.push({id:id,menu_order:menu_order,title:title})}});const newItems=[];for(const[id,obj]of Object.entries(itemsObj)){const{url:url="",title:title="",contentType:contentType="",children:children=[],object:object="",object_id:object_id="",locale:locale=""}=obj;if(!isString(url)||!isStringStrict(title))continue;const newItem={id:id,title:title},isCustom="custom"===contentType;if(!isCustom&&isStringStrict(object)&&isStringStrict(object_id)){const isTerm="taxonomy"===contentType,internalLink={contentType:isTerm?"term":object,id:object_id,slug:url.split("/").filter(Boolean).pop()};isTerm&&(internalLink.taxonomy=getTaxonomy(object)),isStringStrict(locale)&&(internalLink.locale=locale),newItem.link=url,newItem.internalLink=internalLink}if(isCustom){url.startsWith("http")&&!url.startsWith(config.env.prodUrl)?newItem.externalLink=url:newItem.link=url}isArrayStrict(children)&&(newItem.children=children.sort((a,b)=>a.menu_order-b.menu_order));const exclude=[...excludeProps,"url","type","type_label","object","object_id","invalid","meta","menu_order","menus","parent","contentType","status"];Object.entries(obj).forEach(([key,val])=>{exclude.includes(key)||(newItem[key]=val)}),newItems.push(newItem)}return newItems},normalizeWordPressMenus=menus=>{const newMenus=[];return menus.forEach(menu=>{const{id:id="",title:title="",description:description="",locations:locations=[],meta:meta=[]}=menu,newMenu={id:id,title:title,description:description,meta:meta,location:locations,items:menusById.get(id)?.sort((a,b)=>a.menu_order-b.menu_order)??[]};newMenus.push(newMenu)}),newMenus},normalizeWordPressData=(data,route,_newData=[])=>isArrayStrict(data)?("taxonomies"===route&&(data=Object.entries(data[0]).map(([key,value])=>({id:key,type:"taxonomy",...value}))),data.forEach(item=>{isObjectStrict(item)&&_newData.push(normalizeItem(item))}),"taxonomies"===route&&_newData.forEach(item=>{setStoreItem("taxonomies",item,item.id)}),_newData):[];export{normalizeWordPressData,normalizeWordPressMenuItems,normalizeWordPressMenus,normalRoutes,normalMetaKeys};

package/lib/wordpress/wordpressDataTypes.d.ts

@@ -0,0 +1,208 @@
+import type { Generic, GenericStrings } from '../global/globalTypes.js';
+import type { NavigationItem } from '../components/Navigation/NavigationTypes.js';
+import type { RenderServerlessData, RenderPreviewData, RenderItem } from '../render/renderTypes.js';
+export type WordPressDataParams = Record<string, string | number | boolean>;
+interface WordPressDataErrorData {
+    status?: number;
+    params?: GenericStrings;
+    details?: Generic;
+}
+export interface WordPressDataError {
+    code?: string;
+    message?: string;
+    data?: WordPressDataErrorData;
+}
+export type WordPressDataStatus = 'publish' | 'draft' | 'future' | 'pending' | 'private' | 'trash' | 'auto-draft' | 'inherit';
+export interface WordPressDataRendered {
+    rendered?: string;
+}
+export interface WordPressDataRenderedProtected {
+    rendered?: string;
+    protected?: boolean;
+}
+export interface WordPressDataMenuChild extends NavigationItem {
+    menu_order: number;
+}
+export interface WordPressDataMenuItem extends RenderItem {
+    children?: WordPressDataMenuChild[];
+}
+export interface WordPressDataMenu extends RenderItem {
+    name?: string;
+    locations?: string[];
+}
+export interface WordPressDataAuthor {
+    id: number;
+    name?: string;
+    url?: string;
+    description?: string;
+    link?: string;
+    slug?: string;
+}
+export interface WordPressDataMediaDetails {
+    width?: number;
+    height?: number;
+    filesize?: number;
+    file?: string;
+    sizes?: Record<string, WordPressDataMediaSize>;
+}
+export interface WordPressDataMediaSize {
+    source_url?: string;
+    mime_type?: string;
+    file?: string;
+    filesize?: number;
+    width?: number;
+    height?: number;
+}
+export interface WordPressDataFeaturedMedia {
+    id: number;
+    source_url?: string;
+    alt_text?: string;
+    caption?: WordPressDataRendered;
+    media_type?: string;
+    mime_type?: string;
+    media_details?: WordPressDataMediaDetails;
+}
+export interface WordPressDataTerm {
+    id: number;
+    link?: string;
+    name?: string;
+    slug?: string;
+    taxonomy?: string;
+}
+export interface WordPressDataAttachment {
+    id: number;
+    source_url?: string;
+    title?: WordPressDataRendered;
+    media_type?: string;
+    mime_type?: string;
+}
+export interface WordPressDataParent {
+    id: number;
+    title?: WordPressDataRendered;
+    excerpt?: WordPressDataRendered;
+    slug?: string;
+    type?: string;
+    link?: string;
+    author?: number;
+    featured_media?: number;
+    name?: string;
+    taxonomy?: string;
+}
+export interface WordPressDataEmbedded {
+    author?: WordPressDataAuthor[];
+    up?: WordPressDataParent[];
+    'wp:featuredmedia'?: WordPressDataFeaturedMedia[];
+    'wp:attachment'?: WordPressDataAttachment[];
+    'wp:term'?: WordPressDataTerm[][];
+}
+export interface WordPressDataLink {
+    href: string;
+    name?: string;
+    templated?: boolean;
+    count?: number;
+    taxonomy?: string;
+    embeddable?: boolean;
+}
+export interface WordPressDataLinks {
+    self: WordPressDataLink[];
+    collection: WordPressDataLink[];
+    about: WordPressDataLink[];
+    'version-history': WordPressDataLink[];
+    'wp:attachment': WordPressDataLink[];
+    'wp:term': WordPressDataLink[];
+    curies: WordPressDataLink[];
+}
+export interface WordPressDataFileSize {
+    height?: number;
+    width?: number;
+    url?: string;
+    source_url?: string;
+    orientation?: string;
+}
+interface WordPressDataFileNonces {
+    update: string;
+    delete: string;
+    edit: string;
+}
+export interface WordPressDataFile {
+    contentType?: string;
+    id?: number;
+    title?: string;
+    filename?: string;
+    url?: string;
+    link?: string;
+    alt?: string;
+    author?: string;
+    description?: string;
+    caption?: string;
+    name?: string;
+    status?: string;
+    uploadedTo?: number;
+    date?: string;
+    modified?: string;
+    menuOrder?: number;
+    mime?: string;
+    type?: string;
+    subtype?: string;
+    icon?: string;
+    dateFormatted?: string;
+    nonces?: WordPressDataFileNonces;
+    editLink?: string;
+    meta?: boolean;
+    authorName?: string;
+    authorLink?: string;
+    filesizeInBytes?: number;
+    filesizeHumanReadable?: string;
+    context?: string;
+    height?: number;
+    width?: number;
+    orientation?: string;
+    sizes?: Record<string, WordPressDataFileSize>;
+}
+export interface WordPressDataMeta extends Generic {
+    footnotes?: string;
+}
+export interface WordPressDataItem extends Partial<WordPressDataFeaturedMedia>, Generic {
+    id?: number;
+    date?: string;
+    date_gmt?: string;
+    guid?: WordPressDataRendered;
+    modified?: string;
+    modified_gmt?: string;
+    slug?: string;
+    status?: WordPressDataStatus;
+    type?: string;
+    link?: string;
+    title?: WordPressDataRendered;
+    content?: WordPressDataRenderedProtected;
+    excerpt?: WordPressDataRenderedProtected;
+    author?: number;
+    featured_media?: number;
+    parent?: number;
+    menu_order?: number;
+    comment_status?: string;
+    ping_status?: string;
+    sticky?: boolean;
+    template?: string;
+    format?: string;
+    meta?: WordPressDataMeta;
+    categories?: number[];
+    tags?: number[];
+    class_list?: string[];
+    taxonomy?: string;
+    name?: string;
+    _links?: WordPressDataLinks;
+    _embedded?: WordPressDataEmbedded;
+}
+export interface WordPressDataArgs {
+    key: string;
+    route: string;
+    params?: WordPressDataParams;
+    fetcher?: typeof fetch;
+    options?: RequestInit;
+}
+export interface AllWordPressDataArgs {
+    serverlessData?: RenderServerlessData;
+    previewData?: RenderPreviewData;
+}
+export {};

package/lib/wordpress/wordpressDataTypes.js

@@ -0,0 +1 @@
+export{};

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@alanizcreative/formation-static",
+  "version": "0.0.1",
+  "description": "Minimal static-site HTML renderer from JSON, Contentful, or WordPress data",
+  "main": "./lib/config/config.js",
+  "packageManager": "pnpm@10.23.0",
+  "type": "module",
+  "files": [
+    "./lib",
+    "./cjs"
+  ],
+  "exports": {
+    "./*": {
+      "import": "./lib/*",
+      "require": "./cjs/*"
+    }
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build:lib": "npx tsc --project tsconfig.build.json",
+    "build:cjs": "npx tsc --project tsconfig.build.json --moduleResolution node --module commonjs --esModuleInterop --outDir cjs/",
+    "build": "pnpm build:lib && pnpm build:cjs && node scripts/packageFile.js && pnpm minify",
+    "minify": "find lib cjs -name \"*.js\" -exec terser {} -o {} --compress \\;",
+    "test": "vitest --run --reporter verbose --coverage",
+    "lint": "npx eslint .",
+    "release": "release-it"
+  },
+  "keywords": [
+    "static-site",
+    "renderer",
+    "html",
+    "nodejs"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/galaniz/formation-static.git"
+  },
+  "bugs": {
+    "url": "https://github.com/galaniz/formation-static/issues"
+  },
+  "homepage": "https://github.com/galaniz/formation-static#readme",
+  "author": "Graciela Alaniz (https://alanizcreative.com/)",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/contentful-resolve-response": "^0.1.33",
+    "@types/node": "^24.10.1",
+    "@vitest/coverage-v8": "^4.0.13",
+    "eslint": "9.39.1",
+    "memfs": "4.51.0",
+    "release-it": "^19.0.6",
+    "terser": "5.44.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "8.47.0",
+    "vitest": "^4.0.13"
+  },
+  "dependencies": {
+    "uuid": "^13.0.0"
+  },
+  "peerDependencies": {
+    "@wordpress/block-serialization-default-parser": "^5.25.0",
+    "contentful-resolve-response": "^1.9.3",
+    "sharp": "0.34.2"
+  },
+  "peerDependenciesMeta": {
+    "@wordpress/block-serialization-default-parser": {
+      "optional": true
+    },
+    "contentful-resolve-response": {
+      "optional": true
+    },
+    "sharp": {
+      "optional": true
+    }
+  },
+  "release-it": {
+    "git": {
+      "requireCommits": true,
+      "commitMessage": "chore: release ${version} [ci skip]",
+      "tag": true,
+      "push": true
+    },
+    "github": {
+      "release": true
+    },
+    "npm": {
+      "publish": true,
+      "skipChecks": true
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}