npm - elegance-js - Versions diffs - 1.0.0 - Mend

elegance-js 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (93) hide show

package/README.md +4 -0
package/dist/build.d.ts +22 -0
package/dist/build.mjs +1060 -0
package/dist/client/client.d.ts +1 -0
package/dist/client/client.mjs +272 -0
package/dist/client/watcher.d.ts +1 -0
package/dist/client/watcher.mjs +26 -0
package/dist/compile_docs.d.ts +1 -0
package/dist/compile_docs.mjs +1087 -0
package/dist/components/Breakpoint.d.ts +3 -0
package/dist/components/Breakpoint.mjs +17 -0
package/dist/components/Link.d.ts +1 -0
package/dist/components/Link.mjs +116 -0
package/dist/docs/components/Header.d.ts +1 -0
package/dist/docs/components/Header.mjs +219 -0
package/dist/docs/components/RootLayout.d.ts +1 -0
package/dist/docs/components/RootLayout.mjs +10 -0
package/dist/docs/docs/basics/page.d.ts +2 -0
package/dist/docs/docs/basics/page.mjs +1174 -0
package/dist/docs/docs/compilations/page.d.ts +2 -0
package/dist/docs/docs/compilations/page.mjs +15 -0
package/dist/docs/docs/components/CodeBlock.d.ts +2 -0
package/dist/docs/docs/components/CodeBlock.mjs +316 -0
package/dist/docs/docs/components/DocsLayout.d.ts +1 -0
package/dist/docs/docs/components/DocsLayout.mjs +465 -0
package/dist/docs/docs/components/Header.d.ts +1 -0
package/dist/docs/docs/components/Header.mjs +163 -0
package/dist/docs/docs/components/Mono.d.ts +1 -0
package/dist/docs/docs/components/Mono.mjs +7 -0
package/dist/docs/docs/components/PageHeading.d.ts +1 -0
package/dist/docs/docs/components/PageHeading.mjs +9 -0
package/dist/docs/docs/components/Paragraph.d.ts +1 -0
package/dist/docs/docs/components/Paragraph.mjs +10 -0
package/dist/docs/docs/components/Separator.d.ts +1 -0
package/dist/docs/docs/components/Separator.mjs +7 -0
package/dist/docs/docs/components/SubHeading.d.ts +1 -0
package/dist/docs/docs/components/SubHeading.mjs +8 -0
package/dist/docs/docs/components/SubSeparator.d.ts +1 -0
package/dist/docs/docs/components/SubSeparator.mjs +7 -0
package/dist/docs/docs/components/Subtext.d.ts +1 -0
package/dist/docs/docs/components/Subtext.mjs +8 -0
package/dist/docs/docs/concepts/page.d.ts +2 -0
package/dist/docs/docs/concepts/page.mjs +892 -0
package/dist/docs/docs/page-files/page.d.ts +2 -0
package/dist/docs/docs/page-files/page.mjs +1144 -0
package/dist/docs/docs/page.d.ts +2 -0
package/dist/docs/docs/page.mjs +49 -0
package/dist/docs/docs/route.d.ts +2 -0
package/dist/docs/docs/route.mjs +8 -0
package/dist/docs/docs/running/page.d.ts +2 -0
package/dist/docs/docs/running/page.mjs +7 -0
package/dist/docs/nullpage/page.d.ts +2 -0
package/dist/docs/nullpage/page.mjs +52 -0
package/dist/docs/page.d.ts +2 -0
package/dist/docs/page.mjs +405 -0
package/dist/docs/utils/MEGALEXER.d.ts +1 -0
package/dist/docs/utils/MEGALEXER.mjs +171 -0
package/dist/global.d.ts +290 -0
package/dist/global.mjs +0 -0
package/dist/helpers/ObjectAttributeType.d.ts +7 -0
package/dist/helpers/ObjectAttributeType.mjs +12 -0
package/dist/helpers/camelToKebab.d.ts +1 -0
package/dist/helpers/camelToKebab.mjs +7 -0
package/dist/index.d.ts +0 -0
package/dist/index.mjs +0 -0
package/dist/server/createReference.d.ts +6 -0
package/dist/server/createReference.mjs +18 -0
package/dist/server/createState.d.ts +47 -0
package/dist/server/createState.mjs +50 -0
package/dist/server/generateHTMLTemplate.d.ts +7 -0
package/dist/server/generateHTMLTemplate.mjs +222 -0
package/dist/server/layout.d.ts +3 -0
package/dist/server/layout.mjs +17 -0
package/dist/server/loadHook.d.ts +29 -0
package/dist/server/loadHook.mjs +28 -0
package/dist/server/observe.d.ts +19 -0
package/dist/server/observe.mjs +16 -0
package/dist/server/pageShimmer.d.ts +2 -0
package/dist/server/pageShimmer.mjs +5 -0
package/dist/server/render.d.ts +5 -0
package/dist/server/render.mjs +210 -0
package/dist/server/server.d.ts +9 -0
package/dist/server/server.mjs +184 -0
package/dist/shared/bindServerElements.d.ts +1 -0
package/dist/shared/bindServerElements.mjs +145 -0
package/dist/shared/serverElements.d.ts +11 -0
package/dist/shared/serverElements.mjs +165 -0
package/dist/types/Metadata.d.ts +19 -0
package/dist/types/Metadata.mjs +15 -0
package/package.json +38 -0
package/scripts/dev.js +25 -0
package/scripts/export.js +20 -0
package/scripts/prod.js +21 -0

