docs: remove obsolete temporary README file

Refactor the calc-02 demo to use a single popup menu component for angle mode and constants, align the menus to their trigger buttons, and update the README/project notes to reflect the portrait-first demo layout and constant API.

.memory/project.md

@@ -1,8 +1,8 @@
-# Project memory
+# State
-
+- Core engine: `src/rpn-calculator.js`
-- RPN calculator JS project.
+- Reference demo: `samples/calc-02/` (portrait-first HP48GX layout, compact mode/constants popups; Const button comes before Mode in the display row)
-- Read `.memory/state.md` for current state.
+- Important UI behavior: mode button shows the current angle mode; keyboard focus stays on the hidden input on desktop; clipboard paste is supported
-- Keep names and commands in English.
+- Public API: `push`, `pop`, `clear`, `swap`, `remove`, `edit`, `isValidIndex`, `input`, `command`, `getOperationsByCategory`, `getConstants`, `listConstants`, `setConstant`, `removeConstant`, `hasConstant`
-- Update memory files based on events: engine, demo, API, commands, exports, docs, or tasks.
+- Config: `maxSize`, `base`, `angleMode`, `enabledCommands`
-- Core arithmetic now includes `root` for y-th roots, and `samples/calc-02/` uses it for `y√x`.
+- Commands: arithmetic, stack, trigonometry, constants `pi` and `e`; arithmetic includes `root`; constants can be added or removed dynamically through the core API
-- `samples/calc-02/` in portrait mode remains the active responsive demo.
+- Exports: browser `window.RpnCalculator`, CommonJS `module.exports`

.memory/state.md

@@ -1,9 +1,8 @@
 # State
 - Core engine: `src/rpn-calculator.js`
-- Active demo: `samples/calc-02/` responsive HP48GX layout with portrait/landscape support; display-adjacent button row stays in 4 columns
+- Default demo: `samples/dev/` classic browser demo; `samples/calc-02/` remains the portrait-first HP48GX-inspired reference
-- Mode button shows the current angle mode only; selecting a mode uses a popup menu
+- Public API: `push`, `pop`, `clear`, `swap`, `remove`, `edit`, `isValidIndex`, `input`, `command`, `getOperationsByCategory`, `getConstants`, `listConstants`, `setConstant`, `removeConstant`, `hasConstant`
-- Public API: `push`, `pop`, `clear`, `swap`, `remove`, `edit`, `isValidIndex`, `input`, `command`, `getOperationsByCategory`, `getConstants`
 - Config: `maxSize`, `base`, `angleMode`, `enabledCommands`
-- Commands: arithmetic, stack, trigonometry, constants `pi` and `e`; arithmetic now includes `root` for y-th roots
+- Commands: arithmetic, stack, trigonometry, constants `pi`, `e`, `phi`, `g`, and `c`; arithmetic includes `root` with `y√x`, `yroot`, and `nroot` aliases; constants can be added or removed dynamically through the core API
-- Demo actions: keyboard focus is kept on the hidden input on desktop so typing keeps working; the keypad layout places Enter in the bottom-left, ± in the former Enter position, and Esc before Clear for safety; paste parses clipboard text as a number before pushing it to the stack; Ctrl+V is supported via the hidden input paste event; backspace is ignored when the stack is empty; operation errors are shown as an overlay bar on top of the calculator with a shorter timeout and darker red
+- Demo behavior: `samples/dev/` keeps hidden input focus on desktop and supports clipboard paste; `samples/calc-02/` uses compact mode/constants popups, a 4-column display-adjacent row, stack selection/move mode, and paste through the hidden input
 - Exports: browser `window.RpnCalculator`, CommonJS `module.exports`

README.md

@@ -1,30 +1,28 @@
 # RPN Virtual Calculator
 
-A browser-friendly RPN calculator built around a small, generic JavaScript API.
+A browser-friendly RPN calculator built around a small JavaScript API.
 
 ## Overview
 
 This project provides:
 
 - a reusable JavaScript RPN engine in `src/rpn-calculator.js`
-- browser demos in `samples/dev/` and `samples/calc-02/`
+- a classic browser demo in `samples/dev/`
-- a command system centralized in a single operation dictionary
+- a portrait-first HP48GX-inspired demo in `samples/calc-02/`
-- a small public API focused on stack operations and generic command dispatch
+- a centralized command system with aliases
+- a compact public API focused on stack operations, editing, and command dispatch
 
 The main class is `RpnCalculator`.
 
 ## Project structure
 
 - `src/rpn-calculator.js`: calculator engine
-- `samples/dev/index.html`: active browser demo entry point
+- `samples/dev/index.html`: browser demo entry point
 - `samples/dev/index.css`: demo styles
 - `samples/dev/index.js`: demo UI and keyboard logic
-- `samples/calc-01/index.html`: active browser demo entry point
+- `samples/calc-02/index.html`: portrait-first HP48GX-style demo entry point
-- `samples/calc-01/index.css`: demo styles
+- `samples/calc-02/index.css`: portrait-first demo styles
-- `samples/calc-01/index.js`: demo UI and keyboard logic
+- `samples/calc-02/index.js`: portrait-first HP48GX-style demo UI and keyboard logic
-- `samples/calc-02/index.html`: new responsive HP48GX-style demo entry point
-- `samples/calc-02/index.css`: new responsive demo styles
-- `samples/calc-02/index.js`: responsive HP48GX-style demo UI and keyboard logic
 - `samples/calc-XX/`: placeholder name for future demo variants
 
 ## Public API
@@ -45,6 +43,10 @@ Instance helpers also available:
 
 - `getOperationsByCategory()`
 - `getConstants()`
+- `listConstants()`
+- `setConstant(name, value)`
+- `removeConstant(name)`
+- `hasConstant(name)`
 
 Static helpers also available:
 
