@aglyn/aglyn 1.0.0-beta.143

package/src/lib/types/nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/types/nodes.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ConditionDefinition,\n  DataType,\n  Validator,\n} from '@data-driven-forms/react-form-renderer'\nimport type {\n  FieldActions,\n  ResolvePropsFunction,\n} from '@data-driven-forms/react-form-renderer/common-types'\nimport type { MuiStyledOptions } from '@mui/system/createStyled'\nimport type { SvgIconProps } from '@mui/material/SvgIcon'\n/** Minimal icon-props type used in component/preset schemas. Structurally compatible with @aglyn/shared-ui-jsx MdiIconProps. */\nexport type MdiIconProps<D extends React.ElementType = 'svg', P = object> = SvgIconProps<D, P> & {\n  path?: string\n}\nimport type {\n  ComponentId,\n  ComponentsLinealOrder,\n  NodeId,\n  PresetId,\n} from '../foundation'\nimport { ComponentCategory } from '../foundation/constants/components'\nimport type { ITimestamp } from '@aglyn/shared-util-timestamp'\nimport type React from 'react'\nimport type { ComponentClass, ComponentProps } from 'react'\nimport type { NODE_ROOT_ID } from '../canvas-manager'\nimport type { NodeInteraction } from '../app-utils/node-interactions'\n\nimport type {\n  FEATURE_FLAG,\n  FieldComponentType,\n  RICH_TEXT_COMMANDS,\n} from '../foundation'\nimport type { PluginId } from '../plugin-manager'\nimport type { ElementContentMap, Node, Props, Taxonomic } from './ast'\nimport type { AglynDocument } from '../foundation'\nimport type { HostUid } from '../foundation'\n\ndeclare module './ast' {\n  /**\n   * This map registers all node types that may be used as top-level content in\n   * the document.\n   *\n   * These types are accepted inside `root` nodes.\n   *\n   * This interface can be augmented to register custom node types.\n   *\n   * @example\n   * declare module 'hast' {\n   *   interface RootContentMap {\n   *     // Allow using raw nodes defined by `rehype-raw`.\n   *     raw: Raw;\n   *   }\n   * }\n   */\n  export interface RootContentMap {\n    canvasNode: CanvasNode\n    canvasElement: CanvasElement\n  }\n\n  /**\n   * This map registers all node types that may be used as content in an\n   * element.\n   *\n   * These types are accepted inside `element` nodes.\n   *\n   * This interface can be augmented to register custom node types.\n   *\n   * @example\n   * declare module 'hast' {\n   *   interface RootContentMap {\n   *     custom: Custom;\n   *   }\n   * }\n   */\n  export interface ElementContentMap {\n    canvasNode: CanvasNode\n    canvasElement: CanvasElement\n  }\n}\n\n/**\n * This map registers all node types that may be used as content in an canvas\n * node.\n *\n * These types are accepted inside `element` nodes.\n *\n * This interface can be augmented to register custom node types.\n *\n * @example\n * declare module 'hast' {\n *   interface RootContentMap {\n *     custom: Custom;\n *   }\n * }\n */\nexport interface CanvasNodeContentMap extends ElementContentMap {\n  canvasNode: CanvasNode\n  canvasElement: CanvasElement\n}\n\nexport type CanvasNodeContent = CanvasNodeContentMap[keyof CanvasNodeContentMap]\n\n/**\n * CanvasNode represents a the schema for building a JSX Element.\n */\nexport interface CanvasNode extends Node {\n  /**\n   * Represents this variant of a Node.\n   */\n  type: 'node'\n\n  /**\n   * List representing the children of a node.\n   */\n  children?: CanvasNodeContent[] | undefined\n\n  /**\n   * Represents the element's internal name defined by the user\n   */\n  name?: string | undefined\n\n  /**\n   * Represents the element's parent unique identifier\n   */\n  parentId?: string | undefined\n\n  /**\n   * Represents the elements' component unique identifier\n   */\n  componentId?: string | undefined\n\n  /**\n   * Represents the elements' components' plugin unique identifier\n   */\n  pluginId?: string | undefined\n\n  /**\n   * Represents information associated with the element.\n   */\n  props?: Props | undefined\n}\n\n/**\n * CanvasElement represents a living JSX Element\n */\nexport interface CanvasElement extends CanvasNode {\n  /**\n   * Represents the element's unique identifier\n   */\n  $id: string\n}\n\nexport type AbstractId = string\n\n// @TODO ⚠️ Refactor for better adoption of hast\nexport interface AbstractNodeSchema<P = JSX.AnyProps> extends CanvasNode {\n  /**\n   * The unique identifier for a node\n   */\n  $id: AbstractId\n  title?: string\n  displayName?: string\n  description?: string\n\n  children?: any\n  nodes?: any\n\n  /**\n   * The node style properties for emotion\n   */\n  sx?: JSX.SxProps\n  /**\n   * The node props/attributes passed to the component\n   */\n  props?: P\n\n  category?: any\n  icon?: any\n\n  createdAt?: ITimestamp\n  updatedAt?: ITimestamp\n  deletedAt?: ITimestamp\n}\n\n/**\n * CanvasPreset represents an encapsulated 'node' type as the root node for\n * crafting a living JSX Element\n */\nexport interface CanvasPreset extends Node, Taxonomic {\n  /**\n   * Represents this variant of a Node.\n   */\n  type: 'preset'\n\n  /**\n   * Represents the element's unique identifier\n   */\n  $id: string\n\n  /**\n   * Represents the elements' component unique identifier\n   */\n  componentId?: string | undefined\n\n  /**\n   * Represents the elements' components' plugin unique identifier\n   */\n  pluginId?: string | undefined\n\n  /**\n   * Represents information associated with the element.\n   */\n  props?: Props | undefined\n\n  /**\n   * Represents the element's internal name defined by the user\n   */\n  name?: string | undefined\n}\n\nexport type { NodeId }\n\n// @TODO ⚠️ Refactor for better adoption of hast\ntype PresetI = AglynDocument &\n  Omit<AbstractNodeSchema<any>, 'type' | 'data'> &\n  Omit<CanvasPreset, 'type' | 'data'>\n\ninterface PresetII extends PresetI {\n  type: NodeType.PRESET | string\n}\n\nexport interface PresetSchema<P = JSX.AnyProps> extends PresetII {\n  $id: PresetId\n  pluginId?: PluginId\n  displayName?: string\n  description?: string\n  category?: string | ComponentCategory\n  /**\n   * Extra words this element should be findable by in the element picker —\n   * synonyms and the name people reach for when it is not the name we chose\n   * (\"picture\" for Image, \"dropdown\" for Select).\n   *\n   * Search terms only; never rendered. A hit here ranks BELOW every hit on a\n   * name, so a tag widens what the picker finds without letting a synonym\n   * outrank the element actually called that (AGL-2486).\n   */\n  tags?: string[]\n  /** Alias of {@link tags}; both are searched. */\n  keywords?: string[]\n  icon?: MdiIconProps\n  data: NodeSchemaNested<P>\n  /**\n   * Interaction templates wired when the preset is inserted (AGL-589):\n   * the host app resolves each `presetRef` marker to a freshly minted node\n   * and persists the result. Presets that need hover choreography (a\n   * primitive dropdown panel) ship working out of the box instead of asking\n   * the user to author the interactions by hand.\n   *\n   * TEMPLATES, and named so. These are not interactions: they are\n   * unresolved, they reference nodes that do not exist yet, and they are\n   * consumed at insert time and never stored. What they resolve INTO lives\n   * on the node as {@link NodeSchema.interactions}, and a `PresetSchema` is\n   * assignable to a `NodeSchema` — so while the two shared a name, one of\n   * them had to be wrong wherever a preset was passed as a node.\n   */\n  interactionTemplates?: PresetInteractionSchema[]\n}\n\n/**\n * A visibility step inside a {@link PresetSchema} interaction template.\n * Only the basic client visibility steps are expressible — presets\n * scaffold in-page choreography, never server automations.\n */\nexport interface PresetInteractionStepSchema {\n  type: 'showElement' | 'hideElement' | 'toggleElement'\n  /** `presetRef` of the preset node this step targets. */\n  targetRef: string\n  /** Optional grace delay, validated to 0–5000ms like the builder. */\n  delayMs?: number\n  /** Self-dismissal for steps that can reveal the target. */\n  dismissOn?: Array<'escape' | 'outsideClick'>\n}\n\n/** An interaction template a preset wires on insert (AGL-589). */\nexport interface PresetInteractionSchema {\n  name: string\n  event: 'elementClick' | 'elementHoverEnter' | 'elementHoverLeave'\n  /** `presetRef` of the preset node whose selector fires the trigger. */\n  triggerRef: string\n  steps: PresetInteractionStepSchema[]\n}\n\n// @TODO ⚠️ Refactor for better adoption of hast\ntype NodeI<P> = AglynDocument & Omit<AbstractNodeSchema<P>, 'type'>\n\nexport interface NodeSchema<P = JSX.AnyProps> extends NodeI<P> {\n  type: NodeType | string\n  /**\n   * List of the children unique identifiers for the node\n   */\n  nodes?: NodeId[]\n  /**\n   * Class name to pass the DOM node, can also be defined in props\n   */\n  className?: string\n  /**\n   * Preset-authoring marker (AGL-589): names a node inside a preset's\n   * `data` tree so the preset's interaction templates can reference it\n   * (`triggerRef` / `targetRef`). Cloned onto the inserted node; inert\n   * everywhere else.\n   */\n  presetRef?: string\n  /**\n   * Per-instance style overrides on a reusable-component instance node\n   * (AGL-1306), keyed by target: `root` (see `STYLE_OVERRIDES_ROOT_KEY`)\n   * addresses the component ROOT, and any other key is a DEFINITION-internal\n   * node id addressing one leaf inside the component (AGL-1332). Each slice\n   * is an sx-shaped record merged over that node's own sx at graft time\n   * (`composeReusableComponentNodes` → `mergeNodeSx`), so one page's CTA can\n   * switch to a white background AND repaint its headline without widening\n   * the component's declared props or detaching.\n   *\n   * Keyed on the definition's id, never the grafted `cmp__{instance}__{def}`\n   * id: the graft id is derived per placement, so it would not survive a\n   * duplicate or a re-key, and the same component could not offer two\n   * instances the same authoring vocabulary. A key naming a node the\n   * definition no longer has is ignored — a component edited later degrades\n   * to its own styling instead of taking a page down.\n   *\n   * A first-class node field, NOT a prop: `AglynNode`'s constructor drops\n   * unknown top-level keys, and anything in `props` is spread onto the\n   * instance's wrapper DOM element. Lives on the instance node in the\n   * document that places it — it survives component republish and never\n   * pins the instance to an old component version, because the graft\n   * always merges it over the definition's CURRENT nodes.\n   */\n  styleOverrides?: Record<string, JSX.SxProps>\n  /**\n   * Per-instance ATTRIBUTE overrides on a reusable-component instance node\n   * (AGL-1899) — the same addressing as {@link styleOverrides}, applied to\n   * a node's props instead of its sx, so one placement can carry a\n   * different button `variant`, `size` or `href` without the component\n   * declaring a prop for it and without detaching.\n   *\n   * Merged **per named prop**: a slice replaces only the props it names and\n   * leaves the definition's others alone, so a component that later adds a\n   * prop still gives every existing instance the new default. That is\n   * deliberately shallower than the sx merge next door — an sx slice\n   * cascades because `@scheme dark` and breakpoint objects are themselves\n   * selectors, whereas a prop value is one value, and half-merging two\n   * objects that merely look alike (say a `slotProps`) would produce a\n   * third thing neither side asked for.\n   *\n   * `sx` is refused here. Styling an instance already has a mechanism one\n   * field up, and honouring both would leave two writers racing for one\n   * rendered value with no rule to say which wins.\n   *\n   * Applied BEFORE `{{prop.*}}` substitution, so an override may itself be\n   * written in tokens and still resolves, and an override on a prop the\n   * definition binds to a declared prop wins — the more specific placement\n   * beats the component's own default.\n   */\n  attrOverrides?: Record<string, Record<string, unknown>>\n  /**\n   * Interactions this element carries — the click, hover and\n   * scroll-into-view choreography authored on it in the besigner.\n   *\n   * ## Why they live on the NODE\n   *\n   * They used to be rows in `hosts/{hostId}/actions`, bound to an element by\n   * a `[data-aglyn=\"leaf:<id>\"]` selector — the same collection the Workflows\n   * page lists. An interaction is not a site-wide automation, and storing it\n   * as one had four consequences, every one of them a thing an author would\n   * expect to work:\n   *\n   * - it was not versioned with the document, so it neither published nor\n   *   rolled back with the screen it belongs to;\n   * - it did not travel with a component copied to another site, or packaged\n   *   into a template or a plugin — the element arrived inert;\n   * - deleting the element left the action behind, pointing at a selector\n   *   nothing resolves;\n   * - and a nav's hover choreography sat in the site's automation list\n   *   beside \"when an order is placed\", which is a different kind of thing.\n   *\n   * Host actions remain, and remain the right home for a genuine site event.\n   * The split is the concept: an ACTION is something the site does, an\n   * INTERACTION is something an element does.\n   *\n   * ## Shape\n   *\n   * Deliberately the same `HostAction` the automations engine already takes,\n   * so nothing about the runtime changes: the selector is stamped from this\n   * node's own id when the page is composed, and the compiled result is the\n   * shape the client engine has always consumed. `trigger.selector` is\n   * therefore ignored here — the node IS the selector.\n   */\n  interactions?: NodeInteraction[]\n  /**\n   * Hidden by the author — the eye on the element's hierarchy row.\n   *\n   * Renders `display: none` on the canvas AND on the published site. It is\n   * the plain \"I do not want this on the page\" switch: no runtime, no\n   * interaction, nothing reveals it. Showing it again is the same eye.\n   *\n   * ## Why a FIELD and not a style\n   *\n   * Because it has to override the element's own display rather than replace\n   * it. An author who toggles the eye on a Stack laid out with\n   * `display: flex` must get that flex back when they toggle it off, and\n   * writing `display: none` into `node.sx` destroys the value it overwrote —\n   * there is nothing left to restore. Composed LAST in `Leaf` instead, so it\n   * wins on the cascade and the stored style is never touched.\n   *\n   * ## Not {@link ELEMENT_HIDDEN_CLASS}\n   *\n   * `aglyn-hidden` is a different thing wearing a similar name: it means\n   * \"starts hidden, and an interaction shows it\" — a mega-menu panel, a\n   * drawer. That class is part of a runtime contract (the show/hide steps\n   * toggle it, and the canvas reveals it for designing), and it is bespoke to\n   * that job. A visibility toggle that wrote it would enrol every hidden\n   * element in a choreography it is not part of.\n   */\n  hidden?: boolean\n  /**\n   * The computed node parent (only for type completion)\n   */\n  readonly parent?: NodeSchema<any> | null\n  /**\n   * The computed node parent (only for type completion)\n   */\n  readonly children?: NodeSchema<any>[]\n  /**\n   * The computed index in parent nodes (only for type completion)\n   */\n  readonly index?: number | null\n  /**\n   * The computed label (only for type completion)\n   */\n  readonly labelShort?: string | undefined\n  /**\n   * The computed breadcrumb path (only for type completion)\n   */\n  readonly breadcrumbPath?: NodeBreadcrumbPath\n  /**\n   * The computed component schema (only for type completion)\n   */\n  readonly componentSchema?: ComponentSchema | undefined\n  /**\n   * The computed guard for of child nodes (only for type completion)\n   */\n  readonly hasNodes?: boolean\n  /**\n   * The computed property for the resolved props from component schema\n   */\n  readonly resolvedProps?: P\n}\n\nexport enum NodeType {\n  NODE = 'node',\n  TEXT = 'text',\n  NUMBER = 'number',\n  SCREEN = 'screen',\n  REF = 'ref',\n  PRESET = 'preset',\n}\n\nexport type NodeSchemaJSON<P = JSX.AnyProps> = Omit<\n  NodeSchema<P>,\n  | 'parent'\n  | 'index'\n  | 'labelShort'\n  | 'breadcrumbPath'\n  | 'componentSchema'\n  | 'hasNodes'\n>\n\nexport type NodeSchemaNested<P = JSX.AnyProps> = Omit<\n  NodeSchemaJSON<P>,\n  'nodes'\n> & { nodes?: NodeSchemaNested<any>[] }\n\nexport type NodesMap = Record<NodeId, NodeSchema<any>>\n\nexport type NodeBreadcrumbPath = [\n  root: string & typeof NODE_ROOT_ID,\n  ...nodes: [...ancestors: NodeId[], node: NodeId],\n]\n\nexport type ProcessableNodes =\n  | NodeSchemaNested<any>[]\n  | NodeSchemaNested<any>\n  | Record<NodeId, NodeSchema>\n\nexport { ComponentCategory }\n\nexport type { ComponentId }\nexport type { PresetId }\n\nexport type ComponentFactory<\n  P extends ComponentProps<C> | any = any,\n  C extends keyof JSX.IntrinsicElements | JSX.ElementConstructor<any> = any,\n> = ComponentClass<P> | JSX.ElementConstructor<P> | keyof JSX.IntrinsicElements\n// | keyof JSX.IntrinsicElements[keyof JSX.IntrinsicElements]\n\nexport type { ComponentsLinealOrder }\n\n/**\n * What the Attributes panel knows about the element a field edits, handed to\n * an attribute's `resolveProps` as its fourth argument.\n *\n * data-driven-forms gives a field its own value and the form's values, which\n * are the element's props and nothing else. A rule about the element as a\n * whole needs more than that: whether a Link Container holds anything that\n * names its link depends on the elements inside it. So the panel adds the\n * node, and a lookup for the ids listed in its `nodes`.\n *\n * Absent wherever a field is drawn outside that panel, including a unit test\n * calling the function directly, so a `resolveProps` that reads it has to\n * treat a missing context as having nothing to say.\n */\nexport interface AttributeFieldContext {\n  /** The element the Attributes panel is editing. */\n  node: NodeSchema<any>\n  /** An element of the same document by id, such as a child in `nodes`. */\n  getNode: (id: NodeId) => NodeSchema<any> | undefined\n}\n\n/**\n * An attribute's `resolveProps`: the three arguments data-driven-forms\n * passes, then the {@link AttributeFieldContext} the Attributes panel adds.\n */\nexport type AttributeResolveProps = (\n  ...args: [\n    ...Parameters<ResolvePropsFunction>,\n    context?: AttributeFieldContext,\n  ]\n) => ReturnType<ResolvePropsFunction>\n\n// @TODO ⚠️ Refactor for better adoption of hast\nexport interface AttributeSchema extends Dictionary<any> {\n  name: string\n  dataType?: DataType\n  component: string | FieldComponentType\n  validate?: Validator[]\n  condition?: ConditionDefinition | ConditionDefinition[]\n  initializeOnMount?: boolean\n  initialValue?: any\n  clearedValue?: any\n  clearOnUnmount?: boolean\n  actions?: FieldActions\n  resolveProps?: AttributeResolveProps\n  description?: string\n}\n\n// @TODO ⚠️ Refactor for better adoption of hast\nexport interface ComponentSchema<P = any> {\n  $id?: ComponentId\n  pluginId?: PluginId\n  kind?: 'element' | 'plaintext' | 'markdown'\n\n  displayName: string\n  title?: string\n  subtitle?: string\n  description?: string\n  category?: string | ComponentCategory\n\n  /**\n   * Extra words this element should be findable by in the element picker —\n   * synonyms and the name people reach for when it is not the name we chose\n   * (\"picture\" for Image, \"dropdown\" for Select).\n   *\n   * Search terms only; never rendered. A hit here ranks BELOW every hit on a\n   * name, so a tag widens what the picker finds without letting a synonym\n   * outrank the element actually called that (AGL-2486).\n   */\n  tags?: string[]\n  /** Alias of {@link tags}; both are searched. */\n  keywords?: string[]\n\n  /**\n   * Icon props for display around besigner\n   */\n  icon?: MdiIconProps\n  /**\n   * Options to be passed to styled(Component, \\{...styledOptions\\})\n   */\n  styledOptions?: MuiStyledOptions\n\n  /**\n   * Define a limitation for nodes allowed as direct descendents\n   */\n  restrictChildren?: ComponentsLinealOrder\n  /**\n   * Define a limitation for nodes allowed to be direct ancestors\n   */\n  restrictParent?: ComponentsLinealOrder\n\n  /**\n   * Filter props\n   */\n  resolveProps?: JSX.ResolveProps<NodeSchema<P>>\n\n  /**\n   * Attribute fields to modify the contextual properties\n   * New version\n   */\n  attributes?: AttributeSchema[]\n\n  /**\n   * Which groups of formatting the inline rich-text toolbar offers for this\n   * component (AGL-2557). Read only where `flags.richTextEditable` is on.\n   *\n   * Omitted means every group, which is what leaves Typography exactly as it\n   * was. Naming a subset narrows the toolbar AND the commit: a surface that\n   * offers neither lists nor links is phrasing-only, and the sanitizer holds\n   * it to that whatever an author pastes in.\n   */\n  richTextCommands?: RICH_TEXT_COMMANDS[]\n\n  /**\n   * Feature flags\n   */\n  flags?: {\n    /**\n     * Disable the use of emotion styled\n     */\n    emotion?: FEATURE_FLAG\n    /**\n     * Can the nodes of this component type be cloned?\n     */\n    cloning?: FEATURE_FLAG\n    /**\n     * Allow dragging nodes of this component type\n     */\n    dragging?: FEATURE_FLAG\n    /**\n     * Allow dropping nodes inside nodes of this component type\n     */\n    dropping?: FEATURE_FLAG\n    /**\n     * Allow editing element attributes of this component type\n     */\n    editing?: FEATURE_FLAG\n    /**\n     * Allow removing nodes of this component type\n     */\n    removing?: FEATURE_FLAG\n    /**\n     * Describe nodes of this component type to be self-closing\n     */\n    selfClosing?: FEATURE_FLAG\n    /**\n     * Component renders its `children` prop as text content the editor may\n     * edit directly (Attributes \"Text\" field, inline canvas editing).\n     */\n    textEditable?: FEATURE_FLAG\n    /**\n     * Component also accepts basic rich text (AGL-54): the inline editor\n     * upgrades to a formatting surface and commits sanitized HTML into the\n     * `html` prop (with `children` kept as the plain-text fallback).\n     */\n    richTextEditable?: FEATURE_FLAG\n    /**\n     * Component reads its children POSITIONALLY (AGL-1237), so the renderer\n     * hands it one React child per node child instead of the single `<Branch>`\n     * element it normally passes.\n     *\n     * MUI's Accordion does `const [summary, ...rest] = Children.toArray(children)`,\n     * and `toArray` does not traverse into an element — so with the default\n     * wrapping the summary swallowed the whole subtree and the Collapse got\n     * nothing. Every accordion on every published site expanded to reveal an\n     * empty panel while its content rendered unconditionally inside the\n     * summary's heading.\n     *\n     * Opt in only for components with this contract; the wrapper is what keeps\n     * the Branch/Stem/Leaf seam swappable for everything else.\n     */\n    positionalChildren?: FEATURE_FLAG\n  }\n}\n\nexport type SchemasByCategory = Record<\n  ComponentCategory | string,\n  (ComponentSchema<any> | PresetSchema<any>)[]\n>\n\nexport interface ScreenSchema {\n  nodes: NodeSchemaNested\n  createdAt?: ITimestamp\n  updatedAt?: ITimestamp\n  hostId?: HostUid\n}\n"],"names":["ComponentCategory","NodeType"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAuBD,SAASA,iBAAiB,QAAQ,wCAAoC;AAqbtE,OAAO,IAAA,AAAKC,kCAAAA;;;;;;;WAAAA;MAOX;AA6BD,SAASD,iBAAiB,GAAE"}