package/dist/server/generateHTMLTemplate.mjs ADDED Viewed

@@ -0,0 +1,222 @@
+// src/shared/serverElements.ts
+var createBuildableElement = (tag) => {
+  return (options, ...children) => ({
+    tag,
+    options: options || {},
+    children
+  });
+};
+var createChildrenlessBuildableElement = (tag) => {
+  return (options) => ({
+    tag,
+    options: options || {},
+    children: null
+  });
+};
+var childrenlessElementTags = [
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "source",
+  "track",
+  "path",
+  "rect"
+];
+var elementTags = [
+  "a",
+  "address",
+  "article",
+  "aside",
+  "audio",
+  "blockquote",
+  "body",
+  "button",
+  "canvas",
+  "caption",
+  "colgroup",
+  "data",
+  "datalist",
+  "dd",
+  "del",
+  "details",
+  "dialog",
+  "div",
+  "dl",
+  "dt",
+  "fieldset",
+  "figcaption",
+  "figure",
+  "footer",
+  "form",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "head",
+  "header",
+  "hgroup",
+  "html",
+  "iframe",
+  "ins",
+  "label",
+  "legend",
+  "li",
+  "main",
+  "map",
+  "meter",
+  "nav",
+  "noscript",
+  "object",
+  "ol",
+  "optgroup",
+  "option",
+  "output",
+  "p",
+  "picture",
+  "pre",
+  "progress",
+  "q",
+  "section",
+  "select",
+  "summary",
+  "table",
+  "tbody",
+  "td",
+  "template",
+  "textarea",
+  "tfoot",
+  "th",
+  "thead",
+  "time",
+  "tr",
+  "ul",
+  "video",
+  "span",
+  "script",
+  "abbr",
+  "b",
+  "bdi",
+  "bdo",
+  "cite",
+  "code",
+  "dfn",
+  "em",
+  "i",
+  "kbd",
+  "mark",
+  "rp",
+  "rt",
+  "ruby",
+  "s",
+  "samp",
+  "small",
+  "strong",
+  "sub",
+  "sup",
+  "u",
+  "wbr",
+  "title",
+  "svg"
+];
+var elements = {};
+var childrenlessElements = {};
+for (const element of elementTags) {
+  elements[element] = createBuildableElement(element);
+}
+for (const element of childrenlessElementTags) {
+  childrenlessElements[element] = createChildrenlessBuildableElement(element);
+}
+var allElements = {
+  ...elements,
+  ...childrenlessElements
+};
+// src/shared/bindServerElements.ts
+Object.assign(globalThis, elements);
+Object.assign(globalThis, childrenlessElements);
+// src/server/render.ts
+var renderRecursively = (element) => {
+  let returnString = "";
+  if (typeof element === "boolean") return returnString;
+  else if (typeof element === "number" || typeof element === "string") {
+    return returnString + element;
+  } else if (Array.isArray(element)) {
+    return returnString + element.join(", ");
+  }
+  returnString += `<${element.tag}`;
+  const {
+    tag: elementTag,
+    options: elementOptions,
+    children: elementChildren
+  } = element.options;
+  if (elementTag && elementOptions && elementChildren) {
+    const children = element.children;
+    element.children = [
+      element.options,
+      ...children
+    ];
+    element.options = {};
+    for (let i = 0; i < children.length + 1; i++) {
+      const child = element.children[i];
+      returnString += renderRecursively(child);
+    }
+    returnString += `</${element.tag}>`;
+    return returnString;
+  }
+  if (typeof element.options === "object") {
+    for (const [attrName, attrValue] of Object.entries(element.options)) {
+      if (typeof attrValue === "object") {
+        throw `Attr ${attrName}, for element ${element.tag} has obj type. Got: ${JSON.stringify(element)}`;
+      }
+      returnString += ` ${attrName.toLowerCase()}="${attrValue}"`;
+    }
+  }
+  if (element.children === null) {
+    returnString += "/>";
+    return returnString;
+  }
+  returnString += ">";
+  for (const child of element.children) {
+    returnString += renderRecursively(child);
+  }
+  returnString += `</${element.tag}>`;
+  return returnString;
+};
+// src/server/generateHTMLTemplate.ts
+var generateHTMLTemplate = ({
+  pageURL,
+  head,
+  serverData = null,
+  addPageScriptTag = true,
+  name
+}) => {
+  let HTMLTemplate = `<head><meta name="viewport" content="width=device-width, initial-scale=1.0">`;
+  HTMLTemplate += '<meta http-equiv="Content-Security-Policy" content="upgrade-insecure-requests"><meta charset="UTF-8">';
+  if (addPageScriptTag === true) {
+    HTMLTemplate += `<script data-tag="true" type="module" src="${pageURL === "" ? "" : "/"}${pageURL}/${name}_data.js" defer="true"></script>`;
+  }
+  HTMLTemplate += `<script stype="module" src="/client.js" defer="true"></script>`;
+  const builtHead = head();
+  for (const child of builtHead.children) {
+    HTMLTemplate += renderRecursively(child);
+  }
+  if (serverData) {
+    HTMLTemplate += serverData;
+  }
+  HTMLTemplate += "</head>";
+  return HTMLTemplate;
+};
+export {
+  generateHTMLTemplate
+};