@@ -64,10 +66,10 @@ State exposed on instances:
 
 ```js README.md
 const calc = new RpnCalculator({
-  maxSize: 2048,
+	maxSize: 2048,
-  base: 10,
+	base: 10,
-  angleMode: 'deg',
+	angleMode: 'deg',
-  enabledCommands: ['add', 'sub', 'mul', 'div']
+	enabledCommands: ['add', 'sub', 'mul', 'div']
 });
 ```
 
@@ -84,6 +86,10 @@ Available constants:
 
 - `pi`
 - `e`
+- `phi`
+- `g`
+- `c`
+- plus any user-defined constants added through the engine API
 
 They can be used through `command(...)`:
 
@@ -189,10 +195,10 @@ console.log(calc.pop()); // 5
 ```html README.md
 <script src="./src/rpn-calculator.js"></script>
 <script>
-  const calc = new RpnCalculator({ angleMode: 'deg' });
+	const calc = new RpnCalculator({ angleMode: 'deg' });
-  calc.push(9);
+	calc.push(9);
-  calc.command('sqrt');
+	calc.command('sqrt');
-  console.log(calc.pop());
+	console.log(calc.pop());
 </script>
 ```
 
@@ -234,7 +240,7 @@ console.log(calc.pop()); // 0.5
 
 ## Demo
 
-The active demo lives in `samples/dev/`.
+The default demo lives in `samples/dev/`.
 
 Main UI features:
 
@@ -244,7 +250,12 @@ Main UI features:
 - angle mode selector for `deg`, `rad`, and `grad`
 - status pills for `inputValue` and `isEditing`
 - grouped panels for `Stack`, `Arithmetic`, `Trigonometry`, and `Constants`
-- error display area
+- keyboard-friendly hidden input on desktop
+
+## Calc 02 demo
+
+`samples/calc-02/` is a portrait-first HP48GX-inspired demo.
+It keeps the display-adjacent button row aligned in four columns, uses compact popup menus for mode and constants, and supports clipboard paste plus the `y√x` root operation.
 
 The demo loads the engine from:
 
@@ -270,11 +281,6 @@ The current demo supports:
 The demo also implements stack selection and stack-item move mode in its UI layer using the public calculator methods.
 It keeps the calculator screen focused and updates the visible stack window as the selection moves.
 
-## Calc 02 demo
-
-`samples/calc-02/` is a responsive HP48GX-inspired demo.
-It adapts its layout to the browser window, supports portrait and landscape arrangements, and includes the `y√x` root operation.
-
 ## Exports
 
 `RpnCalculator` is exposed in both environments:

samples/calc-02/index.css

@@ -1,3 +1,4 @@
+
 :root {
 	--bg0: #10151e;
 	--bg1: #1b2432;
@@ -37,50 +38,52 @@ body {
 	min-height: 100vh;
 	font-family: Arial, sans-serif;
 	color: var(--buttonText);
-	background:
+	background: var(--bg0);
-		radial-gradient(circle at top, rgba(255, 255, 255, 0.08), transparent 32%),
-		linear-gradient(180deg, var(--bg1), var(--bg0));
 }
 
 .app-shell {
 	min-height: 100vh;
 	display: grid;
-	place-items: center;
+	align-items: start;
+	justify-items: center;
 	padding: 0;
 }
 
 .calculator {
 	width: 100%;
-	height: 100%;
+	height: auto;
 	display: grid;
 	padding: 8px;
 	border-radius: 8px;
-	background: linear-gradient(180deg, var(--panel2), var(--panel));
+	background: var(--panel);
-	border: 1px solid var(--edge);
+	box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.08);
-	box-shadow: 0 26px 70px var(--shadow), inset 0 1px 0 rgba(255, 255, 255, 0.08);
+	grid-template-columns: 1fr;
-	grid-template-columns: 1.3fr 0.9fr;
+	grid-template-rows: auto auto auto auto auto;
-	grid-template-rows: minmax(0, 0.62fr) min-content minmax(180px, 1fr) minmax(180px, 1fr);
+	row-gap: 6px;
-	align-content: start;
 	grid-template-areas:
-		"display functions"
+		"display"
-		"display functions"
+		"display-buttons"
-		"keypad functions"
+		"keypad"
-		"keypad trigo";
+		"functions"
-	row-gap: 0;
+		"trigo";
-	column-gap: clamp(10px, 1.4vw, 18px);
 }
 
 .display-block,
 .display-panel,
-.display-buttons-panel,
 .keypad-panel,
 .functions-panel,