package/src/lib/types/routing.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export type { AglynRedirect, RedirectUid } from '../foundation';

package/src/lib/types/routing.js

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ export { };
+
+//# sourceMappingURL=routing.js.map

package/src/lib/types/routing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/types/routing.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2023 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport type { AglynRedirect, RedirectUid } from '../foundation'\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,WAA+D"}

package/src/lib/types/screen.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { AglynLayoutVersion as AglynLayoutVersionBase, AglynScreenVersion as AglynScreenVersionBase } from '../foundation/definitions/platform.types';
+import type { NodeSchema } from './nodes';
+export type { AglynLayout, AglynScreen, LayoutUid, ScreenSlug, ScreenUid, VersionUid, } from '../foundation';
+/** Host-scoped document */
+export type AglynScreenVersion = AglynScreenVersionBase<NodeSchema>;
+/** CONCEPT: Shared layouts. Host-scoped document */
+export type AglynLayoutVersion = AglynLayoutVersionBase<NodeSchema>;

package/src/lib/types/screen.js

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /** CONCEPT: Shared layouts. Host-scoped document */ export { };
+
+//# sourceMappingURL=screen.js.map

package/src/lib/types/screen.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/types/screen.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2023 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  AglynLayoutVersion as AglynLayoutVersionBase,\n  AglynScreenVersion as AglynScreenVersionBase,\n} from '../foundation/definitions/platform.types'\nimport type { NodeSchema } from './nodes'\n\nexport type {\n  AglynLayout,\n  AglynScreen,\n  LayoutUid,\n  ScreenSlug,\n  ScreenUid,\n  VersionUid,\n} from '../foundation'\n\n/** Host-scoped document */\nexport type AglynScreenVersion = AglynScreenVersionBase<NodeSchema>\n\n/** CONCEPT: Shared layouts. Host-scoped document */\nexport type AglynLayoutVersion = AglynLayoutVersionBase<NodeSchema>\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAoBD,kDAAkD,GAClD,WAAmE"}

