@aglyn/plugins-mui 1.0.0-beta.143

package/src/lib/utils/link-target-props.js

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2026 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.
+ */ /**
+ * Where a link opens, as authored. Persisted in screen documents; never
+ * rename a value.
+ *
+ * - `'_self'` (or unset) — stays in the current tab, the browser default.
+ * - `'_blank'` — a new tab.
+ * - `'custom'` — a NAMED window, read from the companion `targetName` prop.
+ *   Not an anchor value itself; it is the sentinel that reveals the name
+ *   field, and never reaches the DOM.
+ */ /**
+ * Resolves the authored target pair to the attributes an anchor should carry.
+ *
+ * Returns NOTHING for the default choice rather than an explicit
+ * `target="_self"`: the two behave identically, and an absent attribute is
+ * what every link authored before this existed already renders — so adding
+ * the control moves no published markup.
+ *
+ * `rel` rides along because a target that opens elsewhere hands the new
+ * context a live `window.opener` handle back into this page. `noreferrer` is
+ * added only when the destination leaves the site: stripping the referrer
+ * from a link to one of the site's own screens would make the landing page
+ * read as direct traffic in its own analytics, which is a reporting defect,
+ * not a safety win.
+ *
+ * A cleared attribute persists as `null` or `''`, and a custom choice with
+ * an empty name is an author mid-edit — both fall back to the default rather
+ * than stamping an empty `target` on the anchor.
+ */ export function linkTargetProps(target, targetName, leavesSite) {
+    const resolved = target === 'custom' ? typeof targetName === 'string' ? targetName.trim() : '' : target === '_blank' ? '_blank' : '';
+    if (!resolved || resolved === '_self') return {};
+    return {
+        target: resolved,
+        rel: leavesSite ? 'noopener noreferrer' : 'noopener'
+    };
+}
+export default linkTargetProps;
+
+//# sourceMappingURL=link-target-props.js.map

package/src/lib/utils/link-target-props.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/utils/link-target-props.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\n/**\n * Where a link opens, as authored. Persisted in screen documents; never\n * rename a value.\n *\n * - `'_self'` (or unset) — stays in the current tab, the browser default.\n * - `'_blank'` — a new tab.\n * - `'custom'` — a NAMED window, read from the companion `targetName` prop.\n *   Not an anchor value itself; it is the sentinel that reveals the name\n *   field, and never reaches the DOM.\n */\nexport type LinkTargetChoice = '_self' | '_blank' | 'custom'\n\n/** The anchor attributes a {@link LinkTargetChoice} resolves to. */\nexport interface LinkTargetProps {\n  target?: string\n  rel?: string\n}\n\n/**\n * Resolves the authored target pair to the attributes an anchor should carry.\n *\n * Returns NOTHING for the default choice rather than an explicit\n * `target=\"_self\"`: the two behave identically, and an absent attribute is\n * what every link authored before this existed already renders — so adding\n * the control moves no published markup.\n *\n * `rel` rides along because a target that opens elsewhere hands the new\n * context a live `window.opener` handle back into this page. `noreferrer` is\n * added only when the destination leaves the site: stripping the referrer\n * from a link to one of the site's own screens would make the landing page\n * read as direct traffic in its own analytics, which is a reporting defect,\n * not a safety win.\n *\n * A cleared attribute persists as `null` or `''`, and a custom choice with\n * an empty name is an author mid-edit — both fall back to the default rather\n * than stamping an empty `target` on the anchor.\n */\nexport function linkTargetProps(\n  target: LinkTargetChoice | string | null | undefined,\n  targetName: string | null | undefined,\n  leavesSite: boolean,\n): LinkTargetProps {\n  const resolved =\n    target === 'custom'\n      ? typeof targetName === 'string'\n        ? targetName.trim()\n        : ''\n      : target === '_blank'\n        ? '_blank'\n        : ''\n  if (!resolved || resolved === '_self') return {}\n  return {\n    target: resolved,\n    rel: leavesSite ? 'noopener noreferrer' : 'noopener',\n  }\n}\n\nexport default linkTargetProps\n"],"names":["linkTargetProps","target","targetName","leavesSite","resolved","trim","rel"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;CASC,GASD;;;;;;;;;;;;;;;;;;CAkBC,GACD,OAAO,SAASA,gBACdC,MAAoD,EACpDC,UAAqC,EACrCC,UAAmB;IAEnB,MAAMC,WACJH,WAAW,WACP,OAAOC,eAAe,WACpBA,WAAWG,IAAI,KACf,KACFJ,WAAW,WACT,WACA;IACR,IAAI,CAACG,YAAYA,aAAa,SAAS,OAAO,CAAC;IAC/C,OAAO;QACLH,QAAQG;QACRE,KAAKH,aAAa,wBAAwB;IAC5C;AACF;AAEA,eAAeH,gBAAe"}