-.trigo-panel,
+.trigo-panel {
-.status-line {
 	border-radius: 8px;
 	border: 1px solid rgba(255, 255, 255, 0.06);
 	background: rgba(6, 10, 16, 0.16);
-	box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.05);
+	box-shadow: none;
+}
+
+.display-buttons-panel {
+	border-radius: 8px;
+	border: 1px solid rgba(255, 255, 255, 0.06);
+	background: rgba(6, 10, 16, 0.16);
+	box-shadow: none;
 }
 
 .display-block {
@@ -98,39 +101,31 @@ body {
 	width: 100%;
 	padding: 16px;
 	padding-bottom: 8px;
-	background: linear-gradient(180deg, var(--display), var(--display2));
+	background: var(--display);
 	color: var(--displayText);
 	font-family: "Courier New", monospace;
 	overflow: hidden;
-	height: auto;
+	box-sizing: border-box;
-	min-height: clamp(112px, 18vw, 124px);
+	height: 138px;
-	max-height: none;
+	min-height: 138px;
+	max-height: 138px;
 	margin-bottom: 0;
 }
-
-.display-frame {
-	margin: 0;
-	padding: 0;
-}
-
-.display-buttons-panel {
-	margin-top: 0;
-}
-
 .display-grid {
 	height: 100%;
 	display: grid;
 	grid-template-columns: 1fr;
-	grid-template-rows: repeat(4, minmax(0, 1fr));
+	grid-template-rows: repeat(4, minmax(0, auto));
+	align-content: start;
 	gap: 2px;
 }
 
 .stack-cell {
 	display: grid;
-	grid-template-columns: 2.2ch 1fr auto;
+	grid-template-columns: 2.2ch auto minmax(0, 1fr);
 	align-items: center;
-	gap: 12px;
+	gap: 8px;
-	font-size: clamp(18px, 3vw, 30px);
+	font-size: 20px;
 	line-height: 1;
 	min-height: 0;
 	padding-block: 0;
@@ -148,60 +143,83 @@ body {
 	text-overflow: ellipsis;
 	text-align: right;
 	justify-self: end;
+	font-size: 20px;
+}
+.display-buttons-panel {
+	grid-area: display-buttons;
+	padding: 8px;
+	align-self: start;
+	min-height: 0;
 }
 
-.display-buttons-panel {
+.display-buttons-grid {
-	width: 100%;
-	padding: 8px;
 	display: grid;
 	grid-template-columns: repeat(4, minmax(0, 1fr));
-	grid-template-rows: repeat(2, auto);
 	gap: 8px;
 	align-content: start;
 	align-items: stretch;
-	grid-auto-flow: row;
+}
-	grid-auto-rows: auto;
+
-	background: linear-gradient(180deg, #242a33, #1a1f27);
+.display-button-spacer {
-	border-color: rgba(255, 255, 255, 0.04);
+	pointer-events: none;
-	margin-top: 0;
+	visibility: hidden;
+	background: transparent;
+	border-color: transparent;
+	box-shadow: none;
 }
 
 .display-button {
-	box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.08), 0 3px 0 rgba(0, 0, 0, 0.34);
+	background: linear-gradient(180deg, var(--btnTop), var(--btnBottom));
-	background-clip: padding-box;
+	color: #eef2f7;
-	background: linear-gradient(180deg, #3a414c, #252b34);
+	box-shadow: none;
-	color: #e8edf3;
-	border-color: rgba(255, 255, 255, 0.05);
 }
 
-.display-button-offset {
+.display-button-symbol {
-	grid-column-start: 2;
+	display: inline-flex;
+	align-items: center;
+	justify-content: center;
+	min-width: 1.2em;
+	font-size: 1.05em;
+	line-height: 1;
+	font-weight: 800;
+	transform: translateY(-0.01em);
 }
 
-.display-buttons-panel > button {
+.paste-symbol {
-	width: 100%;
+	font-size: 1em;
 }
 
-.mode-menu {
+.display-buttons-grid > button {
+	padding: 6px 8px;
+}
+
+.menu-popup {
 	position: fixed;
 	z-index: 20;
-	display: grid;
+	display: flex;
-	gap: 6px;
+	flex-direction: column;
-	padding: 10px;
+	gap: 4px;
-	border-radius: 8px;
+	padding: 6px;
-		background: rgba(18, 24, 33, 0.98);
+	border-radius: 6px;
-	border: 1px solid rgba(255, 255, 255, 0.08);
+	background: rgba(16, 21, 30, 0.96);
-
+	border: 1px solid rgba(255, 255, 255, 0.12);
-	box-shadow: 0 14px 30px rgba(0, 0, 0, 0.35);
+	box-shadow: 0 10px 24px rgba(0, 0, 0, 0.32);
+	backdrop-filter: blur(2px);
 }
 
-.mode-menu-item {
+.menu-popup-item {
-	min-width: 120px;
+	width: 100%;
+	min-width: 0;
+	padding: 6px 10px;
+	border-radius: 5px;
 	background: linear-gradient(180deg, var(--btnAltTop), var(--btnAltBottom));
+	text-align: left;
+	font-weight: 700;
 }
 
-.mode-menu-item.is-active {
+.menu-popup-item.is-active {
-	outline: 2px solid rgba(207, 224, 174, 0.7);
+	outline: 1px solid rgba(207, 224, 174, 0.7);
+	outline-offset: 0;
 }
 
 .key-escape {
@@ -209,35 +227,12 @@ body {
 	color: #eef2f7;
 }
 
-.display-button:nth-child(6) {
+.keypad-panel,
-	background: linear-gradient(180deg, #343b46, #20262e);
+.functions-panel,
-}
-
-.display-button:nth-child(7) {
-	background: linear-gradient(180deg, #343b46, #20262e);
-}
-
-.keypad-panel {
-	grid-area: keypad;
-	padding: 10px;
-}
-
-.functions-panel {
-	grid-area: functions;
-	padding: 10px;
-	align-self: start;
-	min-height: 0;
-	padding-top: 10px;
-	padding-bottom: 8px;
-}
-
 .trigo-panel {
-	grid-area: trigo;
+	padding: 8px;
-	padding: 10px;
 	align-self: start;
 	min-height: 0;
-	padding-top: 10px;
-	padding-bottom: 8px;
 }
 
 .status-bar {
@@ -279,36 +274,31 @@ body {
 .trigo-grid {
 	display: grid;
 	gap: 8px;
-	grid-auto-rows: minmax(0, 1fr);
 }
 
 .keypad-grid {
 	grid-template-columns: repeat(4, minmax(0, 1fr));
-	grid-template-rows: repeat(5, minmax(0, 1fr));
+	grid-template-rows: repeat(5, minmax(0, 1.7fr));
 }
 
 .functions-grid,
 .trigo-grid {
 	grid-template-columns: repeat(4, minmax(0, 1fr));
-}
-
-.functions-grid,
-.trigo-grid {
 	grid-template-rows: repeat(2, minmax(0, 1fr));
 }
 
 button {
 	border: 1px solid rgba(14, 18, 25, 0.85);
 	border-radius: 8px;
-	padding: 10px 8px;
+	padding: 8px 8px;
 
 	font: inherit;
 	font-weight: 700;
 	color: var(--btnText);
 	text-shadow: 0 1px 0 rgba(0, 0, 0, 0.35);
 	cursor: pointer;
-	box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.18), 0 3px 0 rgba(0, 0, 0, 0.28);
+	box-shadow: none;
-	transition: transform 120ms ease, filter 120ms ease, box-shadow 120ms ease, opacity 120ms ease;
+	transition: filter 120ms ease, opacity 120ms ease;
 	line-height: 1;
 }
 
@@ -316,22 +306,28 @@ button:hover {
 	filter: brightness(1.06);
 }
 
-.display-button:hover {
-	filter: brightness(1.08);
-}
-
 button:active {
-	transform: translateY(2px);
+	transform: none;
-	box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.08), 0 1px 0 rgba(0, 0, 0, 0.25);
+	box-shadow: none;
 }
 
-.display-button:active {
+.stack-copy-button:active {
-	transform: translateY(2px);
+	animation: stack-copy-flash 140ms ease-out;
 }
 
+@keyframes stack-copy-flash {
+	0% {
+		opacity: 0.7;
+	}
+	50% {
+		opacity: 1;
+	}
+	100% {
+		opacity: 0.7;
+	}
+}
 .stack-copy-button {
 	padding: 4px;
-	border-radius: 999px;
 	min-width: 24px;
 	width: 24px;
 	height: 24px;
@@ -339,11 +335,12 @@ button:active {
 	place-items: center;
 	opacity: 0;
 	pointer-events: none;
-	transform: scale(0.9);
+	transform: scale(1);
 	background: transparent;
+	border: none;
 	box-shadow: none;
 	color: rgba(31, 42, 18, 0.58);
-	margin-left: 6px;
+	margin-left: 0;
 }
 
 .stack-cell:last-child {
@@ -351,9 +348,9 @@ button:active {
 }
 
 .stack-copy-button svg {
-	width: 13px;
+	width: 15px;
-	height: 13px;
+	height: 15px;
-	fill: currentColor;
+	fill: #0a0a0a;
 	display: block;
 }
 
@@ -370,7 +367,7 @@ button:active {
 }
 
 .stack-copy-button:active {
-	transform: translateY(2px) scale(1);
+	transform: scale(1);
 	color: rgba(31, 42, 18, 0.95);
 }
 
@@ -379,19 +376,30 @@ button:active {
 	outline-offset: 2px;
 }
 
-
 .key-default {
 	background: linear-gradient(180deg, var(--btnTop), var(--btnBottom));
 	color: #eef2f7;
 }
 
-.key-accent {
+.keypad-grid > button {
-	background: linear-gradient(180deg, var(--btnAccentTop), var(--btnAccentBottom));
+	min-height: 1.7em;
-	color: #eef2f7;
 }
 
-.key-alt {
+#keypadGrid > button {
-	background: linear-gradient(180deg, var(--btnAltTop), var(--btnAltBottom));
+	min-height: calc(1.7em * 1.7);
+	padding-top: calc(8px * 1.7);
+	padding-bottom: calc(8px * 1.7);
+}
+
+#keypadGrid > button.key-default,
+#keypadGrid > button.key-accent,
+#keypadGrid > button.key-danger,
+#keypadGrid > button.key-enter {
+	min-height: calc(1.7em * 1.7);
+}
+
+.key-accent {
+	background: linear-gradient(180deg, var(--btnAccentTop), var(--btnAccentBottom));
 	color: #eef2f7;
 }
 
@@ -403,6 +411,7 @@ button:active {
 .key-enter {
 	background: linear-gradient(180deg, var(--btnEnterTop), var(--btnEnterBottom));
 	color: #eef2f7;
+	padding-inline: 6px;
 }
 
 .hidden-input {
@@ -414,79 +423,4 @@ button:active {
 	pointer-events: none;
 }
 
-@media (orientation: portrait), (max-width: 860px) {
-	.calculator {
-		width: 100%;
-		height: auto;
-		min-height: 100%;
-		grid-template-columns: 1fr;
-		grid-template-rows: minmax(160px, auto) auto auto auto;
-		row-gap: 6px;
-		grid-template-areas:
-			"display"
-			"keypad"
-			"functions"
-			"trigo";
-	}
 
-	.display-buttons-panel {
-		grid-template-columns: repeat(4, minmax(0, 1fr));
-		grid-template-rows: repeat(2, auto);
-		margin-top: 0;
-		margin-bottom: 0;
-		padding-top: 4px;
-		padding-bottom: 4px;
-		align-content: start;
-	}
-
-	.keypad-grid {
-		grid-template-rows: repeat(5, minmax(42px, 1fr));
-	}
-
-	.functions-grid,
-	.trigo-grid {
-		grid-auto-rows: minmax(0, auto);
-		grid-template-rows: repeat(2, minmax(0, 1fr));
-	}
-}
-
-@media (max-width: 520px) {
-	.app-shell {
-		padding: 0;
-	}
-
-	.calculator {
-		width: 100%;
-		min-height: 100%;
-		border-radius: 8px;
-		padding: 8px;
-		gap: 12px;
-	}
-
-	.display-panel {
-		padding: 8px;
-		padding-bottom: 8px;
-	}
-
-	.stack-cell {
-		font-size: clamp(16px, 5.2vw, 22px);
-		gap: 8px;
-	}
-
-	.stack-copy-button {
-		padding: 4px;
-		min-width: 24px;
-	}
-
-	button {
-		border-radius: 8px;
-		padding: 10px 8px;
-		font-size: 13px;
-		line-height: 1;
-	}
-
-	.display-buttons-panel {
-		gap: 8px;
-	}
-
-}

samples/calc-02/index.html

@@ -14,25 +14,28 @@
 					<div class="status-bar" id="statusLine" aria-live="polite"></div>
 					<div class="display-frame">
 						<div class="display-grid">
-							<div class="stack-cell"><span class="stack-label">T:</span><span id="stackT" class="stack-value"></span><button type="button" class="stack-copy-button" data-copy-stack="T" aria-label="Copy T value"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M9 9V5.5A1.5 1.5 0 0 1 10.5 4h8A1.5 1.5 0 0 1 20 5.5v8A1.5 1.5 0 0 1 18.5 15H15v3.5A1.5 1.5 0 0 1 13.5 20h-8A1.5 1.5 0 0 1 4 18.5v-8A1.5 1.5 0 0 1 5.5 9H9Zm1.5-3a.5.5 0 0 0-.5.5V9h5.5a1.5 1.5 0 0 1 1.5 1.5V16h.5a.5.5 0 0 0 .5-.5v-8a.5.5 0 0 0-.5-.5h-8Z"/></svg></button></div>
+							<div class="stack-cell"><span class="stack-label">T:</span><button type="button" class="stack-copy-button" data-copy-stack="T" aria-label="Copy T value"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M15.5 4h-7A2.5 2.5 0 0 0 6 6.5V8H5.5A1.5 1.5 0 0 0 4 9.5v8A2.5 2.5 0 0 0 6.5 20H13a1 1 0 0 0 1-1v-1.5H17.5A2.5 2.5 0 0 0 20 15V6.5A2.5 2.5 0 0 0 17.5 4h-2Zm.5 2h1.5a.5.5 0 0 1 .5.5V14a.5.5 0 0 1-.5.5H13V6.5A2.5 2.5 0 0 0 15.5 6Zm-1.5 12H6.5a.5.5 0 0 1-.5-.5v-8a.5.5 0 0 1 .5-.5h7.5V18Zm-1.5-8h-4V8.5A.5.5 0 0 1 9 8h4a.5.5 0 0 1 .5.5V10Z"/></svg></button><span id="stackT" class="stack-value"></span></div>
-							<div class="stack-cell"><span class="stack-label">Z:</span><span id="stackZ" class="stack-value"></span><button type="button" class="stack-copy-button" data-copy-stack="Z" aria-label="Copy Z value"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M9 9V5.5A1.5 1.5 0 0 1 10.5 4h8A1.5 1.5 0 0 1 20 5.5v8A1.5 1.5 0 0 1 18.5 15H15v3.5A1.5 1.5 0 0 1 13.5 20h-8A1.5 1.5 0 0 1 4 18.5v-8A1.5 1.5 0 0 1 5.5 9H9Zm1.5-3a.5.5 0 0 0-.5.5V9h5.5a1.5 1.5 0 0 1 1.5 1.5V16h.5a.5.5 0 0 0 .5-.5v-8a.5.5 0 0 0-.5-.5h-8Z"/></svg></button></div>
+							<div class="stack-cell"><span class="stack-label">Z:</span><button type="button" class="stack-copy-button" data-copy-stack="Z" aria-label="Copy Z value"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M15.5 4h-7A2.5 2.5 0 0 0 6 6.5V8H5.5A1.5 1.5 0 0 0 4 9.5v8A2.5 2.5 0 0 0 6.5 20H13a1 1 0 0 0 1-1v-1.5H17.5A2.5 2.5 0 0 0 20 15V6.5A2.5 2.5 0 0 0 17.5 4h-2Zm.5 2h1.5a.5.5 0 0 1 .5.5V14a.5.5 0 0 1-.5.5H13V6.5A2.5 2.5 0 0 0 15.5 6Zm-1.5 12H6.5a.5.5 0 0 1-.5-.5v-8a.5.5 0 0 1 .5-.5h7.5V18Zm-1.5-8h-4V8.5A.5.5 0 0 1 9 8h4a.5.5 0 0 1 .5.5V10Z"/></svg></button><span id="stackZ" class="stack-value"></span></div>
-							<div class="stack-cell"><span class="stack-label">Y:</span><span id="stackY" class="stack-value"></span><button type="button" class="stack-copy-button" data-copy-stack="Y" aria-label="Copy Y value"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M9 9V5.5A1.5 1.5 0 0 1 10.5 4h8A1.5 1.5 0 0 1 20 5.5v8A1.5 1.5 0 0 1 18.5 15H15v3.5A1.5 1.5 0 0 1 13.5 20h-8A1.5 1.5 0 0 1 4 18.5v-8A1.5 1.5 0 0 1 5.5 9H9Zm1.5-3a.5.5 0 0 0-.5.5V9h5.5a1.5 1.5 0 0 1 1.5 1.5V16h.5a.5.5 0 0 0 .5-.5v-8a.5.5 0 0 0-.5-.5h-8Z"/></svg></button></div>
+							<div class="stack-cell"><span class="stack-label">Y:</span><button type="button" class="stack-copy-button" data-copy-stack="Y" aria-label="Copy Y value"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M15.5 4h-7A2.5 2.5 0 0 0 6 6.5V8H5.5A1.5 1.5 0 0 0 4 9.5v8A2.5 2.5 0 0 0 6.5 20H13a1 1 0 0 0 1-1v-1.5H17.5A2.5 2.5 0 0 0 20 15V6.5A2.5 2.5 0 0 0 17.5 4h-2Zm.5 2h1.5a.5.5 0 0 1 .5.5V14a.5.5 0 0 1-.5.5H13V6.5A2.5 2.5 0 0 0 15.5 6Zm-1.5 12H6.5a.5.5 0 0 1-.5-.5v-8a.5.5 0 0 1 .5-.5h7.5V18Zm-1.5-8h-4V8.5A.5.5 0 0 1 9 8h4a.5.5 0 0 1 .5.5V10Z"/></svg></button><span id="stackY" class="stack-value"></span></div>
-							<div class="stack-cell"><span class="stack-label">X:</span><span id="stackX" class="stack-value"></span><button type="button" class="stack-copy-button" data-copy-stack="X" aria-label="Copy X value"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M9 9V5.5A1.5 1.5 0 0 1 10.5 4h8A1.5 1.5 0 0 1 20 5.5v8A1.5 1.5 0 0 1 18.5 15H15v3.5A1.5 1.5 0 0 1 13.5 20h-8A1.5 1.5 0 0 1 4 18.5v-8A1.5 1.5 0 0 1 5.5 9H9Zm1.5-3a.5.5 0 0 0-.5.5V9h5.5a1.5 1.5 0 0 1 1.5 1.5V16h.5a.5.5 0 0 0 .5-.5v-8a.5.5 0 0 0-.5-.5h-8Z"/></svg></button></div>
+							<div class="stack-cell"><span class="stack-label">X:</span><button type="button" class="stack-copy-button" data-copy-stack="X" aria-label="Copy X value"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M15.5 4h-7A2.5 2.5 0 0 0 6 6.5V8H5.5A1.5 1.5 0 0 0 4 9.5v8A2.5 2.5 0 0 0 6.5 20H13a1 1 0 0 0 1-1v-1.5H17.5A2.5 2.5 0 0 0 20 15V6.5A2.5 2.5 0 0 0 17.5 4h-2Zm.5 2h1.5a.5.5 0 0 1 .5.5V14a.5.5 0 0 1-.5.5H13V6.5A2.5 2.5 0 0 0 15.5 6Zm-1.5 12H6.5a.5.5 0 0 1-.5-.5v-8a.5.5 0 0 1 .5-.5h7.5V18Zm-1.5-8h-4V8.5A.5.5 0 0 1 9 8h4a.5.5 0 0 1 .5.5V10Z"/></svg></button><span id="stackX" class="stack-value"></span></div>
 						</div>
 					</div>
 				</div>
-
-				<div class="display-buttons-panel">
-					<button id="modeButton" class="display-button">Mode</button>
-					<button id="pasteButton" class="display-button">⎘</button>
-					<button id="upButton" class="display-button">↑</button>
-					<button id="constButton" class="display-button">π</button>
-					<button id="leftButton" class="display-button display-button-offset">←</button>
-					<button id="downButton" class="display-button">↓</button>
-					<button id="rightButton" class="display-button">→</button>
-				</div>
 			</div>
 
+			<div class="display-buttons-panel">
+				<div class="display-buttons-grid">
+					<button id="constButton" class="display-button">π</button>
+					<button id="pasteButton" class="display-button"><span class="display-button-symbol paste-symbol">⎘</span></button>
+					<button id="upButton" class="display-button"><span class="display-button-symbol arrow-symbol">↑</span></button>
+					<button id="modeButton" class="display-button">Mode</button>
+					<div class="display-button-spacer"></div>
+					<button id="leftButton" class="display-button display-button-offset"><span class="display-button-symbol arrow-symbol">←</span></button>
+					<button id="downButton" class="display-button"><span class="display-button-symbol arrow-symbol">↓</span></button>
+					<button id="rightButton" class="display-button"><span class="display-button-symbol arrow-symbol">→</span></button>
+				</div>
+			</div>
+			
 			<div class="keypad-panel">
 				<div class="keypad-grid" id="keypadGrid"></div>
 			</div>

samples/calc-02/index.js

@@ -78,7 +78,6 @@ const trigoKeys = [
 	{ label: '', spacer: true },
 ];
 
-
 const isTouchDevice = window.matchMedia('(pointer: coarse)').matches || 'ontouchstart' in window;
 
 function focusInput() {
@@ -229,7 +228,6 @@ function execute(name) {
 			} else if (calc.isValidIndex(0)) {
 				calc.remove(0);
 			}
-
 		} else if (name === 'swap') {
 			pushEditingValueIfNeeded();
 			if (calc.isValidIndex(1)) {
@@ -340,41 +338,49 @@ function handleKeyboard(event) {
 }
 
 const modeOptions = ['deg', 'rad', 'grad'];
-let modeMenuEl = null;
+let activeMenuEl = null;
 
 function closeModeMenu() {
-	if (modeMenuEl) {
+	if (activeMenuEl) {
-		modeMenuEl.remove();
+		activeMenuEl.remove();
-		modeMenuEl = null;
+		activeMenuEl = null;
 	}
 }
 
+function openMenu(anchorButton, items, onSelect) {
+	const rect = anchorButton.getBoundingClientRect();
+	const menu = document.createElement('div');
+	menu.className = 'menu-popup';
+	menu.style.top = `${rect.bottom + 6 + window.scrollY}px`;
+	menu.style.left = `${rect.left + window.scrollX}px`;
+	menu.style.minWidth = `${rect.width}px`;
+	for (const item of items) {
+		const button = document.createElement('button');
+		button.type = 'button';
+		button.className = `menu-popup-item${item.active ? ' is-active' : ''}`;
+		button.textContent = item.label;
+		button.addEventListener('click', () => onSelect(item.value));
+		menu.appendChild(button);
+	}
+	document.body.appendChild(menu);
+	return menu;
+}
+
 function toggleModeMenu() {
-	if (modeMenuEl) {
+	if (activeMenuEl) {
 		closeModeMenu();
 		return;
 	}
 	closeConstMenu();
-	const rect = modeButton.getBoundingClientRect();
+	activeMenuEl = openMenu(modeButton, modeOptions.map((mode) => ({
-	modeMenuEl = document.createElement('div');
+		label: mode,
-	modeMenuEl.className = 'mode-menu';
+		value: mode,
-	modeMenuEl.style.top = `${rect.bottom + 6 + window.scrollY}px`;
+		active: mode === calc.angleMode,
-	modeOptions.forEach((mode) => {
+	})), (mode) => {
-		const button = document.createElement('button');
+		calc.angleMode = mode;
-		button.type = 'button';
+		render();
-		button.className = `mode-menu-item${mode === calc.angleMode ? ' is-active' : ''}`;
+		closeModeMenu();
-		button.textContent = mode;
-		button.addEventListener('click', () => {
-			calc.angleMode = mode;
-			render();
-			closeModeMenu();
-		});
-		modeMenuEl.appendChild(button);
 	});
-	document.body.appendChild(modeMenuEl);
-	const menuRect = modeMenuEl.getBoundingClientRect();
-	const maxLeft = Math.max(8, window.innerWidth - menuRect.width - 8);
-	modeMenuEl.style.left = `${Math.max(8, Math.min(maxLeft, rect.left + window.scrollX))}px`;
 }
 
 modeButton.addEventListener('click', (event) => {
@@ -385,6 +391,7 @@ modeButton.addEventListener('click', (event) => {
 window.addEventListener('resize', () => {
 	closeModeMenu();
 	closeConstMenu();
+	render();
 });
 window.addEventListener('scroll', () => {
 	closeModeMenu();
@@ -398,10 +405,8 @@ window.addEventListener('click', (event) => {
 		if (label) copyStackValue(label);
 		return;
 	}
-	if (modeMenuEl && !event.target.closest('.mode-menu') && event.target !== modeButton) {
+	if (activeMenuEl && !event.target.closest('.menu-popup') && event.target !== modeButton && event.target !== constButton) {
 		closeModeMenu();
-	}
-	if (constMenuEl && !event.target.closest('.mode-menu') && event.target !== constButton) {
 		closeConstMenu();
 	}
 });
@@ -424,52 +429,43 @@ hiddenInput.addEventListener('paste', (event) => {
 
 upButton.addEventListener('click', () => {});
 
-const constants = [
+const constantLabels = {
-	{ label: 'π', value: Math.PI },
+	pi: 'π',
-	{ label: 'e', value: Math.E },
+	e: 'e',
-	{ label: 'φ', value: (1 + Math.sqrt(5)) / 2 },
+	phi: 'φ',
-	{ label: 'g', value: 9.80665 },
+	g: 'g',
-	{ label: 'c', value: 299792458 },
+	c: 'c',
-];
+};
+const constantOrder = ['pi', 'e', 'phi', 'g', 'c'];
 
-let constMenuEl = null;
 
 function closeConstMenu() {
-	if (constMenuEl) {
+	if (activeMenuEl) {
-		constMenuEl.remove();
+		activeMenuEl.remove();
-		constMenuEl = null;
+		activeMenuEl = null;
 	}
 }
 
 function toggleConstMenu() {
-	if (constMenuEl) {
+	if (activeMenuEl) {
 		closeConstMenu();
 		return;
 	}
 	closeModeMenu();
-	const rect = constButton.getBoundingClientRect();
+	const availableConstants = calc.listConstants();
-	constMenuEl = document.createElement('div');
+	const keys = [...constantOrder, ...Object.keys(availableConstants).filter((name) => !constantOrder.includes(name))]
-	constMenuEl.className = 'mode-menu';
+		.filter((name) => Object.prototype.hasOwnProperty.call(availableConstants, name));
-	constMenuEl.style.top = `${rect.bottom + 6 + window.scrollY}px`;
+	activeMenuEl = openMenu(constButton, keys.map((name) => ({
-	constants.forEach((constant) => {
+		label: constantLabels[name] ?? name,
-		const button = document.createElement('button');
+		value: name,
-		button.type = 'button';
+	})), (name) => {
-		button.className = 'mode-menu-item';
+		pushEditingValueIfNeeded();
-		button.textContent = constant.label;
+		calc.push(availableConstants[name]);
-		button.addEventListener('click', () => {
+		render();
-			pushEditingValueIfNeeded();
+		clearStatus();
-			calc.push(constant.value);
+		closeConstMenu();
-			render();
+		focusInput();
-			clearStatus();
-			closeConstMenu();
-			focusInput();
-		});
-		constMenuEl.appendChild(button);
 	});
-	document.body.appendChild(constMenuEl);
-	const menuRect = constMenuEl.getBoundingClientRect();
-	const desiredLeft = rect.right + window.scrollX - menuRect.width;
-	constMenuEl.style.left = `${Math.max(8, desiredLeft)}px`;
 }
 
 constButton.addEventListener('click', (event) => {
@@ -478,7 +474,6 @@ constButton.addEventListener('click', (event) => {
 });
 
 leftButton.addEventListener('click', () => {});
-
 downButton.addEventListener('click', () => {
 	if (!calc.isEditing && calc.isValidIndex(0)) {
 		const value = calc.stack[0];
@@ -490,19 +485,16 @@ downButton.addEventListener('click', () => {
 	}
 });
 
-
 rightButton.addEventListener('click', () => {
 	execute('swap');
 });
 
-
 window.addEventListener('keydown', handleKeyboard, { capture: true });
 window.addEventListener('load', focusInput);
 window.addEventListener('pageshow', focusInput);
 window.addEventListener('focus', focusInput);
 window.addEventListener('pointerdown', focusInput, true);
 window.addEventListener('mousedown', focusInput, true);
-window.addEventListener('click', focusInput, true);
 
 hiddenInput.setAttribute('inputmode', 'none');
 hiddenInput.setAttribute('readonly', 'readonly');
@@ -517,7 +509,7 @@ hiddenInput.addEventListener('focus', () => {
 });
 
 document.addEventListener('click', (event) => {
-	if (!isTouchDevice && !event.target.closest('.mode-menu')) {
+	if (!isTouchDevice && !event.target.closest('.menu-popup')) {
 		focusInput();
 	}
 });

samples/calc-02/visual-landscape.txt

@@ -1,10 +0,0 @@
-┌──────────── Display ────────────┐ ┌────── Functions ─────┐ ┌──────────── Keypad ─────────────┐
-| T:                              | | x^2 | y^x | 1/x  | % | | +/- | Clear | Esc   | backspace |
-| Z:                              | | √x  | y√x | 10^x |   | | 7   | 8     | 9     | /         |
-| Y:                              | | log | ln  |      |   | | 4   | 5     | 6     | *         |
-| X:                              | └──────────────────────┘ | 1   | 2     | 3     | -         |
-└─────────────────────────────────┘ ┌─────── Trigo ────────┐ | 0   | .     | Enter | +         |
-┌──────── Display Buttons ────────┐ | sin  | cos   | tan   | └─────────────────────────────────┘
-| Mode  | Paste  | Up    | Const  | | asin | acos  | atan  | 
-|       | Right  | Down  | Right  | └──────────────────────┘ 
-└─────────────────────────────────┘

samples/calc-02/visual-portrait.md

@@ -1,13 +1,28 @@
+# Calc 02 Visual Portrait
+
+## Display
+
+```
 ┌──────────── Display ────────────┐
 | T:                              |
 | Z:                              |
 | Y:                              |
 | X:                              |
 └─────────────────────────────────┘
+```
+
+## Display Buttons
+
+```
 ┌──────── Display Buttons ────────┐
-| Mode  | Paste  | Up    | Const  |
+| Const | Paste  | Up    | Mode   |
-|       | Right  | Down  | Right  |
+|       | Left   | Down  | Right  |
 └─────────────────────────────────┘
+```
+
+## Keypad
+
+```
 ┌──────────── Keypad ─────────────┐
 | +/- | Clear | Esc   | backspace |
 | 7   | 8     | 9     | /         |
@@ -15,12 +30,23 @@
 | 1   | 2     | 3     | -         |
 | 0   | .     | Enter | +         |
 └─────────────────────────────────┘
-┌─────────── Functions ───────────┐
+```
-| x^2 | y^x   | 1/x   | %         |
+
-| √x  | y√x   | 10^x  |           |
+## Functions
-| log | ln    |       |           |
+
+```
+┌──────────── Functions ──────────┐
+| x^2  | y^x   | 1/x   | %        |
+| √x   | y√x   | 10^x  |          |
+| log  | ln    |       |          |
 └─────────────────────────────────┘
-┌───────────── Trigo ─────────────┐
+```
-| sin  | cos   | tan  |           |
+
-| asin | acos  | atan |           |
+## Trigo
+
+```
+┌──────────── Trigo ──────────────┐
+| sin  | cos   | tan   |          |
+| asin | acos  | atan  |          |
 └─────────────────────────────────┘
+```

src/rpn-calculator.js

@@ -2,6 +2,9 @@ class RpnCalculator {
   static CONSTANTS = {
     pi: Math.PI,
     e: Math.E,
+    phi: (1 + Math.sqrt(5)) / 2,
+    g: 9.80665,
+    c: 299792458,
   };
 
   static OPERATIONS = {
@@ -212,6 +215,15 @@ class RpnCalculator {
     this.enabledCommands = new Set(selectedCommands.map((name) => this.normalizeCommandName(name)).filter((name) => RpnCalculator.OPERATIONS[name]));
   }
 
+  static isValidConstantName(name) {
+    return typeof name === 'string' && name.trim() !== '';
+  }
+
+  static isReservedName(name) {
+    const normalized = typeof name === 'string' ? name.toLowerCase() : '';
+    return Boolean(RpnCalculator.OPERATIONS[normalized]);
+  }
+
   toRadians(value) {
     if (this.angleMode === 'grad') {
       return (value * Math.PI) / 200;
@@ -257,6 +269,45 @@ class RpnCalculator {
     return typeof name === 'string' && Object.prototype.hasOwnProperty.call(this.constants, name.toLowerCase());
   }
 
+  setConstant(name, value) {
+    if (!RpnCalculator.isValidConstantName(name)) {
+      throw new Error('Invalid constant name');
+    }
+    if (!Number.isFinite(value)) {
+      throw new Error('Invalid constant value');
+    }
+
+    const normalized = name.trim().toLowerCase();
+    if (RpnCalculator.isReservedName(normalized)) {
+      throw new Error(`Constant name conflicts with a command: ${name}`);
+    }
+
+    this.constants[normalized] = value;
+    return value;
+  }
+
+  removeConstant(name) {
+    if (!RpnCalculator.isValidConstantName(name)) {
+      throw new Error('Invalid constant name');
+    }
+
+    const normalized = name.trim().toLowerCase();
+    if (!this.isConstantName(normalized)) {
+      return false;
+    }
+
+    delete this.constants[normalized];
+    return true;
+  }
+
+  hasConstant(name) {
+    if (!RpnCalculator.isValidConstantName(name)) {
+      return false;
+    }
+
+    return this.isConstantName(name.trim().toLowerCase());
+  }
+
   push(value) {
     if (this.stack.length >= this.maxSize) {
       throw new Error('Stack overflow');
@@ -408,6 +459,10 @@ class RpnCalculator {
   getConstants() {
     return { ...this.constants };
   }
+
+  listConstants() {
+    return this.getConstants();
+  }
 }
 
 if (typeof window !== 'undefined') {