package/src/lib/utils.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { FEATURE_FLAG } from './foundation/constants/shared';
+export declare function _isFeatureExplicitlyDisabled(val: FEATURE_FLAG): boolean;
+export declare function _isFeatureExplicitlyEnabled(val: FEATURE_FLAG): boolean;
+export declare function _isFeatureDisabledDefault(val: FEATURE_FLAG): boolean;
+export declare function _isFeatureEnabledDefault(val: FEATURE_FLAG): boolean;
+export declare function _isFeatureUnknown(val: FEATURE_FLAG): boolean;
+export declare function isFeatureDefaulted(val: FEATURE_FLAG): boolean;
+export declare function isFeatureDisabled(val: FEATURE_FLAG): boolean;
+export declare function isFeatureEnabled(val: FEATURE_FLAG): boolean;

package/src/lib/utils.js

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { FEATURE_FLAG } from "./foundation/constants/shared.js";
+export function _isFeatureExplicitlyDisabled(val) {
+    return Boolean(val === FEATURE_FLAG.DISABLED);
+}
+export function _isFeatureExplicitlyEnabled(val) {
+    return Boolean(val === FEATURE_FLAG.ENABLED);
+}
+export function _isFeatureDisabledDefault(val) {
+    return val === (val | FEATURE_FLAG.DISABLED_DEFAULT);
+}
+export function _isFeatureEnabledDefault(val) {
+    return val === (val | FEATURE_FLAG.ENABLED_DEFAULT);
+}
+export function _isFeatureUnknown(val) {
+    return val === FEATURE_FLAG.UNKNOWN || val === undefined || val === null;
+}
+export function isFeatureDefaulted(val) {
+    return Boolean(val & FEATURE_FLAG.DEFAULT) || _isFeatureUnknown(val);
+}
+export function isFeatureDisabled(val) {
+    return Boolean(val & FEATURE_FLAG.DISABLED_DEFAULT);
+}
+export function isFeatureEnabled(val) {
+    return Boolean(val & FEATURE_FLAG.ENABLED_DEFAULT) || _isFeatureUnknown(val);
+}
+
+//# sourceMappingURL=utils.js.map