package/dist/server/layout.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export declare const resetLayouts: () => Map<any, any>;
+export declare const getLayouts: () => Map<string, number>;
+export declare const createLayout: (name: string) => number | undefined;

package/dist/server/layout.mjs ADDED Viewed

@@ -0,0 +1,17 @@
+// src/server/layout.ts
+var resetLayouts = () => globalThis.__SERVER_CURRENT_LAYOUTS__ = /* @__PURE__ */ new Map();
+var getLayouts = () => globalThis.__SERVER_CURRENT_LAYOUTS__;
+if (!globalThis.__SERVER_CURRENT_LAYOUT_ID__) globalThis.__SERVER_CURRENT_LAYOUT_ID__ = 1;
+var layoutId = globalThis.__SERVER_CURRENT_LAYOUT_ID__;
+var createLayout = (name) => {
+  const layouts = globalThis.__SERVER_CURRENT_LAYOUTS__;
+  if (layouts.has(name)) return layouts.get(name);
+  const id = layoutId++;
+  layouts.set(name, id);
+  return id;
+};
+export {
+  createLayout,
+  getLayouts,
+  resetLayouts
+};

package/dist/server/loadHook.d.ts ADDED Viewed

@@ -0,0 +1,29 @@
+import { ObjectAttributeType } from "../helpers/ObjectAttributeType";
+type ClientSubjectGeneric<T> = Omit<ClientSubject, "value"> & {
+    value: T;
+};
+type ServerSubject = {
+    type: ObjectAttributeType;
+    value: unknown;
+    id: number;
+    bind?: string;
+};
+type LoadHookOptions<T extends ServerSubject[]> = {
+    bind?: number | undefined;
+    deps?: [...T];
+    fn: (state: State, ...subjects: {
+        [K in keyof T]: ClientSubjectGeneric<T[K]["value"]>;
+    }) => void;
+};
+export type LoadHook = {
+    fn: string;
+    bind: number;
+};
+export type ClientLoadHook = {
+    bind: number;
+    fn: (state: State) => (void | (() => void) | Promise<(void | (() => void))>);
+};
+export declare const resetLoadHooks: () => never[];
+export declare const getLoadHooks: () => any[];
+export declare const createLoadHook: <T extends ServerSubject[]>(options: LoadHookOptions<T>) => void;
+export {};

package/dist/server/loadHook.mjs ADDED Viewed

@@ -0,0 +1,28 @@
+// src/server/loadHook.ts
+var resetLoadHooks = () => globalThis.__SERVER_CURRENT_LOADHOOKS__ = [];
+var getLoadHooks = () => globalThis.__SERVER_CURRENT_LOADHOOKS__;
+var createLoadHook = (options) => {
+  const stringFn = options.fn.toString();
+  const deps = (options.deps || []).map((dep) => ({
+    id: dep.id,
+    bind: dep.bind
+  }));
+  let dependencyString = "[";
+  for (const dep of deps) {
+    dependencyString += `{id:${dep.id}`;
+    if (dep.bind) dependencyString += `,bind:${dep.bind}`;
+    dependencyString += `},`;
+  }
+  dependencyString += "]";
+  const isAsync = options.fn.constructor.name === "AsyncFunction";
+  const wrapperFn = isAsync ? `async (state) => await (${stringFn})(state, ...state.getAll(${dependencyString}))` : `(state) => (${stringFn})(state, ...state.getAll(${dependencyString}))`;
+  globalThis.__SERVER_CURRENT_LOADHOOKS__.push({
+    fn: wrapperFn,
+    bind: options.bind || ""
+  });
+};
+export {
+  createLoadHook,
+  getLoadHooks,
+  resetLoadHooks
+};

package/dist/server/observe.d.ts ADDED Viewed

@@ -0,0 +1,19 @@
+import { ObjectAttributeType } from "../helpers/ObjectAttributeType";
+export declare const observe: <T extends {
+    type: ObjectAttributeType;
+    value: unknown;
+    id: string | number;
+    bind?: string;
+}[]>(refs: [...T], update: (...values: { [K in keyof T]: T[K] extends {
+    value: infer V;
+} ? V : never; }) => (string | number)) => {
+    type: ObjectAttributeType;
+    initialValues: unknown[];
+    update: (...values: { [K in keyof T]: T[K] extends {
+        value: infer V;
+    } ? V : never; }) => (string | number);
+    refs: {
+        id: string | number;
+        bind: string | undefined;
+    }[];
+};

package/dist/server/observe.mjs ADDED Viewed

@@ -0,0 +1,16 @@
+// src/server/observe.ts
+var observe = (refs, update) => {
+  const returnValue = {
+    type: 2 /* OBSERVER */,
+    initialValues: refs.map((ref) => ref.value),
+    update,
+    refs: refs.map((ref) => ({
+      id: ref.id,
+      bind: ref.bind
+    }))
+  };
+  return returnValue;
+};
+export {
+  observe
+};

package/dist/server/pageShimmer.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ declare const marker = "";
2	+ export { marker as "__ELEGANCE_PAGE_DESIGNATOR__" };

package/dist/server/pageShimmer.mjs ADDED Viewed

@@ -0,0 +1,5 @@
+// src/server/pageShimmer.ts
+var marker = "";
+export {
+  marker as __ELEGANCE_PAGE_DESIGNATOR__
+};

package/dist/server/render.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+import "../shared/bindServerElements";
+export declare const renderRecursively: (element: Child) => string;
+export declare const serverSideRenderPage: (page: Page, pathname: string) => Promise<{
+    bodyHTML: string;
+}>;

package/dist/server/render.mjs ADDED Viewed