package/src/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../libs/aglyn/src/lib/utils.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { FEATURE_FLAG } from './foundation/constants/shared'\n\nexport function _isFeatureExplicitlyDisabled(val: FEATURE_FLAG) {\n  return Boolean(val === FEATURE_FLAG.DISABLED)\n}\nexport function _isFeatureExplicitlyEnabled(val: FEATURE_FLAG) {\n  return Boolean(val === FEATURE_FLAG.ENABLED)\n}\nexport function _isFeatureDisabledDefault(val: FEATURE_FLAG) {\n  return val === (val | FEATURE_FLAG.DISABLED_DEFAULT)\n}\nexport function _isFeatureEnabledDefault(val: FEATURE_FLAG) {\n  return val === (val | FEATURE_FLAG.ENABLED_DEFAULT)\n}\nexport function _isFeatureUnknown(val: FEATURE_FLAG) {\n  return val === FEATURE_FLAG.UNKNOWN || val === undefined || val === null\n}\nexport function isFeatureDefaulted(val: FEATURE_FLAG) {\n  return Boolean(val & FEATURE_FLAG.DEFAULT) || _isFeatureUnknown(val)\n}\nexport function isFeatureDisabled(val: FEATURE_FLAG) {\n  return Boolean(val & FEATURE_FLAG.DISABLED_DEFAULT)\n}\nexport function isFeatureEnabled(val: FEATURE_FLAG) {\n  return Boolean(val & FEATURE_FLAG.ENABLED_DEFAULT) || _isFeatureUnknown(val)\n}\n"],"names":["FEATURE_FLAG","_isFeatureExplicitlyDisabled","val","Boolean","DISABLED","_isFeatureExplicitlyEnabled","ENABLED","_isFeatureDisabledDefault","DISABLED_DEFAULT","_isFeatureEnabledDefault","ENABLED_DEFAULT","_isFeatureUnknown","UNKNOWN","undefined","isFeatureDefaulted","DEFAULT","isFeatureDisabled","isFeatureEnabled"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,YAAY,QAAQ,mCAA+B;AAE5D,OAAO,SAASC,6BAA6BC,GAAiB;IAC5D,OAAOC,QAAQD,QAAQF,aAAaI,QAAQ;AAC9C;AACA,OAAO,SAASC,4BAA4BH,GAAiB;IAC3D,OAAOC,QAAQD,QAAQF,aAAaM,OAAO;AAC7C;AACA,OAAO,SAASC,0BAA0BL,GAAiB;IACzD,OAAOA,QAASA,CAAAA,MAAMF,aAAaQ,gBAAgB,AAAD;AACpD;AACA,OAAO,SAASC,yBAAyBP,GAAiB;IACxD,OAAOA,QAASA,CAAAA,MAAMF,aAAaU,eAAe,AAAD;AACnD;AACA,OAAO,SAASC,kBAAkBT,GAAiB;IACjD,OAAOA,QAAQF,aAAaY,OAAO,IAAIV,QAAQW,aAAaX,QAAQ;AACtE;AACA,OAAO,SAASY,mBAAmBZ,GAAiB;IAClD,OAAOC,QAAQD,MAAMF,aAAae,OAAO,KAAKJ,kBAAkBT;AAClE;AACA,OAAO,SAASc,kBAAkBd,GAAiB;IACjD,OAAOC,QAAQD,MAAMF,aAAaQ,gBAAgB;AACpD;AACA,OAAO,SAASS,iBAAiBf,GAAiB;IAChD,OAAOC,QAAQD,MAAMF,aAAaU,eAAe,KAAKC,kBAAkBT;AAC1E"}