@@ -0,0 +1,210 @@
+// src/shared/serverElements.ts
+var createBuildableElement = (tag) => {
+  return (options, ...children) => ({
+    tag,
+    options: options || {},
+    children
+  });
+};
+var createChildrenlessBuildableElement = (tag) => {
+  return (options) => ({
+    tag,
+    options: options || {},
+    children: null
+  });
+};
+var childrenlessElementTags = [
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "source",
+  "track",
+  "path",
+  "rect"
+];
+var elementTags = [
+  "a",
+  "address",
+  "article",
+  "aside",
+  "audio",
+  "blockquote",
+  "body",
+  "button",
+  "canvas",
+  "caption",
+  "colgroup",
+  "data",
+  "datalist",
+  "dd",
+  "del",
+  "details",
+  "dialog",
+  "div",
+  "dl",
+  "dt",
+  "fieldset",
+  "figcaption",
+  "figure",
+  "footer",
+  "form",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "head",
+  "header",
+  "hgroup",
+  "html",
+  "iframe",
+  "ins",
+  "label",
+  "legend",
+  "li",
+  "main",
+  "map",
+  "meter",
+  "nav",
+  "noscript",
+  "object",
+  "ol",
+  "optgroup",
+  "option",
+  "output",
+  "p",
+  "picture",
+  "pre",
+  "progress",
+  "q",
+  "section",
+  "select",
+  "summary",
+  "table",
+  "tbody",
+  "td",
+  "template",
+  "textarea",
+  "tfoot",
+  "th",
+  "thead",
+  "time",
+  "tr",
+  "ul",
+  "video",
+  "span",
+  "script",
+  "abbr",
+  "b",
+  "bdi",
+  "bdo",
+  "cite",
+  "code",
+  "dfn",
+  "em",
+  "i",
+  "kbd",
+  "mark",
+  "rp",
+  "rt",
+  "ruby",
+  "s",
+  "samp",
+  "small",
+  "strong",
+  "sub",
+  "sup",
+  "u",
+  "wbr",
+  "title",
+  "svg"
+];
+var elements = {};
+var childrenlessElements = {};
+for (const element of elementTags) {
+  elements[element] = createBuildableElement(element);
+}
+for (const element of childrenlessElementTags) {
+  childrenlessElements[element] = createChildrenlessBuildableElement(element);
+}
+var allElements = {
+  ...elements,
+  ...childrenlessElements
+};
+// src/shared/bindServerElements.ts
+Object.assign(globalThis, elements);
+Object.assign(globalThis, childrenlessElements);
+// src/server/render.ts
+var renderRecursively = (element) => {
+  let returnString = "";
+  if (typeof element === "boolean") return returnString;
+  else if (typeof element === "number" || typeof element === "string") {
+    return returnString + element;
+  } else if (Array.isArray(element)) {
+    return returnString + element.join(", ");
+  }
+  returnString += `<${element.tag}`;
+  const {
+    tag: elementTag,
+    options: elementOptions,
+    children: elementChildren
+  } = element.options;
+  if (elementTag && elementOptions && elementChildren) {
+    const children = element.children;
+    element.children = [
+      element.options,
+      ...children
+    ];
+    element.options = {};
+    for (let i = 0; i < children.length + 1; i++) {
+      const child = element.children[i];
+      returnString += renderRecursively(child);
+    }
+    returnString += `</${element.tag}>`;
+    return returnString;
+  }
+  if (typeof element.options === "object") {
+    for (const [attrName, attrValue] of Object.entries(element.options)) {
+      if (typeof attrValue === "object") {
+        throw `Attr ${attrName}, for element ${element.tag} has obj type. Got: ${JSON.stringify(element)}`;
+      }
+      returnString += ` ${attrName.toLowerCase()}="${attrValue}"`;
+    }
+  }
+  if (element.children === null) {
+    returnString += "/>";
+    return returnString;
+  }
+  returnString += ">";
+  for (const child of element.children) {
+    returnString += renderRecursively(child);
+  }
+  returnString += `</${element.tag}>`;
+  return returnString;
+};
+var serverSideRenderPage = async (page, pathname) => {
+  if (!page) {
+    throw `No Page Provided.`;
+  }
+  if (typeof page === "function") {
+    throw `Unbuilt page provided to ssr page.`;
+  }
+  const bodyHTML = renderRecursively(page);
+  return {
+    bodyHTML
+  };
+};
+export {
+  renderRecursively,
+  serverSideRenderPage
+};

package/dist/server/server.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import { IncomingMessage, ServerResponse } from 'http';
+interface ServerOptions {
+    root: string;
+    port?: number;
+    host?: string;
+    environment?: 'production' | 'development';
+}
+export declare function startServer({ root, port, host, environment }: ServerOptions): import("http").Server<typeof IncomingMessage, typeof ServerResponse>;
+export {};