package/src/server.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Server-safe entry point for @aglyn/aglyn (AGL-405). Identical to the main
+ * barrel except it re-exports `app-utils/server` (no client React contexts)
+ * instead of the full `app-utils`, so tenant Server Components can import the
+ * framework's types + pure functions without dragging `createContext` into
+ * the RSC module graph. Client code keeps using `@aglyn/aglyn`.
+ */
+export * from './lib/aglyn';
+export * from './lib/types';
+export * from './lib/utils';
+export * from './lib/components-manager';
+export * from './lib/emit-manager';
+export * from './lib/plugin-manager';
+export * from './lib/canvas-manager';
+export * from './lib/app-utils/server';
+export * from './lib/foundation';
+export * from './lib/app-utils/api-adapter';
+export * from './lib/app-utils/api-idempotency';
+export * from './lib/app-utils/person-key';
+export * from './lib/app-utils/plugin-bundle-checks';
+export * from './lib/plugin-manager/realm-server';

package/src/server.js

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * Server-safe entry point for @aglyn/aglyn (AGL-405). Identical to the main
+ * barrel except it re-exports `app-utils/server` (no client React contexts)
+ * instead of the full `app-utils`, so tenant Server Components can import the
+ * framework's types + pure functions without dragging `createContext` into
+ * the RSC module graph. Client code keeps using `@aglyn/aglyn`.
+ */ export * from "./lib/aglyn.js";
+export * from "./lib/types/index.js";
+export * from "./lib/utils.js";
+export * from "./lib/components-manager/index.js";
+export * from "./lib/emit-manager/index.js";
+export * from "./lib/plugin-manager/index.js";
+export * from "./lib/canvas-manager/index.js";
+export * from "./lib/app-utils/server.js";
+export * from "./lib/foundation/index.js";
+// The Web↔(req,res) API adapter (AGL-407) imports `node:stream`, so it is
+// exposed ONLY through this `/server` entry — never re-exported by the full
+// `@aglyn/aglyn` barrel (which client code bundles).
+export * from "./lib/app-utils/api-adapter.js";
+// The attempt claim (AGL-1691/1697) imports `node:crypto`, so it rides the
+// same rule: exposed ONLY through this `/server` entry, never the full
+// `@aglyn/aglyn` barrel that client code bundles.
+export * from "./lib/app-utils/api-idempotency.js";
+// The address-derived document id (`docs/specs/email-overhaul.md` §3d,
+// `docs/specs/reusable-forms.md` §4) imports `node:crypto`, so it rides the
+// same rule as the two above: exposed ONLY through this `/server` entry, never
+// the full `@aglyn/aglyn` barrel that client code bundles. Its normalizer
+// stays in `app-utils/contacts`, which has no Node builtin and may stay there.
+export * from "./lib/app-utils/person-key.js";
+// The marketplace bundle verifier (AGL-2486) imports `acorn` to parse an
+// untrusted plugin bundle, so it rides the same rule as the two above:
+// exposed ONLY through this `/server` entry, never re-exported by the full
+// `@aglyn/aglyn` barrel that client code bundles. Measured on a Turbopack
+// production build: -39,035 B GZIPPED off the `/[host]/[scheme]/[[...slug]]` route's
+// client chunks. It runs in two console admin routes and nowhere else, and
+// it was putting a JavaScript parser into every published customer page.
+export * from "./lib/app-utils/plugin-bundle-checks.js";
+export * from "./lib/plugin-manager/realm-server.js";
+
+//# sourceMappingURL=server.js.map

package/src/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../libs/aglyn/src/server.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Server-safe entry point for @aglyn/aglyn (AGL-405). Identical to the main\n * barrel except it re-exports `app-utils/server` (no client React contexts)\n * instead of the full `app-utils`, so tenant Server Components can import the\n * framework's types + pure functions without dragging `createContext` into\n * the RSC module graph. Client code keeps using `@aglyn/aglyn`.\n */\nexport * from './lib/aglyn'\nexport * from './lib/types'\nexport * from './lib/utils'\nexport * from './lib/components-manager'\nexport * from './lib/emit-manager'\nexport * from './lib/plugin-manager'\nexport * from './lib/canvas-manager'\nexport * from './lib/app-utils/server'\nexport * from './lib/foundation'\n// The Web↔(req,res) API adapter (AGL-407) imports `node:stream`, so it is\n// exposed ONLY through this `/server` entry — never re-exported by the full\n// `@aglyn/aglyn` barrel (which client code bundles).\nexport * from './lib/app-utils/api-adapter'\n// The attempt claim (AGL-1691/1697) imports `node:crypto`, so it rides the\n// same rule: exposed ONLY through this `/server` entry, never the full\n// `@aglyn/aglyn` barrel that client code bundles.\nexport * from './lib/app-utils/api-idempotency'\n// The address-derived document id (`docs/specs/email-overhaul.md` §3d,\n// `docs/specs/reusable-forms.md` §4) imports `node:crypto`, so it rides the\n// same rule as the two above: exposed ONLY through this `/server` entry, never\n// the full `@aglyn/aglyn` barrel that client code bundles. Its normalizer\n// stays in `app-utils/contacts`, which has no Node builtin and may stay there.\nexport * from './lib/app-utils/person-key'\n// The marketplace bundle verifier (AGL-2486) imports `acorn` to parse an\n// untrusted plugin bundle, so it rides the same rule as the two above:\n// exposed ONLY through this `/server` entry, never re-exported by the full\n// `@aglyn/aglyn` barrel that client code bundles. Measured on a Turbopack\n// production build: -39,035 B GZIPPED off the `/[host]/[scheme]/[[...slug]]` route's\n// client chunks. It runs in two console admin routes and nowhere else, and\n// it was putting a JavaScript parser into every published customer page.\nexport * from './lib/app-utils/plugin-bundle-checks'\nexport * from './lib/plugin-manager/realm-server'\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;CAMC,GACD,cAAc,iBAAa;AAC3B,cAAc,uBAAa;AAC3B,cAAc,iBAAa;AAC3B,cAAc,oCAA0B;AACxC,cAAc,8BAAoB;AAClC,cAAc,gCAAsB;AACpC,cAAc,gCAAsB;AACpC,cAAc,4BAAwB;AACtC,cAAc,4BAAkB;AAChC,0EAA0E;AAC1E,4EAA4E;AAC5E,qDAAqD;AACrD,cAAc,iCAA6B;AAC3C,2EAA2E;AAC3E,uEAAuE;AACvE,kDAAkD;AAClD,cAAc,qCAAiC;AAC/C,uEAAuE;AACvE,4EAA4E;AAC5E,+EAA+E;AAC/E,0EAA0E;AAC1E,+EAA+E;AAC/E,cAAc,gCAA4B;AAC1C,yEAAyE;AACzE,uEAAuE;AACvE,2EAA2E;AAC3E,0EAA0E;AAC1E,qFAAqF;AACrF,2EAA2E;AAC3E,yEAAyE;AACzE,cAAc,0CAAsC;AACpD,cAAc,uCAAmC"}